Aktuelle Pubset-Konfiguration ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | @ |
Funktionsbeschreibung
Das Kommando SHOW-PUBSET-CONFIGURATION informiert über die physikalische Zusammensetzung von Pubsets, die lokal verfügbar (importiert ) sind. Die möglichen Informationen sind abhängig vom Pubset-Typ:
Für SM-Pubsets werden sowohl Pubset-globale als auch Volumeset-spezifische Konfigurationsparameter angezeigt (siehe Kommando MODIFY-PUBSET-DEFINITION-FILE).
Für SF-Pubsets werden nur die Grundinformationen und Informationen über die physikalische Pubset-Konfiguration ausgegeben. Weitergehende Informationen müssen mit dem Kommando SHOW-MASTER-CATALOG-ENTRY angefordert werden.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
Teilinformationen des Kommandos SHOW-PUBSET-CONFIGURATION erhalten Sie auch mit den folgenden SHOW-Kommandos, die als Pendant zu dem entsprechenden MODIFY-Kommando existieren:
Kommando | entsprechende Operanden in |
|
|
|
|
|
|
Format
SHOW-PUBSET-CONFIGURATION | ||||||||||||||||||||||||||||||||||||
|
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.
INFORMATION = *SUMMARY / *VOLUME-SET-PARAMETERS(...) /
list-poss(2): *PHYSICAL-CONFIGURATION / *PUBSET-FEATURES
Bestimmt die auszugebenden Konfigurationsparameter und den Umfang der Informationen.
INFORMATION = *SUMMARY
Es werden nur Grundinformationen bezüglich der Pubset-Konfiguration ausgegeben. Angezeigt werden der Pubset-Typ und die Anzahl der Volumes (bei SF-Pubsets) bzw. die Anzahl der Volume-Sets und das Standard-Dateiformat (bei SM-Pubsets).
INFORMATION = *VOLUME-SET-PARAMETERS(...)
Für SM-Pubsets werden die Konfigurationsparameter volumeset-spezifisch angezeigt. Nachfolgend können die Volume-Sets und der Informationsumfang bestimmt werden.
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. Mit dem Operanden SELECT-VOLUME-SET kann die Auswahl auf bestimmte Volume-Sets beschränkt werden.
VOLUME-SET = <cat-id 1..4>
Kennung des Volume-Sets, dessen Konfigurationsparameter ausgegeben werden sollen.
SELECT-VOLUME-SET = *ALL / *NORMAL-USE / *IN-HOLD / *DEFECT / *DEFINED-ONLY
Bestimmt Auswahlkriterien für die Auswahl bestimmer Volume-Sets aus der Menge aller Volume-Sets (siehe VOLUME-SET=*ALL).
Voreinstellung ist *ALL, d.h. die Konfigurationsparameter aller Volume-Sets werden angezeigt.
SELECT-VOLUME-SET = *NORMAL-USE
Die Konfigurationsparameter aller zugreifbaren Volume-Sets werden angezeigt.
SELECT-VOLUME-SET = *IN-HOLD
Die Konfigurationsparameter aller temporär nicht betriebsfähigen Volume-Sets werden angezeigt.
SELECT-VOLUME-SET = *DEFECT
Die Konfigurationsparameter aller defekten Volume-Sets werden angezeigt.
SELECT-VOLUME-SET = *DEFINED-ONLY
Die Konfigurationsparameter aller definierten, aber nicht zugreifbaren Volume-Sets werden angezeigt.
VOLUME-SET-INFO = *SUMMARY / *ALL / list-poss(2): *GLOBAL-ATTRIBUTES /
*PERFORMANCE-ATTRIBUTES
Bestimmt die auszugebenden Konfigurationsparameter und den Umfang der Informationen.
VOLUME-SET-INFO = *SUMMARY
Es werden nur Grundinformationen bezüglich der volumeset-spezifischen Konfigurationsparameter ausgegeben. Angezeigt werden die Kennung und der Betriebszustand des Volume-Sets. Die Grundinformationen werden auch bei den anderen Operandenwerten mit angezeigt.
Bei *SUMMARY werden zusätzlich das Format, falls vom Standardwert abweichend auch die Nutzungsart und die Verfügbarkeit ausgegeben.
VOLUME-SET-INFO = *ALL
Es werden die Grundinformationen, die globalen Eigenschaften und die Performance-Eigenschaften des Volume-Sets angezeigt.
VOLUME-SET-INFO = *GLOBAL-ATTRIBUTES
Zusätzlich zur Grundinformation werden Informationen über folgende Konfigurationsparameter ausgegeben:
Verfügbarkeit des Volume-Sets
Nutzungsart des Volume-Sets
Format des Volume-Sets
Maximale Ein-/Ausgabelänge
Allokierungseinheit
DRV-Eigenschaften
Einschränkungen bezüglich Neuanlegen von Dateien und Zugang zu Volume-Sets
VOLUME-SET-INFO = *PERFORMANCE-ATTRIBUTES
Zusätzlich zur Grundinformation werden Informationen über das volumeset-spezifische Profil der Performance-Eigenschaften augegeben.
INFORMATION = *PHYSICAL-CONFIGURATION
Zusätzlich zur Grundinformation (siehe INFORMATION=*SUMMARY) werden detaillierte Informationen über die physikalische Pubset-Konfiguration ausgegeben. Angezeigt werden Name, Gerätetyp und Allokierungsmöglichkeit der Volumes (bei SF-Pubsets) bzw. der Volume-Sets und ihrer Volumes (bei SM-Pubsets).
INFORMATION = *PUBSET-FEATURES
Zusätzlich zur Grundinformation (siehe INFORMATION=*SUMMARY) werden für SF-Pubsets folgende Pubset-Eigenschaften angezeigt:
Formateigenschaft
Maximale Ein-/Ausgabelänge
Allokierungseinheit
DRV-Eigenschaft
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. Die Ausgabeinformation pro Pubset lässt sich in vier Gruppen von Ausgabeblöcken aufteilen:
Ausgabeblock mit pubset-globalen Grundinformationen (INFORMATION=*SUMMARY)
Ausgabeblock mit Informationen über die physikalische Pubset-Konfiguration (INFORMATION=*PHYSICAL-CONFIGURATION)
Ausgabeblock mit Informationen über die pubset-globalen Konfigurationsparameter (INFORMATION=*PUBSET-FEATURES); Ausgabe nur für SF-Pubsets
Ausgabeblock mit Informationen über die volumeset-spezifischen Konfigurationsparameter (INFORMATION=*VOLUME-SET-PARAMETERS)
Bei Informationen über mehrere Pubsets werden zuerst SF-Pubsets und danach SM-Pubsets ausgegeben.
Pubset-globale Grundinformationen
Der Ausgabeblock besteht aus einer Zeile und enthält die Katalogkennung, den Pubset-Typ (SF- oder SM-Pubset) und die Anzahl der zugehörigen Volumes bzw. Volume-Sets. Bei SM-Pubsets wird zusätzlich das Standard-Dateiformat ausgegeben.
Diese Zeile wird auch bei detaillierter Informationsausgabe als Überschriftszeile pro Pubset-Informationsblock ausgegeben.
Ausgabe für einen SF-Pubset:
PUBSET <catid>: TYPE = SINGLE-FEATURE, VOLUMES = <n>
Ausgabe für einen SM-Pubset:
PUBSET <catid>: TYPE = SYSTEM-MANAGED, VOLUME-SETS = <m>,
DEFAULT-FILE-FORMAT = <f>
Informationen über die physikalische Pubset-Konfiguration
Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- PHYSICAL CONFIGURATION ---------------------------------------
Für ein SF-Pubset werden die Informationen zu den Volumes in einer bzw. mehreren Wertezeilen unter der folgenden Überschrift ausgegeben:
VOLUME-CONFIGURATION: VOLUME DEVICE ALLOCATION VOLUME DEVICE ALLOCATION <vsn> <type> <alloc> <vsn> <type> <alloc>
Für jedes Volume-Set eines SM-Pubsets wird die Volume-Set-Kennung und die Anzahl der zugehörigen Volumes angezeigt. Anschließend werden die Informationen zu den Volumes in einer bzw. mehreren Wertezeilen unter der folgenden Überschrift ausgegeben:
--- VOLUME SET INFORMATION -------------------------------------- VOLUME-SET <catid>: VOLUMES = <n> VOLUME CONFIGURATION: VOLUME DEVICE ALLOCATION VOLUME DEVICE ALLOCATION <vsn> <type> <alloc> <vsn> <type> <alloc>
Bedeutung der Ausgabewerte
<catid> | Kennung des Pubsets bzw. Volume-Sets |
<n> | Anzahl der zugehörigen Volumes |
<vsn> | Datenträgerkennzeichen des Volumes |
<type> | Gerätetyp, der dem Volume zugeordnet ist |
<alloc> | Allokierungsmöglichkeit des Volumes:
|
Informationen über die Pubset-globalen Konfigurationsparameter
Die Informationen werden nur für SF-Pubsets ausgegeben. Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:
--- PUBSET FEATURES ---- + ---------------------------------
Danach werden die Informationen tabellarisch ausgegeben. Die linke Spalte bezeichnet den Parameter, die rechte Spalte die möglichen Werte.
Information bezüglich des Pubset-Formats:
PUBSET-FORMAT | 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-PUBSET | NO | YES
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) |
|
|
Über den Operanden VOLUME-SET-INFO können zusätzlich zur Grundinformation zwei weitere Informationsblöcke angefordert werden. 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.
Ausgabe mit VOLUME-SET-INFO = *GLOBAL-ATTRIBUTES
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
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
Ausgabe mit VOLUME-SET-INFO = *PERFORMANCE-ATTRIBUTES
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
Mit VOLUME-SET-INFO=*ALL werden beide Informationsblöcke zusätzlich 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 = *PHYSICAL-CONFIGURATION | 1 |
INFORMATION = *PUBSET-FEATURES (nur SF-Pubsets) | 2 |
INFORMATION = *SUMMARY | 3 |
INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*GLOBAL-ATTRIBUTES) | 4 |
INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*PERFORMANCE-ATTRIBUTES) | 5 |
INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*SUMMARY) | 6 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
Anzahl der Volumes bei SF-Pubsets | var(*LIST).COUNT | I | <integer 1..255> | 1,2,3,4,5,6 |
Maximale I/O-Transferlänge (HP) des SM-Pubsets | var(*LIST).MAX-IO-LEN | I | <integer> | 1,2,3,4,5,6 |
Allokierungseinheit | var(*LIST).PUBSET.ALLOC-UNIT-SIZE | I | <integer> | 2 |
DRV-Eigenschaft des Pubsets | var(*LIST).PUBSET.DRV | S | *NO | 2 |
Format des SF-Pubsets | var(*LIST).PUBSET.FORM | S | *K | 2 |
Maximale I/O-Transferlänge (HP) | var(*LIST).PUBSET.MAX-IO-LEN | I | <integer> | 2 |
Katalogkennung des Pubsets | var(*LIST).PUBSET-ID | S | <cat-id> | 1,2,3,4,5,6 |
Pubsettyp | var(*LIST).PUBSET-TYPE | S | *SINGLE-FEATURE | 1,2,3,4,5,6 |
Allokierungssperre des SF-Pubsets | var(*LIST).VOL(*LIST).ALLOC | S | *NOT-RESTRICT | 1 |
Gerätetypen der Volumes des SF-Pubsets | var(*LIST).VOL(*LIST).DEV | S | <device> | 1 |
VSNs der Volumes des SF-Pubsets | var(*LIST).VOL(*LIST).VOL | S | <vsn> | 1 |
Aktuelle Allokierungseinheit | var(*LIST).VOLSET(*LIST).ALLOC-UNIT-SIZE | I | <integer> | 4 |
Zugang zum Volume-Set | var(*LIST).VOLSET(*LIST).ACCESS | S | *ADM-ONLY | 4 |
Aktuell eingestellte Verfügbarkeit | var(*LIST).VOLSET(*LIST).AVAIL | S | *STD | 4 |
Volume-Set enthält die Verwaltungsdaten des Pubsets | var(*LIST).VOLSET(*LIST).CONTR | S | *NO | 4,5,6 |
DRV-Eigenschaft des Volume-Sets | var(*LIST).VOLSET(*LIST).DRV | S | *NO | 4 |
Format des Volume-Sets | var(*LIST).VOLSET(*LIST).FORM | S | *K | 4 |
Aktuelle maximale I/O-Transferlänge | var(*LIST).VOLSET(*LIST).MAX-IO-LEN | I | <integer> | 4 |
Aktuelle Allokierungsrestriktionen | var(*LIST).VOLSET(*LIST).NEW-FILE-ALLOC | S | *NOT-RESTRICT | 4 |
I/O-Performance | var(*LIST).VOLSET(*LIST).PERF.PERF(*LIST) | S | *STD | 5 |
Datenkonsistenz bei erhöhter | var(*LIST).VOLSET(*LIST).PERF.WRITE-CONSIST | S | *BY-CLOSE | 5 |
Status des Volume-Sets | var(*LIST).VOLSET(*LIST).STA | S | *DEFECT | 4,5,6 |
Dateien des Volume-Sets | var(*LIST).VOLSET(*LIST).USAGE | S | *HSMS-CONTR | 4 |
Kennung des Volume-Sets | var(*LIST).VOLSET(*LIST).VOLSET | S | <vsid> | 1,4,5,6 |
Anzahl der Volumes des Volume-Sets | var(*LIST).VOLSET(*LIST).VOL-COUNT | I | <integer 0..255> | 1 |
Allokierungssperre des Volumes | var(*LIST).VOLSET(*LIST).VOL(*LIST).ALLOC | S | *NOT-RESTRICT | 1 |
Gerätetypen der Volumes pro Volume-Set | var(*LIST).VOLSET(*LIST).VOL(*LIST).DEV | S | <device> | 1 |
VSNs der Volumes pro Volume-Set | var(*LIST).VOLSET(*LIST).VOL(*LIST).VOL | <vsn> | 1 |