Host Environment Commands › ADDRESS MIM Command › TAPE Function › Variable TAPE.n

Variable TAPE.n

Variables of the form TAPE.n are created, one for each device that matches the criteria specified by the user. The very first variable, TAPE.0, contains the total number of these devices that are returned. Each of these variables contains a single string of 16 blank-delimited fields. If no data is available for a particular field, a single asterisk displays. Blanks within a field are replaced by an underscore.

The following lists the sequence of fields for TAPE.n:

1

Contains the two-character CA MIM block version identifier.

2

Contains flag bytes 0, 1 and 2, 24 Boolean characters (eight for each flag), and either Y or N table column identifier. The conditions represented by each flag position are as follows:

• 1 - Device not locally managed.
• 2 - Caller asked for OS system name but the OS system name is not yet available. System names for this block will be filled in with the value of the 3rd position on the DEFSYS statement.
• 3-24 - Reserved.

3

Contains the internal CA MIM device number, this is equivalent to the device hardware address, specified in four hexadecimal characters.

4

Contains the four-character device UCB address.

5

Contains the four-character preference value. The possible values are from 0001 to 0255.

6

Contains one of the following device types: 3420, 3480, 3490, 3495 or 3590.

7

Contains the autopath host name, which can be MIM or any name of up to four characters.

8

Contains flag bytes 3, 4, 5, and 6, 32 Boolean characters (eight for each flag), and either Y or N table column identifier. The following are the local device attributes represented by each flag:

• 1 - Device has ACL installed
• 2 - Device has active ACL
• 3 - Device has IDRC
• 4-32 - Reserved

9

Contains the four character global device name.

10

Contains the elapsed mount-pending time in seconds, which can be up to 10 numeric characters.

11

Contains the elapsed mount pending time in the format hh:mm:ss.

12

Contains the jobname for which the device is reserved. The name can be up to eight characters.

13

Contains the system name on which the device is reserved for the job. The name can contain up to 8 characters.

14

Contains the job name that has this device allocated. The name can contain up to eight characters.

15

Contains the user data assigned to the device by the CA MIA VARY command.

16

Contains the VOLSER when the device is mounted or mount-pending. The VOLSER is six alpha-numeric characters.