Start Enter job

The 4 variants of the E (Enter) command and their syntax are first described, followed by the parameters of the E command.

Start Enter Job

E { enter-file | lib(element) } [ /enter-params | , ? ] [, JRF=jr-file]

Start DO procedure in Enter mode

E[N,] { DO procedure | lib(element) } [, DO-params | , ? ] [ / [ enter-params] [, JRF=jr-file] [, JN=jobname] ]

Start Enter job or DO procedure with predefined parameters

E[N,] %name | %? [, jrsave]

The parameters must have been saved previously with an SP (Save Params) command. The SP command can only be given in the command field of the parameter mask.

E Specifying the E command without any operands will cause the parameter mask to be displayed with the parameter values from the last DO procedure or Enter job already filled in.

Parameters:

N Suffixing the E command with N will suppress the parameter analysis for a DO procedure (see page 11-). All the required parameters must be specified in the E command.

enter-file Name of the Enter file to be started. This file must begin with a LOGON command and end with a LOGOFF command, or with the respective SDF commands. If a protocol listing (SYSOUT/SYSLST) is to be displayed after the termination of the job, the relevant SYSFILE SYSOUT or SYSFILE SYSLST command, or its respective SDF command must be inserted.

DO procedure Name of the DO procedure to be started in Enter mode. The DO procedure must begin with a PROC statement and end with an ENDP statement, or with the respective SDF commands. The necessary /SYSFILE SYSOUT and/SYSFILE SYSLST commands will be inserted by JRS when it creates the Enter file containing the CALL to the DO procedure.

lib(element) The Enter file or DO procedure is stored in the specified library element. In PLAM libraries, the element must be stored as a J-type element.

%name Name of the parameter set in the JRSAVE file. The parameter mask saved with SP %name will be presented to the Enter job. %name establishes a relationship between a DO procedure and a particular set of parameters (for further information see the description of the SP (Save Parameters) command on page 11-).

%? All relevant parameter sets will be displayed in a list, from which one may be selected by marking it.

jrsave JRSAVE file to be used. This name should only be specified if the parameter set is not stored in the standard JRSAVE file. The naming convention for the JRSAVE file is described in Chapter 27 "CFS Files and Job Variables" under the CFS.JRSAVE section.

DO-params Parameters for the DO procedure about to be started. The DO-params can be omitted if the DO procedure does not contain any parameters, or when all parameters have already been assigned using standard values, or when the user wishes to enter the values from the parameter mask. Parameters cannot be specified together with %name.

? Entering "?" instead of DO parameters will always display the parameter mask, even if all the parameters have been assigned, or even if the procedure does not have parameters.

/enter-params BS2000 Enter parameters. Any BS2000 Enter command parameters can be specified, e.g.TIME=nn,JOB-CLASS=xxxx,PRIORITY=nnn

If a valid Enter file should be started using JRS, then the slash in the E enter-file/enter-params command can be replaced with a comma to maintain compatibility with the BS2000 Enter command: E enter-file,enter-params.

The Enter parameters can also be predefined with the JREP command, or in the JRP mask. The predefined Enter parameters in the E command will replace the predefined parameters (on a keyword basis).

? Entering "?" instead of the parameters will cause a mask to be displayed containing the standard Enter parameters (see JREP command on page 11-), which can then be amended.

JRF= SYSOUT | SYSLST

{ file | *LIB(lib,element[(vers)] [,typ] } , SYSOUT | SYSLST | JRFILE]

If a library element has been specified (*LIB ...) without the type indicator, the element will be saved as Type P.

This optional JRF parameter determines the file to be displayed when the job terminates.

JN=jobname one to eight character Job name for the Enter job created by CFS.