- 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.
- NumFiles
An integer input variable, from 1 through
40 (required). The NumFiles parameter indicates the following:
The number of file names that
are in FileList.
The number of elements in FileLens.
The number of elements in SubCode.
- FileList
An input byte array (required).
The FileList array contains actual file designators, formal file designators,
or file references for each file, in sequence, that goes into your
job stream. The contents of the files named in FileList are broken into spool files, with one host job per
spool file.
The format of the FileList is a continuous string of actual or formal file designators
without any delimiters between entries; the length of each substring
is in the FileLens array.
The file designators $NULL, $STDLIST, and $NEWPASS are not allowed in the FileList.
You must provide sufficient elements for this array. The maximum
length for this array is 3440 bytes (40 files * 86 character
maximum per file reference). The format of a file reference is as
follows:
Infile[/LockWord][.GrpName[.AcctName[:Envid]]]
|
The meanings of the parameters used in this reference are
described in Chapter 3 “User Commands” in the SUBMIT command description.
- FileLens
An input integer array (required).
Each element of the FileLens array specifies the length in bytes of its corresponding
file identifier in the FileList array; FileLens[i] is from 0 through 86.
The maximum length of the FileLens array is 40 elements, to accommodate the MPE stacksize
for the NRJE intrinsics.
- SubCode
An input integer array. Each
element of the SubCode array corresponds to a file name in the FileList array. Each SubCode element must contain one of these values:
0 = NRJE should translate the
file from ASCII to EBCDIC.
2 = NRJE should not translate the file to EBCDIC.
You must use SubCode(i)=0 with Direct=1. Table 5-4 “SubCode — Direct Relationship”, in the NRJESubmit intrinsic description, shows how the SubCode and Direct parameters relate to each other.
- Name
An eight-character input byte array.
The Name array provides an identification for each spool file created
(one per host job in your submitted stream).
The identification in Name must begin with a letter, contain alphanumeric characters,
and be left-justified and blank-filled.
If a blank name is supplied, the spool file is named with the
jobname from your JCL JOB card.
- Pri
An integer input parameter.
The Pri parameter specifies your job input priority, from 0
through 14; 14 is the highest priority.
If you set Pri=0, the MPE-configured default is used.
- Direct
An input integer. The
Direct parameter, together with the SubCode element for each FileList entry, indicates translation and compression.
The settings for Direct are as follows:
An odd
number: your job file is written directly to the MPE Spooler. Any
translation or compression is done during transmission of the job
file to the host.
An even number: any required translation or compression
is done while copying the files you specified in FileList to the spool file of your job.
Table 5-4 “SubCode — Direct Relationship”, in the NRJESubmit intrinsic description, shows how the Direct and SubCode parameters relate to each other.
The three parameters described below (PR, PU, and FO) cannot be used if you are connected to a VSE/POWER host
system.
- PR
An input byte array of up
to eighty-eight characters, left-justified and blank-filled, with
no embedded blanks.
The PR array is used to control standard forms output to the
printer and contains one of these:
A backreferenced formal file designator
preceded by an asterisk (*fileid).
The ldev of an MPE output device (a numeric entry).
An MPE device class name, enclosed in double quotation
marks ("DevClass").
An actual file designator. The file must be built before
the job is submitted.
An alternate form name used as a key into the Lookup
Table. This designation can be up to eight characters long and must
be delimited by single quotes ('formid').
- PU
An input byte array of up
to eighty-eight characters, left-justified and blank-filled, with
no embedded blanks. The PU array is used to control standard forms output to the
punch stream. It is the same form as the PR array.
- FO
An input byte array of up
to eighty-eight characters, left-justified and blank-filled, with
no embedded blanks. The FO array is used to control special forms output for both
the printer and punch stream. It is the same form as the PR array.
- 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.