Adapter Runtime Configuration Parameter Appendix

Overview

This appendix contains a description of the Adapter Runtime parameters you can specify in the server configuration file (server.cnf), which is located in the Integration Server_directory \config directory. Typically you use the Settings > Extended screen in Integration Server Administrator to update this file, but there might be times when you need to edit the file directly using a text editor. If you edit the file directly, you should first shut down Integration Server before updating the file. After you make the changes, restart the server. If you are using the Settings > Extended screen to update the server configuration file (server.cnf), a server restart is not required unless otherwise specified. The server uses default values for the parameters. If a parameter has a default, it is listed with the description of the parameter.

watt.art.analysis

Specifies whether to enable logging to analyze adapter listeners and their linked notifications. When set to true, wm.art.dev.notification:analyzeListenerNotifications service and wm.art.dev.listener:analyzeListenerNodes service will log the data in the server log file. Service wm.art.dev.listener:updateRegisteredNotifications will update the listener for missing listener notifications. When set to false, no analysis is done and no information is logged. The default is false.

watt.art.adapterService.invocationStats.excludePipeline

Set to true to exclude the pipeline from caching the invocation statistics of the adapter service, thereby improving the performance. The invocation statistics captures the adapter service execution details such as start time, end time, error message and pipeline data (if the config parameter is not set or set to false). The default value is false.

watt.adk.adapterService.disable.errorlogging

Specifies whether or not the Adapter Development Kit (ADK) creates an entry in the error logs for exceptions in adapter services. When the parameter is set to true, ADK does not create an entry in the error logs for exceptions in adapter services. When the parameter is set to false, ADK creates an entry in the error logs for exceptions in adapter services. The default is false.

watt.art.adapterService.disable.errorlogging

Specifies whether or not the Adapter Runtime creates an entry in the error logs for exceptions in adapter services. When the parameter is set to true, Adapter Runtime does not create an entry in the error logs for exceptions in adapter services. When the parameter is set to false, Adapter Runtime creates an entry in the error logs for exceptions in adapter services. The default is false.

watt.art.clusteredPollingNotification.keepAliveExpireTimeout

This parameter is not supported with Integration Server 9.0 and higher. Specifies the amount of time, in milliseconds, that a node executing a clustered polling notification can be late before it is assumed to have failed. In general, this setting should be equal to the amount of drift anticipated on the server clocks. If not set, the secondary instance of the polling notification will change to the default maxLockDuration value of 180000 for the shared cache.

watt.art.clusteredPollingNotification.keepAliveInterval

This parameter is not supported with Integration Server 9.0 and higher. Specifies the frequency, in milliseconds, with which a secondary instance of a clustered polling notification will check to see if an executing instance is still alive. If you do not set the parameter, the secondary instance of the polling notification will change to the default maxLockDuration value of 180000 for the shared cache.

watt.art.concurrent.ConnectionPool

Specifies whether Adapter Runtime uses the concurrent connection pooling feature to concurrently create and release connections from a connection pool. When the parameter is set to true, Adapter Runtime can create and release multiple connections from a connection pool at the same time. When the parameter is set to false, Adapter Runtime can either create or release one connection at a time from a connection pool. The default is false.

watt.art.connection.nodeVersion

Specifies whether the adapter connection stores the password in the passman store and the password handle in the connection node. When the watt.art.connection.nodeVersion parameter is set to 1, the password is embedded in the adapter connection. When the parameter is set to 2, the password handle is stored in the adapter connection. The default is 2. Software AG recommends using the default value. Every time you set a new value for this parameter, you must restart Integration Server or reload the WmART package.

When the value of the watt.art.connection.nodeVersion parameter is 2, during run time-based deployment with webMethods Deployer you must perform variable substitution for the password field to deploy the password to the target system.

watt.art.deploy.listener.disable.waitTime

Specifies the time interval in milliseconds for which the Adapter Runtime waits for the listener to be disabled. The default time interval is 60000 milliseconds.

watt.art.notification.eventBus.retries

Specifies the number of retries to publish adapter polling and listener notifications to the event bus. The default number of retries is 5.

Note: Event Routing component is deprecated from version 10.3 onwards. Event publishing for adapter notifications will not be supported.

watt.art.notification.eventBus.retryInterval

Specifies the time interval in milliseconds between each retry. The default time interval is 30000 milliseconds.

Note: Event Routing component is deprecated from version 10.3 onwards. Event publishing for adapter notifications will not be supported.

watt.art.notifications.disableImplicitUpdate

Specifies whether the Adapter Runtime updates an adapter listener with the list of registered listener notifications when creating a new listener notification. When the parameter is set to true, the adapter disables the implicit update of registered notifications. When the parameter is set to false, the adapter does not disable the implicit update of registered notifications. The default is false.

watt.art.page.size

Specifies the maximum number of items to be displayed on an adapter's Connections screen, Listeners screen, and Notifications screen. The default is 10. For more information about controlling pagination, see Controlling Pagination.

watt.art.synchronousNotification.selectExecuteUser

