VM2000 V12.0 (en)

&pagelevel(4)&pagelevel

/SHOW-VM-DEVICE-STATUS outputs detailed information on VM2000 devices.

The command provides the following information:

The mnemonic device name
The hardware attributes of the device (device type, PAV and SNAP attributes)
The pubres attributes of the device (PUBRES-FOR-ATTRIBUTES / PUBRES-FOR-ASSIGNMENT)
The specifications for implicit assignment of the device (ASSIGN-BY-GUEST attribute, assignment set)
The assignment of the device to a VM
The assignment mode and the usage mode of the device

This command is reserved for the VM2000 administrator and VM administrators with ADMIN-PRIVILEGES=*MAXIMUM.

SHOW-VM-DEVICE-STATUS

UNITS = STD / ALL / *PUBSET-DEVICES(...) /
				list-poss(28): *DEVICE-RANGE(...) / <alphanum-name 1..4 with-wild(20)>
	*PUBSET-DEVICES(...)
		\|	PUBSET = *BY-PUBRES-DEVICE(...) / <cat-id 1..4>
		\|		*BY-PUBRES-DEVICE(...)
		\|			\|	UNIT = <alphanum-name 2..2> / <x-text 4..4>
	*DEVICE-RANGE(...)
		\|	FROM = <alphanum-name 2..2> / <x-text 4..4>
		\|	,TO = <alphanum-name 2..2> / <x-text 4..4>

,SELECT = *PARAMETERS(...)
	*PARAMETERS(...)
		\|	TYPE = ANY / VC / <family> / <device>
		\|	,STATE = ANY / ASSIGNED(...) / *DISPOSABLE(...)
		\|		*ASSIGNED(...)
		\|			\|	BY = ANY / VM-ADMIN / *GUEST
		\|			\|	,USAGE = ANY / EXCLUSIVE / *SHARED
		\|			\|	,VM-IDENTIFICATION = *ANY / <integer 1..99> / <name 1..8 with-wild(20)> /
		\|			\|					BY-VM-GROUP(...) / BY-CPU-POOL(...)
		\|			\|		*BY-VM-GROUP(...)
		\|			\|			\|	VM-GROUP-NAME = <name 1..8>
		\|			\|		*BY-CPU-POOL(...)
		\|			\|			\|	CPU-POOL-NAME = *STDPOOL / <name 1..8>
		\|		*DISPOSABLE(...)
		\|			\|	CURRENT-STATE = ANY / UNASSIGNED / SHARED / KEEP
		\|	,ASSIGN-BY-GUEST = ANY / NO / *YES(...)
		\|		*YES(...)
		\|			\|	SET-NAME = ANY / STDSET / *BY-GUEST(...) / <name 1..8>
		\|			\|		*BY-GUEST(...)
		\|			\|			\|	GUEST = <integer 1..99> / <name 1..8>
		\|	,SPECIFIED-AS-PUBRES = ANY / NO / *YES(...)
		\|		*YES(...)
		\|			\|	FOR = ANY / ASSIGNMENT / *ATTRIBUTES
		\|	,SNAP-DEVICE = ANY / NO / *YES
		\|	,PAV-ATTRIBUTE = ANY / PAV / NO-PAV / BASE / ALIAS / NO-ALIAS
,INFORMATION = STD / ALL / VM-SUMMARY / PAV

UNITS =
Specifies the devices whose device information is to be output.

UNITS = *STD
Information on all devices is output. If this operand is entered on a BS2000 console or in the ADMIN dialog via $VMCONS, the information to be output must be limited by specifying SELECT=... or INFORMATION=*VM-SUMMARY.

UNITS = *ALL
Information on all devices is output. The output set can be extensive unless other entries are made to limit the information to be output.

UNITS = *PUBSET-DEVICES(...)
Information is output on all devices of a pubset.

PUBSET = *BY-PUBRES-DEVICE(...)
Determines the devices of the pubset by means of the pubres device.

UNIT = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name of the pubres device.

PUBSET = <cat-id 1..4>
Catalog ID of the pubset. The pubset must be entered together with its pubres device in the monitor system’s MRS catalog.

UNITS = *DEVICE-RANGE(...)
Information is to be output for all the devices in this name range.

