3.66 AIFWGGET

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

⇑ Page Top

Syntax

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

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

workgroup_name

256-byte character array by reference (required)

Passes the name of the workgroup for which information is desired. The workgroup name follows the convention for CI variables and Job Control Words(JCW's) and can be a maximum of 255 alphanumeric characters or underscores, where the first character cannot be numeric. The user-specified name (including case) is preserved, though comparisions are case insensitive. The workgroup_name is terminated by a NULL character (ASCII 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