Remove a Net-Storage volume from a local pubset
Component: | BS2000 |
Functional area: | Net-Storage administration |
Domain: | STORAGE-MANAGEMENT |
Privileges: | TSOS |
Function
The REMOVE-NET-STORAGE-VOLUME removes a Net-Storage volume from a local pubset.
By default, the command is executed only if the directory concerned on the Net-Storage contains no (more) BS2000 files.
The following actions are performed here:
The management files (catalog and FSL files) in the directory are deleted.
Then the directory is deleted.
Optionally the command can also be executed if the directory still contains cataloged BS2000 files. The specification in the FILES-ON-VOLUME operand determines the procedure for the BS2000 files:
*EXPORT:
The BS2000 files are exported (as with the EXPORT-FILE command). The directory and the files on the Net-Storage remain unchanged and can, if required, once again be added to a pubset as a Net-Storage volume.*DELETE:
If there are no inconsistencies, the existing BS2000 files, the management data and the directory are deleted. If there are inconsistencies, command execution can be forced with the FORCE=*YES operand.
Information on the Net-Storage available in BS2000 can be requested using the SHOW-NET-STORAGE command. Information on the Net-Storage assigned to a pubset can be requested using the SHOW-PUBSET-NET-STORAGE command.
Fundamental information on the use of Net-Storage in BS2000 is provided in the “Introduction to System Administration” [14]. How to work with files on Net-Storage is described in the “Introductory Guide to DMS” [13].
Format
REMOVE-NET-STORAGE-VOLUME | ||||||||||||||||||||
| ||||||||||||||||||||
Operands
VOLUME =
Specifies the VSN of the Net-Storage volume.
On the Net-Storage the Net-Storage volume is implemented by a directory below the released directory with a name which corresponds to the VSN.
VOLUME = *STD
The VSN of the new Net-Storage volume was derived from the name of the pubset, see the “Introduction to System Administration” [14]. The VSN must be specified explicitly for a Net-Storage volume with a nonstandard name.
VOLUME = <vsn 6..6>
Specifies the VSN of the Net-Storage volume explicitly. A default name cannot be specified explicitly. The VSN must consist of 6 characters and comply with the conventions for private volumes Consequently it may not begin with the string PUB and may not contain a period, see the “Introduction to System Administration” [14].
PUBSET = <cat-id 1..4>
Specifies the name of the pubset from which the Net-Storage volume is to be removed.
FILES-ON-VOLUME =
Determines the procedure when the Net-Storage volume still contains cataloged BS2000 files.
FILES-ON-VOLUME = *REJECT
The command is executed only when the Net-Storage volume contains no cataloged BS2000 files.
FILES-ON-VOLUME = *EXPORT
The files’ catalog entries are deleted only in the local pubset (as with the EXPORT-FILE command). The directory and the file on the Net-Storage are retained.
FILES-ON-VOLUME = *DELETE(...)
The BS2000 files on the Net-Storage volume are deleted. Subsequently, the directory concerned on the Net-Server is also deleted.
By default, (FORCE=*NO) deletion takes place only when no inconsistencies are determined between the catalog entry on the local pubset and the catalog entry on the Net-Storage volume. Otherwise, the command will be rejected.
FORCE = *NO / *YES
Specifies whether the files should also be deleted if inconsistencies exist. The default *NO causes the command to be rejected in this case. When FORCE = *YES, the files are always deleted and inconsistencies are ignored. Files which are not cataloged in BS2000 (UNIX files) are also deleted.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
32 | CMD0221 | System error | |
32 | DMS1CFF | System error (see SERSLOG entry) | |
64 | DMS1C04 | Error when calling the ONETSTOR subsystem | |
64 | DMS1C05 | Catalog ID does not exist | |
64 | DMS1C06 | Pubset not imported | |
64 | DMS1C07 | Error when calling the allocation function | |
64 | DMS1C08 | Error when calling a CMS function for the TSOSCAT | |
64 | DMS1C09 | Error when calling a CMS function on the Net-Storage volume | |
64 | DMS1C0C | Net-Storage volume is not empty | |
64 | DMS1C0D | File system label on the net server does not match the pubset | |
64 | DMS1C0E | File catalog on the Net-Storage volume is not empty | |
64 | DMS1C10 | The Net-Storage volume contains locked files | |
64 | DMS1C12 | No Net-Storage volume can be created on the home pubset | |
64 | DMS1C13 | Error when calling the multiprocessor system function | |
64 | DMS1C14 | Error when calling the watchdog | |
64 | DMS1C15 | Error when allocating on the slave system | |
64 | DMS1C18 | Net-Storage volume cannot be accessed | |
64 | DMS1C20 | Name of the Net-Storage volume is invalid |