Show information about assignment, DISK parameters and monitoring of disks
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | STD-PROCESSING |
Routing code: | E |
Function
The SHOW-DISK-STATUS command provides information relating to the assignment, disk parameters and volume monitoring of the specified disks. The VSN of the disk can also be specified using a wildcard. The information displayed refers to the reserving disk, irrespective of which volume is physically online (in contrast to SHOW-DEVICE-STATUS). Nonprivileged users are shown information only on private disks on which their own jobs have reserved space.
The various output fields and their functions are described in 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").
Privileged functions
System support staff are supplied with information for all devices. If they select *TASK or *SYSTEMS with the INFORMATION operand they are shown all the available information.
Format
SHOW-DISK-STATUS | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
UNIT = *SELECT(...) / *VOLUME(...) /list-poss(26): <alphanum-name 2..2 with-wild(20)> /
<alphanum-name 4..4 with-wild(20)>
Selection of disks by attributes, volume serial numbers or the mnemonic (two- or four-character) device name of the device on which the disk is mounted. At most 26 mnemonic device names are permitted.
Mnemonic device names that cannot be generated are handled like non-generated devices.
UNIT = *SELECT(...)
Selection by attributes.
ATTRIBUTE =
Information is output for the disks with the specified attribute.
ATTRIBUTE = *ALL
Information is output for all specified disks.
ATTRIBUTE = *FREE / *EXCLUSIVE / *SHARE / *PUBLIC / *ONLINE / *MOUNTING / *IN-USE / *CANCELLED / *NO-DEVICE / *RECOVER / *DMS / *SPECIAL / *DISMOUNT / *UNLOCK / *SVL-UPDATE / *STD / *NON-STD / *BS1000
Default information is output for all disks with the specified attribute.
Possible specifications:
Operand value (device attribute) | Meaning |
|---|---|
*ALL | any attribute |
volume-allocation-state | |
*FREE | free |
*EXCL[USIVE] | exclusively reserved |
*SHARE | shareable |
device-allocation-state | |
*PUB[LIC] | public |
volume-phase | |
*ONLINE | mounted, but not assigned |
*MOUNTING | waiting for operator answer |
*IN-USE | assigned |
action-state | |
*CAN[CELLED] | permanently locked |
*NO-DEV[ICE | no device assignment |
*REC[OVER] | interrupt handling |
*DISMOUNT | REMOUNT or MOUNT message still pending |
*UNLOCK | UNLOCK job being executed |
*SVL-UPD[ATE] | system occupancy log being stored |
use-mode | |
*DMS | occupied by DMS application |
*SPECIAL | occupied by special application |
label-type | |
*STD | standard labels |
*N[ON]-STD | nonstandard labels |
*BS1000 | BS1000 labels |
UNIT = *VOLUME(...)
Specifies the volume serial numbers of the disks for which information is to be output.
VOLUME = list-poss(10): <vsn 1..6> / <alphanum-name 1..6 with-wild(30)>
Specifies the volume serial numbers (VSN, up to 6 characters) of the disks for which information is to be output.
A maximum of 10 VSNs can be specified.
With certain restrictions, wildcard characters may also be used in the volume serial numbers; an asterisk “*” may be specified in place of any character string. If two or more asterisks are entered, they must be separated in each case by at least one character.
UNIT = list-poss(26): <alphanum-name 2..2> / <alphanum-name 4..4>
Lists up to 10 disks for which information is to be output.
INFORMATION =
Type of information to be displayed. This operand is only evaluated if device names or volume serial numbers (UNIT or VOLUME operand) are used to select the disks. If ATTRIBUTE is specified, only INFORMATION=*STD is possible.
INFORMATION = *STD
For each private disk occupied by the task, a record is displayed with global occupancy and monitoring information (e.g. access by START-PROGRAM to a program on private disk).
INFORMATION = *PARAMETER
Parameters set with the SET-DISK-PARAMETER or SET-DISK-DEFAULTS command are displayed. Parameter values set with SET-DISK-DEFAULTS are marked with “(D)”. Output is independent of occupancy by the task.
No information can be requested for public disks with this operand.
INFORMATION = *TASK
For nonprivileged users, INFORMATION = *STD applies.
A list of the TSNs that are occupying this disk in DMS usage mode is displayed.
INFORMATION = *SYSTEMS
For nonprivileged users, only the first line for the disks occupied by them is displayed.
A list of systems occupying this disk is displayed.
INFORMATION = *ALL
For nonprivileged users, only STD, PARAMETER and SYSTEMS information is displayed.
Displays all four output records for the specified disks (*STD, *PARAMETER, *TASK, and the second output line of *SYSTEMS).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NKD0005 | Warning: information incomplete |
2 | 0 | NKD0030 | Warning: INFORMATION parameter changed |
1 | NKD0001 | Syntax error in the input, correction of the command parameters recovers the error | |
1 | NKD0013 | Syntax error in SHOW-DISK-STATUS | |
64 | NKD0002 | No information available | |
64 | NKD0005 | No information available for MN list | |
64 | NKD0006 | Software error in NKDDISC procedure | |
64 | NKD0032 | No information available for ATTRIBUTE | |
4 | 130 | NKD0010 | The disk monitor is temporarily not available; try again later |
Output formats
The output shows a header line followed by one values line for each disk specified. Five display formats are possible, depending on the entry made in the INFORMATION operand.
The meaning of the output columns and possible values are explained in section "Information services of device management: Meanings of the output values of SHOW commands".
1. Standard output record (INFORMATION=*STD)
Header line
MNEM VSN USE DEV-A VOL-A PHASE ACTION
Values
mn vsn use device volume volume action
mode allocation allocation phase state
state state
Note
The distinction between PAGING and PUBLIC assignments (dynamic paging area modification) also affects information columns DEV-A and VOL-A. The meanings of the possible combinations of values in these two columns are as follows:
DEV-A | VOL-A | Meaning |
|---|---|---|
PUBLIC | PUBLIC | The disk is imported and is not used for PAGING. |
PUBLIC | PAGING | The disk is imported and is used for PAGING. |
PAGING | PAGING | The disk is used exclusively for PAGING. |
PUB-DRV | PAGING | The disk is imported as a DRV volume and is used for PAGING. |
DRV-PAG | PAGING | The disk is used for PAGING in DRV mode. |
DRV-PAG | The matching second disk of a DRV pair is used for PAGING in DRV mode. | |
DMS-PAG | SHARE | The disk is used for PAGING and is also shareable for tasks. |
2. Output record for INFORMATION=*PARAMETER
Header line
ALLOC VSN TYPE SYS-ALLOC ASS-TIME USER-ALLOC OP-CTL ACCESS
Values
<Y/N> vsn device system assign user operator access
type allocation time allocation access mode
mode type control
3. Output record for INFORMATION=*TASK
Header line MNEM VSN TSN ́S Values mn vsn tsn,tsn,...
4. Output record for INFORMATION=*SYSTEMS
Header line 1 MNEM VSN TIME-STAMP SVL-RECORDING-MODE Values mn *vsn time-stamp svl-recording-mode Header line 2 MNEM VSN #PHYS-HALF-PAGES PAMKEY/FRMT Values mn *vsn #php pamkey/format Header line 3 (privileged users only) MNEM VSN VTOC-SYS SVL-ALLOC SYSTEMS Values mn *vsn vtoc-sys system allocation mode sys-id[,...]
where:
| = | disk format (2K or 4K) |
| = | yyyy-mm-dd hh:mm:ss (time of last occupancy of the disk) |
| = | designates the task in the user’s own system that is locking or wishes to lock the VTOC of the disk, but has not yet successfully completed the SVL I/O operation. |
| = | System ID of the system that is occupying the VTOC of the disk. In this phase, no VTOC operations by other systems are possible. |
Notes
Nonprivileged users are shown no information for public disks if they specify INFORMATION=*PARAMETER or *ALL.
Privileged users are shown no information if they specify INFORMATION=*PARAMETER or *TASK and are shown information only for *STD and *SYSTEMS if they specify INFORMATION=*ALL.If more than one disk with the same VSN exists within one system, only one record is displayed if INFORMATION=*PARAMETER or *TASK or *SYSTEMS is specified.
A VSN may appear in two or more output records: For all devices on which the volumes are also physically available.
MNs or VSNs which cannot be generated are handled like unknown MNs or VSNs. If VSNs are specified which are not known to the system at present, “empty” records containing only VSN and “NO ACTION” are returned. Only when “*” is specified in the VSN operand are no records output for unknown VSNs.
Examples
Example 1: Output for private disk with INFORMATION=*PARAMETER
/show-disk-sta *vol(work01),inf=*par
% ALLOC VSN TYPE SYS-ALLOC ASS-TIME USER-ALLOC OP-CTL ACCESS % Y WORK01 D3435 EXCL OPERATOR SHARE NO WRITE
Example 2: Output for private disk with INFORMATION=*SYSTEM
/show-disk-sta *vol(work01),inf=*sys
% MNEM VSN TIME-STAMP SVL-RECORDING-MODE % B156 WORK01 2017-02-27 07:04:09 SRV
Example 3: Output for private disk with INFORMATION=*ALL and device reservation information
/show-disk-sta *vol(work01),inf=*all
% MNEM VSN USE DEV-A VOL-A PHASE ACTION % B156 WORK01 DMS DMS SHARE IN-USE NO ACTION % ALLOC VSN TYPE SYS-ALLOC ASS-TIME USER-ALLOC OP-CTL ACCESS % Y WORK01 D3435 EXCL OPERATOR SHARE NO WRITE % MNEM VSN TIME-STAMP SVL-RECORDING-MODE % B156 WORK01 2017-02-27 07:04:09 SRV
/show-res-alloc
% MNEM TYPE VSN VOL-A TSN NAME/ID PHASE ACTION % B156 D3435 WORK01 SHARE 3QLJ ALF IN-USE NO ACTION
Output in S variables
The INFORMATION operand identifies the S variables which are to be created. The following values are possible for INFORMATION: *STD/*PARAMETER/*TASK/ *SYSTEMS/*ALL:
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Read or write access to data on the disk | var(*LIST).ACCESS | S | '' | INF=PAR |
Mount operation being performed for the disk from the volume monitoring system | var(*LIST).ACTION | S | '' | INF=STD |
Disk is allocated | var(*LIST).ALLOC | S | Y | INF=PAR |
Time of device assignment/release | var(*LIST).ASS-TIME | S | '' | INF=PAR |
Date of last disk allocation | var(*LIST).DATE | S | '' | INF=SYS |
Type of device allocation | var(*LIST).DEV-ALLOC | S | '' | INF=STD |
A REMOUNT or MOUNT message is pending for the DISMOUNT volume on this device | var(*LIST).DISMOUNT-ACTION | S | '' | INF=STD |
DISMOUNT volume | var(*LIST).DISMOUNT-VOL | S | '' | INF=STD |
Mnemnonic of the corresponding DRV unit | var(*LIST).DRV-UNIT | S | '' | INF=TASK |
Disk format | var(*LIST).FORM | S | '' | INF=SYS |
Inconsistency indicator in SVL (Standard Volume Lable) | var(*LIST).INCONS | S | YES | INF=SYS |
Disk capacity in PAM pages (PHP: physical half pages) | var(*LIST).NUM-OF-PHP | S | <number-of-php> | INF=SYS |
Amount of information for the operator about new disk allocations for tasks | var(*LIST).OPER-CONTR | S | '' | INF=PAR |
Use of the PAM key allowed | var(*LIST).PAM-KEY | S | '' | INF=SYS |
Disk monitoring mode | var(*LIST).PHASE | S | '' | INF=STD |
Recording mode last used for the disk | var(*LIST).REC-MODE | S | '' | INF=SYS |
Actual disk allocation mode | var(*LIST).SVL-ALLOC | S | '' | INF=SYS |
Disk operating mode for the system | var(*LIST).SYS-ALLOC | S | '' | INF=PAR |
System ID | var(*LIST).SYSID(*LIST) | S | '' | INF=SYS |
Time of last allocation | var(*LIST).TIME | S | '' | INF=SYS |
TSN of the task | var(*LIST).TSN(*LIST) | S | '' | INF=TASK |
Device type from which the information is retrieved | var(*LIST).TYPE | S | '' | INF=PAR |
Device unit mnemonic | var(*LIST).UNIT | S | '' | INF=TASK/ |
Usage mode in which the mounted volume is to be operated | var(*LIST).USE | S | '' | INF=STD |
Type of disk allocation request the user is allowed to make. | var(*LIST).USER-ALLOC | S | '' | INF=PAR |
VSN of the private disk | var(*LIST).VOL | S | '' | |
Mounted disk type | var(*LIST).VOL-ALLOC | S | '' | INF=STD |
System ID of the system currently holding the VTOC lock for the disk | var(*LIST).VTOC-SYS | S | '' | INF=SYS |