- 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
