- Wsid
An eight-character input byte array.
The Wsid parameter identifies your workstation. It must contain a
left-justified alphanumeric name beginning with a letter. If the
workstation identifier is less than eight characters long, it must
be followed by blanks.
- StartPos
An input integer variable (required).
This parameter allows the user to fill the output arrays beginning
with the StartPos — the matched item from the Job Log. In this
way, smaller output arrays can be used with repeated calls to
NRJEHJInfo to show all the jobs transmitted to the host.
Set StartPos to 1 (not 0) to return the first Incount or Outcount number of matched jobs, whichever is less.
- Incount
An input integer variable (required).
The Incount parameter specifies the maximum number of elements to
be returned in each output array parameter
except Result.
- UserName
An input byte array (required
if JobList and JobListLen are not supplied. If both UserName and JobList are supplied, only JobList is used to match host jobs). The UserName parameter specifies the kind of job information you
want. A Username can be one of the following:
An @ character. If you have NM capability, this means
all jobs of all users. Otherwise, it means all jobs of the logon
UserName.AcctName.
A UserName.AcctName. You must have NM capability to specify jobs submitted
by other users.
- UserNameLen
An input integer variable (required
if UserName is supplied). The UserNameLen parameter specifies the number of bytes in UserName, from 0 through 17.
- JobList
An input byte array (required
if UserName and UserNameLen are not supplied. If JobList and JobListLen are supplied, then UserName and UserNameLen are not required parameters and are ignored).
The JobList array is a list of host job names, host job numbers,
and/or SpoolfileIds.
Names are those
on the host JCL JOB card. By using job names, you obtain information
for all jobs with this name under your own logon UserName.AcctName, or for all users if you have NM capability.
Numbers are those assigned by the host system. When
using job numbers, you must have NM capability to show jobs submitted
by another user.
The SpoolfileId is assigned by the spooler after
a job is successfully submitted. When used in the Joblist array,
the SpoolfileIds must be entered starting with the character "^" followed
by up to seven digits.
Each entry is eight characters long, left-justified, and blank-filled.
Following is an example of a JobList with four entries:
- JobListLen
An input integer variable (required
if JobList is supplied). The JobListLen parameter specifies the number of entries in the
JobList.
- Outcount
An output integer variable (required).
The Outcount parameter contains the actual number of elements in
each of the output arrays, except for Result.
- JobNum
An output integer array (required).
The JobNum array is a list of host job numbers of all submitted
jobs that meet the specification in UserName and JobList.
- JobName
An output byte array (required).
The JobName array is a list of host job names of all submitted
jobs that met the specification in UserName and JobList.
Each entry in JobName is eight characters long, left-justified, and blank-filled.
Each entry in JobName corresponds to an entry in JobNum.
- User
An output byte array (required).
The User array is a list of users of all submitted jobs that
meet the specifications in UserName and JobList.
Each entry in User corresponds to an entry in JobNum.
Each entry is eighteen characters long, left-justified, and
blank-filled, in the form UserName.AcctName. An example of User with three entries is:
tyrone.shoelace
phillip.mgastank
hardlei.able |
Each entry has at least one trailing blank.
- XmitRcv
An output integer array (required).
The XmitRcv array is a list of the number of data sets received against
the transmitted jobs that met the specifications in UserName and JobList.
Each entry corresponds to an entry in JobNum.
- Time
An output logical array (required).
The Time array is a list of three-word entries in a format that
is compatible with intrinsics for the native language in use. The
first word contains the date information, and the remaining two
words contain the time information.
If the corresponding XmitRcv entry is zero, the Time entry is the time that the job was transmitted to the host.
If the corresponding XmitRcv entry is greater than zero, the Time entry is the time that the most recent data set was
received.
Each entry in Time corresponds to an entry in JobNum.
- PR
An output byte array (required).
The PR array is a list of destinations for output routed to
NRJE printers on the standard form. The entries are from transmitted jobs
that met the specifications in UserName and JobList.
Each entry in PR corresponds to an entry in JobNum.
Each entry is eighty-eight characters long, left-justified, and
blank-filled, containing at least one trailing blank. No embedded
blanks are in an entry except in the case of a file equation. In
this case, one blank follows the initial :FILE.
An entry is one of these:
file equation (:FILE filename, etc.).
ldev of an MPE output device (numeric entry).
an MPE device class name, enclosed in double quotes.
an actual file reference.
an alternate formid in the Lookup Table, enclosed in single quotes.
- PU
An output byte array (required).
The PU array is a list of destinations for output routed to
NRJE punches on the standard form. The entries are from transmitted jobs
that met the specifications in UserName and JobList.
Each entry in PU corresponds to an entry in JobNum.
Each entry is eighty-eight characters long, left-justified, and
blank-filled. The same form is used as for PR entries.
- FO
An output byte array (required).
The FO array is a list of destinations for output routed to
NRJE printers and punches on forms other than the standard form. Entries
are from transmitted jobs that met the specifications in UserName and JobList.
Each entry in FO corresponds to an entry in JobNum.
Each entry is eighty-eight characters long, left-justified, and
blank-filled. The same form is used as for PR entries.
- Result
An eight-element integer output array
(required). The Result array contains error codes that occurred during execution
of this intrinsic.
The first element of the Result array is set to zero if no errors took place. The structure
of the Result array is described in "Parameters Common to
NRJE Intrinsics" in the introduction to this chapter.
Always test the first element of Result immediately after you call this intrinsic. If the first
element of Result is not zero, test the other elements of Result to determine the nature of the problem that has occurred.
