- jsind
16-bit signed integer by value (required)
Indicates whether jsnum denotes a session or job:
- Value
Meaning
- 1
jsnum is a session
- 2
jsnum is a job
- jsnum
32-bit signed integer by reference (required)
Passes the job/session number for which information is requested.
Job/session numbers can be displayed by the SHOWME and
SHOWJOB commands. If this value is zero, JOBINFO
returns information about your logon job/session (unless the first
itemnum has a value of 1; see below). When you pass a 0
for jsnum, JOBINFO returns the actual
job/session number in jsnum.
- jsstatus
16-bit unsigned integer array (required)
Returns indicator of the success or failure of the call in a two-element
array. The first element contains the error indicator. The second element
should be ignored.
- Value
Meaning
- 0
Successful call. All itemerrors equal
zero.
- 1
Partially successful call. One or more
itemerror(s) returned with nonzero values.
- 2
Unsuccessful call. All itemerrors returned with
nonzero values.
- 3
Unsuccessful call. Syntax error in calling sequence.
- 4
Unsuccessful call. Unable to retrieve
jsnum.
- 5
Process terminated. The process terminated during the start of
retrieval.
- itemnum
16-bit signed integer by value (optional)
Specifies which item value is to be returned. Refer to Table 4-20 for a
complete list of valid item numbers and what they return to the
caller.
- item
type varies (optional)
A reference parameter (whose data type corresponds to the data type for
the desired information) to which the desired information is returned.
These are standard data types and are defined in Table 2-1. All
itemnum and item parameters are output
parameters. The only exception is itemnum=1, when all the
following conditions are met:
The caller passes itemnum=1 in the first item
triple.
The item parameter contains a character string of
the form
[jsname,]username.acctname.
The jsnum parameter is set to 0, and the
jsind parameter is set to 1 or 2.
If all these conditions are met, JOBINFO returns information
about the specified job/session in all other items and returns that
job/session number in jsnum. The size of the first item
is determined by the way it is used.
- itemerror
16-bit signed integer by reference (optional)
Returns the success or failure of the retrieval of each item. The
returned values are:
- Value
Meaning
- 0
Successful
- 1
Invalid itemnum
- 2
Information requested not valid for specified
jsnum
- 3
Insufficient capability
- 4
Information not available
- Itemnum/
Mnemonic
Item Description
- 1/CA
[jsname,]user.account.
Can be used as an I/O parameter:
If used as an input parameter, the array must be 26 bytes long,
plus one for a binary 0 (zero) terminator. The input string must be
in the form [jsname,]user.account.
The wildcard character @ is not allowed.
If used as an output parameter, the array must be 26 bytes long.
The output is left-justified and padded with blanks.
- 2/CA8
Session/job name.
An ASCII output parameter. Output is left-justified and padded
with blanks.
- 3/CA8
User name.
An ASCII output parameter. Output is left-justified and padded
with blanks.
- 4/CA8
User logon group.
An ASCII output parameter. Output is left-justified and padded
with blanks.
- 5/CA8
User account.
An ASCII output parameter. Output is left-justified and padded
with blanks.
- 6/CA8
User home group.
An ASCII output parameter. Output is left-justified and padded
with blanks.
- 7/I32
The date/time that is displayed by the :SHOWJOB command. This
date/time is updated whenver a job changes state (SCHED, WAIT, EXEC).
The date/time that is displayed by the :SHOWJOB command. This
date/time is updated whenver a job changes state (SCHED, WAIT,
EXEC).
- 8/U16
The date/time that is displayed by the :SHOWJOB command. This
date/time is updated whenever a job changes state (SCHED, WAIT, EXEC).
Returns a 16-bit unsigned integer to be used by the FMTCALENDAR
intrinsic. For a job, this is the date when it enters the WAIT
state.
- 9/CA8
Input LDEV/class name.
An ASCII output parameter. Whatever array the user passes
in will be overwritten with the LDEV/class name, using exactly the
number of characters in the LDEV/class name. The remainder of the
array is left intact; no fill character is used.
- 10/CA8
Output LDEV/class name.
An ASCII output parameter. Whatever array the user passes
in will be overwritten with the LDEV/class name, using exactly the
number of characters in the LDEV/class name. The remainder of the
array is left intact; no fill character is used.
- 11/CA
Current job step.
Returns a maximum of 238 ASCII characters and is the image of the command
currently executing. The array must be long enough for the expected
command image (the length can be obtained from
itemnum=34).
- 12/I16
Current number of active jobs
- 13/I16
Current number of active sessions
- 14/I16
Job input priority
- 15/I32
Job/session number
- 16/I16
Jobfence
- 17/I16
Job output priority
- 18/I16
Number of copies
- 19/I16
Job limit (system)
- 20/I16
Session limit (system)
- 21/I16
Job deferred. Returns the values:
- 0
No
- 1
Yes
- 22/U16
Main CI PIN for job/session
- 23/U16
Original job spooled. Returns the values:
- 0
No
- 1
Yes
- 24/U16
RESTART option. Returns the values:
- 0
No
- 1
Yes
- 25/U16
Sequenced job. Returns the values:
- 0
No
- 1
Yes
- 26/U16
Term code. Returns the values:
- 0
No
- 1
Yes
- 27/U16
CPU limit
- 28/U16
Session/jo state.. Returns the values:
- 2
Executing
- 4
Suspending
- 32
Wait
- 48
Initialization
- 56
Scheduled
- 27/U32
User's local attributes
- 30/I16
$STDIN spoolfile number.
Returns data for current jobs and sessions only. Valid for
spoolfile numbers less than or equal to 32768.
- 31/I16
$STDIN spoolfile status.
Returns data for current jobs and sessions only. Returns the values:
- 0
Open
- 1
Active
- 3
Reserved
- 4
Ready
- 32/I16
$STDLIST spoolfile number.
Returns data for current jobs and sessions only. Valid for
spoolfile numbers less than or equal to 32768.
- 33/I16
$STDLIST spoolfile status.
Returns data for current jobs and sessions only. Returns the values:
- 0
Active
- 1
Ready
- 2
Open
- 3
Reserved
- 34/I16
Length of itemnum=11 (current job step)
- 35/U16
SET STDLIST=DELETE invoked. Returns the values:
- 0
$STDLIST is saved
- 1
SET STDLIST=DELETE is invoked
- 36/U16
Job information table data segment number
- 37/N/A
Not allowed. Call results in error to calling routine
- 38/I32
$STDIN spoolfile number.
Returns data for current jobs and sessions only. Valid for
all spoolfile numbers regardless of size.
- 39/I32
$STDLIST spoolfile number.
Returns data for current jobs and sessions only. Valid for
all spoolfile numbers regardless of size.
- 40/U16
Session quiet mode. Returns:
- 0
No
- 1
Yes
- 41/I32
The job or session number of the job submitter.
- 42/CA8
The job or session name of the job submitter.
An ASCII output parameter. Output is left justisfied and padded
with blanks.
- 43/CA8
The user name of the job submitter.
An ASCII output parameter. Output is left justified and padded
with blanks.
- 44/CA8
The user account of the job submitter.
An ASCII output parameter. Output is left justified and padded
with blanks.
- 45/CA8
The logical device of the job submitter.
An ASCII output parameter. Output is left justified and padded
with blanks.
- 46/U16
The date/time that the STREAM command was submitted by the
job submitter. For jobs, this is the date that the job was streamed (and
is the same date that appears in the job submitter banner.) For sessions,
this is the date that the session was started via either the
STARTSESS command, the STARTSESS intrinsic, or by the
default automatic logon at boot time.
This item value differs from item 8 only for jobs scheduled for the
future.
Returns a 16-bit unsigned integer to be used by the FMTCALENDAR
intrinsic.
- 47/I32
The date/time that the STREAM command was submitted by the
job submitter. For jobs, this is the date that the job was streamed (and
is the same date that appears in the job submitter banner.) For sessions,
this is the date that the session was started via either the
STARTSESS command, the STARTSESS intrinsic, or by the
default automatic logon at boot time.
This item value differs from item 7 only for jobs scheduled for the
future.
Returns a 32-bit signed integer to be used by the FMTCLOCK
intrinsic.