Script Function: Determines earliest start times in workflows
Syntax
GET_CONDITION (Condition)
|
Syntax |
Description/Format |
|---|---|
|
Condition |
Start condition to be determined Allowed values: "EARLIEST_START_TIME",
"JOBP_EARLIEST_START_TIME" |
|
Return code |
|---|
|
Earliest start time of the task or workflow in the format "TT/HH:MM" |
Comments
This script function only works within a workflow.
The earliest start time may be specified in the properties of tasks and in the START box of workflows. It can also be set at runtime with the script statement :SET_CONDITION.
For determining the earliest start time, the following relations apply:
- With "EARLIEST_START_TIME", this script function determines the earliest start time of the task in whose script it is called.
- If this script function is used with "JOBP_EARLIEST_START_TIME" in the script of a task, it returns the earliest start time of the workflow.
- In the script of a workflow, this script function may only be used with "JOBP_EARLIEST_START_TIME" if this workflow is part of a superordinate workflow. The earliest start time of the parent workflow is returned. An error occurs if no parent workflow exists.
The earliest start time of the workflow is the point in time that has been defined in the START box of the workflow.
Example
In the following example, the script function is used in the script of a task that is running within a workflow. The earliest start time of the task and the workflow are queried and output in the activation protocol.
:SET &RETJOBS# = GET_CONDITION ("EARLIEST_START_TIME")
:SET &RETJOBP# = GET_CONDITION ("JOBP_EARLIEST_START_TIME")
:PRINT "Task's earliest start time:", &RETJOBS#
:PRINT "Workflow's earliest start time:", &RETJOBP#
See also:
Script Elements - Ordered by Function
About Automation Engine Scripts