Create Net-Storage volume and assign it to a local pubset
Component: | BS2000 |
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.
As of BS2000 V21.0A, there is a second Net Storage volume type NETVOL in addition to the previous Net Storage volume type NETSTOR. A Net-Storage volume contains administration files, whereby a Net-Storage volume of the NETSTOR type has its own file catalog in addition to the FSL file, while only the FSL file is stored on a Net Storage volume of the NETVOL type. With a Net-Storage volume of the NETVOL type, the catalog entries of the individual files are only contained in the TSOSCAT of the pubset.
Up to BS2000 OSD/BC V11, only Net-Storage volumes of the NETSTOR type can be created. As of BS2000 V21.0A, only Net-Storage volumes of the NETVOL type can be created.
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 following is valid for Net-Storage volumes of type NETSTOR:
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.
The following is valid for Net-Storage volumes of type NETVOL:
Only after a successful EXPORT (see REMOVE-NET-STORAGE-VOLUME ..., FILES-ON-VOLUME = * EXPORT) can a Net-Storage volume of the NETVOL type be imported.
All files are cataloged, i.e. an IMPORT-FILES or IMPORT-NODE-FILES is not necessary. The Net-Storage volume of type NETVOL can only be accessed when all files have been cataloged by ADD-NET-STORAGE-VOLUME ..., IMPORT = * YES.
If this is not possible (e.g. user IDs did not exist or files with the same name are already cataloged or exist on a different data volume), all files are removed from the catalog and the original status is restored on the PUBSET. After suitable measures have been taken (possibly creating a missing user ID, cleaning up TSOSCAT), the import process can be repeated.
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.
CONVERT =
Specifies whether an existing Net-Storage volume of the NETSTOR type should be converted into a Net-Storage volume of the NETVOL type.
CONVERT = *NO/
No conversion takes place.
CONVERT = *TO-NETVOL
An existing Net-Storage volume of the NETSTOR type is converted into a Net-Storage volume of the NETVOL type. Conversion back is not possible! The converted volume cannot be accessed by BS2000 systems <V21.
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 |