Device names <x-text 4..4> (in *DEVICE-RANGE) are selected from FROM to TO in hexadecimal order. Otherwise, device names <alphanum-name 2..2> are selected in alphabetical order.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Defines the start of the name range.

TO = <alphanum-name 2..2> / <x-text 4..4>
Defines the end of the name range. The mnemonic device name must be in the same value range (2- or 4-digit mn) as the FROM device name and must be greater than or equal to the FROM device name in ascending order in the value range.

UNITS = <alphanum-name 1..4 with-wild(20)>
Specifies the devices whose device information is to be output.

SELECT = *PARAMETERS(...)
Selects from the (possibly large) set of devices in the UNITS operand a suitable subset about which detailed device information is to be output.

TYPE =
Selects devices on the basis of the device type.

TYPE = *ANY
No selection is made on the basis of the device type.

TYPE = *VC
Selects devices which are assigned as virtual console (STATE=*ASSIGNED) or can be assigned as virtual console (STATE=*DISPOSABLE).

TYPE = <family>
Outputs all the devices of the specified device family.

<family>	device family (group)
*CONSOLE	Console
*PRINTER	Printer
*FAM50	Special devices
*TD	TRANSDATA device
*UR	Unit record device
*DISK	Disk device
*MBK	Magnetic tape cartridge device
*BIMTAPE	Bimodal tape device
*TAPE	Tape device

TYPE = <device>

Outputs all the devices of the specified device type. The possible device types are contained in the device type table (Device type column) in the "System Installation" manual [1]. The possible device and volume types are displayed in the dialog with TYPE=?. The device types on the current system can be displayed by means of /SHOW-DEVICE-CONFIGURATION, for example.

STATE =
Selects devices on the basis of their assignment status.

STATE = *ANY
No selection is made on the basis of the assignment status.

STATE = *ASSIGNED(...)
Outputs all devices that are assigned to a VM. The VM is selected by means of the VMIDENTIFICATION operand. The BY and USAGE operands define the set of devices to be output more closely.

BY =
Selects devices on the basis of who has assigned the device to at least one VM.

BY = *ANY
No selection.

BY = *VM-ADMIN
Outputs all devices assigned explicitly by the VM or VM2000 administrator. If a VM was explicitly selected in the VM-IDENTIFICATION operand, this selection attribute must apply for this VM.

BY = *GUEST
Outputs all devices assigned implicitly to the VM by the guest system. If a VM was explicitly selected in the VM-IDENTIFICATION operand, this selection attribute must apply for this VM.

USAGE =
Selects devices on the basis of the usage mode.

USAGE = *ANY
No selection is made on the basis of the usage mode.

USAGE = *EXCLUSIVE
Outputs all devices that are assigned to a VM for exclusive use.

USAGE = *SHARED
Outputs all devices that are assigned to a VM for shared use with other VMs.

VM-IDENTIFICATION =
Selects devices on the basis of the VM to which they are assigned.

VM-IDENTIFICATION = *ANY
No selection.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8 with-wild(20)>
Identifies the virtual machine by means of a VM index or VM name.

VM-IDENTIFICATION = *BY-VM-GROUP(...)
Information is output for all VMs which belong to the VM group (SU /390).

VM-GROUP-NAME = <name 1..8>
Name of the VM group.

VM-IDENTIFICATION = *BY-CPU-POOL(...)
No selection is made on this basis.

CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.

STATE = *DISPOSABLE(...)
Outputs all devices that can currently be assigned.

CURRENT-STATE =
Selects devices on the basis of their assignment status.

CURRENT-STATE = *ANY
No selection is made on the basis of the assignment status.

CURRENT-STATE = *UNASSIGNED
Outputs all devices not assigned to a VM (free devices).

CURRENT-STATE = *SHARED
Outputs all devices that are assigned for shared use with other VMs. These devices are assigned to at least one VM.

CURRENT-STATE = *KEEP
Outputs all devices in the KEEP state (see "Assignment sets, implicit device assignment and release").

ASSIGN-BY-GUEST =
Selects devices on the basis of whether they have to be assigned explicitly by the VM or VM2000 administrator or can be assigned to a suitable VM implicitly by the guest system.

