GET_CONDITION

Use the GET_CONDITION script function to determine the earliest start time of a Workflow, or of a task within a Workflow. The script function returns the earliest start time in DD/HH:MM format.

The earliest start time can be defined in the following ways:

• In the Time & Dependencies settings of the task
• In the Time & Dependencies settings of the START node of the Workflow
• By a :SET_CONDITION script statement at runtime

More Information:

• Time & Dependencies
• :SET_CONDITION

Syntax

GET_CONDITION (Condition)

Parameters

• GET_CONDITION
  Retrieves the earliest start time of a Workflow or a task in a Workflow

• Condition
  Specifies whether to retrieve the earliest start time of the Workflow or of the task in the Workflow
  Format: script literal or script variable
  Allowed values:

  • EARLIEST_START_TIME
    Earliest start time of the task that contains the script
  • JOBP_EARLIEST_START_TIME
    Earliest start time of the Workflow
    Important! Only use this parameter in the script of a Workflow when the Workflow itself has a parent Workflow. The script function returns the earliest start time of the parent Workflow. An error occurs if there is no parent Workflow.

Note: GET_CONDITION only works with Workflows and tasks in Workflows.

Example

A task that contains the following script runs in a Workflow. The first line of the script retrieves the earliest start time of the task itself. The second line retrieves the earliest start time of the Workflow. The script prints both times in the activation report of the task.

:SET &RETJOBS# = GET_CONDITION ("EARLIEST_START_TIME")
:SET &RETJOBP# = GET_CONDITION ("JOBP_EARLIEST_START_TIME")
:PRINT "Earliest start time for task:", &RETJOBS#
:PRINT "Earliest start time for Workflow:", &RETJOBP#

See also: