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-DEVICE-CONFIGURATION

&pagelevel(3)&pagelevel

Display system configuration and hardware unit availability

Component:

BS2000

Functional area:

Device management

Domain:

DEVICE

Privileges:

STD-PROCESSING
OPERATING
HARDWARE-MAINTENANCE
SW-MONITOR-ADMINISTRATION

Routing code:

E

Function

This command provides information about the system configuration and the availability of hardware units (see also section "Information services of device management: Meanings of the output values of SHOW commands").

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

Format

SHOW-DEVICE-CONFIGURATION

UNIT = *STD / *SELECT(...) / *CPU(...) / *CHANNEL(...) / *CONTROLLER(...) /

*CHANNEL-RANGE(...) / *PUBSET-DEVICES(...) /

list-poss(26): <alphanum-name 2..2 with-wild(20)> / <alphanum-name 4..4 with-wild(20)>


*SELECT(...)



|


CLASS = *ALL / *CENTRAL-PROCESSOR / *CHANNEL / *CONTROLLER / *DEVICE(...)



|



*DEVICE(...)



|




|


TYPE = *ALL / <device>



|




|


,VM-ASSIGNMENT = *ANY / *NO / *YES / *BY-GUEST-POSSIBLE



|


,ATTRIBUTE = *ALL / *ATTACHED / *DETACHED / *DETACH-PENDING / *ATTACH-PENDING /



|


INVALID / *ENABLED / *DISABLED


*CPU(...)



|


CPU-IDENTIFIER = list-poss(26): <alphanum-name 2..2 with-wild(10)>


*CHANNEL(...)



|


CHANNEL-PATH-ID = list-poss(26): <alphanum-name 2..2 with-wild(10)>


*CONTROLLER(...)



|


CONTROLLER-UNIT = list-poss(26): <alphanum-name 2..2 with-wild(20)> /



|


<alphanum-name 4..4 with-wild(20)>


*CHANNEL-RANGE(...)



|


FROM = <alphanum-name 2..2>



|


,TO = <alphanum-name 2..2>


*PUBSET-DEVICES(...)



|


PUBSET = <cat-id 1..4> / *BY-PUBRES-DEVICE(...)



|



*BY-PUBRES-DEVICE(...)



|




|


UNIT = <alphanum-name 2..2> / <x-text 4..4>

,INFORMATION = *STD / *INNER / *OUTER / *ALL / *PATH / *VM2000 / *PAV

Operands

UNIT = *STD / *SELECT(...) / *CPU(...) / *CHANNEL(...) / *CONTROLLER(...) / *CHANNEL-RANGE(...) / *PUBSET-DEVICES(...) / list-poss(26): <alphanum-name 4..4>
Selection of hardware units by device class or device mnemonic (2 or 4 symbols). A maximum of 26 device mnemonics may be specified.

UNIT = *STD
The default value is output for all generated units. Users should note that the output may be very extensive.
The command is rejected if entered at the console, since the output of the entire configuration can be extensive and may occupy the operating terminal for too long.

UNIT = *SELECT(...)
Specifies a subset of the hardware units known to the system for which information is to be output. Hardware units are selected by the following device class and state:

CLASS = *ALL / *CENTRAL-PROCESSOR / *CHANNEL / *CONTROLLER / *DEVICE(...)
Device class. Default information is output for all hardware units belonging to the device class specified.
The following device classes can be specified:

Operand value (device class)

Meaning

*ALL

any device class

*CENTRAL-PROCESSOR

central processors

*CHANNEL

channels

*CONTROLLER

controllers

*DEVICE(...)

devices

CLASS = *DEVICE(...) 
Information on devices is output.

TYPE = *ALL / <device>
Information on devices belonging to the specified type is output. The default setting is *ALL, i.e. all device types are displayed. If a device type is explicitly specified then only device or volume types known within the system are accepted.
To display the possible types, enter TYPE=? in the dialog.

The device type can be specified for all devices (see see also the device table (device type column) of the “System Installation” manual [46]). For tape devices, volume types can also be specified (see section "Device types for DMS tape processing").

VM-ASSIGNMENT = *ANY / *NO / *YES / *BY-GUEST-POSSIBLE
If INFORMATION=*VM2000 is specified, information is displayed on terminal devices which possess the specified status. The default setting is *ANY, i.e. output is independent of the status.

VM-ASSIGNMENT = *NO
Information is displayed on terminal devices which are not assigned to the user’s own VM.

