3.42 AIFPROCPUT

	MPE documents
	Complete PDF
	Table of Contents
	Index
⇓ Page Bottom
Syntax
Parameters
Operation Notes
Item Descriptions

⇑ Page Top

Syntax

              REC             I32A           @64A
 AIFPROCPUT ( overall_status, itemnum_array, item_array,

              RECA              I32  REC  I32
              itemstatus_array, 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

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