GET_CONDITION

Use the GET_CONDITION script function to retrieve the earliest start time of a Workflow or of a task within a Workflow.

Prerequisites

This function only works with Workflows and tasks in Workflows. The earliest start time can be defined in the following ways: in the Time and Dependencies settings of the task, in the Time and Dependencies settings of the START node of the Workflow, or by a :SET_CONDITION statement at runtime.

Syntax

GET_CONDITION (Condition)

Parameters

Parameter	Description	Format	Allowed Values
Condition	Specifies whether to retrieve the earliest start time of the task or of the Workflow	Script literal or script variable	EARLIEST_START_TIME — Earliest start time of the task that contains the script JOBP_EARLIEST_START_TIME — Earliest start time of the Workflow. Use this only in the script of a Workflow that has a parent Workflow; the function returns the earliest start time of the parent Workflow. An error occurs if there is no parent Workflow.

Return Codes

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

Examples

The following example runs in a task inside a Workflow. The first line retrieves the earliest start time of the task itself; the second line retrieves the earliest start time of the Workflow. Both times are printed to the activation report.

:SET &RETJOBS# = GET_CONDITION("EARLIEST_START_TIME")

:SET &RETJOBP# = GET_CONDITION("JOBP_EARLIEST_START_TIME")

:PRINT "Earliest start time for task:", &RETJOBS#