PooledTxPipeline Object
.gif "Ee810208.c++_off(en-US,CS.10).gif")
.gif "Ee810208.vb_on(en-US,CS.10).gif")
Use this object to execute a Microsoft Commerce Server 2000 pipeline. The pipeline may be an Order Processing pipeline (OPP). Use in place of the PooledPipeline object where you need transactions.
The PooledTxPipeline object uses COM+ object pooling to greatly increase the loading speed of pipelines. For more information about pooled pipelines, see Pooled Pipelines.
| ProgID: | Commerce.PooledTxPipeline (Externally creatable) |
| COM Class Name: | CPooledTxPipeline |
| COM Interface Name: | IPipeline |
| Interface ID Constant: | IID_IPipeline |
| Header File: | pipeline.h, mspu_guids.h |
| Type Library Name: | Microsoft Commerce 2000 Order Pipeline Type Library |
| DLL Name: | pipeline.dll |
| Threading Model: | Both |
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.
The methods of the PooledTxPipeline object are shown in the following table.
| Method | Description |
| Execute | Runs the components in the pipeline as configured by the LoadPipe method. |
| LoadPipe | Loads a pipeline configuration file (.pcf) into the pipeline. |
| SetLogFile | 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. For more information about transactions and pipelines, see Pipeline Basics.
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.
In general, use the PooledTxPipeline object only in production Web sites; use the MtsPipeline object when developing the site. If you use the PooledTxPipeline object during development, you will need 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 in which it is used rather than being held in Application or Session scope.
When you create custom poolable pipeline components, you must add the Component Object Model (COM) category, CATID_POOLABLE, to the component to make it poolable.