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

AIFPROCPUT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Modifies process information

Syntax

                   REC        I32A              

AIFPROCPUT(overall_status, itemnum_array, 

                  @64A         RECA 

              item_array, itemstatus_array,

              I32   REC   I32

              PIN, PID, user_id,

                I32A           @64A          RECA

              ver_item_nums, ver_items, 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.

Record type: status_type

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 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 containg 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 the 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.

Array type: status_type

PIN

32-bit signed integer by value (optional)

Passes the process identification number (PIN) of the process whose information is to be modified.

Default 0

PID

Record by value (optional)

Passes the process identifier (PID) of the process whose information information is to be modified.

Record type: longint_type

Default 0

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.

Array type: status_type

Operation Notes

AIFPROCPUT accepts either of the following as an input key:

  • A process identification number (PIN) that identifies a process immediately and provides faster access than using the PID. However, PINs are not unique throughout the life of a system. Thus, there is a chance that the specified PIN is associated with a different process than expected.

  • A process identifier (PID) that uniquely identifies a process throughout the life of a system. Using a PID to access process information is almost as fast as using a PIN.

If neither PIN or PID are provided, the default is the PIN of the calling process.

The process whose information is being modified must be of type user, son, or CI. If it is anything else, AIFPROCPUT terminates with an error condition.

If both the PIN and PID are provided, the values are checked against each other. If the process identifiers do not match, AIFPROCPUT terminates with an error condition.

Feedback to webmaster