Using COM+ Pooling

To obtain a PooledObject object, create a new PooledObject object using COM. The COM+ interceptors detect this creation and take care of pooling the PooledObject objects. The PooledObject object has been written to support the COM+ pooling mechanism.

See using COM+ pooling for an example.

Administering COM+ Pooling

To administer a COM+ pool, use the COM+ Component Services administrative tool, which is a standard Microsoft Management Console (MMC) plug-in that ships with Windows 2000.

You can configure COM+ pools in two different ways:

• Library application — each process has its own pool.
• Server application — the pool is shared by all processes on the same machine.

To create a new COM+ server application:

1. Start the Component Services administrative tool: select Start Programs Administrative Tools Component Services.
2. Expand Component Services Computer COM+ Applications. Right-click COM+ Applications and select New Application. This starts a wizard. Click Next.
3. Select Create an Empty Application.
4. Enter a name of your choice, and select Server application as the Activation Type. Click Next.
5. Specify an identity, and click Next.
6. Click Finish.

To add the PooledObject component to the application:

1. In the tree view, expand the application you previously created in order to see Components and Roles.
2. Right-click Components and select New Component, which brings up a wizard.
3. Click Next, then click Import components that are already registered.
4. Select SASObjectManager.PooledObject.1, then click Next and Finish.

To administer the pooling properties:

1. Right-click SASObjectManager.PooledObject.1 under the Components node of the application you created and select Properties from the pop-up menu.
2. Select the Activation tab.
3. Select the Enable object pooling check box. Enter the properties.
4. You can also enter a constructor string, which allows you to specify which machine SAS should run on. For more information, see Constructor Strings.

   Note: If you do not specify a constructor string, the SAS Object Manager will create workspaces on the local machine using COM. It is only necessary to configure a metadata server with pooling metadata if you specify a logicalName.

Constructor Strings

The constructor string is a single string that specifies the parameters that are used to initially create the pool. The SAS Object Manager (or Version 8 SAS Workspace Manager) requires that the constructor string contain a set of name/value pairs, with the names separated from the values by an equals sign(=), and the pairs separated by a semi-colon (;). If no parameters are specified, then a pool consisting of SAS servers running on the local machine will be created. You should never use quotation marks (") in the constructor string. The constructor string contains the only attributes specific to SAS.

If errors occur when creating a workspace, the SAS Object Manager (or Version 8 SAS Workspace Manager) writes entries to the Event Log.

Constructor Parameters Used to Connect with Metadata

Constructor Parameters Used to Connect without Metadata