| File | 200 |
|---|---|
| Statement | PROCESS
|
| Task | This view allows you or a program to submit a job to the operating system. The job to be submitted can reside on disk or in storage. See also SUBMIT Programming Notes at the bottom of this view description. |
| Dictionary Field Name | F/L | Mu | DE | Remarks |
|---|---|---|---|---|
ERROR-CODE
|
N3 | |||
ERROR-TEXT
|
A58 | |||
NODE
|
N5 | D | ||
NODE-NAME
|
A16 | D | ||
SYSTEM-MESSAGE-CODE
|
A10 | |||
CARD
|
A80 | D | Required if no DSNAME /
MEMBER is given.
|
|
JOB-NUMBER
|
N7 | D | ||
JOB-ID
|
A8 | D | ||
DSNAME
|
A54 | D | Required if no CARD is given.
|
|
PASSWORD
|
A8 | D | ||
FUNCTION
|
A8 | D | Required for the last submit request. | |
IDENTIFIER
|
A8 | D | Required with multiple parallel submit calls. | |
JOB-NAME
|
A8 | D | ||
FROM-NODE
|
N5 | D | ||
FROM-USERID
|
A8 | D | ||
FROM-USER-PASSWORD
|
A32 | D | ||
MEMBER
|
A10 | D | Required | |
GENERATION |
N9 | D | ||
VOLSER
|
A6 | D | Required only if dataset is not cataloged. | |
PRODUCT
|
A1 | D | ||
OPTIONS
|
A8 | D |
| Code | Text |
|---|---|
| 500 | VSAM error. |
| 699 | GETVIS failed. |
| 899 | I/O error during read. |
| 901 | Alloc of reader failed. |
| 902 | Dynamic alloc failed. |
| 993 |
OPEN error.
|
| Field Name | Type/Length |
|---|---|
CARD
|
(A80) |
JCL record to be sent from Natural to the internal reader.
| Field Name | Type/Length |
|---|---|
DSNAME
|
(A54) |
Fully qualified dataset or file name containing the JCL to be
submitted. To perform the submit, a second SUBMIT request with
FUNCTION=CLOSE is required.
| Field Name | Type/Length |
|---|---|
FROM-NODE
|
(N5) |
Entire System Server node on which the JCL for the job is to be read. Ignored if it
matches the USING node or the node where the user is already logged in.
| Field Name | Type/Length |
|---|---|
FROM-USERID
|
(A8) |
User ID in the FROM-NODE.
| Field Name | Type/Length |
|---|---|
FROM-USER-PASSWORD
|
(A32) |
User password in the FROM-NODE.
| Field Name | Type/Length |
|---|---|
FUNCTION
|
(A8) |
Function to be performed. Possible options:
| Option | Explanation |
|---|---|
| blank | Default. Pass a JCL card or the name of the dataset or member/element to be submitted to the Entire System Server. |
CLOSE
|
All cards have been processed - perform the submit. You
must specify this function for the last SUBMIT request.
|
| Field Name | Type/Length |
|---|---|
GENERATION
|
(N9) |
Generation number of member (only valid for PDSE version 2 with MAXGENS > 0).
| Field Name | Type/Length |
|---|---|
IDENTIFIER
|
(A8) |
Required if multiple submit calls are executing in parallel, as requests for the same job to be submitted must have the same identifier.
| Field Name | Type/Length |
|---|---|
JOB-ID
|
(A8) |
Same as JOB-NUMBER, only in alpha format.
| Field Name | Type/Length |
|---|---|
JOB-NAME
|
(A8) |
Name of job to be submitted.
| Field Name | Type/Length |
|---|---|
JOB-NUMBER
|
(N7) |
This field is returned after a call with
FUNCTION=CLOSE.
Job number assigned by the JES . If JOB-NUMBER=0,
no valid job card was sent.
|
| Field Name | Type/Length |
|---|---|
MEMBER
|
(A10) |
Name of member that contains the JCL to be submitted.
| Field Name | Type/Length |
|---|---|
OPTIONS
|
(A8) |
Specify X to expand all ++INCLUDE
statements.
| Field Name | Type/Length |
|---|---|
PASSWORD
|
(A8) |
Password for protected dataset.
| Field Name | Type/Length |
|---|---|
PRODUCT
|
(A1) |
Access method for dataset containing the JCL. Possible options:
| Option | Explanation |
|---|---|
L
|
CA-Librarian |
P
|
CA-Panvalet |
| Field Name | Type/Length |
|---|---|
VOLSER
|
(A6) |
Volume serial number. Required only if the dataset is not cataloged.
SUBMIT is an UPDATE view, i.e., data is
transmitted from the Natural program (client side) to ESY (server side).
The Entire System Server view SUBMIT returns codes and
messages that describe whether the requested operation has been executed
successfully or not, and the JOB-NUMBER of a submitted job.
Therefore, the DEFINE DATA section of the Natural
program should only contain the fields shown in the following example:
1 SUBMIT VIEW OF SUBMIT
2 ERROR-CODE 2 ERROR-TEXT 2 SYSTEM-MESSAGE-CODE
2 SYSTEM-CODE 2 JOB-NUMBER
These fields in DEFINE DATA are the fields returned
from the SUBMIT view in Entire System Server to the calling
Natural program.
Defining other fields in the DDM is not critical, but the access to these fields may lead to unpredictible results.
