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

Variable TAPE.n.SYS.m

For each TAPE.n REXX variable, a varying number of associated variables return data on the status of the device on each system in the CA MIA complex.

These variables take the form of TAPE.n.SYS.m, where m is any decimal number in a sequence of decimal numbers. Each variable contains a single string of four blank-delimited fields. If no data is available for a particular field, it will contain a single asterisk. Blanks within a field are replaced by underscores.

TAPE.n.SYS.0 contains the total number of systems in the CA MIA complex. The sequence for TAPE.n.SYS.m follows:

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 managed on this system.
• 2 - This system is the local system to the API request. That is, this system is the system that originated the API request.
• 3 - This system has been freed from the CA MIA complex.
• 4 - 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 third position on the DEFSYS statement.
• 5-24 - Reserved.

3

Contains the system name represented by this variable, which can be up to eight characters.

4

Contains flag bytes 3, 4, 5 and 6, 32 Boolean characters (eight for each flag), and either Y or N table column identifier. The device status values (for this system) represented y each flag position are as follows:

• 1 - Device is DEDICATED to this system (CA MIA VARY DEDICATED)
• 2 - Device is DEDICATED to an external system (CA MIA VARY DEDICATED)
• 3 - Device is NOTAVAILABLE (CA MIA VARY NOTAVAILABLE)
• 4 - Device is OVERGENNED (CA MIA VARY OVERGENNED)
• 5 - Device is ALLOCATED
• 6 - Device is ONLINE
• 7 - Device is MOUNT PENDING on this system
• 8 - Device is JOB RESERVED (CA MIA VARY JOB)
• 9 - Device is PENDING OFFLINE
• 10 - Reserved
• 11 - Device is reserved for CP (VM only - CA MIA VARY CPON)
• 12 - Device is attached to a guest operating system (VM only - CA MIA ATTACH with SYSTEM option)
• 13 - Device is JOB RESERVED with the FORCE option (CA MIA VARY JOB with FORCE option)
• 14-32 - Reserved

Example 1: Request allocated tape information

To request information for all allocated tapes with device names between 3100 and 3900 within the CA MIM complex and the desired stem is MIA, enter:

ADDRESS MIM “TAPE 'GLOBAL(3100 TO 3900)' 'STATUS(ALLOC)' 'STEM(MIA)'”

GLOBAL keyword

Ensures the allocation of a matching device on any system in the CA MIM complex.

TO parameter

Specifies the examination of all devices between and inclusive of 3100 and 3900.

ALLOC parameter in STATUS

Ensures the return of only those devices that are currently allocated.

Result: REXX variables are generated in the form of MIA.n and MIA.n.SYS.m, when allocated devices within this range are found. If no device exists that matches the criteria, a return code of 11 is set.

Example 2: Request device information for hardware addresses

To request information for the devices with online hardware addresses of 3200, E70 and 3800 and use the default stem of TAPE, issue:

ADDRESS MIM “TAPE 'LOCAL(3200,E70,3800)' 'STATUS(ONLINE)'”

The LOCAL keyword indicates that we want to search for devices using their hardware address. The ONLINE parameter of STATUS further limits the returned devices to only those that are presently online.