| File | 217 |
|---|---|
| Statement | PROCESS |
| Task | Enter procedure |
| Code | Text |
|---|---|
| 506 | Data set is migrated. |
| 530 | Access denied by Security facility. |
| 556 | File is in use. |
| 701 | DSNAME missing. |
| 733 | User ID does not exist. |
| 749 | PVS (CATID) not available. |
| 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. |
| 998 | Member not found. |
| Dictionary Field Name | Format/
Length/ Desc/Mu |
Description |
|---|---|---|
| ACCOUNT-NUMBER | (A8) | Account number for the job. |
| D | ||
| CARD | (A80) | Procedure record to be sent from Natural to the temporary file. |
| D | ||
| COMMAND-RESPONSE | (A253) | ENTER-PROCEDURE command response. |
| DSNAME | (A54) | Name of the procedure file to be entered. |
| D | Required if no CARD is given. | |
| FUNCTION=CLOSE is required to enter the procedure. | ||
| ELEMENT | (A64) | Name of the LMS element to be entered. |
| D | ||
| ELEMENT-PASSWORD | (A8) | Password for protected LMS element. |
| D | ||
| FUNCTION | (A8) | Function to be performed. Possible options: |
| D | Blank Pass a job card or the name of a file or | |
| an element to be submitted to ESA. | ||
| CLOSE All cards have been submitted. | ||
| Specify this on the last request. | ||
| IDENTIFIER | (A8) | Required if multiple update views are executing in parallel. All requests for the same view must have the same identifier. |
| D | ||
| JOB-CLASS | (A8) | Name of the job class where the job is to run. |
| D | ||
| JOB-ID | (A8) | This field is returned after a call with FUNCTION=CLOSE. |
| JOB-NAME | (A8) | Name of the job to be entered. |
| D | ||
| JOB-PRIORITY | (A3) | Scheduling priority for job. Possible values are between 9 and the maximum of the job class, or STD. STD is the default. |
| D | ||
| JOB-VARIABLE-PASSWORD | (A4) | Password for protected monitoring job variable. |
| D | ||
| MONITOR-JOB-VARIABLE | (A54) | Specifies the name of a monitoring job variable that always contains the job status. For an explanation, see the description of the MONITOR-JOB-VARIABLE parameter of the view SUBMIT. |
| D | ||
| PARAMETER-SET-1 | (A253) | Extra operands for command ENTER-PROCEDURE. |
| D | ||
| PARAMETER-SET-2 | (A253) | Extra operands for command ENTER-PROCEDURE. |
| D | ||
| PASSWORD | (A8) | Password of protected file. |
| D | ||
| REPEAT-OPTION | (A17) | Specifies repeated job runs. For an explanation, see the description of the REPEAT-OPTION parameter of the view SUBMIT. |
| D | ||
| REPEAT-TIME | (A5) | Specifies time for repeat runs. For an explanation, see the description of the REPEAT-TIME parameter of the view SUBMIT. |
| D | ||
| RUN-PRIORITY | (A3) | Priority during job execution. The value can be between job class maximum and 255, or STD. STD is the default. |
| D | ||
| START-DATE | (A8) | Start date value in format YY-MM-DD. |
| D | ||
| START-DATX | (D) | Start date of the entered procedure in Natural format. |
| START-OPTION | (A17) | Specifies start of job. For an explanation, see the description of the START-OPTION parameter of the view SUBMIT. |
| D | ||
| START-TIME | (A5) | Start time value in format HH:MM. |
| D | ||
| START-TIMX | (T) | Start time of entered procedure in Natural format. |
| TIME | (A5) | Maximum CPU time the job may consume. For an explanation, see the description of the TIME parameter of the view SUBMIT. |
| D | ||
| USERID | (A8) | User ID under which the job is to be submitted. |
| D | ||
| USER-PASSWORD | (A32) | Password belonging to the user ID under which the job is to be started. |
| D |
ENTER-PROCEDURE is an UPDATE view, that is, data is transmitted from the Natural program (client side) to ESY (server side).
The Entire Systems Management Adapter view ENTER-PROCEDURE returns codes and messages that describe whether the requested operation has been executed successfully or not.
Therefore, the DEFINE DATA section of the Natural program should only contain the fields shown in the following example:
1 ENTER-PROCEDURE VIEW OF ENTER-PROCEDURE 2 ERROR-CODE 2 ERROR-TEXT 2 SYSTEM-MESSAGE-CODE 2 SYSTEM-CODE 2 COMMAND-RESPONSE 2 JOB-ID 2 START-DATX 2 START-TIMX
These fields in DEFINE DATA statement are the fields returned from the ENTER-PROCEDURE view in Entire Systems Management Adapter to the calling Natural program.
Defining other fields in DDM is not critical, but the access to these fields may lead to unpredictible results.