|
|
|
Returns magneto-optical disk library system information.
Syntax
REC I32 I32A @64A
AIFMOGET ( overall_status, ldev, itemnum_array, item_array,
RECA I32 I32
itemstatus_array, pin, user_id );
Parameters
- 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
Operation Notes
If the ldev parameter passed specifies an optical drive which contains mounted
media for which information is to be retrieved, and the pin parameter is not
specified, an attempt is made to retrieve information on behalf of the pin of
the calling process. If the ldev parameter passed specifies an autochanger and
the pin parameter is passed, the pin is ignored.
|
