Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-NET-STORAGE

&pagelevel(3)&pagelevel

Show Net-Storage of BS2000

Component:

BS2000

Functional area:

Net-Storage administration

Domain:

DEVICE
STORAGE-MANAGEMENT

Privileges:

TSOS
OPERATING

Routing code:

G

Function

The SHOW-NET-STORAGE command provides information on Net-Storage systems which are connected with BS2000. The net server and net client and the associated Net-Storage volumes are displayed for each connected directory. The status from the NDM viewpoint and the pubset allocation are displayed for each Net-Storage volume.

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

Information on the Net-Storage available in a pubset can be requested with the SHOW-PUBSET-NET-STORAGE command.

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-NET-STORAGE

DIRECTORY = *ALL / <c-string 1..64 with-low>

,SERVER = *ALL / <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 = *ALL / <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>

,UPDATE-VOLUMES = *NO / *YES

Operands

DIRECTORY =
Specifies the directory name of the Net-Storage released on the net server.

DIRECTORY = *ALL
Information on all the directories available in BS2000 (mounted directories) is displayed.

DIRECTORY = <c-string 1..64 with-low>
Only information on the specified directory is displayed.

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

SERVER = *ALL
Information on all net servers is displayed.

SERVER = <composed-name 1..256 with-under> / <c-string 1..256 with-low>
Host name or fully qualified domain name of a 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.

CLIENT = *ALL
Information on all net clients is displayed.

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.

UPDATE-VOLUMES = *NO / *YES
Specifies whether the Net-Storage volumes of the specified directories should be determined again and the NDM tables should be updated before the display takes place. 

Return codes

(SC2)

SC1

Maincode

Meaning/Guaranteed messages


0

CMD0001

Command executed without error


1

NKAN003

Syntax error in the input


32

CMD0221

system error


32

NKAN004

Error in command execution


32

NKAN008

Error in S variable format


64

NKAN006

No information available


64

NKAN009

Leading slash in directory name missing

Meanings of the output fields

Output field                 

Possible values

Meaning

NET-DIRECTORY

<name 1..64>

Directory name of the directory released on the
net server

  • (<status>)

MOUNT-ID: <integer>

Mount ID of the connected Net-Storage

NET-SERVER

See SERVER operand

Name of the net server

NET-CLIENT

See CLIENT operand

Name of the net client

NET-VOLUMES

<vsn 6..6>

VSN of the Net-Storage volume (corresponds to the directory name in the Net-Storage)

  • (<status> [PUBSET=catid])







Status of the Net-Storage volume:

IN USE

Files accessible (pubset has been imported)

ONLINE

Net-Storage is connected, but the volume cannot be accessed (e.g. pubset not imported). The volume can be switched to the IN USE status using /IMPORT-PUBSET or, in the case of a pubset which has already been imported, using /ADD-NET-STORAGE-VOLUME.

MULT DEF

The VSN of the Net-Storage volume already exists in another net directory.

CANCELLED

Access to the volume is locked (e.g. after /UMOUNT-NET-STORAGE with FORCE=*YES). /ADD-NET-STORAGE-VOLUME can be used to switch the status back to IN USE. 

<catid 1..4>

Pubset to which the Net-Storage volume is allocated

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

Output in S variable

Only the S variables for the known names of the net server and net client are supplied with values. In the case of an unknown name, the S variable contains an empty string.

Output information

Name of the S variable

T

Contents         

Condition

Directory name of the directory released on the net server

var(*LIST).DIR(*LIST).NAME

S

<name 1..64>


Mount ID of the Net-Storage volume (0: volume not connected)

var(*LIST).DIR(*LIST).MOUNT-ID

I

<integer>


Host or DNS name of the net server

var(*LIST).DIR(*LIST).SERVER.NAME

S

''
<name 1..256>


IPv4 address of the net server

var(*LIST).DIR(*LIST).SERVER.IPV4

S

''
<name 7..15>


IPv6 address of the net server

var(*LIST).DIR(*LIST).SERVER.IPV6

S

''
<name 15..39>


BCAM name of the net client

var(*LIST).DIR(*LIST).CLIENT.NAME

S

''
<name 1..8>


DNS name of the net client

var(*LIST).DIR(*LIST).CLIENT.DNS

S

''
<name 1..256>


IPv4 address of the net client

var(*LIST).DIR(*LIST).CLIENT.IPV4

S

''
<name 7..15>


IPv6 address of the net client

var(*LIST).DIR(*LIST).CLIENT.IPV6

S

''
<name 15..39>


Name of a Net-Storage volume

var(*LIST).DIR(*LIST).NET-VOL(*LIST).VSN

S

<vsn 6..6>


Status of the Net-Storage volume

var(*LIST).DIR(*LIST).NET-VOL(*LIST).STA

S

*IN-USE
*ONLINE
*MULT-DEF
*CANCELLED


Catalog ID of the pubset to which the Net-Storage volume is assigned.

var(*LIST).DIR(*LIST).NET-VOL(*LIST).CAT-ID

S

''
<catid 1..4>


Example

/show-net-storage

************************************************************************ 
- NET-DIRECTORY: /TEST    (MOUNT-ID = 2)
------------------------------------------------------------------------ 
   NET-SERVER:  IPV4: 1.2.3.4 

   NET-CLIENT:  CLIENT_C 


------------------------------------------------------------------------ 
   NET-VOLUMES: TEST00    (ONLINE)


************************************************************************
- NET-DIRECTORY: /BS2000-1    (MOUNT-ID = 1) 
------------------------------------------------------------------------ 
   NET-SERVER:  IPV4: 1.2.3.4 

   NET-CLIENT:  CLIENT_C 


------------------------------------------------------------------------ 
   NET-VOLUMES: P@BX00    (IN USE, PUBSET = X   ) 

                MONI01    (IN USE, PUBSET = MONI) 


************************************************************************ 
- NET-DIRECTORY: /BS2000-1    (MOUNT-ID = 3)
------------------------------------------------------------------------ 
   NET-SERVER:  IPV4: 1.2.3.5 

   NET-CLIENT:  CLIENT_C 


------------------------------------------------------------------------ 
   NO NET-VOLUMES 


************************************************************************
Powered by Atlassian Confluence and Scroll Viewport.