confirm

You can use the confirm command to change the status of a job after it finishes.

Overview

When a job finishes with the ABEND status, you can use the confirm command to change the status to SUCC, so that the other depended jobs can start. You can use the confirm command to change the status of the jobs to either SUCC or ABEND, so that the workflow is not interrupted. The command can also be used when there is an issue delays job completion.

When you use the confirm command while the job is running, the confirmation overrides the evaluation status when the job is finished. Based on the (SUCC or ABEND) status that you provide with the command, the jobs finish with either SUCC or ABEND status.

You can also override the evaluation of the output conditions. For example, if you set one or more output conditions to true (by using the confirm SUCC), the specified output conditions are set to true and any other conditions in the job are set to false. You must have confirm access to the job.

Syntax and command line options

Before you run the command, you must specify the details of the command line options such as job name, arguments and required permissions. You can enter the command as follows.
ocli plan confirm | conf jobselect;[succ | abend] [IF 'output_condition_name[, output_condition_name]
     [, ...]'] [;noask]
The details that are required with each parameters are as follows:
jobselect

Specify the job to update, by using attributes and qualifiers.

For example, enter the following command WA_AGT_0#JOB_STREAM.JOB.

SUCC
To confirm that the job ended successfully.
ABEND
To confirm that the job ended unsuccessfully.
output_condition_name
To confirm the SUCC or ABEND status for one or more specified output conditions. The conditions which are not specified are set to false. This setting overrides any other evaluation.
noask

When you add the noask option as an argument, the agent does not ask for confirmation before it acts on each qualifying item.

Change in status after confirm command

Table 1. Change in status after confirm command
Initial job status Status after running the confirm ;succ command Status after running confirm ;abend command
READY No effect regardless of output conditions No effect regardless of output conditions
HOLD No effect regardless of output conditions No effect regardless of output conditions
EXEC
without output conditions
SUCC
with output conditions
SUCC_P and selected output conditions are set to satisfied
without output conditions
ABEND
with output conditions
ABEND_P and selected output conditions are set to satisfied
ABENP SUCCP regardless of output conditions No effect regardless of output conditions
SUCCP No effect regardless of output conditions No effect regardless of output conditions
PEND
without output conditions
SUCC
with output conditions
SUCC and selected output conditions are set to satisfied.
without output conditions
ABEND
with output conditions
ABEND and selected output conditions are set to satisfied.
DONE SUCC regardless of output conditions. ABEND regardless of output conditions.
SUCC
without output conditions
The operation is not supported.
with output conditions
SUCC and selected output conditions are set to satisfied.
without output conditions
This operation is not supported.
with output conditions
This operation is not supported.
ABEND SUCC, regardless of output conditions.
without output conditions
No effect
with output conditions
ABEND and selected output conditions are set to satisfied.
SUPPR
without output conditions
SUCC
with output conditions
SUCC and selected output conditions are set to satisfied.
 The operation is not supported regardless of output conditions.
FAIL This operation is not supported regardless of output conditions. This operation is not supported regardless of output conditions.

Examples

  1. To issue a succ confirmation for the job4 job in fronttl(1000 04/11/08) job stream, run the following command:
    ocli plan confirm fronttl(1000 04/11/08).job4;succ
  2. To issue an abend confirmation for the 352 job, run the following command:
    ocli plan confirm 352;abend
  3. To issue a succ confirmation for job7 job and set the MYOUTPUTCOND result to true in the weekly(1230 04/11/2018) job stream job stream, run the following command:
    ocli plan confirm weekly(1230 04/11/2018).job7;succ if MYOUTPUTCOND