- overall_status
record by reference (required)
Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call, not specific to any particular item. A positive value indicates the last element in itemstatus_array, signaling an error condition. Refer to appendix A for meanings of status values.
Record type: status_type (Refer to appendix B.)
- ldev
32-bit signed integer by value (required)
Passes one of the following:
The logical device number (ldev) of the optical drive which contains
mounted media for which information is to be retrieved.
The logical device number of the autochanger for the
magneto-optical device for which information is to be retrieved.
- itemnum_array
32-bit signed integer array by reference (required)
An array of integers where each element is an item number indicating
the magneto-optical device
system information to be returned to a data structure pointed to
in the corresponding element in item_array.
If n item numbers are being requested,
element n+1 must be a zero to indicate the end of the
element list.
- item_array
64-bit address array by reference (required)
An array where each element is a 64-bit address pointing to a
data structure where information is to be returned.
Information and its required data type are
defined by the item number passed in the corresponding element
in itemnum_array.
Array type: globalanyptr (Refer to Appendix B.)
- itemstatus_array
record array by reference (required)
An array where each element returns the status of the operation
performed in the corresponding element in item_array. A zero
indicates a successful operation. A negative value indicates
an error condition. A positive value indicates a warning.
Array type: status_type (Refer to Appendix B.)
- pin
32-bit signed integer by reference (optional)
Passes the pin of the process that was used to allocate the
optical media that contains the mounted media for which information
is to be retrieved.
This is used for
verification of ownership for an optical drive.
If 0 is passed, the pin of the calling process is used.
Default: 0
- user_id
32-bit signed integer by value (optional)
The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product.
If it is not passed, the caller must have previously called
AIFACCESSON.
Default: 0