ASSIGN-BY-GUEST = *ANY
No selection.

ASSIGN-BY-GUEST = *NO
Outputs all devices that can only be assigned by the VM or VM2000 administrator.
Exception: Alias devices (PAV/DPAV, see "Parallel access volume (PAV, SU /390)"), CRD devices (see "Special devices") and snap units for Snapsets (see "Special devices").

ASSIGN-BY-GUEST = *YES(...)
Outputs all devices that can be assigned to a suitable VM implicitly by the guest system. Alias devices (PAV/DPAV, see "Parallel access volume (PAV, SU /390)"), CRD devices (see "Special devices") and snap units for Snapsets (see "Special devices") are not taken into consideration.

SET-NAME = *ANY / *STDSET / <name 1..8>
Outputs all devices which are assigned to any or to the specified assignment set.

SET-NAME = *BY-GUEST(...)
Outputs all devices which the guest system on the VM may implicitly assign to itself.

GUEST = <integer 1..99 / <name 1..8>
Selects the VM by means of the VM index or VM name.

SPECIFIED-AS-PUBRES =
Selects the devices on the basis of whether they are known as pubres devices.

SPECIFIED-AS-PUBRES = *ANY
No selection.

SPECIFIED-AS-PUBRES = *NO
Outputs all devices which are not known as pubres devices.

SPECIFIED-AS-PUBRES = *YES(...)
Selects the pubres devices on the basis of their pubres attribute.

FOR = *ANY
No selection.

FOR = *ASSIGNMENT
Outputs all pubres devices which have the PUBRES-FOR-ASSIGNMENT attribute for an arbitrary VM. If a VM was explicitly selected in the VM-IDENTIFICATION operand, this selection attribute must apply for this VM.

FOR = *ATTRIBUTES
Outputs all pubres devices which have the PUBRES-FOR-ASSIGNMENT attribute.

SNAP-DEVICE =
Selects the devices on the basis of whether they are configured as snap units (see "Special devices").

SNAP-DEVICE = *ANY
No selection.

SNAP-DEVICE = *NO
Outputs all devices which are not configured as snap units.

SNAP-DEVICE = *YES
Outputs all devices which are configured as snap units.

PAV-ATTRIBUTE =
Selects devices on the basis of whether they are configured as PAV/DPAV (base device or alias device). See "Parallel access volume (PAV, SU /390)".

PAV-ATTRIBUTE = *ANY
No selection.

PAV-ATTRIBUTE = *PAV
Outputs all detected base or alias devices.

PAV-ATTRIBUTE = *NO-PAV
Outputs all devices that are not base or alias devices.

PAV-ATTRIBUTE = *BASE
Outputs all detected base devices.

PAV-ATTRIBUTE = *ALIAS
Outputs all detected alias devices.

PAV-ATTRIBUTE = *NO-ALIAS
Outputs all devices that are not alias devices.

FastDPAV alias devices are displayed with selection *ANY, *NO-PAV or *NO-ALIAS.

INFORMATION =
Specifies the output information.

INFORMATION = *STD
Outputs detailed information on each device. If the device is assigned to several VMs, only the number of VMs is output.

INFORMATION = *ALL
Outputs detailed information on each device. If the device is assigned to several VMs, all VMs are output. In addition, the PAV property of the device may be output.

INFORMATION = *VM-SUMMARY
Compact output of the devices which are assigned to a VM, sorted by VMs. Devices are then output which can still be assigned to a VM.

INFORMATION = *PAV
Outputs detailed device information including the configuration of the PAV/DPAV devices (base and alias devices).

Command return codes

(SC2) SC1	Main code	Meaning
0 2 0 2 0 1 0 1 0 2 0 2 0 2 0 64 64 64 64 64 64 64	CMD0001 CMD0001 VMS4001 VMS4035 VMS4180 VMS4238 VMS4403 VMS4613 VMS3002 VMS3037 VMS4000 VMS4200 VMS4223 VMS4400 VMS4600	Command successfully executed Command successfully executed; not all devices available No VM with appropriate name found No corresponding device found (SELECT) Specified set of devices empty Only information on pubres device (PUBSET-DEVICES) No VM belongs to VM group No VM has been assigned to CPU pool Invalid operand value (e.g. TYPE or DEVICE-RANGE) UNITS=STD, no additional selection and input from console or via $VMCONS VM not yet created Assignment set not yet created Command not executed (operand PUBSET-DEVICES) VM group not yet created CPU pool not yet created

