RERUN_UC_OBJECT

Use the RERUN_UC_OBJECT script function to continue a Workflow that has been rolled back. The function reruns all child tasks with the following statuses in the Workflow:

• ENDED_ROLLBACKED
• ENDED_ROLLBACK_EMPTY
• Waiting for rollback

Notes:

• You can only rerun Workflows that have been rolled back.
• You cannot rerun a Workflow that has already ended.

More Information:

• Rolling Back Tasks and Workflows
• ROLLBACK_UC_OBJECT

Syntax

RERUN_UC_OBJECT (RunID)

Parameters

• RERUN_UC_OBJECT
  Reruns tasks that have been rolled back in a Workflow

• RunID
  RunID of the Workflow that has been rolled back
  Format: script variable, number without quotation marks, or script literal

Return Codes

• 12113
  The specified task is not a Workflow.
• 11011
  No object with the specified RunID could be found.

Example

The following example retrieves the status of a Job. If the status is 1904 (ENDED_ROLLBACKED), the script retrieves the RunID of the Workflow that contains the Job, and reruns the Workflow.

:SET &RET# = GET_UC_OBJECT_STATUS(, &RUNID#, "STATUS")

:IF &RET# = 1904
:SET &PARENT# = GET_PARENT_NR(&RUNID#)
:SET &RB# = RERUN_UC_OBJECT(&PARENT#)
:ENDIF

See also: