LIST - Read and output magnetic tape labels

The LIST statement is used in the form described below to read and output volume labels.The user can choose

• the number of volumes to be listed

• a particular volume

• and a particular device.

If OPTION CONS is set, the list is output to the console. If this option is not set, the list is output to SYSOUT.

The LIST function is executed only if the task has the system privilege TAPE-ADMINISTRATION.

Format

LIST                                                                                                                                                         

[no] voltyp

[,VSN = vsn / (vsn1,vsn2,...,vsn16) / (initval)]

[,UNIT = mn]

[,REW / RUN]

Operands

no
Number of volumes to be listed with this statement.
Permissible values: 1, 2, ..., 16.

The operands “no” and “voltyp” must be separated by at least one blank.

voltyp
Defines the volume (volume type). Defines the volume type, and thus also the recording mode.

You will find the volume types supported in the current in BS2000 version in the “System Installation” manual [7 (Related publications)]. For compatibility reasons, INIT also supports a few more volume types. You can ascertain the volume types accepted by INIT by means of the HELP statement (see "HELP - Outline description of INIT statements").

The keywords for volume types can be abbreviated as long as they remain unique, e.g. T-C4 = TAPE-C4. As new volume types are introduced, however, an abbreviation which was originally unique may become ambiguous. There are no guaranteed abbreviations.

There is no default value for this operand; the value must always be specified by the user.

VSN
The labels of the volume with the specified volume serial number are to be output. To list two or more volumes with a single statement, the appropriate number of volume serial numbers or an initial value must be specified.

Default: If the VSN is not specified, a volume of type “voltyp” with any volume serial number is requested.
In this way, it is possible to read the labels of an unknown volume.

VSN=vsn
Single volume serial number. The labels of a single volume are to be output. If a single volume serial number is specified, the value of the “no” operand must be 1 or “no” must not be specified.

Permissible values: Max. 6 characters (A..Z, 0..9, #,$,@).
The special characters #, $, @ are permitted by INIT but must not be used in labels (DIN 66029, DIN 66003). If OPTION DIN is active, these special characters are rejected.

VSN=(vsn1,vsn2,...,vsn16)
The labels of the volumes with the specified volume serial numbers are to be output. The corresponding volumes are requested in consecutive order. The number of volumes must tally with the number specified for the “no” operand. See above and "INIT - Initialize magnetic tape" for a list of possible values.

VSN=(initval)
The labels of multiple volumes beginning with the volume serial number “initval” are to be output. Every time the labels of a volume are read successfully, the volume serial number is automatically incremented by 1. The number of volumes must be specified in the “no” operand. See above and "INIT - Initialize magnetic tape" for a list of possible values.

UNIT=mn
Mnemonic device name for seizure of a particular device. A volume is to be mounted on the specified device.
Unsuitable devices, i.e. devices that cannot process volumes of the specified type, are rejected.

REW
Specifies that the magnetic tape or magnetic tape cartridge is to be rewound after listing but not unloaded.
If a single volume is listed, REW is set by default.

RUN
Specifies that the magnetic tape or magnetic tape cartridge is to be rewound and unloaded after listing.
If two or more volumes are to be listed with a single statement (operand no=2..16), RUN is set by default.

Examples

1. Outputting the labels of a single volume with any volume serial number (specifying minimum parameters):

   LIST TAPE-C4

2. Outputting the labels of three particular volumes with a single statement:

   LIST 3 TAPE-C4,VSN=(TAPE01,TAPE02,TAPE03)

3. Outputting the records of 8 particular volumes with a single statement:

   LIST 8 TAPE-C4,VSN=(VSN001)

   The volumes with the volume serial numbers VSN001, VSN002,...,VSN008 are requested one after the other.

4. Outputting the labels

   • of a particular volume (with the volume serial number VSN001),

   • on a particular device (with the mnemonic name M1),

   • and remove after initialization:

   LIST TAPE-C4,VSN=VSN001,UNIT=M1,RUN