DBMOVER Configuration Statements for PowerExchange Connection Pooling
DBMOVER Configuration Statements for PowerExchange Connection Pooling
To configure PowerExchange connection pooling, define DBMOVER configuration statements on each machine that hosts the PowerExchange Listener or the Data Integration Service.
Define the following statements:
LISTENER
Defines the TCP/IP port on which a named PowerExchange Listener process listens for work requests. Include the LISTENER statement in the DBMOVER configuration file on the PowerExchange Listener machine.
MAXTASKS
Defines the maximum number of tasks that can run concurrently in a PowerExchange Listener. Include the MAXTASKS statement in the DBMOVER configuration file on the PowerExchange Listener machine.
Ensure that MAXTASKS is large enough to accommodate twice the maximum size of the connection pool for the Listener. The maximum size of the connection pool is equal to the sum of the values that you enter for the
Maximum # of Connections
pooling property for each database connection that is associated with the Listener.
Default is 30.
NODE
Defines the TCP/IP host name and port that PowerExchange uses to contact a PowerExchange Listener. Include the NODE statement in the DBMOVER file on the Data Integration Service machine.
TCPIP_SHOW_POOLING
Writes diagnostic information to the PowerExchange log file. Include the TCPIP_SHOW_POOLING statement in the DBMOVER file on the Data Integration Service machine.
If TCPIP_SHOW_POOLING=Y, PowerExchange writes message PWX-33805 to the PowerExchange log file each time a connection is returned to a PowerExchange connection pool.
Message PWX-33805 provides the following information:
Size. Total size of PowerExchange connection pools.
Hits. Number of times that PowerExchange found a connection in a PowerExchange connection pool that it could reuse.
Partial hits. Number of times that PowerExchange found a connection in a PowerExchange connection pool that it could modify and reuse.
Misses. Number of times that PowerExchange could not find a connection in a PowerExchange connection pool that it could reuse.
Expired. Number of connections that were discarded from a PowerExchange connection pool because the maximum idle time was exceeded.
Discarded pool full. Number of connections that were discarded from a PowerExchange connection pool because the pool was full.
Discarded error. Number of connections that were discarded from a PowerExchange connection pool due to an error condition.