SHOW-DEVICE-DEPOT

Show assignment of tape devices to storage locations

Component:	BS2000
Functional area:	Device management
Domain:	DEVICE
Privileges:	STD-PROCESSING OPERATING HARDWARE-MAINTENANCE
Routing code:	E

Function

The SHOW-DEVICE-DEPOT command provides information on the assignment of tape devices to volume storage locations.

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

Format

SHOW-DEVICE-DEPOT

UNIT = *SELECT(...) / *LOCATION(...) /
list-poss(26): <alphanum-name 2..2 with-wild(20)> / <alphanum-name 4..4 with-wild(20)>
	*SELECT(...)
		|	ROUTING-CODE = *ANY / <name 1..1>
	*LOCATION(...)
		|	LOCATION = list-poss(10): <alphanum-name 1..8 with-wild(40)>

Operands

UNIT =
Selection criterion for information output. Possible specifications: storage locations, routing codes of storage locations, device mnemonics.

UNIT = *SELECT(...)
Specification of a subset of the possible selection parameters that determine the scope of the output.

ROUTING-CODE = *ANY / <name 1..1>
Provides information about device sets to which storage locations with the specified routing code are assigned.

ROUTING-CODE = *ANY
Provides information about device sets, not depending on the routing codes of the assigned storage locations.

ROUTING-CODE = <name 1..1>
The storage locations with the specified routing code are selected.

UNIT = *LOCATION(...)
Specifies one or more depots whose assigned tape devices are to be output.

LOCATION = list-poss(10): <alphanum-name 1..8 with-wild(40)>
Depot names (1 - 8 characters long). A maximum of 10 depots can be specified.

UNIT = list-poss(26): <alphanum-name 2..2 with-wild(20)> / <alphanum-name 4..4 with-wild(20)>
Specification of tape devices whose storage location is to be output. Up to 26 devices can be specified.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	NKD0005	Warning: information incomplete
	1	NKD0001	Syntax error in the input, correction of the command parameters recovers the error
	32	CMD2009	Error on output to S variable (e.g. subsystem not available)
	64	NKD0006	Internal error during initialization of the command server
	64	NKD0002	No information available
	64	NKD0006	Software error in NKDDEVD procedure
	64	NKD0023	No information available
	64	NKD0036	No information available for LOCATION list
	64	NKD0037	No information available for routing code
	64	OPS0002	Interrupt (e.g. by K2 key) during S variable generation
	130	OPS0001	SDF-P reporting space problems (possible response: FREE-VARIABLE and repeat command)

Output format

All three command options have the following header line:

LOCATION RTC TAPE-MNEMONICS

Example

/show-dev-depot

%  LOCATION RTC TAPE-MNEMONICS
%  ROBOTER1  T  E0  ,E1  ,E2  ,E3  ,E4  ,E5  ,E6  ,E7  ,E8
%               E9  ,EC  ,ED  ,EA  ,EB  ,EE  ,EF
%  ROBOTER2  T  EU  ,EX  ,ES  ,ET  ,EW  ,EV  ,EY  ,EZ  ,EK
%               EL  ,EO  ,EP  ,EM  ,EN  ,EQ  ,ER
%  D016ZE04  T  TE  ,TL  ,MA  ,MB  ,MC  ,ME  ,MD  ,MF  ,MM
%               MN  ,MO  ,MP  ,MQ  ,MR

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Name of the depot	var(*LIST).LOCATION	S	'' <location>
Routing code of the depot	var(*LIST).ROUT-CODE	S	'' <alphan.-name 1..1>
Tape device mnemonic	var(*LIST).UNIT(*LIST)	S	'' <mnemo-name>

Note

For technical reasons the output of storage locations with more than 128 tape devices assigned is split: SYSOUT output as well as variable output contains more than one storage location in this case. However, all these locations have the same name, and with respect to the last one all have exactly 128 devices assigned.

Therefore the use of SDF-P function SIZE is recommended when processing the variable output: As long as var(*LIST).UNIT has 128 elements, the current element and the next element in var(*LIST) could belong to the same storage location, i.e. var(*LIST).LOCATION of both elements could be identical.