AS/400 Adapter 6.0.1 | webMethods AS/400 Adapter Documentation | webMethods AS/400 Adapter Installation and User’s Documentation | Managing AS/400 Adapter Connections | Configuring Adapter Connections
Configuring Adapter Connections
When you configure AS/400 Adapter connections, you specify information that the Integration Server uses to connect and to log on to the server.
Before you can configure a connection, you must have the AS/400 Adapter and IBM ToolBox for Java installed and loaded by the Integration Server. For more information, see Installing and Uninstalling the AS/400 Adapter. You create AS/400 Adapter connections using the Integration Server Administrator.
*To configure an AS/400 Adapter connection
1. Start the Integration Server Administrator if it is not already running.
2. Make sure the WmAS400 package is enabled.
To see the status of the WmAS400 package, in the Packages menu in the navigation area, select Management. The Integration Server Administrator displays the list of packages that are installed on the Integration Server. If the WmAS400 package is disabled, click No in the Enabled column to enable it.
3. In the Adapters menu in the Integration Server Administrator's navigation area, click AS/400 Adapter.
4. On the Connections screen, click Configure New Connection.
5. On the Connection Types screen, click the AS/400 service you want to connect to.
*To execute non-interactive CL commands or RPG programs, you need to create a connection using the COMMAND connection type.
*To perform operations on the DataQueue, for example, read or write, you need to create a connection using the DATAQUEUE connection type.
6. On the Configure Connection Type screen, provide values for the connection's parameters.
Connection Alias
Required. Name you want to give the connection. Connection names cannot have spaces or use special characters reserved by the Integration Server, 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.
Required. Name or the IP address of the AS/400 server, for example, AS/400
Required. User name that the connection must use to connect to the server.
Required. Password for the user account defined in the User field.
Initialization Service
Optional. Integration service that you want to invoke every time a new connection is created, for example wm.as400.sample.connection:initService. You can use the service to call the AS/400 programs or commands that would set the AS/400 sessions environment (current library, and so on.)
Current Library
Optional. Library that you want to use for accessing the AS/400 resources. Instead of hard coding the library name you can use this parameter in your service.
Use Secure Connection
Required. Use SSL to connect to the AS/400 server. Possible values are:
*true. If you have configured SSL connections between AS/400 Adapter and AS/400 server, 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.
7. In the Connection Management Properties section, provide values for the following parameters:
Enable Connection Pooling
Enables the adapter to use connection pooling. Default: true.
Minimum Pool Size
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
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 parameter 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
If connection pooling is enabled, this parameter specifies the number of milliseconds that the Integration Server will wait to obtain a connection from the pool before it times out and returns an error. Default: 1000 msecs.
Expire Timeout
If connection pooling is enabled, this parameter 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. Type 0 to specify no timeout. Default: 1000 msecs.
8. Click Save Connection. If the parameters are valid the connection you created appears on the AS/400 Adapter's Connections screen.
9. Click Return to AS/400 Adapter Connections Types to return to the Connection Types screen.