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.
watt.art.notification.eventBus.retryInterval
Specifies the time interval in milliseconds between each retry. The
default time interval is 30000 milliseconds.
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.
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.
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:
- Set the watt.pkg.art.pollingnotification.scheduler.adapters parameter to specify the adapters that will use the scheduled task functionality.
- Decide whether to display the scheduled tasks for adapter polling notifications in Integration Server Administrator, by setting the watt.pkg.art.scheduler.notificationtask.display parameter.
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.