Managing Pooled Pipelines

You can change properties of COM+ object pools and monitor the performance of those pools using the Component Services administrative tool.

By monitoring pipeline performance and adjusting the parameters of the pooled objects, you can optimize pipeline pooling for your application.

Changing Pool Properties of Components

Monitoring Performance

Changing Pool Properties of Components

You can specify several properties that determine how COM+ handles the pool of pipeline objects. These properties include:

• Minimum pool size

• Maximum pool size

• Creation request timeout

The minimum pool size is the minimum number of objects that are in the pool and the number of objects created when the application starts. When the pool reaches the maximum pool size, no more objects are created. This includes both active and inactive objects. The creation request timeout value is in milliseconds and specifies how long a client will wait for an object from the pool before the request times out (returns an E_TIMEOUT error).

To change pool properties

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

2. Expand Component Services, expand Computers, expand My Computer, expand COM+ Applications, expand CommercePipeline, and then expand Components.

3. Right-click the pipeline you want to change, and then select Properties.

4. In the Properties dialog box, on the Activation tab, and do the following:

   Use this	To do this
   Enable object pooling	Enable object pooling for the component.
   Minimum pool size	Type the minimum number of objects that will be maintained in the pool at any time.
   Maximum pool size	Type the maximum number of objects that can exist in the pool at any time.
   Creation timeout (ms)	Type the amount of time (in milliseconds) that the object pool has to provide a requested object.
   Enable object construction	Enable object construction for the component.
   Constructor string	Type a string that will be made available to the object at creation time when object construction is enabled.
   Enable Just in Time Activation	Specify that the object may be repeatedly deactivated and reactivated just in time to handle calls from a client, where the client is unaware that the object was ever deactivated.
   Component supports events and statistics	Enable object event reporting and object statistics, such as object call time.
   Must be activated in caller's context	Ensure that the object can only be activated within the context of its initial caller.

The new pool properties are saved.

Monitoring Performance

You can actively monitor pooled object performance in the Component Services administrative tool. The tool allows you to view the items listed in the following table for each pooled object.

To monitor object status

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

2. Expand Component Services, expand Computers, expand My Computer, expand COM+ Applications, and expand CommercePipeline.

3. Right click Components, select View, and then select Status View. The Status View appears on the right of the Component Services screen.

All rights reserved.