Definition einer Storage-Klasse ändern
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Funktionsbeschreibung
Mit dem Kommando MODIFY-STORAGE-CLASS kann die Systembetreuung die Definition einer bereits bestehenden Storage-Klasse ändern. Der SM-Pubset, für den die Storage-Klasse definiert ist, muss lokal importiert sein (exklusiv oder shared).
Alle Datei-Attribute, die für die Storage-Klasse geändert werden, gelten zunächst für Dateien, die mit dieser Storage-Klasse neu eingerichtet werden. Eine bereits bestehende Datei mit dieser Storage-Klasse erhält die geänderten Datei-Attribute erst, wenn der Datei mit dem Kommando MODIFY-FILE-ATTRIBUTES unter Angabe von STORAGE-CLASS= *UPDATE die Datei-Attribute der Storage-Klasse erneut zugewiesen werden.
Format
MODIFY-STORAGE-CLASS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
STORAGE-CLASS-NAME = <composed-name 1..8>
Name der Storage-Klasse, deren Definition geändert werden soll.
PUBSET = <cat-id 1..4>
Kennung des Pubsets, für den die Storage-Klasse eingerichtet wurde. Der Pubset muss lokal importiert sein (exklusiv oder shared).
FILE-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
Bestimmt, welche Anforderungen an die Pubset-Verwaltung, die durch ein Datei-Attribut darstellbar sind, geändert werden sollen. Diese Datei-Attribute gelten für alle neuen Dateien, denen der Benutzer statt der expliziten Attribute die Storage-Klasse zuordnet (siehe Operand STORAGE-CLASS im Kommando CREATE-FILE bzw. MODIFY-FILE-ATTRIBUTES).
Für eine bereits bestehende Datei werden die Datei-Attribute erst geändert, wenn der Datei mit dem Kommando MODIFY-FILE-ATTRIBUTES unter Angabe von STORAGE-CLASS= *UPDATE die Datei-Attribute der Storage-Klasse erneut zugewiesen werden.
Der Default-Wert *UNCHANGED bedeutet, dass die bisherige Vereinbarung für das jeweilige Datei-Attribut bestehen bleibt.
FILE-ATTRIBUTES = *PARAMETERS(...)
Gibt an, welche Datei-Attribute für Dateien mit dieser Storage-Klasse geändert werden.
IO-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
Gibt an, welche Performance-Anforderungen für Dateien mit dieser Storage-Klasse geändert werden.
Der Default-Wert *UNCHANGED bedeutet, dass die bisherige Vereinbarung für das jeweilige Datei-Attribut bestehen bleibt.
IO-ATTRIBUTES = *PARAMETERS(...)
Die Performance-Eigenschaften ergeben sich aus den Angaben zu den Operanden PERFORMANCE und USAGE.
PERFORMANCE = *UNCHANGED / *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 = *UNCHANGED / *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 = *UNCHANGED / *STD / *IMMEDIATE / *BY-CLOSE
Gibt an, zu welchem Zeitpunkt nach einer Schreiboperation Datenkonsistenz für Dateien mit der Storage-Klasse gefordert werden.
DISK-WRITE = *STD
Der Operandenwert *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 mit 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 = *UNCHANGED / *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 = *UNCHANGED / *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 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 = *UNCHANGED / *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 mit dieser Storage-Klasse werden als Arbeitsdateien angelegt. Diese können von der Systembetreuung zu festgelegten Zeiten gelöscht werden.
STORAGE-CLASS-INFO = *UNCHANGED / *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 speziellen Eigenschaften der Storage-Klasse.
STORAGE-CLASS-INFO = *NONE
Für die Storage-Klasse wird kein beschreibender Kurztext bereitgestellt. Ein bereits existierender Kurztext wird gelöscht.
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. Ein bereits existierender Kurztext wird überschrieben.
PROTECTION = *UNCHANGED / *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 wird nicht über einen Guard geregelt. Ein bereits bestehender GUARDS-Schutz wird dadurch aufgehoben.
PROTECTION = *BY-GUARDS(...)
Die Zuweisung der Storage-Klasse 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 = *UNCHANGED / *NONE / <composed-name 1..8>
Gibt an, ob der Storage-Klasse eine Volume-Set-Liste zugeordnet werden soll.
VOLUME-SET-LIST = *NONE
Der Storage-Klasse wird keine Volume-Set-Liste zugeordnet. Eine bereits existierende Zuordnung wird aufgehoben.
VOLUME-SET-LIST = <composed-name 1..8>
Der Storage-Klasse wird die angegebene Volume-Set-Liste zugeordnet. Eine bereits existierende Zuordnung wird dadurch aufgehoben.
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 | DMS148A | Storage-Klasse nicht 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 |