Guaranteed messages

Only if UNITS is specified without *DEVICE-RANGE and without wildcards: VMS4006

Output in S variables (in user task)

The INFORMATION operand of the command is used to specify which S variables are to be supplied with values. The following can be specified for INFORMATION:

Notation of command	Abbreviated form used in table
INFORMATION = STD INFORMATION = ALL INFORMATION = PAV INFORMATION = VM-SUMMARY	1 2 3 4

Output information	Name of S variable	T	Contents	Cond.
Mnemonic device name	var(*LIST).MN	S	<alphanum-name 2..2> <x-text 4..4>	1,2,3
Device type	var(*LIST).TYPE	S	<name 1..8>	1,2,3
Can the device be used as a virtual console?	var(*LIST).VC	B	TRUE / FALSE	1,2,3
Is the device configured as a snap unit?	var(*LIST).SNAP	B	TRUE / FALSE	1,2,3
Can the device be assigned implicitly by the guest system?	var(*LIST).ASS-BY-GUEST	B	TRUE / FALSE	1,2,3
Assignment set to which the device is assigned	var(*LIST).ASSIGNMENT-SET	S	<name 1..8> / NONE / STDSET	1,2,3
Does the device have attribute `PUBRES-FOR-ATTRIBUTES`?	var(*LIST).PUBRES-FOR-ATTR	B	TRUE / FALSE	1,2,3
PAV attribute of the device	var(*LIST).PAV-ATTR	S	NO-PAV / BASE / *ALIAS	1,2,3
Base device of the alias device (PAV/DPAV)	var(*LIST).BASE-MN	S	<alphanum-name 2..2> <x-text 4..4> *NONE	1,2,3
Alias devices of the base device (PAV/DPAV)	var(LIST).ALIAS(LIST).ALIAS-MN	S	<alphanum-name 2..2> <x-text 4..4>	1,2,3
Usage mode	var(*LIST).USAGE	S	EXCL / SHARED / *UNDEF	1,2,3
Type of I/O processing	var(*LIST).IO-MODE	S	UNDEF / DIRECT / *INDIRECT	1,2,3
Index of the VM to which the device is assigned	var(LIST).ASS(LIST).TO-VM-INDEX	I	<integer 1..99>	1,2,3
Name of the VM to which the device is assigned	var(LIST).ASS(LIST).TO-VM-NAME	S	<name 1..8>	1,2,3
Who assigned the device to the VM?	var(LIST).ASS(LIST).BY	S	VM-ADMIN GUEST	1,2,3
Was the device assigned to the VM as a pubres device?	var(LIST).ASS(LIST).PUBRES-FOR- ASSIGN	B	TRUE / FALSE	1,2,3
Is the device in KEEP mode?	var(LIST).ASS(LIST).KEEP	B	TRUE / FALSE	1,2,3
The VM index	var(*LIST).VM-INDEX	I	<integer 0..99> ¹	4
Name of VM	var(*LIST).VM-NAME	S	<name 1..8> *NONE ¹	4
Mnemonic device name	var(LIST).UNIT(LIST).MN	S	<alphanum-name 2..2> <x-text 4..4>	4
Who assigned the device to the VM?	var(LIST).UNIT(LIST).ASS-BY	S	VM-ADMIN / GUEST / *UNDEF	4
Usage mode	var(LIST).UNIT(LIST).USAGE	S	EXCL / SHARED / *UNDEF	4
Is the device in KEEP mode?	var(LIST).UNIT(LIST).KEEP	B	TRUE / FALSE	4
Is the device a virtual console?	var(LIST).UNIT(LIST).VC	B	TRUE / FALSE	4

¹0 or *NONE as VM identification for devices that are not assigned to a VM

Output format for INFORMATION = STD / ALL

Example (INFORMATION=*ALL)

