PooledTxPipeline Object
Use this object to execute a Commerce Server pipeline if you need transactions.
The PooledTxPipeline object uses COM+ object pooling to increase the loading speed of pipelines, where the pipeline components that it contains support object pooling.
ProgID: |
Commerce.PooledTxPipeline (Externally creatable) |
COM Class Name: |
CPooledTxPipeline |
Type Library Name: |
Microsoft Commerce Server Order Pipeline Type Library |
DLL Name: |
pipeline.dll |
Threading Model: |
Both |
COM Interface Name: |
IPipeline |
Interface ID Constant: |
IID_IPipeline |
Header File: |
pipeline.h |
In C++, use the IPipeline interface to access the properties and methods of the PooledTxPipeline object.
Because this object is primarily intended for use within ASP script, access from C++ will not be common.
Methods
Method |
Description |
|---|---|
Runs the components in the pipeline as configured by the LoadPipe method. |
|
Loads a pipeline configuration file (.pcf) into the pipeline. |
|
Identifies the file in which to log pipeline events. |
Remarks
The PooledTxPipeline object is registered under COM+ as "transactions required." Use this pipeline where transactions are needed.
The Microsoft Distributed Transaction Coordinator (MSDTC) service must be running in order to use the PooledTxPipeline object.
To verify that the Distributed Transaction Coordinator service is running
Click Start, point to Programs, point to Administrative Tools, and then click Services.
Scroll to Distributed Transaction Coordinator and verify that the Status is Started.
Generally, use the PooledTxPipeline object only in production Web sites; use the MtsPipeline object when you are developing the site. If you use the PooledTxPipeline object during development, you will have to stop and restart Internet Information Services (IIS) in order to force the .pcf files to be re-read when you change them.
The PooledPipeline object should be created on each ASP page that it is used in instead of being held in Application or Session scope.
To create a custom poolable pipeline component, add the GUID 4cb33c86-58fa-4e10-97a8-f19aff3b81d9 to the pipeline component's implemented categories.