Partager via


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

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.

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

  1. Click Start, point to Programs, point to Administrative Tools, and then click Services.

  2. 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.

See Also

Other Resources

COM Object Reference