NBSpool for MPE Reference Guide

Background Processing
5-5
Background Jobs With XEQ
This section discusses background jobs that invoke NBSpool and its XEQ command. The NBSpool
commands that are used in the background job are
XEQ, XEQSTOP, END, ERROR and WHILE.
XEQ Command
The XEQ
command causes a file of commands to be executed either once or repetitively. The major
use of this command is to execute various NBSpool functions as a background task. This command
can be issued from either
INPUT or OUTPUT command modes. The format of the command file is
described in the beginning of this section.
When a
REPEAT or WAIT parameter is specified, the XEQ command will repeat its list of commands
from the beginning after pausing for the desired time. To allow for the stopping of this repeated
execution, each NBSpool process using
XEQ repeating will be assigned a process number. This
number will be displayed on the console and the
$STDLIST and can be used with the XEQSTOP
command.
When commands are being executed, the actual command will not be displayed unless the
SHOW
parameter is specified on the original XEQ command. If the SHOW parameter is not used, commands
will be displayed only if one or more spool files qualifies for the command. In this case, a time
stamp will also be appended to the
n Spool Files Qualify
message.
Upon the completion of all commands, one of three things occurs. If the
WAIT or REPEAT parameter
is specified, the command will pause the desired number of seconds and then repeat from the
beginning. If neither parameter was specified or if the repeat count has been reached, the command
stops. Finally, if an
XEQSTOP command was entered for this process, the command will terminate.
XEQ Syntax
O> XEQ [filename] [;REPEAT=count]
[;WAIT=seconds]
[;PROCNUM=number]
[;BACKGROUND]
[;DEVICE=dev[,dev[,...]]]
[;PRI=priority]
[;SHOW]
[;SHORT]
User Tip. This command may be abbreviated to
X
.