Automation Engine Script Guide > Ordered by Function > Read or Modify Objects > :SET_CONDITION

:SET_CONDITION

Script statement: Sets the earliest start time in workflows

Syntax

:SET_CONDITION Condition [= Value]

Syntax	Description/Format
Condition	Start condition that should be set. Format: script literal or script variable Allowed values: "EARLIEST_START_TIME", "JOBP_EARLIEST_START_TIME" "EARLIEST_START_TIME" = Earliest start time of a task within a workflow"JOBP_EARLIEST_START_TIME" = Earliest start time of a workflow
Value	Earliest start time that should be se.t Format: script literal or script variable Format: "DD/HH:MM" Default value: "00/00:00"

Syntax

Description/Format

Condition

Start condition that should be set.
Format: script literal or script variable

Allowed values: "EARLIEST_START_TIME", "JOBP_EARLIEST_START_TIME"

"EARLIEST_START_TIME" = Earliest start time of a task within a workflow"JOBP_EARLIEST_START_TIME" = Earliest start time of a workflow

Value

Earliest start time that should be se.t
Format: script literal or script variable

Format: "DD/HH:MM"
Default value: "00/00:00"

Comments

This script statement only works within the tasks of a workflow.

The earliest start time that is set with this function only applies for the particular object execution . The point in time that can be specified in the task properties is not changed. The earliest start time can also be retrieved at runtime using the script function GET_CONDITION.

The following rules apply for setting the earliest start time:

With "EARLIEST_START_TIME" this script statement sets the earliest start time of the task in whose script it is called. This script statement is not allowed if "generate at runtime" ("Attributes" tab) has been defined for the task. In this case, the task would have started already when the script is to be processed.
If this script statement is used with "JOBP_EARLIEST_START_TIME" in the script of a task, it sets the earliest start time of the workflow. Here the script statement does cannot be used with "Generate at runtime".
In the script of a workflow, the script statement with "JOBP_EARLIEST_START_TIME" can only be used for setting the earliest start time of a superordinate workflow (parent). An error occurs if there is no parent workflow.

The earliest start time of the workflow is the particular point in time that has been defined in the START box of the workflow.

Example

In this example, the script statement is used in the script of a task running in a workflow. The task's and the workflow's earliest start times are set and output in the activation report.

:SET_CONDITION "EARLIEST_START_TIME"="00/10:19"
:SET_CONDITION "JOBP_EARLIEST_START_TIME"="00/10:18"
:SET &RETJOBS# = GET_CONDITION ("EARLIEST_START_TIME")
:SET &RETJOBP# = GET_CONDITION ("JOBP_EARLIEST_START_TIME")
:PRINT "New earliest start time of the task:", &RETJOBS#
:PRINT "New earliest start time of the workflow:", &RETJOBP#