SUBMIT

#### Search Results

Search

# SUBMIT

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.

## Fields

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 |

## Relevant Error Codes

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 Descriptions

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 Programming Notes

`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.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions
- SUBMIT Programming Notes