Specifies WmART-based adapters that are to include a Run as User column on the Listener Notifications screen. With this column in place, you can assign a user to a notification. Then, when the listener notification invokes a service, it runs as the specified user. You can specify one or more adapters. If you specify multiple adapters, separate the names with semicolons (;), for example: watt.art.synchronousNotification.selectExecuteUser=WmMQAdapter;WmSAP

watt.art.service.pipeline.hidden

Specifies whether the adapter service pipeline is logged in the Integration Server log file. When the watt.art.service.pipeline.hidden parameter is set to true, the service pipeline is not logged in the Integration Server log file. When the parameter is set to false, the service pipeline is logged in the Integration Server log file. The default is false.

watt.art.tmgr.timeout

Specifies Integration Server’s transaction timeout interval in number of seconds. If you do not set this parameter, Integration Server’s default transaction timeout is no timeout (NO_TIMEOUT). The transaction timeout parameter does not halt the execution of a flow service. It is the maximum number of seconds that a transaction can remain open and still be considered valid. For example, if a current transaction has a timeout value of 60 seconds and a flow takes 120 seconds to complete, the transaction manager will roll back all registered operations regardless of the execution status.

watt.art.wmConnectionPool.pingRetryInterval

Specifies the time interval of an Adapter Runtime ping to the underlying resource. The default value is 120 seconds.

You use this parameter together with the watt.art.wmConnectionPool.pingSafeInterval parameter and the pub.art.connection:queryConnectionState service to monitor the state of the underlying resource at frequent intervals.

Note: The Adapter Runtime ping functionality uses database/back end credentials (user id and password) to create a connection and then destroy it to check the connectivity. Because creating and destroying a connection causes overhead, the ping interval should not be very small.

watt.art.wmConnectionPool.pingSafeInterval

Specifies a safe time interval for an Adapter Runtime ping to the underlying resource. The safe time interval is calculated based on the last connection provided by the connection pool. The default value is 5 seconds.

You use this parameter together with the watt.art.wmConnectionPool.pingRetryInterval parameter and the pub.art.connection:queryConnectionState service to monitor the state of the underlying resource at frequent intervals.

Note: The Adapter Runtime ping functionality uses database/back end credentials (user id and password) to create a connection and then destroy it to check the connectivity. Because creating and destroying a connection causes overhead, the ping interval should not be very small.

watt.pkg.art.pollingnotification.scheduler

This parameter is not supported with Integration Server 9.0 and higher. Specifies whether Integration Server executes adapter polling notifications using scheduled tasks or the shared cache. When this parameter is set to false (the default), Integration Server uses the shared cache to execute polling notifications. When this parameter is set to true, Integration Server uses scheduled tasks for the execution, scheduling, and cluster coordination of adapter polling notifications. When a notification is enabled, Integration Server creates a scheduled task that polls the back end resource at a specified interval. When a notification is disabled, Integration Server deletes the scheduled task.

When the parameter is set to true, you must also:

For complete information about configuring adapter polling notifications, see the adapter's documentation.

watt.pkg.art.pollingnotification.scheduler.adapters

This parameter is not supported with Integration Server 9.0 and higher. Specifies package names of adapters whose polling notifications are to execute using Integration Server scheduled tasks. To specify multiple package names, separate each entry with a semicolon (;). For example, to have polling notifications for webMethods Adapter for JDBC and webMethods Oracle Applications Adapter execute as scheduled tasks, specify the following: watt.pkg.art.pollingnotification.scheduler.adapters=WmJDBCAdapter;WmOAAdapter

This parameter has no effect unless the watt.pkg.art.pollingnotification.scheduler is set to true. For complete information about configuring adapter polling notifications, see the adapter's documentation.

watt.pkg.art.scheduler.notificationtask.display

Specifies whether scheduled adapter polling notification tasks are shown on the Scheduler screen. When the parameter is set to true, the scheduled tasks are displayed. When this parameter is set to false, the tasks are hidden. The default is true. For complete information about configuring adapter polling notifications, see the adapter's documentation.

watt.art.connection.byPassConnValidation

Specifies whether or not the Integration Server validates the WmART based adapter connection parameters. When the parameter is set to true, the server does not validate adapter connection parameters, and all currently enabled adapter connections are maintained. Even if the backend resource is not available at restart, enabled connections remain enabled. When this parameter is set to false, the server verifies all enabled adapter connection parameters by trying to connect to its associated backend resource.

watt.server.jca.connectionPool.createConnection.interrupt.waitTime

Specifies the wait time interval in milliseconds, which elapses before Integration Server interrupts a connection creation thread that is in a wait state. The parameter does not require a default value.

watt.server.jca.connectionPool.threadInterrupter.sleepTime

Specifies the sleep time of the pool interrupter thread. The default value of the property is set to 2000 milliseconds, which is the sleep time for the pool interrupter thread.

watt.server.jca.connectionPool.threadInterrupt.waitTime

Specifies the wait time, measured in milliseconds, that elapses beforeIntegration Server Connection pool interrupts a connection creating thread or connection closing thread. The pool interrupter thread will start monitoring the server threads, only if this property is set. There is no default value. You must restart Integration Sever for changes to this parameter to take effect.