Remedy Adapter 7.1 | webMethods Remedy Adapter Documentation | webMethods Remedy Adapter Installation and User’s Documentation | Adapter Connections | Configuring Adapter Connections
 
Configuring Adapter Connections
When you configure Remedy Adapter connections, you specify information that the adapter uses to connect to an AR System Server.
You configure Remedy Adapter connections using the Integration Server Administrator.
*To configure an adapter connection
1. Start the Integration Server Administrator if it is not already running.
2. In the Adapters menu in the Integration Server Administrator's navigation area, click Remedy Adapter.
3. On the Connections screen, click Configure New Connection.
4. On the Connection Types screen, click Remedy Connection for the connection type.
5. On the Configure Connection Type screen, in the Remedy Adapter section, provide values for the following parameters:
Parameter
Description/Action
Package
Required. 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 for your release.
Note:
Create the connection in a user-defined package rather than in the adapter's package. See Managing the Adapter Package for other important considerations when creating packages for Remedy Adapter.
Folder Name
Required. The folder in which to create the connection.
Connection Name
Required. The name you want to give the connection. Connection names cannot have spaces or use special characters reserved by 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.
6. In the Connection Properties section, provide values for the following parameters:
Parameter
Description/Action
AR Server Host Name or IP address
The host name of the AR System Server.
User
The user name on the AR System Server, used by Integration Server to establish a connection and perform specific operations (as authorized) on the AR System.
Password
The password for the user account defined in the User field.
Retype Password
The password for the user account defined in the User field again.
AR Server Port
The port number that the connection will use to connect to the AR System Server.
Language / Locale
The language code or locale that the AR System uses.
The locale uses the format:
language[_territory[.codeset]][@modifier]
For example, you might specify en_US.ISO8859-15@euro. You can also use the simplified format, for example, en_US or en.
7. In the Connection Management Properties section, provide values for the following parameters:
Parameter
Description/Action
Enable Connection Pooling
Enables the adapter to use connection pooling. Default: true.
See Connection Pools for more information about connection pooling in the adapter.
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 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 Integration Server will wait to obtain a connection with the database before it times out and returns an error. Default: 1000.
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. Enter 0 to specify no timeout. Default: 1000.
Note:
The adapter will never violate the Minimum Pool Size 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.
8. Click Save Connection.
The connection you created appears on the adapter's Connections screen and in Designer.