Execution mode in BizTalk Server Pipeline
This topic discusses the Execution Mode property and stage affinity.
Execution Mode property
During the execution of a pipeline, the pipeline stages can run only the first component that recognizes the message format, or all components. The property that determines the execution pattern is Execution Mode. This property is read-only on the stages included in the pipeline templates, but understanding how it works is an important concept.
Each pipeline stage can have its own Execution Mode setting, so different stages within a pipeline can have different execution modes.
When the Execution Mode property is set to All, all the components within the stage are run in the configured sequence. A run-time error occurs if any component of the stage encounters an error while processing a message. Use this mode when several components must be run to complete a logical task.
When the Execution Mode property is set to FirstMatch, only the first component that recognizes the message is run. If no components in the stage recognize the message, a run-time error results. Use this mode when the pipeline stage receives messages in several formats.
All the stages execution mode of the standard pipelines delivered with BizTalk Server are set to All, except for the Disassemble stage of the receive pipeline which is set to FirstMatch.
When the Execution Mode property is set to All, all the components within the stage are run in the configured sequence. Use this mode when several components must be run to complete a logical task. In this case, a run-time error results if any component encounters an error while processing a message during this pipeline stage.
When a pipeline is used to receive messages in several formats, then you can set its Execution Mode property to FirstMatch. In this mode, only the first component that recognizes the message is run. If no components in the stage recognize the message, a run-time error results.
Note that each stage can have its own Execution Mode setting, so different stages within a pipeline can have different execution modes.
To read pipeline stage properties
- In Pipeline Designer, click a stage shape.
- In the Properties window, in the General section, read the following properties:
|
Use this
|
To do this
|
|
Name
|
Indicates the name of the stage.
|
|
Execution Mode
|
Indicates the execution pattern of the stage.
Valid values: All or FirstMatch
|
|
Minimum Number of Components
|
Indicates the minimum number of pipeline components that can be added to the stage.
|
|
Maximum Number of Components
|
Indicates the maximum number of pipeline components that can be added to the stage.
|
|
StageID
|
Indicates the unique identifier for the stage.
|