VM-ASSIGNMENT = *YES
Information is displayed on terminal devices which are assigned to the user’s own VM.

VM-ASSIGNMENT = *BY-GUEST-POSSIBLE
Information is displayed on terminal devices which are not assigned to the user’s own VM. but which can currently be assigned explicitly (e.g. with the ATTACH-DEVICE command). 

ATTRIBUTE = *ALL / *ATTACHED / *DETACHED / *DETACH-PENDING / *ATTACH-PENDING / INVALID /
* ENABLED / *DISABLED
Specifies the state of hardware units for which default information is to be output. The following states can be specified:

Operand value (state)

Information about

*ALL

Hardware units in any state

*ATTACHED

Hardware units attached to the system

*DETACHED

Hardware units detached from the system

*DETACH-PENDING

Hardware units which are currently assigned but will be unavailable when the assignment ends

*ATTACH-PENDING

Hardware units which are currently not available owing to ATTACH processing

*INVALID

Unusable hardware units (see the “System Installation” manual [46])

*ENABLED

All FastDPAV alias devices in the ENABLED state (FastDPAV see "Introduction to System Administration" [14])

*DISABLED

All FastDPAV alias devices in the DISABLED state

When specifying the operand values *ATTACHED, *DETACHED, *ATTACH-PENDING, *DETACH-PENDING, and *INVALID, no FastDPAV alias devices are output.

UNIT = *CPU(...)
Denotes one or more CPUs for which information is output.

CPU-IDENTIFIER = list-poss(26): <alphanum-name 2..2 with-wild(10)>
Identifiers for the CPUs.

UNIT = *CHANNEL(...)
Denotes one or more channels for which information is output.

CHANNEL-PATH-ID = list-poss(26): <alphanum-name 2..2 with-wild(10)>
Channel path IDs for the channels. In the case of channels, the device name (MN) is the same as the channel path ID in hexadecimal representation.

UNIT = *CONTROLLER(...)
Denotes one or more controllers for which information is output.

CONTROLLER-UNIT = list-poss(26): <alphanum-name 2..2 with-wild(20)> /
<alphanum-name 4..4 with-wild(20)>
Mnemonic device names (MN) of the controllers.

UNIT = *CHANNEL-RANGE(...)
Denotes a range of channels for which information is output.

FROM = <alphanum-name 2..2>
First channel path ID of a range of channels.

TO = <alphanum-name 2..2>
Last channel path ID of a range of channels.

UNIT = *PUBSET-DEVICES(...)
Specifies that information on a pubset’s disks is to be output.
The pubset must have been imported at least once. The mnemonic device codes (MNs) of the associated disks are administered in the system disk’s SVL. This entry is made on IMPORT-PUBSET, EXPORT-PUBSET or MODIFY-PUBSET-PROCESSING. If the system disk or the associated mirror disk is not attached then it is implicitly attached and the information is then read from the SVL before the disk is implicitly detached again. Under VM2000, the disk must also be assigned to the guest system.
If pubset disks are mirrored then the following should be noted:

  • In the case of mirroring with DRV, both disks are output.

  • In the case of mirroring in a disk storage system then only the standard disks (source units) are output. If the mirror disks are to be output, then the mirror disk (target unit) of the system disk (pubres) must be specified in the PUBSET operand. For detailed
    information on mirroring in disk storage systems, see, for example, the “SHC-OSD” manual [37].

PUBSET =
Designates the pubset whose disks are to be output. The pubset can be specified via the catalog ID or the device code of its system disk.

PUBSET = <cat-id 1..4> 
Specifies the pubset’s catalog ID. A corresponding entry must exist in the MRS catalog. If no such entry exists then the disks can only be output by specifying the system disk (see PUBSET=*BY-PUBRES-DEVICE).

PUBSET = *BY-PUBRES-DEVICE(...) 
Specifies the pubset’s system disk (pubres).

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

UNIT = list-poss(26): <alphanum-name 2..2 with-wild(20)> / <alphanum-name 4..4 with-wild(20)>
Denotes one or more devices for which information is output, using their mnemonic device names (2 or 4 alphanumeric characters; see Notes). A maximum of 26 devices can be specified.

INFORMATION = *STD / *INNER / *OUTER / *PATH / *ALL / *VM2000 / *PAV
Type of information desired. If UNIT=*SELECT is specified, only standard information is output, i.e. any specification other than *STD is ignored.
A header line is output, followed by a new line for each device containing the values.

