MOUNT-NET-STORAGE

Connect Net-Storage

Component:	BS2000
Functional area:	Net-Storage administration
Domain:	DEVICE STORAGE-MANAGEMENT
Privileges:	TSOS OPERATING
Routing code:	G

Function

The MOUNT-NET-STORAGE command connects a directory released on a Net-Server as storage space (Net-Storage) with BS2000.

In this case the connection to the net server and net client is set up. The Net-Storage is mounted on the net client as a file system and is consequently available to the BS2000 system. From the BS2000 viewpoint the Net-Storage is in the MOUNTED status.

Before a pubset with a Net-Storage volume is imported, the Net-Storage concerned should be connected. Only then files on the Net-Storage can be accessed immediately after the pubset has been imported.

Information on the mounted directories 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

MOUNT-NET-STORAGE

DIRECTORY = <c-string 1..64 with-low>
,SERVER = <composed-name 1..256 with-under> / <c-string 1..256 with-low> / *IP-ADDRESS(...)
	*IP-ADDRESS(...)
		|	IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
,CLIENT = <composed-name 1..8 with-under> / <c-string 1..8> / *DNS(...) / *IP-ADDRESS(...)
	*DNS(...)
		|	DNS-NAME = <c-string 1..256 with-low>
	*IP-ADDRESS(...)
		|	IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>

Operands

DIRECTORY = <c-string 1..64 with-low>
Specifies the directory name of the Net-Storage released on the net server.

SERVER =
Specifies the net server which makes the Net-Storage available.

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
Specifies the IP address of the net server in IPv4 or IPv6 format.

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 to be mounted. For SUs /390 and S servers this is an HNC. For SUs x86 X2000 performs this role.

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.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	0	NKAN005	Net-Storage already connected
	1	NKAN003	Syntax error in the input
	32	CMD0221	system error
	32	NKAN004	Error in command execution
	64	NKAN009	Leading slash in directory name missing