Definitionen eines SM-Pubsets ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-PUBSET-DEFINITION-FILE informiert über die Volume-Setspezifischen Konfigurationsparameter von System-Managed-Pubsets (SM-Pubsets). Informationen werden nur für lokal verfügbare (importierte) Pubsets ausgegeben.
Die Konfigurationsparameter können mit dem Kommando MODIFY-PUBSET-DEFINITION-FILE geändert werden.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Format
SHOW-PUBSET-DEFINITION-FILE |
PUBSET = *ALL / <cat-id 1..4> ,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *HSMS-SUPPORTED ,VOLUME-SET = *ALL / <cat-id 1..4> |
Operandenbeschreibung
PUBSET = *ALL / <cat-id 1..4>
Bestimmt die lokal verfügbaren Pubsets, deren Konfigurationsparameter angezeigt werden sollen.
PUBSET = *ALL
Es sollen die Konfigurationsparameter aller lokal verfügbaren Pubsets angezeigt werden. Mit dem Operanden SELECT-PUBSET kann die Auswahl auf bestimmte Pubsets beschränkt werden.
PUBSET = <cat-id 1..4>
Kennung des Pubsets, dessen Konfigurationsparameter ausgegeben werden sollen.
SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *HSMS-SUPPORTED
Bestimmt Auswahlkriterien für die Auswahl bestimmer Pubsets aus der Menge aller lokal verfügbaren Pubsets (siehe PUBSET=*ALL).
Voreinstellung ist *ALL, d.h. die Konfigurationsparameter aller Pubsets werden angezeigt.
SELECT-PUBSET = *EXCLUSIVE
Die Konfigurationsparameter aller exklusiv importierten Pubsets werden angezeigt.
SELECT-PUBSET = *SHARED
Die Konfigurationsparameter aller shared importierten Pubsets werden angezeigt.
SELECT-PUBSET = *HSMS-SUPPORTED
Die Konfigurationsparameter aller SM-Pubsets, die durch das Subsystem HSMS bedient werden können, werden angezeigt.
VOLUME-SET = *ALL / <cat-id 1..4>
Bestimmt die Volume-Sets, deren Konfigurationsparameter angezeigt werden sollen.
VOLUME-SET = *ALL
Es sollen die Konfigurationsparameter aller Volume-Sets angezeigt werden.
VOLUME-SET = <cat-id 1..4>
Kennung des Volume-Sets, dessen Konfigurationsparameter ausgegeben werden sollen.
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) | |
32 | DMS138A | Interner Parameterfehler | |
64 | DMS1381 | Volume-Set-Konflikt | |
64 | DMS138B | Pubset nicht vorhanden oder nicht mit angegebener Eigenschaft | |
64 | DMS138C | Pubset nicht zugreifbar | |
64 | DMS138E | Volume-Set nicht vorhanden | |
128 | DMS1386 | Klasse-4/5-Speichermangel |
Ausgabeformat
Als Kopfzeile wird der Kommandoname ausgegeben. Danach folgen pro Pubset:
der Ausgabeblock mit pubset-globalen Grundinformationen
der Ausgabeblock mit Informationen über die volumeset-spezifischen Konfigurationsparameter
Pubset-globale Grundinformationen
Der Ausgabeblock besteht aus einer Zeile und enthält die Katalogkennung, den Pubset-Typ (SM-Pubset), die Anzahl der zugehörigen Volumes bzw. Volume-Sets und das Standard-Dateiformat ausgegeben.
PUBSET <catid>: TYPE = SYSTEM-MANAGED, VOLUMESETS = <m>, DEFAULT-FILE-FORMAT = <f>
Informationen über die volumeset-spezifischen Konfigurationsparameter
Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- VOLUME-SET INFORMATION --------------------------------------
Für jedes Volume-Set wird die volumeset-spezifische Grundinformation ausgegeben:
VOLUME-SET <catid>: [CONTROL-VOLSET] <status>,<usage>,<format>,<avail>
Bedeutung der Ausgabewerte
<catid> | Kennung des Volume-Sets |
CONTROL-VOLSET | Ausgabe nur für Control-Volume-Set. Dieser Volume-Set enthält die Verwaltungsdaten des SM-Pubsets. |
<status> | Betriebszustand des Volume-Sets: |
|
|
|
|
|
|
|
|
<usage> | Nutzungsart (Ausgabe nur bei Abweichung vom Standardwert) |
|
|
|
|
<format> | Dateiformat |
|
|
|
|
|
|
<avail> | Verfügbarkeit (Ausgabe nur bei Abweichung vom Standardwert) |
|
|
Zusätzlich zur Grundinformation werden zwei weitere Informationsblöcke ausgegeben. Die Informationen werden jeweils von einer Überschriftszeile eingeleitet und danach tabellarisch ausgegeben. Die linke Spalte bezeichnet den Parameter, die rechte Spalte die möglichen Werte. Die Angabe list-poss(n): bedeutet, dass bis zu n Werte (jeweils in einer eigenen Zeile) angezeigt werden können.
Globale Attribute
Die Ausgabe wird mit der folgenden Überschrift eingeleitet:
--- GLOBAL ATTRIBUTES ---- + ---------------------------------
Danach folgen die einzelnen Informationen:
Information bezüglich der Verfügbarkeits-Eigenschaften des Volume-Sets:
AVAILABILITY | STANDARD | HIGH
Information bezüglich der Nutzungsarten der Volume-Sets:
USAGE | STANDARD | WORK | HSMS-CONTROLLED
Information bezüglich des Volume-Set-Formats:
FORMAT | UNDEFINED | K-FORMAT | NK2-FORMAT | NK4-FORMAT
Information über die maximale Ein-/Ausgabelänge (in PAM-Seiten).
MAXIMAL I/O LENGTH | <n> HP
Information über die kleinste Allokierungseinheit (in PAM-Seiten).
ALLOCATION UNIT SIZE | <n> HP
Information über Platteneigenschaften bezüglich DRV
DRV-VOLSET | NO / YES
Information bezüglich Einschränkungen beim erstmaliger Allokierung:
NEW FILE ALLOCATION | NOT RESTRICTED | PHYSICAL ONLY | NOT ALLOWED
Information bezüglich des Zugriffs auf den Volume-Set
VOLUME SET ACCESS | NOT RESTRICTED | ADMIN ONLY
Performance-Attribute
Die Ausgabe wird mit der folgenden Überschrift eingeleitet:
PERFORMANCE-ATTRIBUTES |
Danach folgen die einzelnen Informationen:
Information zum Profil der Performance-Eigenschaften:
PERFORMANCE: | NO VALUES | or list-poss(3): | STANDARD | HIGH | VERY-HIGH
Information bezüglich des Zeitpunkts, zu dem Datenkonsistenz bestehen soll:
WRITE-CONSISTENCY: | IMMEDIATE | BY-CLOSE
Ausgabe in S-Variable
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
Anzahl der Volume-Sets bei System-Managed-Pubsets | var(*LIST).COUNT | I | <integer 1..255> | |
Maximale I/O-Transferlänge (HP) des System-Managed-Pubsets | var(*LIST).MAX-IO-LEN | I | <integer> | |
Katalogkennung des Pubsets | var(*LIST).PUBSET-ID | S | <cat-id> | |
Pubsettyp | var(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | |
Aktuelle Allokierungseinheit | var(*LIST).VOLSET(*LIST).ALLOC-UNIT-SIZE | I | <integer> | |
Zugang zum Volume-Set | var(*LIST).VOLSET(*LIST).ACCESS | S | *ADM-ONLY | |
Aktuell eingestellte Verfügbarkeit | var(*LIST).VOLSET(*LIST).AVAIL | S | *STD | |
Volume-Set enthält die Verwaltungsdaten des Pubsets | var(*LIST).VOLSET(*LIST).CONTR | S | *NO | |
DRV-Eigenschaft des Volume-Sets | var(*LIST).VOLSET(*LIST).DRV | S | *NO | |
Format des Volume-Sets | var(*LIST).VOLSET(*LIST).FORM | S | *K | |
Ohne Bedeutung (Ausgabe nur aus Kompatibilitätsgründen) | var(*LIST).VOLSET(*LIST).GS | S | ||
Aktuelle maximale I/O-Transferlänge | var(*LIST).VOLSET(*LIST).MAX-IO-LEN | I | <integer> | |
Aktuelle Allokierungsrestriktionen | var(*LIST).VOLSET(*LIST).NEW-FILE-ALLOC | S | *NOT-RESTRICT | |
I/O-Performance | var(*LIST).VOLSET(*LIST).PERF.PERF(*LIST) | S | *STD | |
Datenkonsistenz bei erhöhter I/O-Performance | var(*LIST).VOLSET(*LIST).PERF.WRITE-CONSIST | S | *BY-CLOSE | |
Status des Volume-Sets | var(*LIST).VOLSET(*LIST).STA | S | *DEFECT | |
Dateien des Volume-Sets | var(*LIST).VOLSET(*LIST).USAGE | S | *HSMS-CONTR | |
Kennung des Volume-Sets | var(*LIST).VOLSET(*LIST).VOLSET | S | <vsid> |
Beispiel
/show-pubset-definition-file pubset=2os6,volume-set=6vs5
---------------------------------------------------------------------------- COMMAND: SHOW-PUBSET-DEFINITION-FILE - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - PUBSET 2OS6: TYPE = SYSTEM-MANAGED, VOLUMESETS = 6, DEFAULT FILE FORMAT = K ---- VOLUME-SET INFORMATION --------- + ------------------------------------ VOLUME-SET 6VS5: NORMAL-USE, WORK, K-FORMAT ---- GLOBAL ATTRIBUTES --------- + ------------------------------------ AVAILABILITY | STANDARD USAGE | WORK FORMAT | K-FORMAT MAXIMAL I/O LENGTH | 80 HP ALLOCATION UNIT SIZE | 3 HP DRV-VOLSET | NO GS-VOLSET | NO NEW FILE ALLOCATION | NOT RESTRICTED VOLUME SET ACCESS | NOT RESTRICTED ---- PERFORMANCE ATTRIBUTES --------- + ------------------------------------ PERFORMANCE | STANDARD WRITE-CONSISTENCY | BY-CLOSE ----------------------------------------------------------------------------