submit - Submit a batch job for background processing

Format

submit [-jq] [filename ...]

Description

The submit command sends a batch job to the primary job entry subsystem (JES) for processing. The filename argument can either be a UNIX path name, data set, or input from standard input (stdin).

If the filename argument is a sequential data set, filename is specified as:
```
 "//'full.data.set.name'"
```
If the filename argument is a partitioned data set, filename is specified as
```
"//'full.pds.name(member)'"
```
where member is the member name of the partitioned data set FULL.PDS.NAME.

If no argument is given, submit reads from standard input. When standard input is being used, enter /// or Ctrl-D to end the input.

If the submit command is successful, the job ID of the submitted job and the file name are displayed as part of the output written to standard output, unless modified by the -j option.

The JCL must have a job card. If a job card is not present, the submit command will fail.

Options

-j: Displays only the job ID when the submit command is successful.
-q: Quiet mode. In quiet mode, all error messages are suppressed and the exit status is preserved.

Examples

To submit a job that resides in a z/OS® UNIX file:
```
submit buildjcl.jcl
```
Output to standard output:
```
JOB JOB05990 submitted from path 'buildjcl.jcl'
```

To submit a job that resides in a partitioned data set:

submit "//'POSIX.RTL.UT13.JCL(TESTJCL)'"

Output to standard output:

JOB JOB06075 submitted from data set 'POSIX.RTL.UT13.JCL(TESTJCL)'

To submit a job from standard input, you can specify the following command:
```
cat test.jcl | submit     
```
Output to standard output:
```
 JOB JOB21532 submitted from stdin
```

Exit values

0: All jobs were submitted successfully.
1: One or more jobs were not submitted.
2: Incorrect command-line arguments or options.

Usage notes

The submit shell command uses the REXX submit() function. For more information about the function, see submit() in z/OS Using REXX and z/OS UNIX System Services.

Localization

The submit command is not sensitive to a user's locale. It is up to the user to provide input that is acceptable to JES.

Limitations

JOBNAME can only be specified from within the JCL.
Only fully qualified data set names are accepted.
This version of submit cannot be run directly from TSO.
If multiple job cards are present in a file, submit only displays the job ID of the last job submitted within that file.
If a PDS member is specified, and the data set exists but the member does not, it produces the following messages to standard output:
```
IRX0250E System abend code 013, reason code 00000024. 
IRX0255E Abend in host command execio or address environment routine MVS. 
IRX0670E EXECIO error while trying to GET or PUT a record.
```
submit then attempts to submit an empty job, and produces message FSUMB409 on stderr.
Do not include ANSI control characters in data sets (for example, RECFM=FBA) that are submitted to JES because they will not be accepted.