INFORMATION = *STD
Default information. 

Output format:

  MNEM        UN-CLASS    UN-TYPE      CONF-STATE        POOL/SIDE

INFORMATION = *INNER
In addition to the default information, information about all inner connections (i.e. from the specified unit to the CPU) is output.

Output format:

UN-TYPE      CONF-STATE        INNER CONNECTION

INFORMATION = *OUTER
In addition to the default information, information about all outer connections (i.e. from the specified unit to peripherals) is output.

Output format:

UN-TYPE      CONF-STATE        OUTER CONNECTION

INFORMATION = *ALL
In addition to the standard information, information about all internal and external connections of the designated units is output.

INFORMATION = *PATH
Information about the possible I/O paths of the designated terminals and their status is output. In the case of devices with path groups (disk and MTC devices), output may be delayed since the command triggers an internal update of the path statuses with
Sense-Path-Group-Id.

Output format:

DVC  DEV-TYPE CONF-STATE PID  CTL  CHPID PM  DEV-ADDR PATH

INFORMATION = *VM2000 

Information on possible assignment to the own VM and on usage mode.

The VM2000 specific information of this command is described in detail in the VM2000 manual [50].

Output format:

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

INFORMATION = *PAV
Information on PAV devices (Parallel Access Volumes, see the “Introduction to System Administration” [14]). The basic device name and the alias device names (max. 7) combined with the relevant status information are output for each logical PAV device. 

Output format:

BASE     ALIAS1    ALIAS2    ALIAS3      ALIAS4 ...     ALIAS7

For FastDPAV devices, when entering UNIT=*CONTROLLER(...), the basis control and alias control names are output additionally, as well as the number of FastDPAV devices in the state ENABLED and DISABLED. The column MAX USED shows the maximum number of FastDPAV devices simultaneously used at alias controlling. 

Output format:

FPAV BASE CTL   FPAV ALIAS CTL   ENABLED ALIAS   DISABLED ALIAS   MAX USED

Note:

  • For the DVC device class, no external connections exist.

  • For the CPU device class, no defined connections exist.

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

4

1

NKD0001

Syntax error in subprocedure


1

NKD0013

Syntax error in SHOW-DEVICE-CONFIGURATION


32

CMD2009

Error on output to S variable (e.g. subsystem not available)


64

NKD0002

No information available


64

NKD0006

Internal error during initialization of the command server or: Syntax error in NKDDEVC procedure


64

NKD0024

No information available for <unit class> and <config state>


64

NKD0025

No information available for <unit> and <information>


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)

Note

Mnemonics which cannot be generated are treated as unknown mnemonics. 

Examples

Example 1: Information about an device

/show-dev-conf unit=hf

%  MNEM UN-CLASS UN-TYPE  CONF-STATE   POOL/SIDE
%  HF   DVC      3590E    DET(EX)        SW

/show-dev-conf unit=hf,inf=*inner

%  MNEM UN-CLASS UN-TYPE  CONF-STATE  INNER-CONNECTION
%  HF   DVC      3590E    DET(EX)     CTL    :HY  ,INCLUDED
%                                     CTL    :HZ  ,INCLUDED

/show-dev-conf unit=8000,inf=*path

%DVC  DEV-TYPE CONF-STATE PID  CTL  CHPID PM DEV-ADDR PATH 
%8000 D3435    DET(EX)    007C 8000 0A    80 0A000000 AVAIL
%                              8000 0D    40 0D000000 AVAIL
%                              8001 4A    20 4A000000 AVAIL
%                              8001 4B    10 4B000000 AVAIL
Example 2: Information about CPUs (S210-40 system with 1 spare CPU)

/show-dev-conf unit=*select(class=*central-proc)

%  MNEM UN-CLASS UN-TYPE  CONF-STATE   POOL/SIDE
%  00   CPU       S210-40 ATTACH /ON     NORMAL
%  01   CPU       S210-40 ATTACH /ON     NORMAL
%  02   CPU       S210-40 ATTACH /ON     NORMAL
%  03   CPU       S210-40 ATTACH /ON     NORMAL
%  04   CPU       S210-40 DET(EX)/OFF    SPARE

/show-dev-conf unit=*cpu(00),inf=*outer

