confirm

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

Overview

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

When you use the confirm command while the task is running, the confirmation overrides the evaluation status when the task is finished. Based on the (SUCC or ABEND) status that you provide with the command, the tasks 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 task are set to false. You must have confirm access to the task.

Syntax and command line options

Before you run the command, you must specify the details of the command line options such as task 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 task to update, by using attributes and qualifiers.

For example, enter the following command WA_AGT_0#WORKFLOW.TASK.

SUCC
To confirm that the task ended successfully.
ABEND
To confirm that the task 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 task 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 task4 task in fronttl(1000 04/11/08) workflow, run the following command:
    ocli plan confirm fronttl(1000 04/11/08).task4;succ
  2. To issue an abend confirmation for the 352 task, run the following command:
    ocli plan confirm 352;abend
  3. To issue a succ confirmation for task7 task and set the MYOUTPUTCOND result to true in the weekly(1230 04/11/2018) workflow workflow, run the following command:
    ocli plan confirm weekly(1230 04/11/2018).task7;succ if MYOUTPUTCOND