HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Architected Interface Facility: Operating System Reference Manual > Chapter 3 Architected Interface Descriptions

AIFDEVCLASSGET

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 NumberItem 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

 

Feedback to webmaster