Versions Compared

Key

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

...

The Edit Menu

OptionDescription

Start

Starts the currently loaded workflow.

Profiler

Starts the currently loaded workflow using workflow profiling, see the section below, Workflow Profiling.

Stop

Stops the currently executing workflow.

Dynamic Update

Updates a running workflow with a new configuration that has been entered in monitor mode. Agents that support the update of the configuration while running will be updated with the new configuration. Once the update has been introduced to the workflow, the user will be shown if anything was affected. Only the current executing workflow is affected by the dynamic update. See Dynamic Update in 1.2 Administration and Management.

Toggle Debug Mode On/Off

Turns on or off debug information for a workflow. Note that turning on the Debug mode might slow down the workflow due to log filing.
View/Edit Workflow
Click to open the workflow editor view.


...

When a workflow is executed using workflow profiling, Image Added continuously samples the load, i.e  the amount . the number of processed UDRs, or raw data, per second. The average load for a workflow is calculated on a regular basis and the status for all routes and agents will be determined based on the average. 

The Workflow Monitor visually shows the load status for agents and routes using symbols to indicate which agents are the slowest and which routes the data usually takes though through the workflow. This way, it is possible to find bottlenecks in the workflow.

...

The load status is calculated based on the average load and is shown using different thickness thicknesses on the routes:


Route symbolDescription

Normal Load:

Load is lower than Average Load x 2

High Load:

Load is equal to Average Load x 2 or between Average Load x 2 and Average Load x 3

Very High Load:

Load is equal to or higher than Average Load x 3

Unknown Load:

There is no known data load. This could be because there is not enough data load to be able to calculate an average.


...


State

Description

Building

When a workflow, or any of a workflow's referenced configurations, are being re-built, for example when saving or recompiling, the workflow will be in Building state.


When a workflow is in Building state, the Configuration Monitor icon in the status bar will indicate that operations are in progress, and in the Worklow Workflow Monitor, the text Workflow is building will also be displayed. Workflows started by scheduling configurations will wait until the workflow leaves the Building state before they start.

Executed

A Workflow becomes Executed after one of the following:


Running:

A successful execution has been completed.

Unreachable:

After the Platform re-establishes connection with the Execution Context, and the workflow has finished execution during the period of disconnection.

Manual stop:

A User stopped the execution.


Note
titleNote!
This is a transient state , after the workflow has run, where cleanup is handled. This state is not reached if the workflow gets aborted. In the GUI, the workflow is shown as Stopped even after it has reached the idle state.


Hold

A workflow that is in the Idle state and is being imported either by the mzsh systemimport r | sr | sir | wr or by the System Importer configured to Hold Execution, enters the Hold state until the import activity is finished. The Workflow group then resumes its Idle state.

Idle

A workflow is in Idle state if there is no activity going on in the workflow. It means that workflow is not running, or, not in the process of starting or stopping, or not in any other state (Invalid or Hold). After execution, although the workflow is indeed idle, the state space on the display might remain as one of the following states:

AbortedAt least one of the workflow agents has aborted. You can track the reason for the error either by double-clicking the aborted agent , or by examining the System Log.
CompletedThe workflow has been executed and gone back to the Idle state with no errors.
Not startedThe workflow has not run since the platform has started.


Invalid

The workflow configuration is erroneous. Once you correct the error, the workflow assumes the Idle state.

Note
titleNote!

The workflow cannot be executed if it is in invalid an invalid state.


Loading

The platform is uploading the workflow to the Execution Context. When the transfer is complete, the Execution Context initializes the agents. When the workflow starts running the state changes to Running.

Running

The workflow is currently executing.

Unreachable

If the Platform fails to establish a connection with the EC where a workflow is executing, the workflow enters the unreachable state. When the workflow server successfully reestablishes the connection, the workflow is marked as Running, Aborted, or Executed, depending on the state that the workflow is in. An Unreachable workflow may require manual intervention if the workflow is not running any moreanymore. For further information see Execution Context in Desktop User's Guide.

Waiting

The Waiting state applies only to workflows that are included as members in a workflow group. In the Waiting state, the workflow cannot start execution due to two parameters in the workflow group configuration: The Startup Delay parameter, and the Max Simultaneous Running quota. A workflow in the Waiting state will change to Running when triggered either by a user, the scheduling criteria of its parent workflow group, or by a more distant ancestor's scheduling criteria. For further information see Scheduling


