|
|
|
Returns information for a device class.
Syntax
REC I32A @64A
AIFDEVCLASSGET ( overall_status, itemnum_array, item_array,
RECA CA16 I32
itemstatus_array, device_class, device_class_key,
I32
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.)
- itemnum_array
- 32-bit signed integer array by reference (required)
An array of integers where each element is an item number indicating the
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 returned. Information and its required
data type are defined by the item number passed in the corresponding
element in itemnum_array.
Array type: globalanyptr
- 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. Refer to appendix A for meanings of
status values.
Array type: status_type (Refer to appendix B.)
- device_class
- 16-byte character array by reference (optional)
The user configured device class name for the request. The name must be
capitalized and blank filled.
- device_class_key
- 32-bit signed integer by reference (optional)
This is the index to the device class table. This is the fast key to
retrieve the device class information.
- 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
The AIFDEVCLASSGET call requires device_class or
device_class_key as an input parameter. Both search keys can
be obtained by calling the AIFSYSWIDEGET procedure area 13500.
If both device_class name and device_class_key
are provided, the values are checked against each other. If the two keys do
not identify the same class, AIFDEVCLASSGET terminates with an error
condition.
AIFDEVCLASSGET Item Descriptions
The following table provides detailed descriptions of item numbers and
corresponding items associated with device criteria items used by
AIFDEVCLASSGET.
Table 3-5 AIFDEVCLASSGET - Device Criteria Items from System Tables
| Item Number |
Item Name (Data Type) Get; Put; Verify; Release First
Available Description |
| 13501 | Devices (Record) Get: Yes; Put: No; Verify: Yes;
Release 4.0
This item returns the LDEVs in the device class. The format of
the record is as follows:
record
size : integer
ldev_array : array[1..size]of integer;
end
The first word of the record holds the number of ldev's
retrieved and the rest of the record holds the ldev's. |
| 13502 | User-defined Device Class Name (C16) Get: Yes; Put: No;
Verify: Yes; Release 4.0
This item returns the device class name assigned to the device
by the user. |
| 13503 | Device Class Key (I32) Get: Yes; Put: No; Verify: Yes;
Release 4.0
Returns the class index to the Device Class Table. |
| 13504 | Number of Devices in Class (I32) Get: Yes; Put: No;
Verify: Yes; Release 4.0
Number of devices in the device class. |
| 13505 | Device Class Access Type (I32) Get: Yes; Put: No;
Verify: Yes; Release 4.0
Returns the device class access type.
| 0-7 | Disk |
| 16-23 | Terminal |
| 24-31 | Tape |
| 32-37 | Printer |
|
|
