Pubset-belegende Aufträge ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-PUBSET-OCCUPATION informiert die Systembetreuung über die Pubset-belegenden Aufträge. Das Kommando liefert Informationen sowohl für Single-Feature-Pubsets (SF-Pubsets) als auch System-Managed-Pubsets (SM-Pubsets).
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Einschränkungen
Für SF-Pubsets im Shared-Pubset-Verbund sind nur die am Pubset-Master ausgegebenen Informationen gültig. Die an einem Pubset-Slave ausgegebenen Informationen werden jeweils gültig, wenn dieser zum Pubset-Master wird.
Format
SHOW-PUBSET-OCCUPATION |
PUBSET = *ALL / <cat-id 1..4> ,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING / *SINGLE-FEATURE / *SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED ,HOST = *LOCAL / *ALL / <alphanum-name 1..8> |
Operandenbeschreibung
PUBSET = *ALL / <cat-id 1..4>
Bestimmt, für welche Pubsets die belegenden Aufträge ausgegeben werden sollen.
PUBSET = *ALL
Es werden die belegenden Aufträge aller Pubsets ausgegeben. Über den Operanden SELECT-PUBSET kann Informationsausgabe auf Pubsets mit bestimmten Eigenschaften beschränkt werden.
PUBSET = <cat-id 1..4>
Kennung des Pubsets, dessen belegenden Aufträge ausgegeben werden sollen.
SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE /
*REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING / *SINGLE-FEATURE /
*SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED
Gibt an, ob die Informationsausgabe nur für bestimmte Pubsets erfolgen soll. Eine Einschränkung auf bestimmte Pubsets ist sinnvoll, wenn im Operanden PUBSET mit *ALL alle Pubsets ausgewählt wurden.
SELECT-PUBSET = *ALL
Die belegenden Aufträge aller im Operanden PUBSET angegebenen Pubsets werden ausgegeben.
SELECT-PUBSET = *EXCLUSIVE
Die belegenden Aufträge aller exklusiv importierten Pubsets werden ausgegeben.
SELECT-PUBSET = *SHARED
Die belegenden Aufträge aller shared importierten Pubsets werden ausgegeben.
SELECT-PUBSET = *ACCESSIBLE
Die belegenden Aufträge aller Pubsets, auf die zugegriffen werden kann, werden ausgegeben.
SELECT-PUBSET = *LOCAL-ACCESSIBLE
Die belegenden Aufträge aller lokal verfügbaren, d.h. importierten Pubsets, werden ausgegeben.
SELECT-PUBSET = *REMOTE-ACCESSIBLE
Die belegenden Aufträge aller Pubsets, die nicht lokal importiert sind, auf deren Dateikatalog jedoch über eine MSCF-Verbindung zugegriffen werden kann, werden ausgegeben.
SELECT-PUBSET = *HSMS-SUPPORTED
Die belegenden Aufträge aller durch das Subsystem HSMS bedienbaren Pubsets werden ausgegeben.
SELECT-PUBSET = *SPEEDCAT
Die belegenden Aufträge aller SF-Pubsets, auf deren Dateikatalog im lokalen System über SPEEDCAT zugegriffen wird, werden ausgegeben.
SELECT-PUBSET = *PAGING
Die belegenden Aufträge aller Pubsets mit lokal genutzten Seitenwechsel-Bereichen werden ausgegeben.
SELECT-PUBSET = *SINGLE-FEATURE
Die belegenden Aufträge aller SF-Pubsets werden ausgegeben.
SELECT-PUBSET = *SYSTEM-MANAGED
Die belegenden Aufträge aller SM-Pubsets werden ausgegeben.
SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
Die belegenden Aufträge aller Pubsets, die im MRS-Katalog als XCS-Pubsets definiert sind, werden ausgegeben.
SELECT-PUBSET = *XCS-CONFIGURATED
Die belegenden Aufträge aller XCS-Pubsets werden ausgegeben.
HOST = *LOCAL / *ALL / <alphanum-name 1..8>
Bestimmt, von welchem Rechner die belegenden Aufträge ermittelt werden sollen.
HOST = *LOCAL
Es werden nur die belegenden Aufträge des lokalen Rechners angezeigt.
HOST = *ALL
Es werden die belegenden Aufträge aller Rechner des Shared-Pubset-Verbundes angezeigt, wenn der lokale Rechner der Pubset-Master ist. Andernfalls werden nur die belegenden Aufträge des lokalen Rechners angezeigt (siehe HOST = *LOCAL).
HOST = <alphanum-name 1..8>
Es werden die belegenden Aufträge des angegebenen Rechners angezeigt.
Bezeichnet der angegebene BCAM-Name nicht den lokalen Rechner, wird die Information nur ausgegeben, wenn der lokale Rechner der Pubset-Master des Shared-Pubsets ist und der angegebene BCAM-Name einen weiteren Pubset-Sharer bezeichnet.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
32 | CMD0221 | Interner Systemfehler | |
32 | CMD2009 | Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar) | |
64 | CMD0216 | Privilegienfehler | |
64 | DMS1381 | Volume-Set-Konflikt | |
64 | DMS138B | Pubset nicht vorhanden oder nicht mit angegebener Eigenschaft | |
64 | DMS138E | Volume-Set nicht vorhanden | |
64 | DMS1396 | Rechnername ungültig | |
128 | DMS1386 | Klasse-4/5-Speichermangel |
Ausgabeformat
Als Kopfzeile wird der Kommandoname ausgegeben. Die Ausgabeinformation pro Pubset lässt sich in zwei Gruppen von Ausgabeblöcken einteilen:
Ausgabeblock für die pubset-globale Grundinformation
Ausgabeblöcke für pubset-globale Detail-Informationen
Pubset-globale Grundinformation
Der Ausgabeblock für die pubset-globale Grundinformation besteht aus einer Wertezeile, die gleichzeitig als Überschriftszeile die Informationsausgabe für einen Pubset einleitet. Die Grundinformation besitzt folgendes Layout:
PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms>
Bedeutung der Ausgabewerte
<catid> | Kennung des Pubsets |
<type> | Typ des Pubsets; möglich sind: SINGLE-FEATURE bzw. SYSTEM-MANAGED |
<ctlid> | Kennung des Control-Volume-Sets (bei SM-Pubset) |
<type> | Gerätetyp der Systemplatte des Control-Volume-Sets (bei SM-Pubset) |
<status> | Verfügbarkeit des Pubsets; möglich Werte sind:
|
<hsms> | Unterstützung durch das Subsystem HSMS (bei SM-Pubset); möglich Werte sind:
|
Pubset-globale Detail-Informationen
Für die Pubsets werden die belegenden Aufträge ausgegeben.
Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- REFERENCE ---------------------------------------
Die nachfolgende Wertezeile zeigt die Anzahl der pubset-belegenden Aufträge:
NUMBER OF OCCUPYING TASKS | <number>
Existiert mindestens ein pubset-belegender Auftrag, dann werden anschließend detaillierte Informationen über die belegenden Aufträge ausgegeben. Die Ausgabe erfolgt pro Rechner, auf dem belegende Aufträge existieren. Die Information über die belegenden Aufträge eines Rechners wird von einer der folgenden Überschriftszeilen eingeleitet:
Überschriftszeile für belegende Aufträge des lokalen Rechners:
OCCUPATIONS BY LOCAL TASKS
Überschriftszeile für belegende Aufträge von unbekannten Rechnern:
OCCUPATIONS FROM HOST: (UNKNOWN)
Überschriftszeile für belegende Aufträge eines entfernten Rechners:
OCCUPATIONS FROM HOST: <bcam name>
In einer bzw. mehreren Wertezeilen werden alle belegenden Aufträge des jeweiligen Rechners mit der Auftragsnummer (TSN) und Benutzerkennung (falls vorhanden) angezeigt:
<tsn> <userid> <tsn> <userid> <tsn> <userid> <tsn> <userid>
Ausgabe in S-Variable
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
Gerätetyp der Systemplatte des Control-Volume-Sets; | var(*LIST).CONTR-DEV-TYPE | S | *NO | |
Kennung des Control-Volume-Sets; | var(*LIST).CONTR-VOLSET | S | *NO | |
HSMS-Unterstützung des Pubsets | var(*LIST).HSMS-SUP | S | *NO | |
Anzahl der Beleger | var(*LIST).OCCUP.NUM-OF-TASK | I | <integer> | |
Rechnername (nur bei OCCUP.NUM-OF-TASK > 0) | var(*LIST).OCCUP.HOST(*LIST).NAME | S | *LOC | |
TSN eines Belegers (nur bei OCCUP.NUM-OF-TASK > 0) | var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).TSN | S | <tsn> | |
Userid eines Belegers (nur bei OCCUP.NUM-OF-TASK > 0) | var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).USER-ID | S | *NONE | |
Kennung des Pubsets | var(*LIST).PUBSET-ID | S | <cat-id> | |
Pubset-Typ | var(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | |
Verfügbarkeit des Pubsets | var(*LIST).STA | S | *ACCESSIBLE |
Beispiel
/show-pubset-occupation pubset=x
%---------------------------------------------------------------------------- %COMMAND: SHOW-PUBSET-OCCUPATION %- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - PUBSET X : SINGLE-FEATURE, ACC ---- REFERENCE ------------------------------------------------- NUMBER OF OCCUPYING TASKS | 1 ---- DETAILS OF OCCUPATION ------------------------------------------------- OCCUPATIONS BY LOCAL TASKS RP02 -----------------------------------------------------------------------------