MPE/iX Intrinsics Reference Manual (32650-90875)

478 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
JOBINFO
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