QUEUE_BEHIND
Use QUEUE_BEHIND
to make become
the running job, or other jobs in the same occurrence as the running
job, a successor behind the identified operations. The QUEUE_BEHIND
command
can be abbreviated to QUEUE
.
QUEUE_BEHIND <identification> <filter> <data> [CONNECT(THIS|SUCC)]
[INSERT(CONNECTED|ENDPOINT|NONE)]
where:
<identification>
- Keywords to identify the operations to update. For details, see Identification keywords.
<filter>
- Keywords to select the operations from the list. For details, see Filter keywords.
<data>
- Keywords to store data from the command. For details, see Data keywords.
CONNECT
- Specifies the job to connect to the operations identified by the
command. If set to
THIS
, the job currently running the command becomes a successor to the identified jobs. If set toSUCC
, the internal successors of the job currently running the command becomes a successor to the identified jobs. If set toTHIS
, the job returns to the Waiting status until the newly applied predecessors have run. After the predecessors have run, the job is rerun and might find new predecessors. IfCONNECT(SUCC)
is specified and the job running the command has no successors, the command fails. INSERT
- Specifies whether to insert the connected job, or occurrence after
the identified job, so that it becomes a predecessor to the successors
of the identified job. Specifying
CONNECTED
, makes the jobs identified by theCONNECT
keyword a predecessor to the successors of the operations identified by the command. SpecifyingENDPOINT
will find the end points of the occurrence and make them a predecessor to the successors of the identified job. SpecifyingNONE
will not insert the running occurrence before the successors of the identified job (this is the default). If anything other thanINSERT(NONE)
is specified and the job identified by theQUEUE_BEHIND
command has no successors, the command fails.
Note: The
QUEUE_BEHIND
command is designed
to influence the occurrence where the job running the command is contained.
If the command is run by a job not being controlled by HCL Workload Automation for Z,
it fails.