HP 3000 Manuals HP 3000 Manuals
NRJEHJInfo
Obtains a list of jobs transmitted to the host, the number of data sets
received against those jobs, and the special destinations of those data
sets. This intrinsic does not apply if you are connected to a VSE/POWER
host system.
Syntax
___________________________________________________________________________
| |
| |
| BA I I BA I BA |
| NRJEHJInfo (Wsid, StartPos, Incount, UserName, UserNameLen, JobList,|
| I I IA BA BA IA |
| JobListLen, Outcount, JobNum, JobName, User, XmitRcv,|
| LA BA BA BA IA |
| Time, PR, PU, FO, Result) |
| |
___________________________________________________________________________
Parameters
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 and/or numbers:
* 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.
Each entry is eight characters long, left-justified, and
blank-filled. Following is an example of a JobList with four
entries:
DS1
1099
2122
FIRSTONE
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.
Description
Use NRJEHJInfo to obtain information about jobs that have already been
transmitted to the host. Input information to this intrinsic is as
follows:
* Workstation identification: Wsid.
* Logical starting position within the Job Log: StartPos.
* Maximum number of elements to be returned in all output arrays except
Result: Incount.
* Job set desired: UserName, UserNameLen, JobList, and JobListLen.
The structure and contents of UserName and JobList determine the job
set desired.
You can specify either a UserName and UserNameLen, or a JobList and
JobListLen. If both pairs are specified, only JobList and JobListLen are
used.
NRJEHJInfo zeros or blanks all output arrays on entry.
After NRJEHJInfo has returned control to your program, test the first
element of Result.
Text Reference
This intrinsic provides information for the SHOW command. See Chapter 3,
"User Commands."