Definitionen von Storage-Klassen ausgeben
Komponente: | BS2000 |
Funktionsbereich: | Dateiverarbeitung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Funktionsbeschreibung
Das Kommando SHOW-STORAGE-CLASS gibt die Definitionen der Storage-Klassen eines System-Managed-Pubsets (SM-Pubsets) aus. Werden die Definitionen mehrerer oder aller Storage-Klassen angefordert, kann die Menge der auszugebenden Storage-Klassen über den Operanden SELECT auf Storage-Klassen mit bestimmten Eigenschaften beschränkt werden. Die Ausgabe erfolgt wahlweise auf SYSOUT oder SYSLST.
Storage-Klassen, die mit einem Guard geschützt sind, werden nur Benutzern angezeigt, die berechtigt sind diese Storage-Klassen zu verwenden.
Der Benutzer kann entweder nur allgemeine Informationen zur Storage-Klasse anfordern oder sich zusätzlich die Datei-Attribute und den beschreibenden Kurztext für die Storage-Klasse ausgeben lassen.
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").
Privilegierte Funktionen
Die Systembetreuung (Privileg TSOS) kann sich über alle Storage-Klassen informieren. Mit INFORMATION=*VOLUME-SET-LIST kann sie sich über die einer Storage-Klasse zugeordnete Volume-Set-Liste informieren. Bei Anforderung aller Informationen mit INFORMATION=*ALL erhält die Systembetreuung zusätzlich zu den Datei-Attributen und dem beschreibenden Kurztext Informationen über die Schutzattribute einer Storage-Klasse und über die zugeordnete Volume-Set-Liste.
Format
SHOW-STORAGE-CLASS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Operandenbeschreibung
STORAGE-CLASS-NAME = *ALL / <composed-name 1..8 with-wild>
Gibt an, über welche Storage-Klassen Informationen ausgegeben werden sollen.
STORAGE-CLASS-NAME = *ALL
Über alle angegebenen Storage-Klassen, die dem in dem Operanden PUBSET angegebenen Pubset zugeordnet sind und gleichzeitig die Auswahlkriterien des Operanden SELECT erfüllen, sollen Informationen ausgegeben werden.
STORAGE-CLASS-NAME = <composed-name 1..8 with-wild>
Name der zu auszugebenden Storage-Klasse. Die Angabe von Musterzeichen zur Bezeichnung mehrerer Storage-Klassen ist möglich.
PUBSET = <cat-id 1..4>
Kennung des betroffenen SM-Pubsets. Der Pubset muss lokal importiert sein (exklusiv oder shared).
INFORMATION = *SUMMARY / *VOLUME-SET-LIST / *ALL
Bestimmt den Umfang der Informationen, die für jede ausgewählte Storage-Klasse ausgegeben werden sollen.
INFORMATION = *SUMMARY
Es werden nur der Name der Storage-Klasse und die Kennung des zugeordneten Pubsets ausgegeben.
INFORMATION = *VOLUME-SET-LIST
Die Angabe ist nur dem privilegierten Benutzer mit dem Privileg TSOS erlaubt.
Die Ausgabe erfolgt wie bei INFORMATION=*SUMMARY. Zusätzlich wird der Name der zugeordneten Volume-Set-Liste ausgegeben.
INFORMATION = *ALL
Die Ausgabe erfolgt wie bei INFORMATION=*SUMMARY. Zusätzlich werden die für die Storage-Klasse definierten Datei-Attribute und der beschreibende Kurztext ausgegeben. Der privilegierte Benutzer mit dem Privileg TSOS erhält außerdem Informationen über die Schutzattribute der Storage-Klasse und den Namen der ihr zugeordneten Volume-Set-Liste.
SELECT = *ALL / *PARAMETERS(...)
Gibt an, ob die im Operanden STORAGE-CLASS-NAME angegebene Menge von Storage-Klassen über Auswahlkriterien eingeschränkt werden soll.
SELECT = *ALL
Die im Operanden STORAGE-CLASS-NAME angegebene Menge von Storage-Klassen wird nicht eingeschränkt.
SELECT = *PARAMETERS(...)
Schränkt die im Operanden STORAGE-CLASS-NAME angegebene Menge von Storage-Klassen über Auswahlkriterien ein. Es sollen nur Storage-Klassen ausgegeben werden, die allen nachfolgend angegebenen Eigenschaften entsprechen.
Der Default-Wert *ANY bedeutet, dass die entsprechende Eigenschaft kein Auswahlkriterium ist.
FILE-ATTRIBUTES = *ANY / *PARAMETERS(...)
Gibt an, ob die Auswahl der auszugebenden Storage-Klassen über die in ihr definierten Datei-Attribute erfolgen soll.
FILE-ATTRIBUTES = *ANY
Die Datei-Attribute sind kein Auswahlkriterium.
FILE-ATTRIBUTES = *PARAMETERS(...)
Die auszugebenden Storage-Klassen werden über die nachfolgend angegebenen Datei-Attribute ausgewählt.
IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
Gibt an, ob die Performance-Eigenschaften Auswahlkriterium sein sollen.
IO-ATTRIBUTES = *PARAMETERS(...)
Es werden nur Storage-Klassen ausgegeben, deren Definitionen die nachfolgend angegebenen Performance-Eigenschaften beinhalten.
PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Wählt alle Storage-Klassen aus, die eines der angegebenen Performance-Attribute beinhalten.
PERFORMANCE = *ANY
Das Performance-Attribut ist kein Auswahlkriterium.
PERFORMANCE = *STD
Es werden nur Storage-Klassen ausgegeben, die das Performance-Attribut *STD (keine Performance-Anforderung) beinhalten.
PERFORMANCE = *HIGH
Es werden nur Storage-Klassen ausgegeben, die das Performance-Attribut *HIGH (erhöhte Performance-Anforderung) beinhalten.
PERFORMANCE = *VERY-HIGH
Es werden nur Storage-Klassen ausgegeben, die das Performance-Attribut *VERY-HIGH (höchste Performance-Anforderung) beinhalten.
USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Wählt alle Storage-Klassen aus, bei denen das Performance-Attribut für eine der angegebenen Ein-/Ausgabe-Operationen vereinbart ist.
USAGE = *ANY
Die Art der Ein-/Ausgabe-Operationen ist kein Auswahlkriterium.
USAGE = *READ-WRITE
Es werden nur Storage-Klassen ausgegeben, deren Performance-Attribut für Lese- und Schreiboperationen gilt.
USAGE = *WRITE
Es werden nur Storage-Klassen ausgegeben, deren Performance-Attribut für Schreiboperationen gilt.
USAGE = *READ
Es werden nur Storage-Klassen ausgegeben, deren Performance-Attribut für Leseoperationen gilt.
DISK-WRITE = *ANY / list-poss(3): *STD / *IMMEDIATE / *BY-CLOSE
Gibt an, ob das Attribut für den geforderten Zeitpunkt für Datenkonsistenz nach Schreiboperationen Auswahlkriterium sein soll.
DISK-WRITE = *ANY
Der geforderte Zeitpunkt für Datenkonsistenz ist kein Auswahlkriterium.
DISK-WRITE = *STD
Es werden nur Storage-Klassen ausgegeben, bei denen der geforderte Zeitpunkt für Datenkonsistenz mit DISK-WRITE=*STD definiert ist.
DISK-WRITE = *IMMEDIATE
Es werden nur Storage-Klassen ausgegeben, bei denen Datenkonsistenz direkt nach Beendigung der Schreiboperation definiert ist.
DISK-WRITE = *BY-CLOSE
Es werden nur Storage-Klassen ausgegeben, bei denen Datenkonsistenz erst nach der CLOSE-Verarbeitung definiert ist.
AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
Gibt an, ob das Attribut für die geforderte Ausfallsicherheit Auswahlkriterium sein soll.
AVAILABILITY = *ANY
Die geforderte Ausfallsicherheit soll kein Auswahlkriterium sein.
AVAILABILITY = *STD
Es werden nur Storage-Klassen ausgegeben, bei denen keine besondere Ausfallsicherheit definiert ist.
AVAILABILITY = *HIGH
Es werden nur Storage-Klassen ausgegeben, bei denen erhöhte Ausfallsicherheit definiert ist.
FILE-PREFORMAT = *ANY / list-poss(4): *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4
Gibt an, ob das Attribut für das beabsichtigte Dateiformat Auswahlkriterium sein soll.
FILE-PREFORMAT = *ANY
Das beabsichtigte Dateiformat soll kein Auswahlkriterium sein.
FILE-PREFORMAT = *BY-PUBSET-DEFAULT
Es werden nur Storage-Klassen ausgegeben, bei denen der pubset-globale Standardwert als beabsichtigtes Dateiformat definiert ist.
FILE-PREFORMAT = *K
Es werden nur Storage-Klassen ausgegeben, bei denen Dateien mit dieser Storage-Klasse als K-Dateien angelegt werden sollen.
FILE-PREFORMAT = *NK2
Es werden nur Storage-Klassen ausgegeben, bei denen Dateien mit dieser Storage-Klasse als NK2-Dateien angelegt werden sollen.
FILE-PREFORMAT = *NK4
Es werden nur Storage-Klassen ausgegeben, bei denen Dateien mit dieser Storage-Klasse als NK4-Dateien angelegt werden sollen.
WORK-FILE = *ANY / list-poss(2): *NO / *YES
Gibt an, ob das Kennzeichen bezüglich Arbeitsdatei Auswahlkriterium sein soll.
WORK-FILE = *ANY
Das Kennzeichen bezüglich Arbeitsdatei soll kein Auswahlkriterium sein.
WORK-FILE = *NO
Es werden nur Storage-Klassen ausgegeben, bei denen die Dateien mit dieser Storage-Klasse als normale Dateien angelegt werden.
WORK-FILE = *YES
Es werden nur Storage-Klassen ausgegeben, bei denen die Dateien mit dieser Storage-Klasse als Arbeitsdateien angelegt werden.
VOLUME-SET-LIST = *ANY / *NONE / <composed-name 1..8>
Gibt an, ob die Storage-Klassen nach der Zuordnung einer Volume-Set-Liste ausgewählt werden sollen.
VOLUME-SET-LIST = *ANY
Die Zuordnung einer Volume-Set-Liste soll kein Auswahlkriterium sein.
VOLUME-SET-LIST = *NONE
Es werden nur Storage-Klassen ausgegeben, denen keine Volume-Set-Liste zugeordnet ist.
VOLUME-SET-LIST = <composed-name 1..8>
Es werden nur Storage-Klassen ausgegeben, denen die angegebene Volume-Set-Liste zugeordnet ist.
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 bestimmte Kommando-Parameter | |
64 | DMS1481 | Fehler beim Zugriff auf den Storage-Klassen-Katalog | |
64 | DMS1483 | Storage-Klassen-Katalog ungültig | |
64 | DMS1485 | Pubset nicht bekannt | |
64 | DMS1486 | Pubset ist kein System-Managed-Pubset | |
64 | DMS1487 | Pubset nicht verfügbar | |
64 | DMS148A | Storage-Klasse nicht definiert | |
64 | DMS1490 | Storage-Klassen-Management für diesen Pubset nicht verfügbar | |
64 | DMS149A | Keine Storage-Klasse erfüllt die Selektionskriterien | |
64 | DMS149C | Für den angegebenen Pubset existiert keine Storage-Klasse | |
64 | DMS149F | Kein Zugriffsrecht für die Storage-Klasse | |
129 | DMS148D | Klasse-4/5-Speicher-Mangel | |
129 | DMS148E | Fehler bei MSCF-Verbindung zum Master | |
129 | DMS148F | Subsystem GCF nicht bereit | |
129 | DMS1498 | Subsystem GUARDS nicht bereit | |
129 | DMS149E | Fehler bei Ausgabe: SYSLST-Datei kann nicht erweitert werden |
Ausgabeformat
Die Ausgabeinformation für jede ausgewählte Storage-Klasse gliedert sich in folgende fünf Informationsblöcke:
Allgemeine Informationen zur Storage-Klasse
Datei-Attribute, die in der Storage-Klasse definiert sind
Schutzattribute der Storage-Klasse (nur für privilegierte Benutzer)
Informationen über die zugeordnete Volume-Set-Liste (nur für privilegierte Benutzer)
Kurzbeschreibung der Storage-Klasse
Die Informationsblöcke 3 und 4 werden nur an privilegierte Benutzer ausgegeben.
Welche Informationsblöcke ausgegeben werden, ist abhängig von dem Privileg des aufrufenden Benutzers und von der Angabe im Operanden INFORMATION. Die folgende Tabelle zeigt, welche Informationsblöcke (Angabe der Nummer) in welcher Reihenfolge ausgegeben werden.
Angabe im Operanden INFORMATION | Privileg | |
---|---|---|
TSOS | STD-PROCESSING | |
*SUMMARY | 1 | 1 |
*VOLUME-SET-LIST | 1 + 4 | Angabe nicht erlaubt |
*ALL | 1 + 2 + 3 + 4 + 5 | 1 + 2 + 5 |
Allgemeine Informationen zur Storage-Klasse
Es wird die folgende Wertezeile mit allgemeinen Informationen ausgegeben:
NAME: <scname> PUBSET: <catid>
Dabei bedeuten:
<scname> | Name der Storage-Klasse |
<catid> | Kennung des SM-Pubsets, für den die Storage-Klasse definiert ist |
Datei-Attribute der Storage-Klasse
Der Informationsblock beginnt mit der Überschriftszeile „FILE-ATTRIBUTES“ und besitzt folgendes Layout:
---------------------- FILE-ATTRIBUTES -------------------------
PERFORMANCE: USAGE: DISK-WRITE:
<perf> <usage> <diskw>
AVAILABILITY: FILE-PREFORMAT: WORK-FILE:
<avail> <format> <work>
Die Ausgabefelder und die angezeigten Werte entsprechen den Datei-Attributen, die mit dem Kommando CREATE-STORAGE-CLASS für die Storage-Klassen-Definition gewählt wurden.
Ausgabefeld | Werte | Bedeutung |
---|---|---|
PERFORMANCE | Performance-Attribut: | |
STANDARD | keine Performance-Anforderung | |
HIGH | erhöhte Performance-Priorität | |
VERY-HIGH | höchste Performance-Priorität | |
USAGE | Art der Ein-/Ausgabeoperation bei Performance-Anforderung: | |
READ-WRITE | Schreib- und Leseoperationen | |
WRITE | nur Schreiboperationen | |
READ | nur Leseoperationen | |
DISK-WRITE | Zeitpunkt für Datenkonsistenz | |
STANDARD | für permanente Dateien gilt IMMEDIATE, für temporäre Dateien gilt BY-CLOSE. | |
IMMEDIATE | Die Datei soll sich direkt nach Schreiboperationen in einem konsistenten Zustand befinden. | |
BY-CLOSE | Die Datei soll sich nach der CLOSE-Verarbeitung in einem konsistenten Zustand befinden. | |
AVAILABILITY | Ausfallsicherheit: | |
STANDARD | keine besondere Ausfallsicherheit | |
HIGH | erhöhte Ausfallsicherheit | |
FILE-PREFORMAT | Beabsichtigtes Dateiformat: | |
BY-PUBSET-DEFAULT | Es gilt der pubset-globale Standardwert. | |
K-FORMAT | Dateien sollen als K-Dateien angelegt werden. | |
NK2-FORMAT | Dateien sollen als NK2-Dateien angelegt werden. | |
NK4-FORMAT | Dateien sollen als NK4-Dateien angelegt werden. | |
WORK-FILE | Kennzeichen bezüglich Arbeitsdateien: | |
NO | Es werden normale Dateien angelegt. | |
YES | Es werden nur Arbeitsdateien angelegt. |
Schutzattribute der Storage-Klasse (nur für privilegierte Benutzer)
Der Informationsblock beginnt mit der Überschriftszeile „PROTECTION“ und besitzt folgendes Layout:
------------------------- PROTECTION ---------------------------
*NONE
bzw.
GUARD-NAME: <profile>
Ist die Storage-Klasse nicht mit einem Guard geschützt, wird in der Wertezeile *NONE ausgegeben. Bei Schutz mit einem Guard zeigt die Wertezeile mit <profile> den Namen des Guards an.
Informationen über die zugeordnete Volume-Set-Liste (nur für privilegierte Benutzer)
Der Informationsblock beginnt mit der Überschriftszeile „ASSIGNED VOLUME-SET-LIST“ und besitzt folgendes Layout:
------------------ ASSIGNED VOLUME-SET-LIST --------------------
*NONE
bzw.
<list>
Ist der Storage-Klasse keine Volume-Set-Liste zugeordnet, wird in der Wertezeile *NONE ausgegeben. Bei Zuordnung einer Volume-Set-Liste zeigt die Wertezeile mit <list> den Namen der Volume-Set-Liste an.
Kurzbeschreibung der Storage-Klasse
Der Informationsblock beginnt mit der Überschriftszeile „STORAGE-CLASS-INFO“ und besitzt folgendes Layout:
---------------------- STORAGE-CLASS-INFO ----------------------
*NONE
bzw.
<text>
Ist für die Storage-Klasse kein Kurzbeschreibungstext definiert, wird in der Wertezeile *NONE ausgegeben.
Existiert ein Kurzbeschreibungstext, zeigt die Wertezeile mit <text> den definierten Kurzbeschreibungstext an. In der Wertezeile werden maximal 74 Zeichen ausgegeben. Ein längerer Text wird in entsprechend vielen Wertezeilen (maximal 10) 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 |
INFORMATION = *VOLUME-SET-LIST (nur für privilegierte Benutzer) | 3 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
---|---|---|---|---|
Anforderung bzgl. der Ausfallsicherheit | var(*LIST).F-ATTR.AVAIL | S | *STD | 1 |
geforderter Dateikonsistenz-Zeitpunkt | var(*LIST).F-ATTR.DISK-WRITE | S | *STD | 1 |
Beabsichtigtes Dateiformat bei Erstallokierung | var(*LIST).F-ATTR.F-PREFORM | S | *BY-PUBSET-DEF | 1 |
Performance-Anforderung | var(*LIST).F-ATTR.IO-ATTR.PERF | S | *STD | 1 |
Typ der Dateizugriffe, für die die Performance-Anforderung *HIGH oder *VERY-HIGH gilt | var(*LIST).F-ATTR.IO-ATTR.USAGE | S | *READ-WRITE | 1 |
Kennzeichen bez. Arbeitsdateien | var(*LIST).F-ATTR.WORK-F | S | *NO | 1 |
GUARDS-Schutz für die Storage-Klasse (nur für privilegierte Benutzer) | var(*LIST).PROT-GUARD | S | *NONE | 1 |
Katalogkennung des Pubsets, für den die Storage-Klasse definiert ist | var(*LIST).PUBSET | S | <cat-id> | 1,2,3 |
Name der Storage-Klasse | var(*LIST).STOR-CLASS | S | <comp.-name 1..8> | 1,2,3 |
freier, vom Systemverwalter formulierter Text | var(*LIST).STOR-CLASS-INFO | S | " | 1 |
Name der dieser Storage-Klasse zugeordneten Volume-Set-Liste (nur für privilegierte Benutzer) | var(*LIST).VOL-SET-LIST | S | <comp.-name 1..8> | 1,3 |
Beispiel
/show-storage-class storage-class-name = stc1,
pubset = abcd,
information = *all
NAME: STC1 PUBSET: ABCD ---------------------- FILE-ATTRIBUTES ------------------------- PERFORMANCE: USAGE: DISK-WRITE: VERY-HIGH READ-WRITE IMMEDIATE AVAILABILITY: FILE-PREFORMAT: WORK-FILE: STANDARD BY-PUBSET-DEFAULT NO ------------------------- PROTECTION --------------------------- GUARD-NAME: $TSOS.STC.GUARD ------------------ ASSIGNED VOLUME-SET-LIST -------------------- VSL1 ---------------------- STORAGE-CLASS-INFO ---------------------- Zu dieser Storage-Klasse gehoert, zusaetzlich zu den durch Attribute darstellbaren Pubset-Service-Anforderungen, noch folgende Anforderung: Datei wird auf ein SSD-Volume-Set abgelegt.
Die Systembetreuung fordert mit dem Kommando SHOW-STORAGE-CLASS alle Informationen über die Storage-Klasse STC1, die für den SM-Pubset ABCD definiert wurde, an.