SNA NRJE User/Programmer Reference Manual (30292-90006)
168 Chapter5
User Intrinsics
NRJE2Submit
MaxJobs
An input integer. The
MaxJobs
parameter specifies
the maximum number of elements to be returned in the
SpoolList
array.
SpoolList
An output integer array. The first
NumJobs
or
MaxJobs
(whichever is less) elements of the
SpoolList
array contain the MPE spool file
identification numbers of the host jobs (one per spool
file) successfully submitted.
When NRJE2Submit is not successful in submitting a
job, the corresponding element of
SpoolList
is set to 0
and control is returned to the caller. The elements
before that element in
SpoolList
are valid spool file
IDs, and elements following it are undefined. The
contents of the
Result
array more fully describe the
error that occurred.
NumJobs
An output integer. The
NumJobs
parameter specifies
the total number of jobs submitted to the host.
If insufficient room exists in
SpoolList
to return job
numbers of jobs submitted to the host, then
NumJobs
is
greater than
MaxJobs
.
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
PR
,
PU
, and
FO
to specify destinations for data sets returning from
the jobs submitted to the host.
The host jobs contained in the submitted
Infiles
(and any included
##FD files) are broken into separate spool files. A list of the spool file
IDs of the jobs is returned to the user.
Console commands can be embedded in the submitted input files,
provided the console commands precede the first JCL JOB card in an
input stream. If the submitter has NM capability, or an embedded
command is one of those allowed to all users (specified in the NMMGR
Workstation Data screen), the console command is passed on as part of