|
|
|
Modifies magneto-optical disk library system information.
Syntax
REC I32 I32A @64A
AIFMOPUT ( overall_status, ldev, itemnum_array, item_array,
RECA I32 I32A @64A
itemstatus_array, pin, ver_item_nums, ver_items,
RECA I32
ver_item_statuses, 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
modified.
- The logical device number of the autochanger for the
magneto-optical device for which information is to be
modified.
- 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 disk library system information to be modified. New
information must be located in a data structure pointed to by 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 containing new information to be passed to the operating
system. 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
modified. 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
- ver_item_nums
- 32-bit signed integer by reference (optional)
An array of integers where each element is an item number indicating
magneto-optical disk library system information to be verified before
proceeding with the modification. Verification information must be
located in a data structure pointed to by the corresponding element in
ver_items. If n items are being verified, element n+1
must be a zero to indicate the end of the item list.
Default: nil
- ver_items
- 64-bit address array by reference (optional)
An array where each element is a 64-bit address pointing to a data
structure containing information to be verified against current
magneto-optical disk library system information. Information and its
required data type are defined by the item number passed in the
corresponding element in ver_item_nums.
Array type: globalanyptr (Refer to Appendix B.)
Default: nil
- ver_item_statuses
- record array by reference (optional)
An array where each element returns the status of the verification
performed in the corresponding element in ver_items.
A zero indicates a successful verification. A negative value indicates
an error condition. A positive value indicates a warning.
Array type: status_type (Refer to Appendix B.)
Default: nil
- 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 modify 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.
AIFMOGET/PUT Item Descriptions
The following tables provide a summary and detailed descriptions of the items
associated with optical drives.
Table 3-20 AIFMOGET/PUT Item Descriptions when ldev is an Optical Drive
| Item Number |
Item Name (Data Type) Put; Verify; Release Description |
| 17001 |
Media Label (REC) Put: YES; Verify: YES; Release 5.0
Returns or modifies the media label. The media label is a record
consisting of a media name, subname1, and subname2. The media name
consists of an array of 1 to 32 characters and identifies the first part
of the media label. Subname1 and subname2 consist of arrays of 1 to 16
characters and identify the second and third parts of the media label.
Each of the fields of this record must be left justified.
The media name, subname1, and subname2 must contain either a name or the
character "@". "@" indicates that this field should be ignored. (Refer to
the item description of media label in the "AIFMOALLOCATE Item
Descriptions")
When this item is specified, the media whose media label is to be
retrieved or modified, must be mounted.
Since the media name, "$SCRATCH", is a system defined name used by
TurboSTORE/iX, if it is passed to AIFMOPUT to modify a media
label, unexpected results may occur if TurboSTORE/iX attempts to use this
media.
Record_type: media_label_type (Refer to Appendix A)
|
| 17002 |
Volume Set Name (CA8) Put: NO; Verify: YES; Release 5.0
Returns a character array containing the volume set name for the mounted
optical media.
When this item is specified, the media whose volume set name is to be
retrieved, must be mounted. |
Auto Changer Item Descriptions
Table 3-21 AIFMOGET/PUT Item Descriptions when ldev specifies an Autochanger
| Item Number |
Item Name (Data Type) Put; Verify; Release Description |
| 17003 |
Number of storage slots (I32) Put: NO; Verify: NO; Release 5.0
Returns the number of storage slots.
|
| 17004 |
Number of drives (I32) Put: NO; Verify NO; Release 5.0
Returns the number of drives. The first word of the buffer will be
expected to hold the size, in words, of the rest of the buffer area. The
first word upon return specifies the number.
|
| 17005 |
List of drive ldevs (REC) Put: NO; Verify: NO; Release 5.0
Returns a list of drive ldevs. The first word of the buffer will be
expected to hold the size, in words, of the rest of the buffer area. The
first word upon return specifies the number of ldevs returned.
Record type: drives_type (Refer to Appendix A)
|
| 17006 |
Number of mail slots (I32) Put: NO; Verify: NO; Release 5.0
Returns the number of mail slots.
|
| 17007 |
List of storage slot information (REC) Put: NO; Verify: NO;
Release 5.0
Returns an array of information for the storage slots. The information
returned includes:
- slot number
- media labels for the media associated with a slot
- volume set names for the media associated with a slot
- whether the slot contains media or not
On input, the first two fields in the buffer will represent the range of
storage slots to retrieve. The first field (first 4 bytes) represent the
lower limit and the second field (next 4 bytes) will represent the upper
limit. On output, the first field (first 4 bytes) will contain the number
of storage slots for which information was actually returned.
Record type: storage_slot_type (Refer to Appendix A) |
|
