JOBINFO

NM and CM callable.

Returns information about any current job or session under your user name and account. If you have sufficient capabilities, it returns information about jobs or sessions running under other users and accounts.

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

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.