%  NKD0030 OPERAND CHANGED TO 'INFORMATION = STD'. PROCESSING CONTINUES
%  MNEM UN-CLASS UN-TYPE  CONF-STATE   POOL/SIDE
%  00   CPU       S210-40 ATTACH /ON     NORMAL

Example 3: Information about CPUs (S210-20 system with 1 extra and 1 spare CPU)

/show-dev-conf unit=*select(class=*central-proc)

%  MNEM UN-CLASS UN-TYPE  CONF-STATE   POOL/SIDE
%  00   CPU       S210-20 ATTACH /ON     NORMAL
%  01   CPU       S210-20 ATTACH /ON     NORMAL
%  02   CPU       S210-20 DETACH /OFF    EXTRA
%  03   CPU       S210-20 DETACH /OFF    SPARE
Example 4: Information about an controller

/show-dev-conf unit=*contr(contr-unit=2900)

%  MNEM UN-CLASS UN-TYPE  CONF-STATE  INNER-CONNECTION
%  2900 CTL      DISK01   ATTACHED    CHN    :4A  ,INCLUDED
%                                     WWPN=500000E0DAC19A00
%                                     CHN    :0D  ,INCLUDED
%                                     WWPN=500000E0DAC19AC5

Output in S variables

The command's INFORMATION operand identifies the S variables which are to be created. The following values are possible for INFORMATION: *STD/*ALL/*INNER/OUTER/*PATH/*VM2000 and *PAV.

Output information

Name of the S variable

T

Contents                

Condition

Mnemonic base name of a PAV device
x='P' for Prefered Device, otherwise '-'
y= 'A' for Active, 'R' for Ready or 'N' for Not Ready

var(*LIST).BASE

S

<mnemo-name>-xy
x = 'P' / '-'
y = 'A' / 'R' / 'N'

INF=*PAV

Mnemonic alias name n of a PAV device (for a definition of the extension xy, see BASE), where x = 'F' of a FastDPAV device

var(*LIST).ALIASn

S

<mnemo-name>-xy
x = 'F' / 'P' / '-'
y = 'A' / 'R' / 'N'

INF=*PAV

Device class
*CHN: channel
*CTL: device controller
*CPU: CPU
*DVC: device

var(*LIST).CLASS

S

*CHN
*CTL
*CPU
*DVC

INF=ALL/
INNER/
OUTER/
STD

Configuration state

var(*LIST).CONF-STA

S

ATTACHED
ATTACH-PENDING
DETACHED
DETACH-PENDING
DETACH-PEND(EX)
DETACH-PEND
(EX+IM)
DETACH-PEND(IM)
DETACHED
(EXPLICIT)
DETACHED(EX+IM)
DETACHED
(IMPLICIT)
INVALID

INF=ALL/
INNER/
OUTER/
PATH/
STD

Channel path ID of the I/O path

var(*LIST).CONN(*LIST).CHAN-PATH-ID

S

<mnemo-name>

INF=PATH

Device class of the inner or outer unit

var(*LIST).CONN(*LIST).CLASS

S

*CHN
*CTL
*CPU
*DVC

INF=INNER/
OUTER

I/O path control unit

var(*LIST).CONN(*LIST).CONTR-UNIT

S

’’
<mnemo-name>

INF=PATH

Path mask

var(*LIST).CONN(*LIST).PATH-MASK

S

’’
<mnemo-name>

INF=PATH

Physical address of the I/O path

var(*LIST).CONN(*LIST).PHYS-ADDR

S

<cuu>

INF=PATH

Configuration status of the I/O path or

var(*LIST).CONN(*LIST).STA


S

AVAIL
NOT-AVAIL

INF=PATH

Configuration status of the inner or outer unit

S

INCLUDED
INVALID
REMOVED
REMOVED
(EXPLICIT)
REMOVED
(IMPLICIT)
REMOVED(EX+IM)
REMOVE-PENDING
REMOVE-PEND(EX)
REMOVE-PEND(IM)
REMOVE-PEND
(EX+IM)

INF=INNER/
OUTER

Device mnemonic of the inner or outer unit

var(*LIST).CONN(*LIST).UNIT

S

<mnemo-name>

INF=INNER/
OUTER

WWPN of the FC channel

var(*LIST).CONN(*LIST).WWPN

S

<wwpn>

INF=INNER

Configuration status of the CPU

var(*LIST).CPU(*LIST).CONF-STA

S

