SHOW-DEVICE-CONFIGURATION (Display device configuration and availability)

/SHOW-DEVICE-CONFIGURATION provides information on the system configuration and the availability of the hardware units (refer also to the commands manual [13] for the meaning of the output columns of the device management SHOW commands).

The command supports structured output to S variables.

Format (VM2000-specific operands)

SHOW-DEVICE-CONFIGURATION (VM2000 specific)

UNIT = *STD / *SELECT(...) / *PUBSET-DEVICES(...) / . . .
	*SELECT(...)
		|	CLASS = *ALL / . . . / *DEVICE(...)
		|		*DEVICE(...)
		|			|	TYPE = *ALL / <device>
		|			|	,VM-ASSIGNMENT = *ANY / *NO / *YES / *BY-GUEST-POSSIBLE
		|	,ATTRIBUTE = . . .
	. . .
	*PUBSET-DEVICES(...)
		|	PUBSET = <cat-id 1..4> / *BY-PUBRES-DEVICE(...)
		|		*BY-PUBRES-DEVICE(...)
		|			|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
,INFORMATION = *STD / . . . / *VM2000

Description of the operands (VM2000-specific operands)

UNIT = *SELECT(...) / *PUBSET-DEVICES(...)
Specifies a subset of the hardware units known to the system for which information is output. The hardware units are selected using device class and state or using a pubset. The devices of a pubset can also be controlled as a unit (with the same syntax *PUBSET-DEVICES(...)) in the VM2000 commands.

In order to obtain information on the pubset devices (*PUBSET-DEVICES operand), the guest system attempts, if necessary, to implicitly assign and attach the pubres device (and the volres devices) to the VM for the duration of command processing.

CLASS = *DEVICE(...)
Information on end devices is displayed.

TYPE = *ALL / <device>
Information is output on end devices of the specified device type. *ALL is the default. In other words, all the device types are displayed by default. When a device type is specified explicitly, only device or volume types that are known in the system are accepted. The possible device and volume types are displayed in the dialog with DEVICE-TYPE=?.

VM-ASSIGNMENT = *ANY / *NO / *YES / *BY-GUEST-POSSIBLE
If INFORMATION=*VM2000 is specified, information is displayed on end devices that have the specified status. *ANY is the default. In other words, output is not dependent on this status by default.

VM-ASSIGNMENT = *NO
Information is displayed on end devices not assigned to own VM.

VM-ASSIGNMENT = *YES
Information is displayed on end devices assigned to own VM.

VM-ASSIGNMENT = *BY-GUEST-POSSIBLE
Information is displayed on end devices that are not assigned to own VM but that can currently be assigned implicitly (using /ATTACH-DEVICE, for example).

. . .

INFORMATION = *VM2000
Information on (possible) assignment to own VM and on usage mode.

Output format:

MNEM UN-CLASS UN-TYPE CONF-STATE   VM-ASSIGN      VM-USAGE

Example

/show-device-configuration unit=(d2,d3,d4,d5,d6,d7,p2,p3),
                            information=*vm2000 ———————————————————————  (1)
MNEM UN-CLASS UN-TYPE  CONF-STATE   VM-ASSIGN      VM-USAGE ———————————  (2)
D2   DVC      D3435    ATTACHED     BY-GUEST       SH(I)
D3   DVC      STDDISK  DET(EX)      BY-VM-ADM      SH(D)
D4   DVC      D3435    DET(EX)      BY-GUEST-POSS  SH(D)
D5   DVC      STDDISK  DET(EX)      BY-GUEST-POSS  NONE
D6   DVC      STDDISK  DET(EX)      ELSEWHERE      EXCL
D7   DVC      D3435    ATTACHED     BY-VM-ADM      EXCL
P2   DVC      HNC      ATTACHED     BY-GUEST       EXCL
P3   DVC      HNC      ATTACHED     BY-GUEST       EXCL

------------------------------------------------------------------------------------------------------------------------

(1)	VM2000 information is requested for the devices specified
(2)	See "Meaning of the output columns with INFORMATION=*VM2000" for the meaning of the output columns VM-ASSIGN and VM-USAGE

------------------------------------------------------------------------------------------------------------------------

S variables

Output information	Name of S variable	T	Contents	Condition
Assignment mode or option of own VM	var(*LIST).VM-ASS	S	BY-GUEST BY-VM-ADM VM-INHIBIT DEV-INHIBIT ELSEWHERE BY-GUEST-POSSIBLE	INF=*VM2000
Usage mode in VM2000	var(*LIST).VM-USAGE	S	NONE EXCL SH(D) SH(I)	INF=*VM2000

Meaning of the output columns with INFORMATION=*VM2000

Keyword     

Meaning

VM-ASSIGN

Displays assignment mode or option for the own VM:

BY-VM-ADM	The device is assigned explicitly to the own VM.
BY-GUEST	The device is assigned implicitly to the own VM.
BY-GUEST-POSS	The device is not assigned to the own VM, implicit assignment is possible.

In the following cases, the device is not assigned to the own VM and implicit assignment is not possible:

VM-INHIBIT	The VM is not authorized for implicit assignment at all.
DEV-INHIBIT	The VM is not authorized to assign this device implicitly. Exception for VM-INHIBIT / DEV-INHIBIT: Snap units (Snapsets) can nevertheless be assigned implicitly to a VM with the AUTO-SNAP-ASSIGNMENT privilege (see "Initializing a VM").
ELSEWHERE	The device is assigned exclusively to another VM.

VM-USAGE

Displays the usage mode in which the device is assigned (depends on VM-ASSIGN).

If VM-ASSIGN = BY-GUEST / BY-VM-ADM:

EXCL	The device is assigned exclusively to the own VM.
SH(D)	The device is assigned to the own VM for shared usage with direct I/O processing (only one VM sharer).
SH(I)	The device is assigned to the own VM for shared usage with indirect I/O processing.

If VM-ASSIGN = BY-GUEST-POSS:

EXCL	The device is assigned exclusively to another VM. It is still possible to assign the device due to the KEEP state of the device (MTC).
SH(D)	The device is assigned to another VM for shared usage with direct I/O processing (only one VM sharer).
SH(I)	The device is assigned to another VM for shared usage with indirect I/O procesing.
NONE	The device is not assigned.

If VM-ASSIGN = VM-INHIBIT / DEV-INHIBIT:

EXCL	The device is assigned exclusively to another VM.
SH(D)	The device is assigned to another VM for shared usage with direct I/O processing (only one VM sharer).
SH(I)	The device is assigned to another VM for shared usage with indirect I/O processing.
NONE	The device is not assigned.

If VM-ASSIGN = ELSEWHERE:

EXCL	The device is assigned exclusively to another VM.