Net-Storage-Volume einem lokalen Pubset entziehen
Komponente: | BS2000 |
Funktionsbereich: | Net-Storage administrieren |
Anwendungsbereich: | STORAGE-MANAGEMENT |
Privilegierung: | TSOS |
Funktionsbeschreibung
Das Kommando REMOVE-NET-STORAGE-VOLUME entzieht einem lokalen Pubset ein Net-Storage-Volume.
Im Standardfall wird das Kommando nur ausgeführt, wenn das entsprechende Verzeichnis auf dem Net-Storage keine BS2000-Dateien (mehr) enthält.
Dabei werden folgende Aktionen ausgeführt:
In dem Verzeichnis werden die Verwaltungsdateien (Katalog- und FSL-Datei) gelöscht.
Anschließend wird das Verzeichnis gelöscht.
Optional kann das Kommando auch ausgeführt werden, wenn das Verzeichnis noch katalogisierte BS2000-Dateien enthält. Die Angabe im Operanden FILES-ON-VOLUME bestimmt dabei die Vorgehensweise für die BS2000-Dateien:
*EXPORT:
Die BS2000-Dateien werden exportiert (wie mit dem Kommando EXPORT-FILE). Das Verzeichnis und die Dateien auf dem Net-Storage bleiben unverändert bestehen und können ggf. wieder als Net-Storage-Volume einem Pubset hinzugefügt werden.*DELETE:
Wenn keine Inkonsistenzen bestehen, dann werden die vorhandenen BS2000-Dateien, die Verwaltungsdaten und das Verzeichnis gelöscht. Wenn Inkonsistenzen bestehen, dann kann die Kommandoausführung mit dem Operanden FORCE=*YES erzwungen werden.
Informationen über den in BS2000 verfügbaren Net-Storage können mit dem Kommando SHOW-NET-STORAGE angefordert werden. Informationen über den einem Pubset zugeordneten Net-Storage können mit dem Kommando SHOW-PUBSET-NET-STORAGE angefordert werden.
Grundlegende Informationen zum Einsatz von Net-Storage in BS2000 finden Sie im Handbuch „Einführung in die Systembetreuung“ [14]. Das Arbeiten mit Dateien auf Net-Storage ist im Handbuch „DVS Einführung“ [13] beschrieben.
Format
REMOVE-NET-STORAGE-VOLUME | ||||||||||||||||||||
| ||||||||||||||||||||
Operandenbeschreibung
VOLUME =
Gibt die VSN des Net-Storage-Volumes an.
Auf dem Net-Storage wird das Net-Storage-Volume durch ein Verzeichnis mit dem der VSN entsprechenden Namen unterhalb des freigegebenen Verzeichnisses realisiert.
VOLUME = *STD
Die VSN des Net-Storage-Volumes wurde aus dem Namen des Pubsets abgeleitet, siehe Handbuch „Einführung in die Systembetreuung“ [14]. Für ein Net-Storage-Volume mit Nicht-Standardnamen muss die VSN explizit angegeben werden.
VOLUME = <vsn 6..6>
Gibt explizit die VSN des Net-Storage-Volumes an. Ein Standardname kann nicht explizit angegeben werden.
Die VSN muss aus 6 Zeichen bestehen und den Konventionen für private Datenträger entsprechen. Sie darf also nicht mit der Zeichenfolge PUB beginnen und keinen Punkt enthalten, siehe Handbuch „Einführung in die Systembetreuung“ [14].
PUBSET = <cat-id 1..4>
Gibt den Namen des Pubsets an, dem das Net-Storage-Volume entzogen werden soll.
FILES-ON-VOLUME =
Bestimmt, wie verfahren werden soll, wenn das Net-Storage-Volume noch katalogisierte BS2000-Dateien enthält.
FILES-ON-VOLUME = *REJECT
Das Kommando wird nur ausgeführt, wenn das Net-Storage-Volume keine katalogisierten BS2000-Dateien enthält.
FILES-ON-VOLUME = *EXPORT
Die Katalogeinträge der Dateien werden nur im lokalen Pubset gelöscht (analog dem Kommando EXPORT-FILE). Das Verzeichnis und die Dateien auf dem Net-Storage bleiben bestehen.
FILES-ON-VOLUME = *DELETE(...)
Die BS2000-Dateien auf dem Net-Storage-Volume werden gelöscht. Anschließend wird auch das entsprechende Verzeichnis auf dem Net-Server gelöscht.
Im Standardfall (FORCE=*NO) wird das Löschen nur dann ausgeführt, wenn keine Inkonsistenzen zwischen dem Katalogeintrag im lokalen Pubset und dem Katalogeintrag auf dem Net-Storage-Volume festgestellt werden. Anderenfalls wird das Kommando abgewiesen.
FORCE = *NO / *YES
Gibt an, ob die Dateien auch gelöscht werden sollen, wenn Inkonsistenzen bestehen. Mit der Voreinstellung *NO wird das Kommando in diesem Fall zurückgewiesen. Bei FORCE = *YES werden die Dateien in jedem Fall gelöscht, Inkonsistenzen werden ignoriert. Es werden auch Dateien, die nicht im BS2000 katalogisiert sind (UNIX-Dateien) gelöscht.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung / garantierte Meldungen |
|---|---|---|---|
0 | CMD0001 | Kommando fehlerfrei ausgeführt | |
32 | CMD0221 | Systemfehler | |
32 | DMS1CFF | Systemfehler (siehe SERSLOG-Eintrag) | |
64 | DMS1C04 | Fehler beim Aufruf des Subsystems ONETSTOR | |
64 | DMS1C05 | Katalogkennung existiert nicht | |
64 | DMS1C06 | Pubset nicht importiert | |
64 | DMS1C07 | Fehler beim Aufruf der Allokierungsfunktion | |
64 | DMS1C08 | Fehler beim Aufruf einer CMS-Funktion für den TSOSCAT | |
64 | DMS1C09 | Fehler beim Aufruf einer CMS-Funktion auf dem Net-Storage-Volume | |
64 | DMS1C0C | Net-Storage-Volume ist nicht leer | |
64 | DMS1C0D | File System Label am Net-Server passt nicht zu Pubset | |
64 | DMS1C0E | Dateikatalog auf dem Net-Storage-Volume ist nicht leer | |
64 | DMS1C10 | Das Net-Storage-Volume hat gesperrte Dateien | |
64 | DMS1C12 | Auf dem Home-Pubset kann kein Net-Storage-Volume angelegt werden. | |
64 | DMS1C13 | Fehler beim Aufruf einer Mehrrechnerfunktion | |
64 | DMS1C14 | Fehler beim Aufruf des Watchdog | |
64 | DMS1C15 | Fehler bei der Allokierung am Slave-Rechner | |
64 | DMS1C18 | Net-Storage-Volume nicht zugreifbar | |
64 | DMS1C20 | Name des Net-Storage-Volumes ist ungültig |