Eintrag im MRSCAT des Home-Pubsets ändern
Komponente: | BS2000 |
Funktionsbereich: | Pubset- und MRSCAT-Verwaltung |
Anwendungsbereich: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privilegierung: | TSOS |
Berechtigungsschlüssel: | $ |
Funktionsbeschreibung
Die mit dem Kommando ADD-MASTER-CATALOG-ENTRY voreingestellten Werte für einen Katalogeintrag im MRSCAT des Home-Pubsets lassen sich über dieses Kommando ändern, sowohl für Single-Feature-Pubsets (SF-Pubsets) als auch System-Managed-Pubsets (SM-Pubsets).
Zu beachten ist, dass über dieses Kommando weder der Pubset-Typ noch ein Volume-Set-Eintrag verändert werden kann. Durchgeführte Änderungen werden erst nach dem nächsten Importieren des Pubsets (Kommando IMPORT-PUBSET) wirksam.
Die Verfügbarkeit des Kataloges kann durch das Kommando IMPORT-PUBSET beeinflusst werden.
Der Default-Wert *UNCHANGED in den entsprechenden Operanden bedeutet jeweils, dass die bisherige Vereinbarung weiterhin gilt.
Format
MODIFY-MASTER-CATALOG-ENTRY | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
ENTRY-NAME = <cat-id 1..4>
Kennung des Pubsets, dessen MRSCAT-Eintrag geändert werden soll.
PUBSET-TYPE = *BY-PUBSET / *SINGLE-FEATURE(...) / *SYSTEM-MANAGED(...)
Bestimmt den Pubset-Typ, dessen MRSCAT-Eintrag geändert werden soll. Der Pubset-Typ selbst kann nicht geändert werden. Nur bei expliziter Angabe des Pubset-Typs können die für diesen Typ spezifischen Eigenschaften geändert werden.
PUBSET-TYPE = *BY-PUBSET
Der Pubset-Typ wird dem MRSCAT-Eintrag entnommen.
PUBSET-TYPE = *SINGLE-FEATURE(...)
Der Pubset, dessen MRSCAT-Eintrag geändert werden soll, ist ein SF-Pubset.
START-SPEEDCAT = *UNCHANGED / *NO / *SPEEDCAT-TASK / *OWN-TASK
Legt fest, ob SCA beim Importieren dieses Pubsets gestartet werden soll.
START-SPEEDCAT = *NO
SCA soll beim Importieren dieses Pubsets nicht gestartet werden.
START-SPEEDCAT = *SPEEDCAT-TASK
SCA soll zur Verfügung stehen und unter einer eigenen Task, der SPEEDCAT-Task, ablaufen.
START-SPEEDCAT = *OWN-TASK
SCA soll zur Verfügung stehen und unter der Task des Benutzers ablaufen.
PHYSICAL-ALLOCATION = *UNCHANGED / *ADMINISTRATOR-ONLY / *USER-ALLOWED
Vereinbart, ob die Benutzer Direktallokierungen auf einzelne Datenträger des Pubsets durchführen dürfen.
PHYSICAL-ALLOCATION = *ADMINISTRATOR-ONLY
Die Benutzer dürfen keine Datenträger des Pubsets direkt allokieren.
Dieses Recht bleibt dem privilegierten Aufrufer unter TSOS vorbehalten.
PHYSICAL-ALLOCATION = *USER-ALLOWED
Auf diesem Pubset soll die Allokierung einzelner Datenträger auch für die nichtprivilegierten Benutzer zulässig sein.
NEXT-CATALOG-EXPORT = *UNCHANGED / *NO-CONVERSION / *V10-COMPATIBLE
Dieser Operand existiert nur noch aus Kompatibilitätsgründen.
ALLOCATION = *UNCHANGED / *PARAMETERS(...)
Vereinbart, ob spezifische Allokierungs-Parameter für die Dateibearbeitung auf diesem Pubset eingestellt werden sollen.
ALLOCATION = *PARAMETERS(...)
Vereinbart die nachfolgenden Allokierungs-Parameter für den Pubset.
SATURATION-LEVEL4 = *UNCHANGED / *STD / <integer 66..2147483647 2Kbyte >
Der Allokierungs-Parameter für die Speicherplatz-Sättigungsstufe 4 soll eingestellt werden. Wurden bereits mit dem Kommando MODIFY-SPACE-SATURATION-LEVELS Sättigungsstufen festgelegt, sollte die Änderung nicht mit MODIFY-MASTER-CATALOG-ENTRY erfolgen, da in diesem Fall keine Überprüfung der Sättigungsstufen erfolgt.
SATURATION-LEVEL4 = *STD
Es soll der im Systemparameter L4SPDEF festgelegte Wert gelten.
SATURATION-LEVEL4 = <integer 66..2147483647 2Kbyte >
Wert für die Speicherplatz-Sättigungsstufe 4, der für diesen Pubset gelten soll.
PRIMARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..16777215 2Kbyte >
Der Allokierungs-Parameter für die Primärzuweisung bei Speicherplatzanforderung (Dateibearbeitung) soll eingestellt werden.
PRIMARY-ALLOCATION = *STD
Es soll der im Systemparameter DMPRALL festgelegte Wert gelten.
PRIMARY-ALLOCATION = <integer 1..16777215 2Kbyte >
Wert für die Primärzuweisung von Speicherplatz bei Dateibearbeitung, der für diesen Pubset gelten soll. Dieser Wert gilt als Standardwert für jeden Benutzer, der bei einer Speicherplatzanforderung keinen Wert für die Anfangszuweisung spezifiziert.
SECONDARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte >
Der Allokierungs-Parameter für die Sekundärzuweisung bei Speicherplatzanforderung (Dateibearbeitung) soll eingestellt werden.
SECONDARY-ALLOCATION = *STD
Es soll der im Systemparameter DMSCALL festgelegte Wert gelten.
SECONDARY-ALLOCATION = <integer 1..32767 2Kbyte >
Wert für die Sekundärzuweisung von Speicherplatz bei Dateibearbeitung, der für diesen Pubset gelten soll. Dieser Wert gilt als Standardwert für jeden Benutzer, der bei einer Speicherplatzanforderung keinen Wert für eine weitere Zuweisung spezifiziert.
MAXIMAL-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte >
Der Allokierungs-Parameter für die Verdopplung der Sekundärzuweisung bei Speicherplatzanforderung (Dateibearbeitung) soll eingestellt werden.
MAXIMAL-ALLOCATION = *STD
Es soll der im Systemparameter DMMAXSC festgelegte Wert gelten.
MAXIMAL-ALLOCATION = <integer 1..32767 2Kbyte >
Für diesen Pubset festgelegter Wert für die Verdopplung der Sekundärzuweisung von Speicherplatz bei der Dateibearbeitung. Dieser Wert gilt als Maximalwert für jeden Benutzer, dessen Speicherplatzbedarf auch nach Sekundärzuweisung nicht ausreicht. Der Wert für die Sekundärzuweisung wird solange verdoppelt, bis der hier angegebene Maximalwert erreicht ist.
PUBSET-TYPE = *SYSTEM-MANAGED(...)
Der Pubset, dessen MRSCAT-Eintrag geändert werden soll, ist ein SM-Pubset.
CONTROL-VOLUME-SET = *UNCHANGED / <cat-id 1..4>
Gibt an, welches Volume-Set beim Importieren des SM-Pubsets als Control-Volume-Set verwendet werden soll.
CONTROL-VOLUME-SET = <cat-id 1..4>
Bezeichnet die Kennung des Volume-Sets, der als Control-Volume-Set beim Importieren des SM-Pubsets verwendet werden soll. Der angegebene Volume-Set muss auch in der Konfigurationsdatei des SM-Pubsets als Control-Volume-Set eingetragen sein.
PARTNER-NAME = *UNCHANGED / <alphanum-name 1..8>
BCAM-Name des Rechners für Fern-Datei-Zugriff (RFA).
Ein Rechner darf nur angegeben werden, wenn keine MSCF-Verbindung besteht, Fern-Datei-Zugriff aber gewünscht ist.
ACCESS-FAILURE = *UNCHANGED / *HOLD-JOBS / *CANCEL-JOBS
Nur für einen Shared-Pubset:
Legt das Verhalten fest, wenn die MSCF-Verbindung zum Master eines importierten Shared-Pubsets verloren geht.
ACCESS-FAILURE = *HOLD-JOBS
Der Pubset wird für die Dauer der Verbindungsunterbrechung in den Zustand LOCAL-IMPORTED, QUIET versetzt. Tasks, die auf den Pubset zugreifen, geraten in einen Wartezustand, dessen Dauer durch den Parameter BATCH-WAIT-TIME oder DIALOG-WAIT-TIME festgelegt wird (siehe unten).
ACCESS-FAILURE = *CANCEL-JOBS
Der Pubset wird wird für die Dauer der Verbindungsunterbrechung in den Zustand INACC versetzt. Zugriffsversuche auf den Pubset werden sofort abgewiesen - auf Programmebene mit einem entsprechenden Returncode, auf Kommandoebene durch Auslösen von Spin-Off.
RESIDENT-BUFFERS = *UNCHANGED / *NO / *YES
Vereinbart, ob residente oder nicht-residente Puffer angelegt werden sollen. Bitte beachten Sie die mögliche Wechselwirkung mit dem Operanden NUMBER-OF-BUFFERS (siehe dort).
RESIDENT-BUFFERS = *NO
Es werden nicht-residente Puffer angelegt.
RESIDENT-BUFFERS = *YES
Es werden residente Puffer angelegt.
NUMBER-OF-BUFFERS = *UNCHANGED / <integer 1..255>
Legt die Anzahl der Puffer fest.
ADD-MASTER-CATALOG-ENTRY RESIDENT-BUFFERS=*SYSTEM-STD, NUMBER-OF-BUFFERS=*SYSTEM-STD), und im Kommando MODIFY-MASTER-CATALOG-ENTRY wird nur einer der beiden Operanden geändert, so erhält der andere Operand trotz Voreinstellung *UNCHANGED einen Standardwert: RESIDENT-BUFFERS=*NO, NUMBER-OF-BUFFERS=32 .Die Puffervereinbarung wird erst beim Importieren des Pubsets nach folgender Hierarchie ausgewertet:
Explizite Parameterangabe im Kommando IMPORT-PUBSET
Angaben über das Kommando ADD- bzw. MODIFY-MASTER-CATALOG-ENTRY.
Vereinbarungen laut Systemparameter CATBUFR und BMTNUM.
- Falls der so ermittelte Wert für NUMBER-OF-BUFFERS kleiner als 32 ist, wird der Wert auf 32 erhöht.
BATCH-WAIT-TIME = *UNCHANGED / <integer 0..2147483647 seconds >
Nur für einen Shared-Pubset:
Wartezeit in Sekunden, die Batchaufträge auf die Verfügbarkeit des wegen unterbrochener Verbindung nicht zugreifbaren Pubsets warten sollen.
Bei Überschreitung dieser Zeitspanne bricht die Kommandobearbeitung mit Fehlercode ab und löst Spin-Off aus.
DIALOG-WAIT-TIME = *UNCHANGED / <integer 0..2147483647 seconds >
Nur für einen Shared-Pubset:
Vereinbart analog zu Batchaufträgen die Wartezeitspanne bei Dialogzugriffen auf Pubsets im QUIET-Zustand. Bei Überschreitung der Zeitspanne erhält der Dialogauftrag eine Meldung und wird fortgesetzt. Der Default-Wert ist hier 30 Sekunden.
SHARED-PUBSET = *UNCHANGED / *NO / *YES
Legt die rechnerlokale Mehrbenutzbarkeit des Pubsets fest.
ACCESS-CONTROLLED = *UNCHANGED / *NO / *YES(...)
Legt fest, ob der Zugriff auf den Pubset auf eine Benutzerkennung beschränkt sein soll.
ACCESS-CONTROLLED = *NO
Der Zugriff auf den Pubset soll keiner Beschränkung unterliegen.
ACCESS-CONTROLLED = *YES(...)
Der Zugriff auf den Pubset soll auf eine Benutzerkennung beschränkt sein. Das Kommando IMPORT-PUBSET wird für einen als ACCESS-CONTROLLED=*YES gekennzeichneten Shared-Pubset mit Fehler abgewiesen.
USER-IDENTIFICATION = *UNCHANGED / <alphanum-name 1..8> / TSOS
Vereinbart die Benutzerkennung, die Zugriff auf den Pubset haben soll.
USER-IDENTIFICATION = <alphanum-name 1..8>
Angabe einer Benutzerkennung, die zusätzlich zur Benutzerkennung TSOS Zugriff auf den Pubset haben soll.
EAM = *UNCHANGED / *PARAMETERS(...)
Vereinbart die für diesen Pubset spezifischen Parameter für die SYSEAM-Datei.
EAM = *PARAMETERS(...)
Vereinbart die nachfolgenden SYSEAM-Parameter für den Pubset.
MAXIMAL-SIZE = *UNCHANGED / *STD / <integer 12..193536 2Kbyte >
Der Operand ist nur aus Kompatibilitätsgründen vorhanden und wird nicht mehr ausgewertet.
MINIMAL-SIZE = *UNCHANGED / *STD / <integer 12..193536 2Kbyte >
Legt die minimale Größe der SYSEAM-Dateien (Anzahl an Halbseiten) fest, die diese auf dem angegebenen Pubset annehmen müssen.
MINIMAL-SIZE = *STD
Es soll der im Systemparameter EAMMIN festgelegte Wert gelten.
MINIMAL-SIZE = <integer 12..193536>
Minimale Größe der SYSEAM-Dateien (Anzahl Halbseiten) auf diesem Pubset.
SECONDARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..193536 2Kbyte >
Legt die Sekundärzuweisung für SYSEAM-Dateien auf diesem Pubset fest.
SECONDARY-ALLOCATION = *STD
Es soll der im Systemparameter EAMSEC festgelegte Wert gelten.
SECONDARY-ALLOCATION = <integer 1..193536 2Kbyte >
Wert für die Sekundärzuweisung für SYSEAM-Dateien (Anzahl Halbseiten). Der Wert sollte ein Vielfaches von 24 betragen.
VIRTUAL-MEMORY = *UNCHANGED / *STD / <integer 0..8192 2Kbyte >
Legt die Anzahl der Halbseiten zur Bemessung der Größe des EAM-Cache-Bereiches im Klasse-4-Speicher fest.
Ein Cache-Bereich kann nur für die SYSEAM-Datei des Home-Pubsets angelegt werden. Für alle anderen Pubsets hat der Parameter keine Wirkung.
VIRTUAL-MEMORY = *STD
Die Größe des EAM-Cache-Bereiches wird aus dem Wert des Systemparameters EAMMEM errechnet.
VIRTUAL-MEMORY = <integer 0..8192 2Kbyte >
Die hier angegebene Anzahl Halbseiten bestimmt die Größe des EAM-Cache-Bereiches.
REMOTE-IMPORT = *UNCHANGED / *BY-CONNECTION / *BY-COMMAND-ONLY
Legt fest, auf welche Art der Remote-Import-Status geändert werden kann.
REMOTE-IMPORT = *BY-CONNECTION
Die Änderung erfolgt mit dem Verbindungsaufbau.
REMOTE-IMPORT = *BY-COMMAND-ONLY
Änderungen des Remote-Import-Status sind nur über Kommando möglich.
XCS-CONFIGURATION = *UNCHANGED / *NO / *YES
Nur für einen Shared-Pubset:
Legt fest, ob der Pubset beim Aufbau eines neuen XCS-Verbundes automatisch als XCS-Pubset importiert werden soll.
XCS-CONFIGURATION = *NO
Der Pubset soll nicht automatisch als XCS-Pubset importiert werden (Die Verwendung als XCS-Pubset ist dennoch möglich, z.B. mit dem Kommando SET-XCS-PUBSET).
XCS-CONFIGURATION = *YES
Bei Aufbau eines neuen XCS-Verbundes soll das Subsystem MSCF den Pubset automatisch als XCS-Pubset importieren.
PUBRES-UNIT = *UNCHANGED / <alphanum-name 2..2> / <x-text 4..4>
Mnemotechnischer Gerätecode (MN) der Pubres des SF-Pubsets bzw. der Volres des SM-Pubsets. Diesen Eintrag benötigt VM2000, wenn der Pubset über seine Katalogkennung angegeben wird.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando ohne Fehler ausgeführt | |
2 | 0 | CMS0002 | Plattenfehler |
1 | CMS0011 | Syntaxfehler | |
1 | CMS0314 | Syntaxfehler im Entry-Namen oder Fehler bei Wildcard-Angabe | |
32 | CMD0221 | Interner Systemfehler | |
32 | CMS031F | MRSCAT-Parameterfehler | |
32 | CMS0310 | Fehler bei Privilegienprüfung | |
32 | CMS0317 | MRSCAT ist gesperrt | |
32 | CMS0318 | Synchronisierungs-Fehler | |
64 | CMS0010 | Keine Berechtigung für Kommando | |
64 | CMS0312 | MRSCAT-Eintrag nicht gefunden | |
64 | CMS0319 | Pubset-Typ-Konflikt |
Hinweis
Zur Behandlung der Pufferangaben siehe auch Hinweise zum Kommando IMPORT-PUBSET.
Beispiel
Lokales Ändern von Katalogeinträgen und Importieren von Pubsets (MPVS)
A, BAD und DAT sind Pubsets, auf die über einen Rechner lokal zugegriffen werden soll. A ist der Home-Pubset.
Folgende Kommandos müssen abgesetzt werden:
|
|
|
|
|
|
|
|
Das Katalogverzeichnis MRSCAT im Home-Pubset hat folgenden Inhalt:
PUBSET A:LOCAL-HOME PUBSET BAD:LOCAL-IMPORTED,SHARED,MASTER-HOST=OWN-HOST PUBSET DAT:LOCAL-IMPORTED