3.68 AIFWGPUT

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

⇑ Page Top

Syntax

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

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

workgroup_name

256-byte character array by reference (required)

Passes the name of the workgroup whose information is to be modified. 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

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

Default: nil