SOPERA Adapter 8.0 | webMethods SOPERA Adapter Documentation | webMethods SOPERA Adapter Installation and User’s Documentation | Adapter Connections | Configuring Adapter Connections
 
Configuring Adapter Connections
SOPERA Adapter requires a connection to the SOPERA infrastructure whenever services from the SOPERA infrastructure are to be invoked. That is, whenever SOPERA Adapter acts as a client for a SOPERA infrastructure. A connection is also required when an Integration Server service is to be invoked through the adapter by any of the SOPERA participants.
When you configure SOPERA Adapter connections, you specify information that Integration Server uses to connect to a SOPERA participant. In most cases, you will need to configure at least two adapter connections: one for the adapter listener and one for all adapter services.
*To configure an adapter connection
1. In Integration Server Administrator, select Adapters > SOPERA Adapter.
2. On the Connections screen, click Configure New Connection.
3. On the Connection Type screen, click SOPERA Connection as the connection type.
4. Complete the following fields in the SOPERA Adapter section:
Field
Description/Action
Package
The package in which to create the connection. You must create the package using Designer before you can specify it using this parameter. For general information about creating packages, see the webMethods Service Development Help.
Note:
Configure the connection in a user-defined package rather than in the adapter’s package. See Package Management for other important considerations when creating packages for SOPERA Adapter.
Folder Name
The folder in which to create the connection.
Connection Name
The name of the new connection.
5. In the Connection Properties section, complete the following fields using the values from your configured SOPERA infrastructure:
Field
Description/Action
SOPERA Location
The location of the SOPERA infrastructure. The default value is generic_location.
SOPERA User
The SOPERA default user name for this adapter connection. For example, SOPAdministrator.
SOPERA Password
The password for the SOPERA default user name.
Note:
You must retype the password in the Retype SOPERA Password field.
6. In the Connection Management Properties section, complete the following fields to configure connection pool sizes:
Field
Description/Action
Enable Connection Pooling
Enables the connection to use connection pooling.
Default: true
For more information about connection pooling, see Connection Pools.
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 Increment Size
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 Integration Server will wait to obtain a connection with the SOPERA infrastructure 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:
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
The number of times that the system should attempt to initialize the connection pool at startup if the initial attempt fails.
Default: 0
Startup Backoff Timeout (sec)
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: 10
7. Click Save Connection.
The connection that you configured appears on the adapter’s Connections screen and in the Designer Package Navigator view.
By default, when you configure a connection, it is not enabled. For more information about enabling connections, see Enabling Adapter Connections.