|
|
|
Modifies job and/or session information.
Syntax
REC I32A @64A
AIFJSPUT ( overall_status, itemnum_array, item_array,
RECA REC I32 I32 I32A
itemstatus_array, JSNum, JSKey, user_id, ver_item_nums,
@64A RECA
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. Refer to
appendix A for meanings of status values.
Record type: status_type (Refer to appendix B.)
- 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 the
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 containing 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 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. Refer to appendix A for meanings of
status values.
Array type: status_type (Refer to appendix B.)
- JSNum
- record by value (optional)
Passes the job/session number of the job or session whose information is
to be modified.
Record type: jsnum_type (Refer to appendix B.)
Default: 0
- JSKey
- 32-bit signed integer by value (optional)
Passes the job/session key returned from a call to
AIFSYSWIDEGET. Modifying information using this key is faster
than when using the job/session number.
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
- 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. Refer to appendix
A for meanings of status values.
Array type: status_type (Refer to appendix B.)
Default: nil
Operation Notes
AIFJSPUT accepts as an input key either of the following:
- A job/session number
- A job/session key returned from AIFSYSWIDEGET
Use of a job/session key provides much faster access than a job/session number.
If neither parameter is specified, the default is the caller's job/session.
|
