Disconnect Net-Storage
Component: | BS2000 |
Functional area: | Net-Storage administration |
Domain: | DEVICE |
Privileges: | TSOS |
Routing code: | G |
Function
The UMOUNT-NET-STORAGE command disconnects the Net-Storage from the BS2000 system. In this case the connection to the net server and net client is cleared. On the net client side the directory which corresponds to the Net-Storage is unmounted.
A Net-Storage should be disconnected only when all pubsets which contain files on this Net-Storage have been exported. While such pubsets remain imported, BS2000 tasks can still occupy the Net-Storage. The command is rejected if such occupancy exists. The SHOW-NET-STORAGE-OCCUPATION command provides information on Net-Storage occupancy. If it is essential, execution of the command can be forced with the FORCE=*YES operand. In this case any existing occupancy is ignored and inconsistencies can arise as files are not closed properly.
Information on the Net-Storage available in BS2000 can be requested using the SHOW-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
UMOUNT-NET-STORAGE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
DIRECTORY =
Specifies the directory name of the Net-Storage released on the net server.
DIRECTORY = *BY-MOUNT-ID(...)
The mount ID unambiguously specifies the connection to the Net-Storage which is to be cleared. In this case SERVER and CLIENT need not be specified explicitly (the defaults for *BY-SYSTEM are sufficient). The mount ID can be determined with the SHOW-NET-STORAGE command.
MOUNT-ID = <integer 1..16777215>
Mount ID of the connection to the Net-Storage.
DIRECTORY = <c-string 1..64 with-low>
Name of the directory to be separated.
SERVER =
Specifies the net server which makes the Net-Storage available. An explicit specification is also verified when the connection has already been unambiguously specified using the mount ID.
SERVER = *BY-SYSTEM
The explicit specification of the net server is not necessary when the mount ID is specified in the DIRECTORY operand or when the net server is defined unambiguously by the directory name.
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 of the net server in IPv4 or IPv6 format.
CLIENT =
Specifies the net client on which the Net-Storage (more precisely: the released directory) is mounted. For SUs /390 and S servers this is an HNC. For SUs x86 X2000 performs this role.
An explicit specification is also verified when the connection has already been unambiguously specified using the mount ID.
CLIENT = *BY-SYSTEM
The explicit specification of the net client is not necessary when the mount ID is specified in the DIRECTORY operand or when the net client is defined unambiguously by the directory name.
CLIENT = <composed-name 1..8 with-under> / <c-string 1..8>
Internal BCAM name of the net client.
CLIENT = *DNS(...)
Domain name of the net client.
DNS-NAME = <c-string 1..256 with-low>
Specifies the fully qualified domain name of the net client.
CLIENT = *IP-ADDRESS(...)
IP address of the net client.
IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
Specifies the IP address of the net client in IPv4 or IPv6 format.
FORCE = *NO / *YES
Specifies whether the Net-Storage is also to be disconnected if it is still occupied by tasks. The default *NO causes the command to be rejected in this case.
FORCE = *YES
The Net-Storage directory is always disconnected. If it is still occupied, this is ignored. In this case data can be lost because files cannot be closed properly.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
1 | NKAN003 | Syntax error in the input | |
32 | CMD0221 | system error | |
32 | NKAN004 | Error in command execution | |
64 | NKAN007 | Net-Storage directory does not exist | |
64 | NKAN009 | Leading slash in directory name missing | |
64 | NKAN010 | Directory name is not unique | |
64 | NKAN011 | Mount ID does not exist |