 |
» |
|
|
|
Modifies magneto-optical disk library system information. Syntax | |
REC I32 I32A
AIFMOPUT(overall_status, ldev, itemnum_array,
@64A RECA I32
item_array, itemstatus_array, pin,
I32A @64A
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. |
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: 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) |
|
