NetBatch Manual

NBEXEC
NetBatch Manual—522460-004
B-2
Log Files
Log Files
Each NBEXEC process logs to its OUT file details of the interaction between the
process, the control file, and controlled processes. Each OUT file has three parts:
•
A timestamped header that lists the job’s defaults and execution environment
•
A timestamped list of the commands executed and their responses
•
Termination lines that record the completion status of the job
For a sample NBEXEC log file, see the example in High PIN Capabilities.
NBEXEC Processing
NBEXEC performs these functions when it runs as the executor program of a job:
•
Reads and validates the job’s control file. If the control file is invalid, NBEXEC logs
errors and terminates the job.
•
Starts and runs the job according to user-specified options.
•
Executes the instructions contained in the control file and performs any string
substitutions in control-file commands.
•
Recognizes abnormal termination of application processes and starts any user-
defined error recovery.
•
Gathers program output in the OUT file (unless directed elsewhere).
High PIN Capabilities
NBEXEC processes can have high PIN creators, and the :PPD command can detect
named high PIN processes in NBEXEC versions D20 and later. NBEXEC versions
earlier than D20 do not have high PIN capabilities.
Example
This example shows submission to a scheduler of an NBEXEC job that starts another
scheduler. The example lists the job’s control file, shows the BATCHCOM command
that submits the job, and displays the resulting NBEXEC log file.
> FUP COPY ZBATWARM
$KILL OFF
$ALLOW NOERRORS
:PPD $ZBAT
$IF NOT #ERROR $GOTO END
:NETBATCH /NAME $ZBAT, NOWAIT/ $DATA7.ZBAT
$IF #ERROR $GOTO END
:BATCHCOM $ZBAT; START SCHEDULER
.END
8 RECORDS TRANSFERRED
> BATCHCOM $SCHD; SUBMIT JOB ZBAT-WARM-START, EXECUTOR