Configuration Parameters
Overview
This appendix contains a description of the webMethods 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.art.connection.parallel.Initialization
Specifies the connectivity with the backend in a separate thread.
When the parameter is set to
true, the enabled connection initializes the
parallel connection in a separate thread to avoid the increase in the package
load time and the
Integration Server booting time. Depending on the number of ART
connections and notifications present in a package, the number of threads are
required to initialize the assets from the
Integration Server pool . The default 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 webMethods Adapter Runtime
creates an entry in the error logs for exceptions in adapter services. When the
parameter is set to true, webMethods Adapter Runtime does
not create an entry in the error logs for exceptions in adapter services. When the
parameter is set to false, webMethods 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 webMethods 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, webMethods Adapter Runtime can create and release multiple connections from a connection
pool at the same time. When the parameter is set to false, webMethods 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. IBM 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 IBM 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 webMethods 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 webMethods 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 page, Listeners page, and Notifications page. The default is
10. For more information about
controlling pagination, see Controlling Pagination.
watt.art.quiesce.threadPool.size
Specifies the number of threads that the server maintains in the thread pool for unregistering the adapter assets when Integration Server enters quiesce mode. The threads in the pool are responsible for tasks related to unregistering adapter assets, including closing connections, disabling listeners, and notifications.
watt.art.quiesce.threadPool.timeout
Time interval in milliseconds that the threads in the pool wait for the adapter asset to unregister, when Integration Server enters quiesce mode.
watt.art.synchronousNotification.selectExecuteUser
Specifies WmART-based adapters that are to include a Run as User column on the Listener
Notifications page. 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 webMethods 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 webMethods 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
IBM 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 number of milliseconds the pool interrupter thread sleeps between sweeps
for server threads that became blocked while creating or closing a connection. When the
sleep time elapses, the pool interrupter thread, which is a monitor thread for the
connection pool, checks for server threads that became blocked while attempting to
create or close a connection from the connection pool. The default is
2000 milliseconds.
watt.server.jca.connectionPool.threadInterrupt.waitTime
Specifies the maximum number of milliseconds that a thread can take while creating or closing a connection before the pool interrupter thread interrupts the thread. After the specified time elapses, the pool interrupter thread considers the thread to be blocked and interrupts it. There is no default value. The pool interrupter thread, which is a monitoring thread for the connection pool, only executes if this server configuration property has a value that is greater than zero.
You must restart Integration Server for changes to this parameter to take effect.