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

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

More Information:

• Configuring the Time & Dependencies Properties of a Task in a Workflow
• :SET_CONDITION

Syntax

GET_CONDITION (Condition)

Parameters

Parameter

Description

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.

Return Code

The earliest start time in DD/HH:MM format.

Examples

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