UNIT DEV-TYPE PAV   S ASSIGN-SET  USAGE VM-ID/(#VM) ASSIGNED-BY
D3   D3435            SYS2IMPL    SH(I)    ( 2)     MIXED 
                                         1 MONITOR  VM-ADMIN
                                         2 SYSTEM2  GUEST
D4   D3435            SYS2IMPL(P) SH(D)  2 SYSTEM2  GUEST 
D5   D3435            SYS2IMPL    EXCL   2 SYSTEM2  VM-ADMIN(P) 
CC42 HNC              SYS2IMPL    EXCL   2 SYSTEM2  GUEST 
CC43 HNC              SYS2IMPL    EXCL   2 SYSTEM2  GUEST

Meaning of the output columns

UNIT

Mnemonic device name.

DEV-TYPE

Device type (*VC for virtual consoles).

PAV

PAV/DPAV attribute of the device.

`BASE`	The device is a base device.
`ALIAS`	The device is an alias device.

S

SNAP attribute of the device.

S The device is configured as a snap unit.

ASSIGN-SET

Assignment set of the device.

*STDSET / <name 1..8> Name of the assignment set.
...(P) This suffix indicates a pubres device with attribute PUBRES-FOR-ATTRIBUTES (see "Assigning and removing pubsets of a VM ").

USAGE

Usage mode of the device.

`EXCL`	The device is used exclusively by a VM.
`SH(D)`	The device is only assigned to one VM. Inputs/outputs are processed directly. The device can be assigned to other VMs for shared use.
`SH(I)`	The device is currently assigned to more than one VM. The inputs/outputs are processed indirectly.

VM-ID/(#VM)

Identification of the VM (<vm-index> <vm-name>) when the device is assigned in the EXCL or SH(D) usage mode, or (n, n>=1) number of VMs that share the device (SH(I) usage mode).
For INFORMATION=*ALL, output lines follow that (only) in this output column and the ASSIGNED-BY column show the identification of the VMs that share the device and the type of device assignment.

ASSIGNED-BY

Specifies who the device was assigned to the VM by:

`VM-ADMIN`	Device assigned explicitly by the VM or VM2000 administrator.
`VM-ADMIN(P)`	Device assigned explicitly as pubres device by the VM or VM2000 administrator. The pubres device therefore has the `PUBRES-FOR-ASSIGNMENT` attribute for this VM (see "Assigning and removing pubsets of a VM").
`GUEST`	Device assigned to the VM implicitly by the guest system.
`GUEST(KEEP)`	After detachment the implicit assignment for an (MTC) device is preserved (see "Assignment sets, implicit device assignment and release").
`MIXED`	Device assigned to multiple VMs as a shareable device in various procedures. This display appears only in the output line with the number of VMs which share this device.

Output format for INFORMATION = *PAV

Example

UNIT DEV-TYPE PAV   S ASSIGN-SET  USAGE VM-ID/(#VM) ASSIGNED-BY
2300 D3435    BASE                EXCL   1 MONITOR  VM-ADMIN
              (BASE: 2300; ALIAS: 2310,2320,2330)

Meaning of the output columns

The meaning of the output columns corresponds to INFORMATION=*STD.

For each base or alias device, the output line is followed by an information line that indicates the structure of the PAV (i.e. base device and associated alias devices):

(BASE: <mn>; ALIAS: <mn>,...)

Output format for INFORMATION = *VM-SUMMARY

Example

VM-ID        UNITS
 1 MONITOR   ASSIGNED BY VM-ADMIN
             EXCL:   C2,C3,V0,V1,2430,2431,2432,2433
             SHARED: 22F4,22F5,22F6,22F7,58F2
             ASSIGNED BY GUEST
             SHARED: E062
 2 SYSTEM2   ASSIGNED BY VM-ADMIN
             EXCL:   CH,CI,E05F,E060,E061
             SHARED: E062
DISPOSABLE   UNASS:  CB,CC,CD,CE,CF,CG,CJ,CK,...
             SHARED: 22F4,22F5,22F6,22F7,58F2,E062,...

Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.
DISPOSABLE The devices can be assigned to a VM.

UNITS

The output of the devices assigned to a VM takes place VM-specifically in blocks: first the explicitly assigned devices (ASSIGNED BY VM-ADMIN), then the implicitly assigned devices (ASSIGNED BY GUEST). The output is grouped in accordance with the usage mode (EXCL/SHARED/KEEP). Empty blocks or groups are omitted.

The output of the devices that can be assigned to a VM (DISPOSABLE) is grouped by its type (UNASS/SHARED/KEEP). See the /SHOW-VM-DEVICE-STATUS operand STATE=*DISPOSABLE. Empty groups are omitted.

The device list is arranged in ascending order of the value range (two- or four-digit). The two-digit device names are output first, followed by the four-digit device names.

For SU /390 the suffix (VC) identifies a device that is used or can be used as a virtual console (see "Operating the guest systems (VC dialog via $VMCONS)").

Example

/show-vm-device-status units=*std,information=*all, select=*par(assign-by-guest=*yes(set-name=sys2impl)) —————————  (1)
UNIT DEV-TYPE PAV   S ASSIGN-SET  USAGE VM-ID/(#VM) ASSIGNED-BYD3   D3435            SYS2IMPL    SH(I)    ( 2)     MIXED —————————————  (2) 1 MONITOR  VM-ADMIN
                                         2 SYSTEM2  GUESTD4   D3435            SYS2IMPL(P) SH(D)  2 SYSTEM2  GUEST —————————————  (3)D5   D3435            SYS2IMPL    EXCL   2 SYSTEM2  VM-ADMIN(P)
CC42 HNC              SYS2IMPL    EXCL   2 SYSTEM2  GUEST —————————————  (4)CC43 HNC              SYS2IMPL    EXCL   2 SYSTEM2  GUEST
/show-vm-device-status units=*std,information=*pav,   select=*par(state=*disposable,pav-attribute=*base) ————  (5)
UNIT DEV-TYPE PAV   S ASSIGN-SET  USAGE VM-ID/(#VM) ASSIGNED-BY2300 STDDISK  BASE (BASE: 2300; ALIAS: 2310,2320,2330)2301 STDDISK  BASE              (BASE: 2301; ALIAS: 2311,2321,2331)2302 STDDISK  BASE              (BASE: 2302; ALIAS: 2312,2322,2332)... (output abbreviated)5400 STDDISK  BASE (BASE: 5400; ALIAS: 540C)

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

(1)	The VM2000 administrator obtains detailed information on the status of the devices of assignment set `SYS2IMPL`. With `INFORMATION=*ALL`, all VMs are output to which a device is assigned in the `SH(I)` usage mode.
(2)	Disk `D3` is assigned to the VMs `MONITOR` and `SYSTEM2` for shared use. The usage mode is therefore `SH(I)` (`SHARED` with indirect I/O). `D3` has been assigned to `MONITOR` explicitly and to `SYSTEM2` implicitly.
(3)	In the case of implicit device assignment, the disk devices are assigned in the usage mode `SHARED`. Input/output takes place by means of direct I/O because the devices are initially assigned to only one VM.
(4)	In the case of implicit device assignment, other devices (see "Assignment sets, implicit device assignment and release") are assigned in the usage mode `EXCLUSIVE`.
(5)	The VM2000 administrator finds out which base devices (PAV) are free. Detailed information is to be displayed on the configuration of the PAV devices (base and alias devices).

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

See also the detailed examples for device and pubset management ("Example of peripheral device management" and "Example of pubset management").

Your Browser is not longer supported

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

SHOW-VM-DEVICE-STATUS (Output detailed device information)

Command return codes

Guaranteed messages

Output in S variables (in user task)

Output format for INFORMATION = STD / ALL

Meaning of the output columns

Output format for INFORMATION = *PAV

Meaning of the output columns

Output format for INFORMATION = *VM-SUMMARY

Meaning of the output columns

Example

Your Browser is not longer supported

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

SHOW-VM-DEVICE-STATUS (Output detailed device information)

Command return codes

Guaranteed messages

Output in S variables (in user task)

Output format for INFORMATION = *STD / *ALL

Meaning of the output columns

Output format for INFORMATION = *PAV

Meaning of the output columns

Output format for INFORMATION = *VM-SUMMARY

Meaning of the output columns

Example

Output format for INFORMATION = STD / ALL