|
|
|
Returns job and/or session information.
Syntax
REC I32A @64A
AIFJSGET ( overall_status, itemnum_array, item_array,
RECA REC I32 I32
itemstatus_array, JSNum, JSKey, 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. 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
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 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 where information is returned. 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 for which
information is desired.
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. Accessing 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
Operation Notes
AIFJSGET 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.
|
