3.41 AIFPROCGET

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

⇑ Page Top

Syntax

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

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

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 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 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 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 for which information is desired.

Default 0

PID

Record by value (optional)

Passes the process identifier (PID) of the process for which information is desired.

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

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