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.

The job can also be a library element (LMS). It is also possible to pass the job's JCL to the Entire Systems Management Adapter on a card-by-card basis.

See also SUBMIT Programming Notes at the bottom of this view description.

Relevant Error Codes

Code Text
530 Access denied by Security Facility.
531 Password missing or incorrect.
556 File is in use.
565 Syntax error in dataset name.
692 You are not permitted to access member.
701 DSNAME missing.
732 Account number missing.
733 User ID does not exist.
756 Job variable name missing or invalid.
758 User ID is missing.
772 Requested dataset not found.
798 Task was not started under TSOS.
799 Entire Systems Management Adapter internal error.
856 Operator unable to mount volume.
883 Dataset is full.
889 Permanent I/O error while writing dataset.
903 Dynamic allocation failed for temporary dataset.
909 Syntax error in JCL command.
991 Unknown product.
992 Requested job variable not found.
993 OPEN error.
998 Member not found.

Field Descriptions

Dictionary Field Name Format/

Length/

Desc/

Mu

Description
ACCOUNT-NUMBER (A8)

D

 Account number for the job.
CARD (A80)

D

 Required if no DSNAME/MEMBER is given.

Record to compose job control to be submitted to the Operating System.

DSNAME (A54)

D

 Fully qualified file name containing the job control to be submitted. To perform the submit, a second SUBMIT request with FUNCTION=CLOSE is required.
ELEMENT (A64)

D

 Elements from which cards are to be submitted.
ELEMENT-PASSWORD (A8)

D

 Password for protected LMS element.
ERASE-AFTER-RUN (A3)

D

 Possible values:

NO - Do not erase ENTER file after run.

YES - Erase ENTER file after run.
FUNCTION (A8)

D

 Function to be performed. Possible options:

Blank - Default. Pass a job control card or the name of the file or element to be submitted to ESA.

CLOSE - All cards have been processed. Specify this on the last request.

IDENTIFIER (A8)

D

 Required if multiple update views are executing in parallel. All requests for the same view must have the same identifier.
JOB-CLASS (A8)

D

 Name of the job class where the job is to run.
JOB-ID (A8)

D

 Same as JOB-NUMBER, only in alpha format.
JOB-NAME (A8)

D

 Name of job to be submitted.
JOB-NUMBER (N7) This field is returned after a call with FUNCTION=CLOSE. This field contains the TSN of the submitted job, if the TSN is numeric. In case of error, the field contains 0.
JOB-PRIORITY (A3)

D

 Scheduling priority for a job. Possible values are between 9 and the maximum of the job class, or STD. STD is the default.
JOB-VARIABLE-PASSWORD (A8)

D

 Password for protected monitoring job variable.
MONITOR-JOB-VARIABLE (A54)

D

 Specifies the name of a monitoring job variable that always contains the job status:

$A - Job abended.

$R - Job is running.

$S - Job is in input queue.

$T - Job terminated normally.
PASSWORD (A8)

D

 Password for protected file.
PRODUCT (A1)

D

 Access method for file containing the job control:

M - LMS
REPEAT-OPTION (A17)

D

 Specifies repeated job runs. Possible options:

AT-STREAM-STARTUP - Job is repeated at every scheduler startup.

DAILY - Job runs daily.

NO - Job is not repeated.

PERIOD - Specifies time interval for repeat runs.

STD - Default. Take the job class default.

WEEKLY - Job runs weekly.

Time given in REPEAT-TIME.
REPEAT-TIME (A5)

D

 Specifies time for repeat runs (see REPEAT-OPTION).
RUN-PRIORITY (A3)

D

 Priority during job execution. The value can be between job class maximum and 255, or STD. STD is the default and is also used if the RUN-PRIORITY value is invalid.
START-DATE (A8)

D

 Start date value in format YY-MM-DD.
START-DATX (D)

D

 Start date in Natural format.
START-OPTION (A17)

D

 Specifies start of job. Possible options:

AT - Start at given time/date.

AT-STREAM-STARTUP - Start job at the start of the scheduler.

EARLIEST - No start before date/time.

IMMEDIATELY - Start now.

LATEST - No start after date/time.

SOON - As soon as possible.

STD - Default. Use job class default.

WITHIN - Specifies a time range.

The starting date and/or time are given in the fields START-DATE and START-TIME.

START-TIME (A5)

D

 Start time value in format HH:MM.
START-TIMX (T)

D

 Start time in Natural format.
TIME (A5)

D

 Maximum CPU time the job may consume. Possible values:

t - Time value in seconds.

NTL - No Time Limit.

STD - Default. As defined in the job class.
USERID (A8)

D

 User ID under which the job is to be submitted.
USER-PASSWORD (A32)

D

 Password belonging to the user ID under which the job is to be started.

SUBMIT Programming Notes

SUBMIT is an UPDATE view, i.e., data is transmitted from the Natural program (client side) to ESA (server side).

The Entire Systems Management Adapter 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 Systems Management Adapter 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.

If system is configured to work with encrypted passwords (class 2 system parameter ENCRYPT), the Entire Systems Management Adapter requires startup parameter JOBENT=YES to submit jobs for password protected users. Class 2 system parameter SVC79 must be enabled also.