SHOW-NET-STORAGE-OCCUPATION

Display occupancy of the BS2000 Net-Storage

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

Function

The SHOW-NET-STORAGE-OCCUPATION command provides information on the
BS2000 tasks of the local system which occupy a Net-Storage. For shared pubsets, too, only the occupying tasks of the local system are displayed. The connection to the Net-Storage is specified unambiguously by entering the mount ID. The mount ID is displayed by the SHOW-NET-STORAGE command.

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.

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-OCCUPATION                                                                                                     

DIRECTORY = *BY-MOUNT-ID(...)
	*BY-MOUNT-ID(...)
		|		MOUNT-ID = <integer 1..16777215>

Operands

DIRECTORY = *BY-MOUNT-ID(...)
Specifies the directory name of the Net-Storage released on the net server. The mount ID which unambiguously specifies the connection to the Net-Storage can be determined using the SHOW-NET-STORAGE command.

MOUNT-ID = <integer 1..16777215>
Mount ID of the connection to the Net-Storage. 

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	32	CMD0221	system error
	32	CMD2009	Error on output in S variables (e.g. subsystem not available)
	32	DMS1CFF	System error (see SERSLOG entry)
	64	DMS1C04	Error when calling ONETSTOR
	64	DMS1C30	The specified mount ID is not assigned
	64	DMS1C31	Invalid mount ID

Meanings of the output fields

Output field	Possible values	Meaning
MOUNT-ID	<integer>	Mount ID which was specified in the command; displayed in the format nnnnnnnn with leading zeros
NUMBER OF OCCUPYING TASKS	<integer>	Number of tasks which are occupying the Net-Storage
OCCUPATIONS BY LOCAL TASKS	<tsn> <userid>	Lists each occupying task with the TSN and the user ID

Table 134: Output fields for the SHOW-NET-STORAGE-OCCUPATION command

Output in S variable

Output information	Name of the S variable	T	Contents	Condition
Mount ID of the connection to the Net-Storage	var(*LIST).MOUNT-ID	I	<integer>
Name of the net server	var(*LIST).NUM-OF-TASK	I	<integer>
TSN of the occupying task	var(*LIST).TASK(*LIST).TSN	S	<name 1..4>
User ID of the occupying task	var(*LIST).TASK(*LIST).USER-ID	S	<name 1..8>

Example

/show-net-storage-occupation mount-id=1

---------------------------------------------------------------------------- 
COMMAND: SHOW-NET-STORAGE-OCCUPATION
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 MOUNT-ID: 00000001
---- REFERENCE              ------------------------------------------------- 
 NUMBER OF OCCUPYING TASKS            | 14
---- DETAILS OF OCCUPATION  ------------------------------------------------- 
 OCCUPATIONS BY LOCAL TASKS
  FTCP TSOS         0FDX TSOS         0FDY TSOS         0FDZ TSOS
  0FD1 TSOS         0FD2 TSOS         0FD5 TSOS         0FD6 TSOS
  0FEA TSOS         0FFR TSOS         0FFS TSOS         0FFT TSOS
  0FFU TSOS         0FFV TSOS
-----------------------------------------------------------------------------