The commands available for user batch jobs include most interactive MCR or DCL commands. User-written CLI commands may also be used in user batch jobs. The syntax is identical to interactive CLI commands except that a dollar sign ($) must precede each CLI command in the user batch job. A user batch job is a text file that reproduces an entire terminal session. User batch jobs may also include batch-specific commands which are recognized by the batch processor only. These also must be preceded by a dollar sign. The first command in a user batch job must be $JOB and the last must be $EOJ. Help is available on the following batch-specific commands: CONTINUE GOTO DATA IF EOD JOB EOJ ON STOP SET For additional help type HELP BATCH command. For information on submitting batch jobs type HELP SUBMIT. 2 JOB JOB JOB marks the beginnning of the batch job and must appear first in the file. $JOB[/qualifier] [loglabel] [[uic]] Command Qualifier /TIME:m or /TIME:(hh:mm) The /TIME qualifier limits CPU time for the user batch job. HEL and LOGIN should not be used for batch jobs. 2 EOJ EOJ EOJ ends the user batch job. $EOJ BYE or LOGOUT cannot be used for batch jobs. 2 ON ON ON defines an exit status code and specifies the action to be taken by the batch processor when that code or a more severe code is returned by subsequent commands and tasks. STOP $ON status-code THEN CONTINUE GOTO label status-code: WARNING ERROR SEVEREERROR ON WARNING THEN STOP is the default setting. The default setting is restored after an ON has been activated. See also HELP BATCH IF. 2 IF IF IF checks for a given status code following execution of a the previous command in the batch job. Unlike ON, IF responds only to the status-code you specify. GOTO label $IF status-code THEN CONTINUE STOP status-code: WARNING ERROR SEVEREERROR See also HELP BATCH ON. 2 GOTO GOTO GOTO directs BPR to skip directly to a line with a specified label and continue processing from there. The line may appear after or before the GOTO. GOTO can be used alone or with ON or IF. $GOTO label $ON status-code THEN GOTO label $IF status-code THEN GOTO label $label:[command] A label can be any six alphanumeric characters. On the GOTO line, the label is NOT terminated with a colon (:). On the line actually being labeled, the label is terminated with a colon. 2 CONTINUE CONTINUE CONTINUE is a no-operation. It can be used alone or with ON or IF. $CONTINUE $ON status-code THEN CONTINUE $IF status-code THEN CONTINUE See HELP/DCL CONTINUE for information on the DCL interactive form of this command. 2 DATA DATA DATA marks the beginning of a data block included in the user batch job. Data is any required user input other than MCR, DCL or any other CLI commands. DATA should immediately follow the command that requests input. $DATA[/qualifier[s]] Command Qualifiers /NOCOPY /DOLLARS[:"string"] You do not need to specify DATA unless you need to specify any of its qualifiers. /NOCOPY specifies that the data block not be included in the batch log file. /DOLLARS permits lines beginning with a dollar sign ($) to be treated as data. Without this qualifier, the first line beginning with $ closes the data block. If you use /DOLLARS, you must explicitly close the data block with $EOD. If you specify a string argument to /DOLLARS, you must use that string to close the data block. 2 EOD EOD EOD marks the end of a data block. $EOD EOD must be used if you have opened the data block with either DATA/DOLLARS or DATA/DOLLARS:"$EOD". See also HELP BATCH DATA. 2 SET SET [NO] ON SET NO ON disables the current setting of ON, including the default. The space between NO and ON is optional. $SET NO ON SET ON reinstates the ON setting to whatever it was before the SET NO ON. $SET ON SET can be used with other parameters or qualifiers as a CLI command, and has the same effect in batch jobs as in interactive mode. 2 STOP STOP STOP stops the batch job. It can be used alone or with ON or IF. $STOP $ON status-code THEN STOP $IF status-code THEN STOP See also HELP/DCL STOP for the DCL interactive form of this command.