AIFPROCGET

Returns process information.

Syntax

                   REC       I32A              

AIFPROCGET(overall_status, itemnum_array, 

                  @64A        RECA 

              item_array, itemstatus_array,

              I32   REC    I32

              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

Operation Notes

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

AIFPROCGET

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Operation Notes