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