Adapter for IBM Power 10.11 | Adapter for IBM Power Connections | Configuring webMethods Adapter for IBM Power Connections
 
Configuring webMethods Adapter for IBM Power Connections
When you configure webMethods Adapter for IBM Power connections, you specify information that Integration Server uses to connect to the IBM Power system. You can configure webMethods Adapter for IBM Power connections manually using the Integration Server Administrator page.
*Perform the following steps to configure an adapter connection:
1. In the Adapters menu in Integration Server Administrator's navigation area, click webMethods Adapter for IBM Power.
2. In the Connections page, click Configure New Connection.
3. In the Connection Types page, click webMethods Adapter for IBM Power Connection.
4. In the Configure Connection Type > webMethods Adapter for IBM Power section, configure the following fields:
Field
Description/Action
Package
Package in which to create the connection. Use Designer to create the package before specifying the value in this field. For general information about creating packages, see the webMethods Service Development Help for your release.
Note:
Configure the connection in a user-defined package rather than in the adapter's package. For other important considerations when creating packages for webMethods Adapter for IBM Power, see Adapter Package Management.
Folder Name
Folder in which to create the connection.
Connection Name
Name you want to give to the connection. Connection names cannot have spaces or use special characters reserved by Integration Server and 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.
5. In the Connection Properties section, use the following fields:
Note:
The following table shows suggested values for these parameters as guidance only. For more information about what values to assign to these parameters, see your IBM Power documentation.
Field
Description/Action
Service Type
Type of service representing various ways to interact with and utilize an IBM Power system's capabilities, such as for data management, system administration, or other tasks. The specific usage and functionality can vary depending on the context and the software or tools being used to establish the connections. Possible values are:
*COMMAND. Run non-interactive Control Language(CL) commands or Report Program Generator (RPG) programs. You can perform system administration and automation tasks.
*DATAQUEUE. Perform read or write operations on dataqueues. Dataqueues are used for asynchronous communication between programs on the system.
System Name
Hostname or IP address of the IBM Power system.
Default System User
Select true to use the default user for the system name specified in the System Name field and false to specify the username.
User ID
Username of the IBM Power system.
Password
Password for the user.
Retype Password
Retype the password for the user.
Secure Connection
Use SSL to connect to the IBM Power system. Possible values are:
*true. If you have configured SSL connections between webMethods Adapter for IBM Power and IBM Power system, set the truststore alias name in the watt.server.ssl.trustStoreAlias server configuration parameter.
*In Integration Server Administrator, select Settings > Extended.
*Set the watt.server.ssl.trustStoreAlias server configuration parameter to the truststore alias name created in Integration Server.
For information on creating truststore aliases, see webMethods Integration Server Administrator’s Guide.
*false. Default.
Proxy
Indicates if the connection is established through a proxy. Set to true to use the proxy to connect to the IBM Power system. Default value is false.
Proxy Endpoint
Hostname or the IP address and port of the proxy server in the format serverName[:port]. If no port is specified, the default port number is used.
Proxy Encryption Mode
Encrypt data path. Possible values:
*CLIENT_TO_SERVER. Encrypt data in both, the connection between the client and the proxy server, and the connection between the proxy server and the system.
*CLIENT_TO_PROXY_SERVER. Encrypt data on the connection between the client and the proxy server.
*PROXY_SERVER_TO_SERVER. Encrypt data on the connection between the proxy server and the system.
Current Library
Optional. Library that you want to use for accessing the IBM Power system resources. The library specified in the Current Library field is available as %CONN_CURLIB% environment variable in your service.
Socket Properties
Optional. Socket properties which the IBM Toolbox for Java sets on its client-side sockets. Use ; (semi-colons) to delimit multiple property settings.
Other Properties
Optional. Property specific to the IBM Power system resources. Use ; (semi-colons) to delimit multiple property settings.
Note:
Create a connection with COMMAND service type if you want to use services like Call Command or Call Program, and a connection with DATAQUEUE service type if you want to use services like Read DataQueue or Write DataQueue.
6. In the Connection Management Properties section, use the following fields:
Field
Description/Action
Enable Connection Pooling
Enables the connection to use connection pooling. For more information about connection pooling, see Adapter Connections.
Minimum Pool Size
If connection pooling is enabled, this field specifies the number of connections to create when the connection is enabled. The adapter will keep open the number of connections you configure here regardless of whether these connections become idle.
Maximum Pool Size
If connection pooling is enabled, this field specifies the maximum number of connections that can exist at one time in the connection pool.
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.
Block Timeout
If connection pooling is enabled, this field specifies the number of milliseconds that Integration Server will wait to obtain a connection with the database before it times out and returns an error. For example, you have a pool with Maximum Pool Size of 20. If you receive 30 simultaneous requests for a connection, 10 requests will be waiting for a connection from the pool. If you set the Block Timeout to 5000, the 10 requests will wait for a connection for 5 seconds before they time out and return an error. If the services using the connections require 10 seconds to complete and return connections to the pool, the pending requests will fail and return an error message stating that no connections are available. If you set the Block Timeout value too high, you may encounter problems during error conditions. If a request contains errors that delay the response, other requests will not be sent. This setting must be tuned in conjunction with the Maximum Pool Size to accommodate such bursts in processing.
Expire Timeout
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. The connection pool will remove inactive connections until the number of connections in the pool is equal to the Minimum Pool Size. The inactivity timer for a connection is reset when the connection is used by the adapter.
If you set the Expire Timeout value too high, you may have a number of unused inactive connections in the pool. This consumes local memory and a connection on your backend resource. This could have an adverse effect if your resource has a limited number of connections.
If you set the Expire Timeout value too low, performance could degrade because of the increased activity of creating and closing connections. This setting must be tuned in conjunction with the Minimum Pool Size to avoid excessive opening/closing of connections during normal processing.
Startup Retry Count
Number of times that the system must attempt to initialize the connection pool at startup if the initial attempt fails. The default is 0.
Startup Backoff Timeout
Number of seconds that the system must wait between attempts to initialize the connection pool.
Heart Beat Interval
If the connection pooling is enabled and the minimum pool size is more than zero, the Heart Beat Interval is applicable. The connection pool checks the connectivity of the connections that are idle for the value of Heart Beat Interval. The default value for Heart Beat Interval is zero and it is mentioned in seconds. For example, if the value of Heart Beat Interval is 25 seconds, connection pool looks for connections that are idle for 25 seconds. If a connection is broken, then the connection pool is reset.
7. Click Save Connection.
The connection you created appears on the adapter's Connections page and in Designer.
You can enable a connection only if the parameters for the connection are valid.