Display information on tapes and assigned devices
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | STD-PROCESSING |
Routing code: | E |
Function
The SHOW-TAPE-STATUS command provides information about tapes reserved for a user’s job. The VSN of the tape may also be specified using a wildcard character. The result is written to SYSOUT.
The information shown on online reserved tapes includes volume serial numbers, assigned device and the status of device monitoring (not with ATTRIBUTE=*UNMONITORED).
The output for offline reserved tapes (without monitoring and device assignment) shows the volume serial numbers not with ATTRIBUTE=*MONITORED.
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").
Format
SHOW-TAPE-STATUS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT =
Specifies the tape devices for which information is to be output.
UNIT = *SELECT(...) / *VOLUME(...) /list-poss(26): <alphanum-name 2..2 with-wild(20)> /
<alphanum-name 4..4 with-wild(20)>
The tapes about which information is desired may be selected by specifying a specific attribute (*SELECT), specific volume serial numbers (*VOLUME) or the mnemonic device names (two or four characters) of the devices on which the tapes are mounted. A maximum of 26 mnemonic device names may be specified. Mnemonic device names that cannot be generated are handled like nongenerated devices.
UNIT = *SELECT(...)
Selection of tapes via particular attributes.
ATTRIBUTE = *ALL / *FREE / *EXCLUSIVE / *MONITORED / *UNMONITORED /*WORK / *ONLINE / *PREMOUNT / *MOUNTING / *IN-USE / *CANCELLED / *NO-DEVICE / *RECOVER / *DMS / *SPECIAL / *DISMOUNT / *POSITION / *STD /*NON-STD / *TAPE-MARK
Attribute. Information is supplied for all tapes with the specified attribute.
Operand value (attribute) | Meaning |
|---|---|
*ALL | any attribute |
volume-allocation-state | |
*FREE | free tape (see Note) |
*EXCLUSIVE | exclusively reserved (see Note) |
volume-phase | |
*MONITORED | device is subject to monitoring (see Note) |
*UNMONITORED | device is not subject to monitoring (see Note) |
*ONLINE | free mounted tape |
*PREMOUNT | tape assigned |
*MOUNTING | tape assigned, must still be mounted |
*IN-USE | tape assigned for use |
action-state | |
*CANCELLED | tape locked |
*NO-DEVICE | no device assignment present |
*RECOVER | interrupt handling taking place |
*DISMOUNT | REMOUNT or MOUNT message still pending |
*POSITION | tape being positioned |
use-mode | |
*DMS | occupied by DMS application |
*SPECIAL | occupied by special application |
*WORK | work tape |
label-type | |
*STD | tape has standard labels |
*NON-STD | tape has nonstandard labels |
*TAPE-MARK | tape begins with tape mark |
Notes on the output when ATTRIBUTE is specified:
*FREE: | All tape devices on which tapes are mounted but not in use are listed. |
*MONITORED: | All tapes subject to volume monitoring are listed. |
*UNMONITORED: | All tapes which have been reserved offline are listed. |
*EXCLUSIVE: | All tapes which are in use or which have been reserved are listed. |
The output is grouped according to the following:
| |
UNIT = *VOLUME(...)
Specifies the volume serial numbers of the tapes about 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, max. 6 characters) of the tapes about which information is to be output. Up to 10 VSNs can be specified.
INFORMATION =
Amount of information to be displayed
INFORMATION = *STD
A standard output record is generated for each device with the selected attributes.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NKD0005 | Warning: information incomplete |
2 | 0 | NKD0030 | Warning: INFORMATION parameter changed |
2 | 0 | NKD0035 | Warning: no information on remaining VSNs |
1 | NKD0001 | Syntax error in input; correct the command parameter to eliminate the error | |
4 | 1 | NKD0001 | Syntax error in subprocedure |
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 | |
64 | NKD0025 | No information on MN list and INF parameter | |
64 | NKD0032 | No information available on attribute | |
64 | NKD0033 | No information on VSN and INFORMATION parameter | |
64 | OPS0002 | Interrupt (e.g. by K2 key) during S variable generation | |
8 | 130 | NKD0010 | Tape monitor temporarily unavailable; command could not be processed |
130 | OPS0001 | SDF-P reporting space problems(possible response: FREE-VARIABLE and repeat command) |
Output format
A header line is displayed along with one values line for each tape device specified. For the meaning of the output columns and possible values, see section "Information services of device management: Meanings of the output values of SHOW commands".
Header line for tapes reserved online:
MNEM VSN USE LABEL DEV-A VOL-A PHASE ACTION CAR
Values
mn vsn use label device volume volume action cartr.
mode type allocation allocation phase state loader
state state state
Header line for tapes reserved offline:
DMS RESERVED UNMONITORED TAPES
Values:
( <vsn>,<tsn> ) ... a maximum of 4 value pairs are output per line
Notes
In response to a UNIT-related request, two output lines may be provided if a volume is online on a device and another volume is to be mounted on the same device.
In response to a VSN-related request, two output records may likewise be provided if the VSN is ambiguous or if the tape is mounted on one device but is to be made available on some other device.
Output in S variables
The INFORMATION and SELECT operands identify the S variables which are to be created. The following specifications are possible:
Notation used in command | Abbreviated form used in table |
|---|---|
INFORMATION = *STD | INF=STD |
UNIT = *SELECT(ATTRIBUTE=*UNIMONITORED) | UNIT=SEL(ATTR=UNMONI) |
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
(Re)mount operation being performed for the volume by the volume monitoring system | var(*LIST).ACTION | S | '' | INF=STD |
Cartridge loader operating mode | var(*LIST).CARTRIDGE | S | '' | INF=STD |
Device allocation mode: | var(*LIST).DEV-ALLOC | S | '' | INF=STD |
A MOUNT or DISMOUNT message is pending on this device for the DISMOUNT volume | var(*LIST).DISMOUNT-ACTION | S | '' | INF=STD |
DISMOUNT volume | var(*LIST).DISMOUNT-VOL | S | '' | INF=STD |
Device’s volume label type | var(*LIST).LABEL | S | '' | INF=STD |
Tape monitoring mode | var(*LIST).PHASE | S | '' | INF=STD |
Tape device mnemonic | var(*LIST).UNIT | S | '' | INF=STD |
TSN for reserved offline tape | var(*LIST).UNMON.TSN | S | '' | UNIT=SEL(ATTR = UNMONI) |
VSN for reserved offline tape | var(*LIST).UNMON.VOL | S | '' | UNIT=SEL(ATTR= UNMONI) |
Usage mode of the mounted | var(*LIST).USE | S | '' | INF=STD |
Volume serial number | var(*LIST).VOL | S | '' | INF=STD |
Usage mode of the mounted disk | var(*LIST).VOL-ALLOC | S | '' | INF=STD |
Example
Reserving one MTC device and several magnetic tape cartridges
/sec-res tape=((vol=m5658k,type=tape-c4),
(vol=m5660k,type=tape-c4,mount=*no),
(vol=m5661k,type=tape-c4,mount=*no)),wait=*par(time=300) ————— (1)
/show-res-alloc ————————————————————————————————————————————————————— (2)
% MNEM TYPE VSN VOL-A TSN NAME/ID PHASE ACTION % EO TAPE-C4 M5658K EXCL 2DR5 ULF PREMOUNT NO ACTION % LOCATION : ROBOTER2 % M5660K EXCL 2DR5 ULF NO ACTION % M5661K EXCL 2DR5 ULF NO ACTION
/show-tape-sta ———————————————————————————————————————————————————————— (3)
% MNEM VSN USE LABEL DEV-A VOL-A PHASE ACTION CAR % EO M5658K DMS 2DR5 EXCL PREMOUNT NO ACTION OFF % DMS RESERVED UNMONITORED TAPES % (M5660K,2DR5 M5661K,2DR5)
(1) | The SECURE-RESOURCE-ALLOCATION command reserves several magnetic tape cartridges of volume type TAPE-C4. An MTC device is simultaneously reserved for the magnetic tape cartridge M5658K (premount request). No device is yet to be made available for magnetic tape cartridges M5660K and M5661K. |
(2) | The reserved volumes and devices are displayed by means of the SHOW-RESOURCE-ALLOCATION command. |
(3) | The SHOW-TAPE-STATUS command shows the user which tapes (or tape cartridges and associated devices his task is occupying. |