Definitionen von Volume-Set-Listen ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Funktionsbeschreibung
Das Kommando SHOW-VOLUME-SET-LIST informiert die Systembetreuung über die Zusammensetzung von Volume-Set-Listen, die für ein System-Managed-Pubset (SM-Pubset) definiert sind. Werden die Definitionen mehrerer oder aller Volume-Set-Listen angefordert, kann die Menge der auszugebenden Storage-Klassen über den Operanden SELECT auf bestimmte Volume-Sets beschränkt werden.
Die Ausgabe erfolgt wahlweise auf SYSOUT oder SYSLST.
Der SM-Pubset muss lokal importiert sein (exklusiv oder shared).
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Format
SHOW-VOLUME-SET-LIST | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VOLUME-SET-LIST-NAME = *ALL / <composed-name 1..8 with-wild>
Gibt an, welche Volume-Set-Listen ausgegeben werden sollen.
VOLUME-SET-LIST-NAME = *ALL
Es sollen alle angegebenen Volume-Set-Listen ausgegeben werden, die dem in dem Operanden PUBSET angegebenen Pubset zugeordnet sind und gleichzeitig die Auswahlkriterien des Operanden SELECT erfüllen.
VOLUME-SET-LIST-NAME = <composed-name 1..8 with-wild>
Name der auszugebenden Volume-Set-Liste. Die Angabe von Musterzeichen zur Bezeichnung mehrerer Volume-Set-Listen ist möglich.
Es sollen alle angegebenen Volume-Set-Listen ausgegeben werden, die dem in dem Operanden PUBSET angegebenen Pubset zugeordnet sind und gleichzeitig die Auswahlkriterien des Operanden SELECT erfüllen.
PUBSET = <cat-id 1..4>
Kennung des betroffenen SM-Pubsets. Der Pubset muss lokal importiert sein (exklusiv oder shared).
INFORMATION = *SUMMARY / *ALL
Bestimmt den Umfang der auszugebenden Informationen. Siehe auch Abschnitt "Ausgabeformat".
INFORMATION = *SUMMARY
Für jede angegebenen Volume-Set-Liste wird der Namen der Volume-Set-Liste, die Katalogkennung des SM-Pubsets und die Anzahl der zugehörigen Volume-Sets angezeigt.
INFORMATION = *ALL
Die Ausgabe erfolgt wie bei INFORMATION = *SUMMARY. Zusätzlich werden für jede angegebene Volume-Set-Liste die zugehörigen Volume-Sets aufgelistet und der Kurzbeschreibungstext ausgeben.
SELECT = *ALL / *BY-VOLUME-SET(...)
Gibt an, ob die im Operanden VOLUME-SET-LIST-NAME angegebene Menge eingeschränkt werden soll.
SELECT = *BY-VOLUME-SET(...)
Es sollen nur Volume-Set-Listen ausgegeben werden, die eines der nachfolgend angegebenen Volume-Sets enthalten.
ENTRY = list-poss(255): <cat-id 1..4>
Kennung des Volume-Sets.
In einer Liste können bis zu 255 Volume-Sets angegeben werden.
OUTPUT = *SYSOUT / *SYSLST(...)
Gibt an, wohin die Information auszugeben ist.
OUTPUT = *SYSOUT
Die Ausgabe erfolgt in die Systemdatei SYSOUT.
OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt in die Systemdatei SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Bestimmt, ob die Ausgabe in die Systemdatei SYSLST oder in eine SYSLST-Datei aus der Menge SYSLST01 bis SYSLST99 erfolgen soll.
Default-Wert ist *STD, d.h. die Ausgabe erfolgt in die Systemdatei SYSLST.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kein Fehler. | |
1 | CMD0202 | Syntaxfehler im Kommando | |
32 | CMD0221 | Interner Systemfehler | |
32 | CMD2009 | Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar) | |
64 | CMD0216 | Keine Berechtigung für das Kommando | |
64 | DMS1482 | Fehler beim Zugriff auf den Volume-Set-Listen-Katalog | |
64 | DMS1484 | Volume-Set-Listen-Katalog ungültig | |
64 | DMS1485 | Pubset nicht bekannt | |
64 | DMS1486 | Pubset ist kein System-Managed-Pubset | |
64 | DMS1487 | Pubset nicht verfügbar | |
64 | DMS148B | Volume-Set-Liste nicht definiert | |
64 | DMS1490 | Storage-Klassen-Management für diesen Pubset nicht verfügbar | |
64 | DMS149B | Keine Volume-Set-Liste erfüllt die Selektionskriterien | |
64 | DMS149D | Für den angegebenen Pubset existiert keine Volume-Set-Liste | |
129 | DMS148D | Klasse-4/5-Speicher-Mangel | |
129 | DMS148E | Fehler bei MSCF-Verbindung zum Master-Rechner | |
129 | DMS149E | Fehler bei Ausgabe: SYSLST-Datei kann nicht erweitert werden | |
129 | DMS148F | Subsystem GCF nicht bereit |
Ausgabeformat
Die Ausgabeinformation für jede ausgewählte Volume-Set-Liste gliedert sich in folgende drei Informationsblöcke:
Informationskopf
Auflistung der Volume-Sets, die der Volume-Set-Liste angehören
Kurzbeschreibung der Volume-Set-Liste
Die Ausgabe der Informationsblöcke ist abhängig von der Angabe im Operanden INFORMATION. Mit INFORMATION=*SUMMARY (Default-Wert) wird nur der erste Informationsblock d.h. der Informationskopf ausgegeben. Mit INFORMATION=*ALL werden die drei Informationsblöcke nacheinander ausgegeben.
Informationskopf
Im Informationskopf wird die nachfolgende Wertezeile ausgegeben.
NAME: <vslname> PUBSET: <catid> NUMBER-OF-VOLUME-SETS: <count>
Dabei bedeuten:
<vslname> | Name der Volume-Set-Liste |
<catid> | Kennung des SM-Pubsets, für den die Volume-Set-Liste definiert ist |
<count> | Anzahlt der zur Liste gehörenden Volume-Sets |
Auflistung der Volume-Sets
Der Informationsblock wird nur mit INFORMATION=*ALL ausgegeben. Die Auflistung wird von der folgenden Kopfzeile eingeleitet:
------------------------ VOLUME-SETS ---------------------------
Anschließend werden maximal 17 Wertezeilen mit den Kennungen der Volume-Sets ausgegeben.
Die Anzahl der Wertzeilen ist abhängig von der Anzahl der Volume-Sets, die in der Volume-Set-Liste definiert sind. In einer Wertezeile können maximal 15 Volume-Sets ausgegeben werden.
Sind in der Volume-Set-Liste keine Volume-Sets definiert, wird nur eine Wertezeile mit dem Wert *NONE ausgegeben.
Kurzbeschreibung der Volume-Set-Liste
Der Informationsblock wird nur mit INFORMATION=*ALL ausgegeben. Die Kurzbeschreibung wird von der folgenden Kopfzeile eingeleitet:
-------------------- VOLUME-SET-LIST-INFO ----------------------
Anschließend werden maximal 10 Zeilen mit dem Kurzbeschreibungstext für die Volume-Set-Liste ausgegeben.
Die Anzahl der Zeilen ist abhängig von Länge der auszugebenden Kurzbeschreibung. In einer Zeile können maximal 74 Zeichen ausgegeben werden.
Existiert für die Volume-Set-Liste keine Kurzbeschreibung, wird nur eine Zeile mit dem Wert *NONE ausgegeben.
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 | 1 |
INFORMATION = *SUMMARY | 2 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
|---|---|---|---|---|
Anzahl der zur Liste gehörenden Volume-Sets | var(*LIST).COUNT | I | <integer 0..255> | 1,2 |
Katalogkennung des Pubsets, für den die Volume-Set-Liste definiert ist | var(*LIST).PUBSET | S | <cat-id 1..4> | 1,2 |
Name der Volume-Set-Liste | var(*LIST).VOL-SET-LIST | S | <comp.-name 1..8> | 1,2 |
freier, vom Systemverwalter formulierter Text | var(*LIST).VOL-SET-LIST-INFO | S | " | 1 |
Kennung des Volume-Sets (Ausgabe nur bei var(*LIST).COUNT > 0) | var(*LIST).VOL-SET(*LIST).VOL-SET-ID | S | <cat-id 1..4> | 1 |
Beispiel
/show-volume-set-list volume-set-list-name = vsl1,
pubset = abcd, information = *all
NAME: VSL1 PUBSET: ABCD NUMBER-OF-VOLUME-SETS: 6 ------------------------- VOLUME-SETS ---------------------------- VST1 VST2 VST3 VST4 VST5 VST6 --------------------- VOLUME-SET-LIST-INFO ----------------------- Liste fuer high available Volume-Sets