The ENTER-PROCEDURE call command

If an S procedure is to be started as a background procedure, it must be called by an ENTER-PROCEDURE command. An ENTER file is created internally when this is done, and the file is started with the ENTER-JOB command.

Method

1. A copy of the procedure file is made under the name S.PROC.tsn.date.time, with date in the format yyyy-mm-dd and time in the format hh.mm.ss.

2. An ENTER file with the following contents is created under the name S.E.tsn.date.time:

   /SET-LOGON-PARAMETERS
   :
   :
   :
    /CALL-PROCEDURE FROM-FILE=S.PROC.tsn.date.time, -
   /                          PROCEDURE-PARAMETERS=(parameter)
   :
   :
   :
   /EXIT-JOB SYSTEM-OUTPUT=option
   

   The value of parameter corresponds to the specification in the operand PROCEDURE-PARAMETERS. (Procedure parameters can only be passed as values (*BY-VALUE).) After execution of the procedure, the copy of the procedure file is deleted (if the background procedure is not to be repeated). The value of option corresponds to the specification in the SYSTEM-OUTPUT operand.

3. The ENTER file is started with ENTER-JOB. The specifications for the operands PROCESSING-ADMISSION, JOB-CLASS, JOB-NAME, MONJV, JV-PASSWORD, JOB-PRIORITY, RERUN-AFTER-CRASH, FLUSH-AFTER-SHUTDOWN, START, REPEAT-JOB, RESOURCES, LISTING and JOB-PARAMETER are taken from the entries in the ENTER-JOB command.

The operands of the ENTER-PROCEDURE command that determine the attributes of the background procedure are described later on in section “Job attributes”.

Notes

• “Remote Enter” is supported. This means that ENTER-PROCEDURE can also be used to call the procedure on a remote computer.

• The ENTER-PROCEDURE command cannot be called from a console.