JOBINFO

Syntax

           I16V   I32    U16A
  JOBINFO (jsind, jsnum, jsstatus
            I16V     *     I16
          [,itemnum, item, itemerror] [...]);

NOTE: You can specify up to five itemnum/item/itemerror triples.

Parameters

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

JOBINFO Itemnum/Item Values

NOTE: Unless otherwise indicated, all mnemonics are as defined in Table 2-1.

Operation Notes

Related Information