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

AIFSPPPUT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Modifies spooler process information.

Syntax



                 REC           I32A          @64A           RECA

AIFSPPPUT (overall_status, itemnum_array, item_array, itemstatus_array,

                 REC        I32       I32A         @64A

           spooler_device, user_id, ver_item_nums, ver_items,

                 RECA

           ver_item_statuses)

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

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.)

spooler_device

record by reference (required)

Passes the logical device number (LDEV) or device name owned by a spooler process for which information is to be modified. An LDEV number must be converted into an ASCII character string before being passed to this routine. The name should be left-justified and padded with blanks.

Array type: device_name_type (Refer to appendix B.)

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

ver_item_nums

32-bit signed integer array by reference (optional)

An array of integers where each element is an item number indicating the operating system information to be verified before proceeding with 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 operating 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

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. Refer to appendix A for meanings of status values.

Array type: status_type (Refer to appendix B.)

Default: nil

Operation Notes

AIFSPPPUT accepts a device name or logical device number (LDEV) that identifies the spooler process for which information in the spooler process information table (SPIT) is to be modified.

The three verification arrays are used to verify that the spooler process to be modified is in the expected state. If the three verification arrays are passed, all item values specified by them are checked against the current values in the SPIT entry. A modification is performed only if all values match. The three verification arrays must all be passed or all defaulted when calling AIFSPPPUT, otherwise, an error is returned.

Item Descriptions

The following table provides detailed descriptions of item numbers and corresponding items associated with spooler process information modified by AIFSPPPUT.

Table 3-36 AIFSPPPUT Spooler Process Information Item Descriptions

Item NumberItem Name (Data Type) Release First Available Description
8009

Device outfence (I32) Release 3.0

>Modifies the outfence of the device. Values are in the range 1..14. An outfence of 0 means that the system global outfence is in effect for this device.

 

Feedback to webmaster