Viewing Abort Reasons

In most cases, if a workflow has been aborted, one of its agents will have the state Aborted displayed above it. Double-clicking such an agent will display a dialog containing the abort reason. The System Log also holds valid information for these cases.

...

Note
titleNote!

Although a workflow has been aborted, its scheduling will still be valid. Thus, if it is scheduled to execute periodically, it will be automatically started again the next time it is due to commence. This is because the abortion might be a lost connection to a network element, which could be available again later. Therefore, a periodically scheduled workflow, which has been aborted, is treated as Active until it is manually deactivated.

...

Click Show Trace; the Stack Trace Viewer opens. Use the information that it provides when consulting Global consulting Image Added Global Support.

Agent States

An agent state is displayed above the agent icon in the workflow. An agent can have one of the following states:


StateDescription

Created

The agent is starting up. No data may be received during this phase. This state only exists for a short while during workflow startup.

Idle

The agent is started, awaiting data to process. This state is not available for a real-time workflow.

Running

The agent has received data and is executing.

Stopped

The agent has successfully finished processing data.

Aborted

The agent has been terminated erroneously.

The error reason can be tracked either by double-clicking the agent or by examining the System Log.


...


State

Description

initialize

The initialize state is entered once for each invocation of the workflow. During this phase, the workflow is being instantiated and all agents are set up according to their configuration.

beginBatch

This state is only applicable for batch workflows.

At every start of a new batch, the batch collection agent will emit a beginBatch call. All agents will then prepare for a new batch. This is normally done every time a new file is collected , but can differ depending on the collection agent.

consume

The agents will handle all incoming UDRs or bytearrays during the consume state.

drain

This state is only applicable for to batch workflows.

When all UDRs within a batch have been executed, the agents enter the drain state. This state can be seen as a final consume state with the difference that there is no incoming UDR or bytearray. The agent may however send additional information before the endBatch state.

endBatch

This state is only applicable for to batch workflows.

The collection agent will call for the endBatch state when all UDRs or the byte arrays have been transferred into the workflow. This is normally done at the file end, but is dependent on the collection agent or when a hintEndBatch call is received from any agent capable of utilizing the APL code.

commit

This state is only applicable for to batch workflows.

Once the batch is successfully processed or sent to ECS, the commit state is entered. During this phase, all actions that concern transaction safety are executed.

deinitialize

This is the last execution state for each workflow invocation. The agents clean and release resources, such as memory and ports, and stop execution.

cancelBatch

This state is only applicable for to batch workflows.

If an agent fails the processing of a batch it may emit a cancelBatch call and the setting in Workflow Properties will define how the workflow should act. For more information regarding the Workflow Properties, see Error Tab in 3.1.8 Workflow Properties.

Note
titleNote!

The execution states cancelBatch and endBatch are mutually exclusive - only one per batch can be executed.


rollback

This state is only applicable for to batch workflows.

If the last execution of the workflow is aborted, the agents will enter the rollback execution state right after the initialize state. The agents will recover the state prior to the failing transaction and then enter beginBatch or deinitialize depending on if there are additional batches to process.


Agent Configuration

Some agents allows allow parts of them to be reconfigured while active. When double-clicking the agent in monitor mode, the agent's configuration is shown in the displayed dialog if the agent can be reconfigured. When the configuration has been updated it can be committed to the active workflow using the Dynamic Update button in the toolbar.

...

A workflow operates on a data stream and supplies and Image Added supplies a transaction model where persistent synchronization is made from the workflow data and agent-specific counters. In theory, the synchronization could be performed continuously on a byte level, but in practice this would drastically decrease the performance of the system.

The transaction The Image Added transaction model is based on the premises premise that collection agents are free to initiate a transaction to the transaction server. At the moment the complete workflow is frozen and the transaction server saves the state of the workflow data that is queued for each agent. In practice, agents indirectly emit a transaction when an End Batch is propagated. When all data is secured, the workflow continues the execution.

Scroll ignore
scroll-viewportfalse
scroll-pdftrue
scroll-officefalse
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse


Next subsection: