HCL Workload Automation, Version 9.4

confirm

Confirms the completion of a job that was scheduled with the confirmed keyword. By default, evaluation on the job is performed when the job completes. However, if you confirm the job while it is running, the confirmation overrides the evaluation performed at job completion time. You can also override the evaluation of the output conditions: for example, if you set one or more output conditions to true (using 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

{confirm | conf} jobselect
    ;{succ | abend}
    [;IF 'output_condition_name[, output_condition_name]
     [, ...]'] [;noask]

Arguments

jobselect: See Selecting jobs in commands.
succ: Confirms that the job ended successfully.
abend: Confirms that the job ended unsuccessfully.
output_condition_name: Confirms the SUCC or ABEND status for one or more specified output conditions. Any conditions not specified are set to not satisfied. This setting overrides any other evaluation.
noask: Specifies not to prompt for confirmation before taking action on each qualifying job.

Comments

Changing the state of a job from ABEND to SUCC does not require that the confirmed keyword be used to schedule the job. For more information about job confirmation, see confirmed. For more information about EXTERNAL jobs, see Managing internetwork dependencies in the plan.

Table 1 shows the effect of the confirm command on the various states of jobs, with or without output conditions:

Table 1. State change after confirm command
Initial Job State	State after confirm ;succ	State after confirm ;abend
READY	No effect, with or without output conditions	No effect, with or without output conditions
HOLD	No effect, with or without output conditions	No effect, with or without 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, with or without output conditions	No effect, with or without output conditions
SUCCP	No effect, with or without output conditions	No effect, with or without 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, with or without output conditions.	ABEND, with or without 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 The operation is not supported. with output conditions The operation is not supported.
ABEND	SUCC, with or without output conditions.	No effect, with or without output conditions.
SUPPR	without output conditions SUCC with output conditions SUCC and selected output conditions are set to satisfied.	The operation is not supported, with or without output conditions.
FAIL	The operation is not supported, with or without output conditions.	The operation is not supported, with or without output conditions.
SCHED	No effect, with or without output conditions	No effect, with or without output conditions
ERROR (for shadow jobs only)	SUCC, with or without output conditions	ABEND, with or without output conditions
any job in the `EXTERNAL` job stream	SUCC, with or without output conditions	ABEND, with or without output conditions

Examples

To issue a succ confirmation for job job3 in job stream misdly(1200 02/17/06), run the following command:

confirm misdly(1200 02/17/06).job3;succ

To issue an abend confirmation for job number 234, run the following command:

confirm 234;abend

To issue a ;succ confirmation for job job4 and set MYOUTPUTCOND to true in the daily(1130 02/17/2016) job stream, run the following command:

confirm daily(1130 02/17/2016).job4;succ if MYOUTPUTCOND

The following example shows the effect of the confirm command on the status of the 79765613 job and its output conditions. The 79765613 job completed in SUCC status:

Type the showjobs;info command to retrieve information about the job:

sj 79765613;info

The following sample output is a subset of the information you obtain by running the command:

Workstation      Job Stream       SchedTime       Job
NC050239        #DUBAIJS1         1908 10/23      (NC050239_1#)JS2                                                                             

                                                oc: OUT1 false "RC=2"
                                                oc: OUT2 true "RC=1500"

The first output condition, OUT1 is false and the second one, OUT2, is true.

Type the confirm command to confirm the ABEND status on condition OUT1:
```
confirm 79765613 ABEND; IF OUT1
```

Type the showjobs;info command again. The following sample output is a subset of the information you obtain by running the command:

Workstation      Job Stream       SchedTime       Job                                                 
NC050239        #DUBAIJS1         1908 10/23      (NC050239_1#)JS2                                                                             

                                                oc: OUT1 true "RC=2"
                                                oc: OUT2 false "RC=1500"

The first output condition, OUT1 has now changed to true and the second one, OUT2, has changed to false.