Utilities and Other Interfaces › The Application Program Interface
The Application Program Interface
The CA MIA application program interface (API) is a module that lets you capture information about managed tape devices and route this information to a TSO session, a system log, or user-defined program.
You can use this interface, for example, to trace particular events (such as pending mounts), to measure device usage so that you can tune your systems for optimal performance, or to assemble usage statistics for logging.
With this interface, you can retrieve the following information:
- z/OS local device name
- CA MIA global device name
- GTAF Autopath host device name
- Device type
- ACL installation status
- ACL active status
- Current volser mounted on a device
- z/OS device status: ONLINE, OFFLINE, ALLOCATED, PENDING-OFFLINE, MOUNT-PENDING
- The name of the job allocating this device
- Identity of system where allocating job is running
- TPCF special device status: OVERGENNED, NOTAVAILABLE, DEDICATED
- Identity of the system to which the device is dedicated
- TPCF job name mask for which the device is reserved
- Identity of systems to which the device is reserved
- TPCF preferencing status
- Eight bytes of user data assigned to the device through the USERDATA command
- Bit mask of known systems
- Bit mask of freed systems
