SHOW-PUBSET-NET-STORAGE

Display Net-Storage of a pubset

Component:	BS2000
Functional area:	Net-Storage administration
Domain:	STORAGE-MANAGEMENT
Privileges:	STD-PROCESSING TSOS

Function

The SHOW-PUBSET-NET-STORAGE command provides information on the Net-Storage which is assigned to an imported pubset in the form of Net-Storage volume(s). For each Net-Storage volume the display shows the VSN, the current status and the net server providing it.

The command supports structured output in S variables (see "Output in S variables").

Information on the tasks occupying the Net-Storage can be requested using the SHOW-NET-STORAGE-OCCUPATION 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

SHOW-PUBSET-NET-STORAGE                                                                                                              

PUBSET = <cat-id 1..4>

Operands

PUBSET = <cat-id 1..4>
Specifies the pubset about whose Net-Storage volumes information is to be provided.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	32	CMD0221	System error
	32	CMD2009	Error during output in S variables (e.g. subsystem not available)
	32	DMS1CFF	System error (see SERSLOG entry)
	64	DMS1C02	Net-Storage volume not found
	64	DMS1C05	Pubset not found
	64	DMS1C06	Pubset not accessible

Meaning of the output fields

Output field	Possible values	Meaning
NET-VOLUME	<vsn 6..6>	VSN of the Net-Storage volume
STATUS		Status of the Net-Storage volume
	IN USE	Being used, pubset has been imported
	ONLINE	Known in the BS2000 system, but pubset has not been imported
	PERMISSION DENIED	No authorization to access the Net-Storage volume
	NOT MOUNTED	Net-Storage not connected
	NO CONNECTION	No connection to the net server
	NOT VALID	Invalid, does not exist
NET-DIRECTORY1	<name 1..64>	Directory name of the Net-Storage released on the net server
SERVER-NAME1	<name 1..255>	Name of the net server
IPV4-ADDRESS1	<name 7..15>	IP address of the net client in IPv4 format
IPV6-ADDRESS1	<name 15..39>	IP address of the net client in IPv6 format

Table 144: Output fields for the SHOW-NET-STORAGE command

1	Status-dependent output: output only when the information is available. Output values which are longer than 60 bytes begin in a new line. The line is also wrapped from a length of 77 bytes.

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Pubset catalog ID	var(*LIST).PUBSET	S	<cat-id 1..4>
Number of the Net-Storage volumes	var(*LIST).NUM-OF-NET-VOL	I	<integer 1..4096>
VSN of the Net-Storage volumes	var(*LIST).NET-VOL(*LIST).VSN	S	<vsn 6..6>
Status of the Net-Storage volumes	var(*LIST).NET-VOL(*LIST).STATUS	S	*IN USE *ONLINE *PERMISSION-DENIED *NOT MOUNTED *NO CONNECTION *NOT VALID
Directory name of the Net-Storage released on the net server	var(*LIST).NET-VOL(*LIST).DIR1	S	<name 1..64> ’’
Name of the net server	var(*LIST).NET-VOL(*LIST).SERVER1	S	<name 1..256> ’’
IP address of the net client in IPv4 format	var(*LIST).NET-VOL(*LIST).IPV41	S	<name 7..15> ’’
IP address of the net client in IPv6 format	var(*LIST).NET-VOL(*LIST).IPV61	S	<name 15..39> ’’

1	Status-dependent output: Null string, only when the information is available.

Example

/show-pubset-net-storage bigf

%NET-VOLUMES FOR PUBSET : BIGF
%--------------------------------------------------------------------------
%NET-VOLUME      :   BIGF@00
%STATUS             :   IN USE
%NET-DIRECTORY :   /nas/200/bs2-cs1
%IPV4-ADDRESS  :   10.20.30.40
%--------------------------------------------------------------------------
%NET-VOLUME      :   MONI00
%STATUS              :   NOT MOUNTED
%--------------------------------------------------------------------------
%NET-VOLUME      :   NET001
%STATUS              :   PERMISSION DENIED
%NET-DIRECTORY :   /nas/200/bs2data
%IPV4-ADDRESS  :   10.20.50.60
%--------------------------------------------------------------------------