ATTACHED
ATTACH-PENDING
DETACHED
DETACH-PENDING
DETACH-PEND(EX)
DETACH-PEND
(EX+IM)
DETACH-PEND(IM)
DETACHED
(EXPLICIT)
DETACHED(EX+IM)
DETACHED
(IMPLICIT)
ENABLED
DISABLED
INVALID

INF=STD

CPU ID

var(*LIST).CPU(*LIST).ID

S

<mnemo-name>

INF=STD

Number of FastDPAV devices in the DISABLED configuration mode

var(*LIST).DISABLED-ALIAS

I

<integer>

INF=PAV

Number of FastDPAV devices in the ENABLED configuration mode

var(*LIST).ENABLED-ALIAS

I

<integer>

INF=PAV

Device mnemonic of FastDPAV alias controlling

var(*LIST).FPAV-ALIAS-CTL

S

<mnemo-name>

INF=PAV

Device mnemonic of FastDPAV base controlling

var(*LIST).FPAV-BASE-CTL

S

<mnemo-name>

INF=PAV

Hardware status

var(*LIST).HARDWARE-STA

S

’’
OFF
ON

INF=ALL/
INNER/
OUTER/
STD

Device class of the inner unit

var(*LIST).INNER-CONN(*LIST).CLASS

S

*CHN
*CTL
*CPU
*DVC

INF=ALL

Configuration status of the inner unit

var(*LIST).INNER-CONN(*LIST).STA

S

INCLUDED
INVALID
REMOVED
REMOVED
(EXPLICIT)
REMOVED
(IMPLICIT)
REMOVED(EX+IM)
REMOVE-PENDING
REMOVE-PEND(EX)
REMOVE-PEND(IM)
REMOVE-PEND
(EX+IM)

INF=ALL

Device mnemonic of the inner unit

var(*LIST).INNER-CONN(*LIST).UNIT

S

<mnemo-name>

INF=ALL

Maximum number of simultaneously used FastDPAV alias devices at alias controlling

var(*LIST).MAX-USED

I

<integer>

INF=PAV

Device class of the outer unit

var(*LIST).OUTER-CONN(*LIST).CLASS

S

*CHN
*CTL
*CPU
*DVC

INF=ALL

Configuration status of the outer unit

var(*LIST).OUTER-CONN(*LIST).STA

S

INCLUDED
INVALID
REMOVED
REMOVED
(EXPLICIT)
REMOVED
(IMPLICIT)
REMOVED(EX+IM)
REMOVE-PENDING
REMOVE-PEND(EX)
REMOVE-PEND(IM)
REMOVE-PEND
(EX+IM)

INF=ALL

Device mnemonic of the outer unit

var(*LIST).OUTER-CONN(*LIST).UNIT

S

<mnemo-name>

INF=ALL

ID of the physical device used for I/O

var(*LIST).PHYS-DEV-ID

S

''
<phys-dev-id>

INF=PATH

Shared availability of a device (CLASS=*CTL/*DVC); displayed with NONE, SHARED or SWITCHABLE or CPU attribute (CLASS=*CPU); displayed with NORMAL, EXTRA, SPARE or ERROR

var(*LIST).POOL-ATTR

S

NONE
SHARED
SWITCHABLE
NORMAL
EXTRA
SPARE
ERROR

INF=STD

Hardware unit type (with INF=PATH this refers to a terminal device)

var(*LIST).TYPE

S

<cpu-type>
<device-type>
BLCK-MUX
FL-DISK
IBL
IBL(XS)
IBF/FCP
IBS/CNC
IBY
IBY(XS)
IE1(XS)
L-PRNTR
MBS/SEL
OFFL/SEL
PPS/BLM
SBL
SBL(XS)
SBS/SEL
SBY
SBY(XS)
SELECTOR

INF=ALL/
INNER/
OUTER/
PATH/
STD

Hardware unit mnemonic (configuration element)
(with INF=PATH this refers to a terminal device)

var(*LIST).UNIT

S

<mnemo-name>

INF=ALL/
INNER/
OUTER/
PATH/
STD

Assignment mode or option of the own VM

var(*LIST).VM-ASS

S

BY-GUEST
BY-VM-ADM
VM-INHIBIT
DEV-INHIBIT
ELSEWHERE
BY-GUEST-
POSSIBLE

INF=*VM2000

Utilization by a  VM

var(*LIST).VM-USAGE

S

NONE
EXCL
SH(D)
SH(I)

INF=*VM2000

Powered by Atlassian Confluence and Scroll Viewport.