Storage-Klasse für SM-Pubset definieren
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Funktionsbeschreibung
Mit dem Kommando CREATE-STORAGE-CLASS kann die Systembetreuung eine neue Storage-Klasse für einen SM-Pubset definieren. Der SM-Pubset muss lokal importiert sein (exklusiv oder shared).
Für die neue Storage-Klasse wird im aktuellen Storage-Klassen-Katalog (Datei :<catid des sm-pubset>:$TSOS.SYSCAT.STORCLS) ein Eintrag erstellt. Die Storage-Klassen-Definition enthält eine Liste von Datei-Attributen. Ist ihr eine Volume-Set-Liste zugeordnet, enthält sie zusätzlich auch deren Namen.
Der Benutzer kann einer Datei im Kommando CREATE-FILE bzw. MODIFY-FILE-ATTRIBUTES eine Storage-Klasse zuordnen. Die Datei erhält damit implizit alle in der Storage-Klasse festgelegten Datei-Attribute. Ist der Storage-Klasse eine Volume-Set-Liste zugeordnet, wird die Datei nach Möglichkeit auf einem Volume-Set der Volume-Set-Liste abgelegt.
Mit dem Kommando SHOW-STORAGE-CLASS können die Eigenschaften einer Storage-Klasse abgefragt werden.
Eine Storage-Klasse kann mit dem Kommando MODIFY-STORAGE-CLASS geändert werden. Mit dem Kommando DELETE-STORAGE-CLASS kann ihr Eintrag aus dem Storage-Klassen-Katalog wieder entfernt werden.
Den aktuellen Storage-Klassen-Katalog kann die Systembetreuung mit dem Kommando CHANGE-STORAGE-CLASS-CATALOG wechseln bzw. im Fehlerfall nachladen.
Format
CREATE-STORAGE-CLASS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
STORAGE-CLASS-NAME = <composed-name 1..8>
Bezeichnet den Namen der neu einzurichtenden Storage-Klasse.
PUBSET = <cat-id 1..4>
Bezeichnet die Kennung des Pubsets, für den die Storage-Klasse eingerichtet wird. Der Pubset muss ein lokal importierter (exklusiv oder shared) SM-Pubset sein.
FILE-ATTRIBUTES = *STD / *PARAMETERS(...)
Bestimmt die Anforderungen an die Pubset-Verwaltung, die durch ein Datei-Attribut darstellbar sind. Diese Datei-Attribute gelten für alle Dateien, denen der Benutzer statt der expliziten Attribute die Storage-Klasse zuordnet (siehe Operand STORAGE-CLASS im Kommando CREATE-FILE bzw. MODIFY-FILE-ATTRIBUTES).
FILE-ATTRIBUTES = *STD
Für Dateien, denen diese Storage-Klasse zugeordnet ist, werden Standardanforderungen an die Pubset-Verwaltung gestellt. Diese entsprechen den jeweiligen Default-Werten in der Struktur FILE-ATTRIBUTES=*PARAMETERS(...).
FILE-ATTRIBUTES = *PARAMETERS(...)
Gibt an, welche Datei-Attribute für Dateien mit dieser Storage-Klasse vergeben werden.
IO-ATTRIBUTES = *STD / *PARAMETERS(...)
Gibt an, welche Performance-Anforderungen für Dateien in dieser Storage-Klasse gestellt werden.
IO-ATTRIBUTES = *STD
Es gelten die Default-Werte in der Struktur *PARAMETERS(...).
IO-ATTRIBUTES = *PARAMETERS(...)
Die Performance-Eigenschaften ergeben sich aus den Angaben zu den Operanden PERFORMANCE und USAGE.
PERFORMANCE = *STD / *HIGH / *VERY-HIGH
Gibt das Performance-Attribut für Dateien mit dieser Storage-Klasse an. Es bestimmt welche Priorität für die im Operanden USAGE bezeichneten Ein-/Ausgabe-Operationen gewünscht wird.
PERFORMANCE = *STD
Für Dateien mit dieser Storage-Klasse werden keine Performance-Anforderungen gestellt. Der Operand USAGE hat in diesem Fall keinen Einfluss auf die Dateibearbeitung.
PERFORMANCE = *HIGH
Dateien mit dieser Storage-Klasse sollen über einen Cache bearbeitet werden (hohe Performance-Priorität).
PERFORMANCE = *VERY-HIGH
Dateien mit dieser Storage-Klasse sollen über einen Cache bearbeitet werden. Falls möglich soll dabei die gesamte Datei permanent im Cache gehalten werden (höchste Perfomance-Priorität).
USAGE = *READ-WRITE / *WRITE / *READ
Gibt an, für welche Ein-/Ausgabe-Operationen die erhöhte Performance-Anforderung (Bearbeitung über einen Cache) gewünscht wird.
Default-Wert ist *READ-WRITE, d.h. die Anforderungen gelten für Lese- und Schreiboperationen.
Die Anforderung kann auch nur für Schreiboperationen (*WRITE) bzw. nur für Leseoperationen (*READ) gelten.
Besitzt die Datei kein besonderes Performance-Attribut (PERFORMANCE=*STD), hat der Operand USAGE keine Auswirkung auf die Bearbeitung.
DISK-WRITE = *STD / *IMMEDIATE / *BY-CLOSE
Gibt an, zu welchem Zeitpunkt nach einer Schreiboperation Datenkonsistenz für Dateien mit dieser Storage-Klasse gefordert wird.
DISK-WRITE = *STD
Der Default-Wert *STD entspricht für permanente Dateien dem Wert *IMMEDIATE, für temporäre Dateien dem Wert *BY-CLOSE.
DISK-WRITE = *IMMEDIATE
Die Daten einer Datei sollen sich direkt nach Beendigung einer Schreiboperation in konsistenten Zustand befinden, d.h., Dateien in dieser Storage-Klasse sollten nicht über einen flüchtigen Schreib-Cache bearbeitet werden.
DISK-WRITE = *BY-CLOSE
Die Daten einer Datei sollen sich erst nach der CLOSE-Verarbeitung in einem konsistenten Zustand befinden, d.h., Dateien mit dieser Storage-Klasse können über einen flüchtigen Schreib-Cache bearbeitet werden.
AVAILABILITY = *STD / *HIGH
Gibt an, welche Ausfallsicherheit für die Dateien mit dieser Storage-Klasse gefordert wird.
AVAILABILITY = *STD
Es werden keine besonderen Anforderungen bezüglich der Ausfallsicherheit gestellt.
AVAILABILITY = *HIGH
Für Dateien mit dieser Storage-Klasse wird erhöhte Ausfallsicherheit gefordert (z.B. Ablage auf gespiegelten Platten).
FILE-PREFORMAT = *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4
Bestimmt das beabsichtigte Dateiformat für Dateien mit dieser Storage-Klasse. Diese Angabe wirkt nur beim Erstellen des Katalogeintrags und dient zur automatischen Bestimmung des Ablageorts.
Solange eine Datei kein Erstellungsdatum besitzt (CRE-DATE=NONE), ist der Ablageort unverbindlich und kann sich bei der OPEN-Verarbeitung ändern.
FILE-PREFORMAT = *BY-PUBSET-DEFAULT
Es gilt der pubset-globale Standardwert.
FILE-PREFORMAT = *K
Die Dateien mit dieser Storage-Klasse sollen als K-Dateien angelegt werden.
FILE-PREFORMAT = *NK2
Die Dateien mit dieser Storage-Klasse sollen als NK2-Dateien angelegt werden.
FILE-PREFORMAT = *NK4
Die Dateien mit dieser Storage-Klasse sollen als NK4-Dateien angelegt werden.
WORK-FILE = *NO / *YES
Bestimmt, ob Dateien mit dieser Storage-Klasse Arbeitsdateien sind.
WORK-FILE = *NO
Dateien mit dieser Storage-Klasse werden als normale Dateien angelegt.
WORK-FILE = *YES
Dateien in dieser Storage-Klasse werden als Arbeitsdateien angelegt. Diese können von der Systembetreuung zu festgelegten Zeiten gelöscht werden.
STORAGE-CLASS-INFO = *NONE / <c-string 1..720 with-low>
Die Systembetreuung kann Eigenschaften der Storage-Klasse in einem Kurztext beschreiben. Dabei können z.B auch spezielle Anforderungen an die Pubset-Verwaltung beschrieben werden, die von der Systembetreuung definiert werden und nicht durch Datei-Attribute darstellbar sind. Dieser Kurztext wird dem Benutzer bei der Ausgabe des Kommandos SHOW-STORAGE-CLASS mit angezeigt und informiert ihn über spezielle Eigenschaften der Storage-Klasse.
STORAGE-CLASS-INFO = *NONE
Für die Storage-Klasse wird kein beschreibender Kurztext bereitgestellt.
STORAGE-CLASS-INFO = <c-string 1..720 with-low>
Beschreibt in einem Kurztext spezielle Eigenschaften der Storage-Klasse, die von der Systembetreuung für die Storage-Klasse definiert wurden.
PROTECTION = *NONE / *BY-GUARDS(...)
Gibt an, ob der Zugriff auf die Storage-Klasse über einen Guard geregelt wird.
PROTECTION = *NONE
Der Zugriff auf die Storage-Klasse ist nicht über einen Guard geregelt.
PROTECTION = *BY-GUARDS(...)
Die Zuweisung der Storage-Klasse an eine Datei und das Anzeigen ihrer Definitionen wird über einen Guard geregelt. Im nachfolgend genannten Guard sind Bedingungen definiert, unter denen ein Benutzer auf die Storage-Klasse zugreifen darf.
GUARD-NAME = <filename 1..18 without-cat-gen-vers>
Name des Guards.
VOLUME-SET-LIST = *NONE / <composed-name 1..8>
Gibt an, ob der Storage-Klasse eine Volume-Set-Liste zugeordnet werden soll. Default-Wert ist *NONE, d.h., der Storage-Klasse wird noch keine Volume-Set-Liste zugeordnet.
VOLUME-SET-LIST = <composed-name 1..8>
Der Storage-Klasse wird die angegebene Volume-Set-Liste zugeordnet. Die Volume-Set-Liste muss für diesen SM-Pubset bereits existieren.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kein Fehler | |
1 | CMD0202 | Syntaxfehler im Kommando | |
32 | CMD0221 | Interner Systemfehler | |
64 | CMD0216 | Keine Berechtigung für das Kommando | |
64 | DMS1488 | Storage-Klasse bereits definiert | |
64 | DMS1497 | Ungültige Datei-Attribut-Kombination | |
64 | DMS148B | Volume-Set-Liste nicht definiert | |
64 | DMS1485 | Pubset nicht bekannt | |
64 | DMS1486 | Pubset ist kein System-Managed-Pubset | |
64 | DMS1487 | Pubset nicht verfügbar | |
64 | DMS1490 | Storage-Klassen-Management für diesen Pubset nicht verfügbar | |
64 | DMS1483 | Storage-Klassen-Katalog ungültig | |
64 | DMS1481 | Fehler beim Zugriff auf den Storage-Klassen-Katalog | |
64 | DMS1484 | Volume-Set-Listen-Katalog ungültig | |
64 | DMS1482 | Fehler beim Zugriff auf den Volume-Set-Listen-Katalog | |
129 | DMS148D | Klasse-4/5-Speicher-Mangel | |
129 | DMS148E | Fehler bei MSCF-Verbindung zum Master | |
129 | DMS148F | Subsystem GCF nicht bereit |