User Guide > Objects > Alphabetical Listing > Runtime Tab

Runtime Tab

The Runtime tab is object-class specific and is available in every executable object in AE. It can be used to specify parameters for a task's runtime behavior.

The Runtime tab is structured as follows:

Return code handling
Forecast setting
Evaluation of estimated runtime (runtime evaluation)
Monitoring of maximum runtime (runtime monitoring)
Monitoring of minimum runtime (runtime monitoring)
Reaction if the runtime is longer or shorter than defined (runtime monitoring)

Description

Field/Control	Description
Definition for ENDED_OK
Return code <=	The maximum return code for the normal end of a task. A task ends normally (Status "ENDED_OK") if its return code lies below or is equal to the specified maximum return code.
Else execute	If the relevant task does not end with a return code that lies within the ENDED_OK zone, you can define an alternative object tha should be processed. Note that this object will not be processed if the task is terminated by using the script statement :EXIT.
End status for forecast	A selection list for the end status that this task should return when you make a forecast calculation.
Estimated runtime (ERT)
Current ERT =	Display of this task's next estimated runtime (ERT). You can specify an estimated runtime here. This value then applies until an ERT calculation has been made after the task's next run. Format: "hours:minutes:seconds".
Use default (UC_CLIENT_SETTINGS)	Selecting this option has the effect that the calculation method that the administrator has specified in the variable UC_CLIENT_SETTINGS using the key "ERT_METHOD" will be used for the estimated runtime.
Fixed value	Enter a fixed value as the estimated runtime. Format: "seconds"
Dyn. method	Selection list for the dynamic method that is used to calculate the estimated runtime from the actual runtime. Possible selections: Adaptive: This method calculates the ERT proactively by considering various factors and runtime parameters such as the start time and the task's agent. Linear regression: This method puts emphasis on runtime increases or decreases. You can also define the number of previous runs that should be considered, or define a correction factor in percent. Average: This means that the average value will be retrieved from the real runtimes. You can also define the number of previous runs that should be considered, or define a correction factor in percent that will be added to the calculated average value. Maximum value: The highest value from the list of real runtimes is used as the estimated runtime.
from the last ... runs	The number of past runs that are considered for the ERT calculation. Allowed values: 0 to 25.
+ ... %	The value in percent for an upward ERT correction.
Differences > ... % are ignored	You can ignore possible huge deviations for the estimated runtime. Upper limit (in percent) until which the real runtime should be used to calculate the estimated runtime.
but do use ... runs at least	The number of past runs that should be considered regardless of deviations. Allowed value: 0 to 25.
Show chart	A button for updating the estimated runtime according to the current settings. A diagram is displayed in a separate window which represents the last 25 ERT/RRT runs. An already open window will be updated.
Reset values	A button for deleting the real and estimated runtimes. After a security query, all stored runtimes will be cleared.
Maximum runtime (MRT)
None	The maximum runtime is not monitored.
Fixed value	The maximum runtime is monitored. The allowed time is entered as a fixed value in the format "hours:minutes:seconds". An action (ELSE condition) must be specified which reacts when maximum runtime is exceeded.
ERT	The maximum runtime is monitored. The valid estimated runtime (ERT) at the time of the task's activation is used as the maximum runtime. An action ( ELSE condition) must be specified which reacts when maximum runtime is exceeded.
+ ... %	A correction in percent can be specified for ERT for the maximum runtime. The determined value is added to the estimated runtime.
Curr. date + day(s) Time	The maximum runtime is monitored. Define a number of days and a particular time until which the task must be finished. The starting point for the date calculation is the task's real date. An action (ELSE condition) must be specified which reacts when maximum runtime has been exceeded.
TimeZone	Selection of a TimeZone object
Minimum runtime (SRT)
None	The minimum runtime is not monitored.
Fixed value	The minimum runtime is monitored. The minimum runtime is used as a fixed value in the format "hours:minutes:seconds". An action (ELSE condition) must be specified which reacts if the runtime falls below the minimum runtime.
ERT	The minimum runtime is monitored. The valid estimated runtime at the time of the task's activation is used as the minimum runtime. An action ( ELSE condition) must be specified which reacts when runtime falls below the minimum runtime.
- ... %	A correction value in percent can be specified for ERT for the minimum runtime. The determined value is subtracted from the estimated runtime.
Else
Cancel / Quit	With this checkbox being activated, the task will be canceled or ended if the runtime has been exceeded. Only available if the maximum runtime is monitored.
Execute	Selecting this checkbox determines a task's execution. You can directly select an executable object. This task will be activated if the runtime is above or below the expected value. Only available when runtime is monitored.

Comments

A different definition of runtime monitoring can be used for tasks that run in a workflow or are activated using a Schedule object. You can define this in the properties of the affected objects (Runtime tab). In doing so, you can implement specific requirements for runtime monitoring which refer to the special context of workflows or schedules. The task settings that are defined in the workflow or schedule override the settings that were made in the task itself.

By default, the settings for runtime monitoring as defined in the task also apply to the workflow or schedule.

The quality of the ERT calculation is dependent on the available data. In case of a reorganization of the databaseA database is an organized collection of data including relevant data structures. there could be not enough datasets available. The calculation might be wrong in this case.

A lot of statistical data will be read from the object for the ERT calculation. Therefore this function should be only activated for individual objects, not client-wide.