Utilities and Other Interfaces › The Application Program Interface › How You Retrieve Device Information

How You Retrieve Device Information

You can use the sample routines and panels available with the API to retrieve information about tape devices and display this information at a TSO session. You can use the interface to format and display the following types of information about a tape device:

• Return code
• z/OS local device name
• CA MIA global device name
• GTAF Autopath “host” device name
• Device type
• ACL installation status
• ACL active status
• Volume serial
• Name of job to which device is allocated
• Identity of system where allocating job is running
• Identity of system to which the device is reserved
• z/OS device status: ONLINE, OFFLINE, ALLOCATED, PENDING-OFFLINE, MOUNT-PENDING
• TPCF “special” device status: OVERGENNED, NOTAVAILABLE, DEDICATED, RESERVED
• TPCF preference value
• TPCF job name mask for which device is reserved

You can display information about a single device, a group of devices, or all devices. You can limit the request to certain devices by telling CA MIA to show you devices that have local names in a range you specify. You also can limit the request to devices that have a status you specify, such as allocated devices, offline devices, and so on.