Zustand von Gerätewarteschlange und Collector-Task abfragen
Komponente: | BS2000 |
Funktionsbereich: | Geräteverwaltung |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | E |
Funktionsbeschreibung
Das Kommando SHOW-RESOURCE-REQUESTS informiert über die Gerätewarteschlange (Secure-Queue) und die Collector-Task.
Die Ausgabe umfasst entweder die Attribute aller Tasks, die momentan auf eine sukzessive Reservierung angeforderter Betriebsmittel warten oder beschränkt sich auf Informationen über die Collector-Task. Zusätzlich können aber auch die von der Systembedienung über RESOURCE-COLLECTION-Kommandos eingestellten Parameter zur systemeigenen Auswahl der Collector-Task abgefragt werden.
Die Ausgabefelder im Einzelnen und ihre Bedeutung sind im Abschnitt „Bedeutung der Ausgabespalten der SHOW-Kommandos der Geräteverwaltung" beschrieben.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Format
SHOW-RESOURCE-REQUESTS |
OUTPUT-INFORMATION = *JOB-NAME / *USER-IDENTIFICATION ,INFORMATION = *ALL-TASKS / *COLLECTOR-TASK / *COLLECT-PARAMETER |
Operandenbeschreibung
OUTPUT-INFORMATION =
Steuert die Belegung des Ausgabefeldes NAME/ID.
OUTPUT-INFORMATION = *JOB-NAME
Der Auftragsname wird in das Feld NAME/ID eingetragen.
OUTPUT-INFORMATION = *USER-IDENTIFICATION
Die Benutzerkennung wird in das Feld NAME/ID eingetragen.
INFORMATION =
Legt die Art der gewünschten Information fest.
Es wird eine Überschriftszeile und eine Wertezeile ausgegeben.
INFORMATION = *ALL-TASKS
Informiert über alle Tasks in der Secure-Queue.
Ausgabeformat:
|
|
|
|
|
|
|
INFORMATION = *COLLECTOR-TASK
Informiert nur über die Collector-Task.
Ausgabeformat:
|
|
|
|
|
| |
|
|
INFORMATION = *COLLECT-PARAMETER
Informiert über die mit den RESOURCE-COLLECTION-Kommandos eingestellten Collect-Parameter.
Ausgabeformat:
|
|
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
2 | 0 | NKD0005 | Warnung: Information unvollständig |
1 | NKD0001 | Syntaxfehler in der Eingabe. Korrektur der Kommandoparameter behebt den Fehler | |
32 | CMD2009 | Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar) | |
64 | NKD0002 | Keine Information vorhanden | |
64 | NKD0006 | Interner Fehler bei der Initialisierung des Kommandoservers oder Software Error | |
64 | NKD0007 | Aufrufer nicht privilegiert | |
64 | NKD0040 | SECURE-QUEUE existiert nicht | |
64 | NKD0041 | COLLECTOR-TASK existiert nicht | |
64 | OPS0002 | Unterbrechung (z.B. K2-Taste) während der Erzeugung der S-Variablen | |
130 | OPS0001 | SDF-P meldet Speichermangel (mögl. Reaktion: FREE-VARIABLE und Kommandowiederholung) |
Ausgabe in S-Variable
Der Operand INFORMATION des Kommandos legt fest, welche S-Variablen erzeugt werden. Folgende Angaben sind für INFORMATION möglich:
Schreibweise im Kommando | gekürzte Schreibweise in Tabelle |
---|---|
INFORMATION = *ALL-TASKS | INF=A-TASK |
INFORMATION = *COLLECTOR-TASK | INF=COLL-TASK |
INFORMATION = *COLLECT-PARAMETER | INF=COLL-PARA |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
TSN der Collector-Task | var(*LIST).COLL | S | ’’ | INF=ALL/ |
Zustand der Collector-Task | var(*LIST).COLL-INFO | ’’ TASK WAITING FOR FILE LOCKS TASK WAITING FOR MOUNT OR OPERATOR ACKNOWLEDGEMENT TASK WAITING FOR MAREN LOCK | INF=A-TASK/ | |
Name des Lagerorts, aus dessen Gerätemenge das Gerät entnommen worden ist, das für die Collector-Task reserviert ist | var(*LIST).COLL-TYPE(*LIST).LOCATION | S | ’’ | INF=ALL/ |
Anzahl der Geräte des angegebenen Gerätetyps, die für die Collector-Taskreserviert ist | var(*LIST).COLL-TYPE(*LIST).NUM | I | <integer> | INF=ALL/ |
Gerätetyp, der für die Collector-Task reserviert ist | var(*LIST).COLL-TYPE(*LIST).TYPE | S | ’’ | INF=ALL/ |
mnemotechnischer Name des Geräts, das für die Collector-Task reserviert ist | var(*LIST).COLL-UNIT(*LIST) | S | ’’ | INF=ALL/ |
Name des Lagerorts des Datenträgers, der für die Collector-Task reserviert ist | var(*LIST).COLL-VOL(*LIST).LOCATION | S |
<location> | INF=ALL/ |
Volume, das für die Collector-Task reserviert ist | var(*LIST).COLL-VOL(*LIST).RESERVED | S | ’’ | INF=ALL/ |
Gerätetyp, auf dem der Datenträger bereitgestellt wird, der die Daten der Collector-Task aufnimmt | var(*LIST).COLL-VOL(*LIST).TYPE | S | ’’ | INF=ALL/ |
VSN des Datenträgers, der über die Gerätereservierung zur Speicherung der Collector-Task-Daten ausgewählt wurde | var(*LIST).COLL-VOL(*LIST).VOL | S | ’’ | INF=ALL/ |
Name des Lagerorts, aus dessen Gerätemenge das Gerät entnommen worden ist, das für die Collector-Task reserviert ist | var(*LIST).COLL-TYPE(*LIST).LOCATION | S | ’’ | INF=ALL/ |
Zeitpunkt, zu dem die Task in die Gerätewarteschlange eingetreten ist | var(*LIST).REQ(*LIST).ADMIS-TIME | S | <admission-time> | INF=ALL/ |
Job-Name der wartenden Task | var(*LIST).REQ(*LIST).NAME | S | ’’ | INF=ALL/ |
Priorität der Task, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TASK-PRIO | S | <task-priority> | INF=ALL/ |
Typ der Task, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TASK-TYPE | S | ’’ | INF=ALL/ |
TSN der Task, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TSN | S | ’’ | INF=ALL/ |
Name des Lagerorts, aus dessen Gerätemenge das Gerät entnommen worden ist, das für die Task reserviert ist, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TYPE(*LIST).LOCATION | S | ’’ | INF=ALL/ |
Anzahl der Geräte des angegebenen Gerätetyps, die für die Task reserviert sind, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TYPE(*LIST).NUM | I | <integer> | INF=ALL/ |
Gerätetyp, der für die Task reserviert ist, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).TYPE(*LIST).TYPE | S | ’’ <dev-type> | INF=ALL/ |
mnemotechnischer Name des Geräts, das für die Task reserviert ist, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).UNIT(*LIST) | S | ’’ | INF=ALL/ |
Name des Lagerortes des Datenträgers, der die Daten der Task aufnimmt, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).VOL(*LIST).LOCATION | S | ’’ | INF=ALL/ |
Volume, das für die Task reserviert werden soll | var(*LIST).REQ(*LIST).VOL(*LIST).RESERVED | S | ’’ | INF=ALL/ |
Gerätetyp, auf dem der Datenträger bereitgestellt wird, der die Daten der Task aufnimmt, die sich in der Warteschlange befindet | var(*LIST).REQ(*LIST).VOL(*LIST).TYPE | S | ’’ | INF=ALL/ |
VSN des Datenträgers, der über die Gerätereservierung zur Speicherung der Task-Daten ausgewählt wurde | var(*LIST).REQ(*LIST).VOL(*LIST).VOL | S | ’’ | INF=ALL/ |
Wartezeit der Task in der Warteschlange | var(*LIST).REQ(*LIST).WAIT-TIME | S | <wait-time> | INF=ALL/ |
Auswahl der Collector-Task | var(*LIST).RES-COLL | S | *NO | INF= |
Wartezeit, die die Task auf die Erfüllung der Reservierungsanforderung maximal warten soll | var(*LIST).TIME-WEIGHT | S | *NONE | INF= |