Tuxedo Adapter 6.0 | webMethods Tuxedo Adapter Documentation | webMethods Tuxedo Adapter Installation and User’s Documentation | Adapter Connections | Creating Adapter Connections
 
Creating Adapter Connections
When you configure Tuxedo Adapter connections, you specify information that the Integration Server uses to connect to the Jolt server.
You create Tuxedo Adapter connections using the Integration Server Administrator.
*To create a Tuxedo Adapter connection
1. Start the Integration Server Administrator if it is not already running.
2. Make sure the WmTuxedoAdapter package is enabled. See Enabling Packages for details.
3. In the Integration Server Administrator, in the Adapters menu, click Tuxedo Adapter.
4. On the Connections screen, click Configure New Connection.
5. On the Connection Types screen, click Tuxedo Sync Connection to display the Configure Connection Type screen.
6. In the Tuxedo Adaptersection, provide values for the following fields.
Field
Description/Action
Package
The package in which to create the connection.
You must create the package using Digital Event Services or Designer before you can specify it using this parameter. For general information about creating packages, see the webMethods Service Development Help for your release.
Note:
Create the connection in a user-defined package rather than in the adapter package. For other important considerations when creating packages for the Tuxedo Adapter, see Managing the Adapter Package.
Folder Name
The folder in which to create the connection.
Connection Name
The name you want to give the connection. Connection names cannot have spaces or use special characters reserved by the Integration Server, Digital Event Services, or Designer. For more information about the use of special characters in package, folder, and element names, see the webMethods Service Development Help for your release.
7. In the Connection Properties section, provides values for the following fields:
Field
Description
Host Server Name
The host name or IP address of the machine on which the Jolt server is running.
Host Port Number
The port number where the Jolt server listens for client requests.
Jolt Transaction Timeout
Optional. The number of seconds that the Tuxedo Adapter will wait during a transaction with the Jolt server before it times out and returns an error. Default: 30 seconds.
User Name
Optional. The user name that you use to log into the Jolt server.
User Role
Optional. The type of user access to the Jolt server. Default: joltadmin.
User Password
Optional. The password associated with the User Name.
Retype User Password
Optional. The same user password in the previous field.
Application Name
Optional. The name of the Tuxedo application that you are accessing with this connection.
Application Password
Optional. The password to the Tuxedo application.
Retype Application Password
Optional. The same application password in the previous field.
8. In the Connection Management Properties section, use the following fields:
Parameter
Description/Action
Enable Connection Pooling
Enables the connection to use connection pooling.
See Adapter Connections for more information about connection pooling.
Note:
If you plan to enable connection pooling in a clustered environment, consider the connection pool size. For details, see Considerations When Configuring Connections with Connection Pooling Enabled.
Minimum Pool Size
The minimum number of connection objects that remain in the connection pool at all times. When the adapter creates the pool, it creates this number of connections. Default: 1.
Maximum Pool Size
The maximum number of connection objects that can exist in the connection pool. When the connection pool has reached its maximum number of connections, the adapter will reuse any inactive connections in the pool or, if all connections are active, it will wait for a connection to become available. Default: 10.
Pool Size Increment
If connection pooling is enabled, this field specifies the number of connections by which the pool will be incremented if connections are needed, up to the maximum pool size. Default: 1.
Block Timeout (msec)
If connection pooling is enabled, this field specifies the number of milliseconds that the Integration Server will wait to obtain a connection with the Jolt Server before it times out and returns an error. Default: 1000.
Expire Timeout (msec)
If connection pooling is enabled, this field specifies the number of milliseconds that an inactive connection can remain in the pool before it is closed and removed from the pool. For example, to specify 10 seconds, specify 10000. Enter 0 to specify no timeout. Default: 1000.
Note:
Note that the adapter will never violate the Minimum Connections parameter. These connections remain in the pool regardless of how long they are inactive.
Startup Retry Count
If connection pooling is enabled, this parameter specifies the number of times that the system should attempt to initialize the connection pool at startup if the initial attempt fails, before issuing an AdapterConnectionException. Default: 0.
Startup Backoff Timeout\
If connection pooling is enabled, this parameter specifies the number of seconds to wait between each attempt to initialize the connection pool. Default: 10.
9. Click Save Connection.
10. Enable the connection before you create adapter services that use it. For instructions, see Enabling Adapter Connections.
The connection you created appears on the adapter's Connections screen and in the Digital Event Services Service Browser.