Create Net-Storage volume and assign it to a local pubset
Component: | BS2000 OS DX |
Functional area: | Net-Storage administration |
Domain: | STORAGE-MANAGEMENT |
Privileges: | TSOS |
Function
The ADD-NET-STORAGE-VOLUME command creates a directory with management files (catalog and FSL files) in the released file system of the net server and establishes the unambiguous assignment of the directory to precisely one local SF or SM pubset in the form of a Net-Storage volume. The pubset must already have been imported. No Net-Storage volume can be assigned to the home pubset.
From the viewpoint of BS2000 a Net-Storage volume is a new disk which is assigned to the pubset but which is not (as in the case of a pubset expansion) added to the pubset. The VSN of the Net-Storage volume is the same as the directory name in the Net-Storage and by default is derived from the name of the pubset, see the “Introduction to System Administration” [14]. Only if the pubset has already been assigned a Net-Storage volume with a default name must a VSN which complies with the conventions for private volumes be specified.
The IMPORT operand enables a directory which already exists on the net server to be assigned to the specified pubset as a Net-Storage volume. Renaming (VSN or directory name) is also possible.
Information on the Net-Storage available in BS2000 can be requested using the SHOW-NET-STORAGE command. Information on the Net-Storage available in the 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
ADD-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 is derived from the name of the pubset, see the “Introduction to System Administration” [14]. If the pubset has already been assigned a Net-Storage volume with a default name, this specification is not possible and the VSN must be specified explicitly.
VOLUME = <vsn 6..6>
Specifies the VSN of the Net-Storage volume explicitly. A default name cannot be specified. 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 to which the Net-Storage volume will be assigned.
DIRECTORY = <composed-name 1..64 with-under> / <c-string 1..64 with-low>
Specifies the directory name of the Net-Storage released on the net server.
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.
SERVER =
Specifies the net server which makes the Net-Storage available. Either the host name, the fully qualified domain name or the IP address of the net server is specified.
SERVER = <composed-name 1..256 with-under> / <c-string 1..256 with-low>
Host name or fully qualified domain name of the net server.
SERVER = *IP-ADDRESS(...)
IP address of the net server.
IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
Specifies the IP address in IPv4 or IPv6 format.
IMPORT =
Specifies whether a new directory is to be created for the specified volume or whether the directory already exists on the Net-Storage.
IMPORT = *NO
Creates a new directory on the Net-Storage for the specified volume and assigns it to the specified pubset as a Net-Storage volume.
IMPORT = *YES(...)
A directory already exists on the Net-Storage for the specified volume. This is assigned to the specified pubset as a Net-Storage volume. The catalog on the Net-Storage is not imported here. As a result the files on the Net-Storage can be accessed only after they have been imported with IMPORT-FILE.
OLD-VOLUME-NAME =
Specifies whether the VSN of the Net-Storage volumes is to be retained.
OLD-VOLUME-NAME = *SAME
The Net-Storage volume already has the VSN specified in the VOLUME operand. It does not have to be renamed.
OLD-VOLUME-NAME = <vsn 6..6>
The Net-Storage volume has so far had the VSN specified here and is to be renamed. In this case the directory which already exists on the Net-Storage and the Net-Storage volume are respectively assigned the name and the VSN which is specified in the VOLUME operand.
FORCE = *NO / *YES
Specifies whether the Net-Storage volume is to be assigned to the pubset even if inconsistencies still exist (e.g. not properly released).
The default *NO causes the command to be rejected in this case.
FORCE = *YES
In all cases the Net-Storage volume is assigned to the pubset. Any inconsistencies which still exist are ignored.
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 | DMS1C0A | Catalog entry of the Net-Storage volume already exists | |
64 | DMS1C0B | File system label already exists on the net server | |
64 | DMS1C0D | File system label on the net server does not match the pubset | |
64 | DMS1C0F | No new Net-Storage volume may be created on the slave system | |
64 | DMS1C11 | The Net-Storage volume already exists | |
64 | DMS1C12 | No Net-Storage volume can be created on the home pubset. | |
64 | DMS1C17 | Net directory cannot be accessed | |
64 | DMS1C1A | Net-Storage volume already placed in service | |
64 | DMS1C20 | Name of the Net-Storage volume is invalid | |
64 | DMS1C21 | Incorrect syntax in the IP address | |
64 | DMS1C0F | Command not permitted on the slave |