Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ItemDescription

Execution Settings

Select Enable to enable setup of the execution parameters.

Distribution

A workflow executes on an EC, or groups of ECs. You can specify these ECs, or the Image Added system can select them automatically.

Note
titleNote!

If you select to configure the distribution using EC groups, the selected distribution type will also be applied on the ECs within the groups.


Tip
titleHint!

You can combine both individual ECs and EC groups in the Execution Contexts list. The selected distribution will then be applied for all ECs stated either individually or in groups.

The following options exist:

Sequential - Valid only if ECs are defined. Starts the workflow on the first EC/EC group in the list. If this EC/EC group is not available, it proceeds with the next in line.

Workflow Count - Starts the workflow on the EC running the fewest number of workflows. If the Execution Contexts list contains at least one entry, only this/these ECs/EC groups will be considered.

Machine Load - Starts the workflow on the EC with the lowest machine load. If the Execution Contexts list contains at least one entry, only this/these ECs/EC groups will be considered. Which EC to select is based on information from the System Statistics sub-system.

Round Robin - Starts the workflow on the available ECs/EC groups in turn, but not necessarily in a sequential order. If ec1, ec2 and ec3 are defined, the workflow may first attempt to start on ec2. The next time it may start on ec3 and then finally on ec1. This order is then repeated. If an EC is not available, the workflow will be started on any other available EC.

Debug Type

Select Event to enable debug output (e g output from a debug call in the APL code) to appear in the Workflow Monitor .

Select File to save debug results in $MZ_HOME/tmp/debug. The file name is made up of the names of the workflow template and of the workflow itself, for example: MZ_HOME/tmp/debug/Default.radius_wf.workflow_2. Only debug events are written to the file. To save to file all the events that are shown when you select to monitor events in the Workflow Monitor, you must add an event notifier to the relevant Agent Message Event with file output. For further information, see 4. Event Notifications.

If you save debug results in a file, and you restart the workflow, this file gets overwritten by the debug information that is generated by the second execution. To avoid losing debug data of earlier executions, set Number of Files to Keep to a number that is higher than 0 (zero).

Number of Files to Keep : Enter the number of debug output files that you want to save. When this limit is reached, the oldest file is overwritten. If you set this limit to 0 (zero), the log file is overwritten every time the workflow starts.


Info
titleExample - Debug output

The workflow configuration Default.radius_wf includes a workflow that is called workflow_2. Number of Files to Keep is set to 10.

The debug output folder contains the following files:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2    (current debug file)
Default.radius_wf.workflow_2.1  (newest rotated file)
Default.radius_wf.workflow_2.2
Default.radius_wf.workflow_2.3
Default.radius_wf.workflow_2.4
Default.radius_wf.workflow_2.5
Default.radius_wf.workflow_2.6
Default.radius_wf.workflow_2.7
Default.radius_wf.workflow_2.8
Default.radius_wf.workflow_2.9
Default.radius_wf.workflow_2.10 (oldest rotated file)

According to this example there are totally 11 files that are being overwritten one-by-one and the rotation order is:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2
             |
             V
Default.radius_wf.workflow_2.1
             |
             V
Default.radius_wf.workflow_2.2
             |
             V
             :
             :
             |
             V
Default.radius_wf.workflow_2.n
             |
             V
          Deleted



Info
titleExample - Using the option Always Create a New Log File

If you have a workflow named Default.radius_wf with an instance called workflow_2 and you create new debug output files every time the workflow executes, the debug output folder contains files like the following:

Code Block
languagetext
themeEclipse
Default.radius_wf.workflow_2.1279102896375
Default.radius_wf.workflow_2.1279102902908
Default.radius_wf.workflow_2.1279102907149



Note
titleNote!

will not manage the debug output files when this option is used. It is up to the user to make sure that the disk does not fill up.


Transaction Data Storage

This field is only applicable if you have enabled Scalable Batch Transaction Service (SBTS).

When SBTS is disabled, batch transaction state information is always stored in a database, i e Derby, Oracle, or PostgreSQL.

When SBTS is enabled, use this drop-down list to select the storage:

  • Default Handler - Database.
  • Local File-Based Handler - EC filesystem.
Note
titleNote!

When you change the transaction data storage, the latest state will remain in the previous storage but will not be transferred to the new storage.

For further information about how to enable SBTS, see 2.13 Enabling Scalable Batch Transaction Service in the System Administrator's Guide.

Anchor
Throughput Calculation
Throughput Calculation
Throughput Calculation

contains an algorithm to calculate the throughput of a running workflow. It locates the first agent in the workflow configuration that delivers UDRs, usually the decoder and counts the number of passed UDRs per second. If no UDRs are passing through the workflow, the first agent delivering raw data will be used. The statistics can be viewed in the System Statistics.

If a MIM value other than the default is preferred for calculating the throughput, the User Defined check box is selected. From the browser button, a MIM Browser dialog is opened and available MIM values for the workflow configuration is shown and a new calculation point can be selected.

Since the MIM value shall represent the amount of data entered into the workflow since the start (for batch workflows from the start of the current transaction), the MIM value must be of a dynamic numeric type, as it will change as the workflow is running.

...