webMethods 10.2 | Integration Server Administrator's Guide | Server Configuration Parameters | watt.server.
 
watt.server.
watt.server
This is an internal parameter. Do not modify.
watt.server.acl.groupScanInterval
Specifies how often, in milliseconds, Integration Server checks for the availability of the My webMethods Server database, if the database is unavailable at Integration Server startup. While the database is unavailable, group information about users that are managed by Central User Management is unavailable. As a result, users in those groups do not have the access rights granted by their associated ACLs. While the My webMethods Server database is unavailable, the Security > Access Control List screen displays the affected groups with the suffix @--@, for example FinanceGroup@--@. When the My webMethods Server database becomes available, the groups regain their access rights and Integration Server removes the @--@ suffix. The default setting is 10,000 milliseconds (10 seconds).
watt.server.allowDirective
Restricts the use of specified directives to specified ports. For information on directives, see Controlling the Use of Directives). The syntax for this property is:
port-string is a comma-delimited list of port numbers such as "5555,6666".
Suppose you want to allow all ports to use the default directive, but you want specific ports to use the other directives, as described below:
Restrict use of the invoke directive to ports 5555 and 7777
Restrict use of the web directive to ports 6666 and 7777
Restrict use of the SOAP directive to port 7777
To obtain the behavior described above, you would specify the following:
watt.server.allowDirective=invoke,5555,7777,web,6666,7777,soap,7777
watt.server.apiportal.url
Specifies the URL for establishing a connection to API Portal and publishing a REST API descriptor. This parameter derives the API Portal URL from the following:
*Host name and port number for the API Portal connection.
*Tenant for which the REST API descriptor is to be published.
*Specification of the REST API descriptor.
watt.server.audit.dbEncoding
Specifies the character set used by the audit logging database. The default is UTF-8. The value for this property must be a standard Internet Assigned Numbers Authority (IANA)-assigned character set name, as defined in the IANA Character Sets specification.
Important: If you change the value of this property, you must restart Integration Server for the change to take effect.
watt.server.audit.displayLogs.convertTime
Specifies how dates are displayed when you view the service, error, session, guaranteed delivery, and security logs from the Integration Server Administrator. When this property is set to false, time stamps are shown as GMT/UTC. When this property is set to true (the default), time stamps are shown in the local time zone of the Integration Server, and in the format specified by watt.server.dateStampFmt.
watt.server.auditDocIdField
Specifies a custom document ID value to identify documents in a standard way and to provide uniform business context in the logging display. Some documents are logged by webMethods Broker through WmLogUtil to the document database, and some are logged by various components within the Integration Server, for example, if a service fails, or if the number of retries in a trigger are exceeded. As a result, when viewing the Document Monitor, some documents are logged with a numeric document ID, and some are logged with lengthy hexadecimal strings as the document ID. The custom document ID value that you specify will be used to create the document logging ID. This value is used in place of the BrokerEvent.getEventId() value (the original document ID behavior). The value must be in the form of a Broker unicode string, and values in excess of 128 characters will be truncated. If this extended setting is missing, the original document ID behavior applies. If this extended setting is present but undefined (null), the _env.uuid value is used if present; if no _env.uuid value is defined, the original document ID behavior applies. For more information about document logging, see Administering webMethods Broker.
watt.server.audit.failFastLoggers
Specifies the loggers that can enter into fail-fast mode when fail-fast mode is enabled for the ISCoreAudit functional alias.
*If watt.server.audit.failFastLoggers is empty, all synchronous audit loggers that use a database destination will have fail-fast capability.
*If watt.server.audit.failFastLoggers is not empty, only the synchronous audit loggers with a database destination listed in watt.server.audit.failFastLoggers will have fail-fast capability.
Note: Fail-fast mode is enabled for the ISCoreAudit functional alias when the Fail-Fast Mode Enabled option is set to Yes for the alias.
If you want to identify the specific audit loggers that can enter fail-fast mode, use the watt.server.audit.failFastLoggers to specify a comma-separated list of the loggers that can enter into fail-fast mode. For example, if you want the Service Logger and Session Logger to be able to enter into fail-fast mode, set the property as follows:
watt.server.audit.failFastLoggers=Service Logger,Session Logger
You must specify the word "Logger" as part of the logger name. The property is case-sensitive. You must specify the logger name as it appears on the Settings > Logging page of Integration Server Administrator. Do not include a space before or after the comma that separates logger names.
Only synchronous loggers can enter fail-fast mode. Integration Server ignores any asynchronous loggers specified in the watt.server.audit.failFastLoggers property.
The default for watt.server.audit.failFastLoggers is empty. That is, the default is that all synchronous audit loggers that use a database destination will have fail-fast capability when the ISCoreAudit functional specifies Yes for the Fail-Fast Mode Enabled option.
watt.server.audit.logDir
Specifies the directory that contains the audit log files. You can specify the full-path name, or a relative path in relation to the Integration Server. The directory must exist on the server. The default value is logs, which indicates the Integration Server_directory \instances\instance_name\logs directory. If an invalid value is specified, Integration Server uses the default value and writes an error to the server log during startup.
Important: If you change the value of this property, you must restart Integration Server for the change to take effect.
Note that watt.server.audit.logDir does not affect audit loggers that write to a database.
watt.server.audit.logFilesToKeep
Specifies the number of audit log files, including the current log file for the audit logger, that Integration Server keeps on the file system for an audit logger that writes to a file. When Integration Server reaches the limit for the number of log files for the audit logger, each time Integration Server rotates the audit log, Integration Server deletes the oldest archived audit log file. If you set watt.server.audit.log.filesToKeep to 1, Integration Server keeps the current audit log file and no previous audit log files for each file-system based audit logger. That is, when Integration Server rotates the audit log for a logger, Integration Server does not create an archive file for the previous audit log. If you set watt.server.audit.logFilesToKeep to 0, or any value less than 1, Integration Server keeps an unlimited number of audit log files.
The default value of watt.server.log.filesToKeep is 0, indicating that there is no limit to the number of audit log files that Integration Server maintains for audit loggers that write to a file.
The watt.server.audit.logFilesToKeep parameter affects only the audit loggers configured to write to a file. The parameter does not affect audit loggers configured to write to a database nor does it affect the FailedAuditLog.
If you reduce the number of logs that Integration Server keeps for file-based audit logs and then restart Integration Server, the existing audit logs will not be pruned until Integration Server writes to the audit log. For example, if the error logger writes to a file and you reduce the number of log files to keep from 10 to 6, Integration Server does not delete the 4 oldest error audit log files immediately after start up. Integration Server deletes the 4 oldest error audit logs after the error logger writes to the error audit log.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.audit.logRotateSize
Specifies the file size at which Integration Server rolls over the audit log for a logger that writes to a file. Set this property to N[KB|MB|GB], where N is any valid integer. The minimum size at which Integration Server rotates an audit log is 33KB. If you use KB as the unit of measure, you must set N to a value greater than or equal to 33. If you do not specify a unit of measure, Integration Server treats the supplied N value as bytes. In this case, N must be greater than or equal to 32768 to take effect. Do not include any spaces between the integer and the unit of measure.
There is no default value for this parameter. That is, by default, the parameter has no value. If no value is specified for watt.server.audit.logRotateSize, Integration Server rotates the audit logs at midnight only.
If an invalid value is specified, Integration Server proceeds as if no value was specified for the parameter. If you set the value using the Extended Settings page in Integration Server Administrator, validation prevents an invalid value from being saved.
The watt.server.audit.logRotateSize parameter affects only the audit loggers configured to write to a file. The parameter does not affect audit loggers configured to write to a database.
For more information about audit logging, see the webMethods Audit Logging Guide.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.audit.schemaName
Specifies the name of the database schema that Integration Server should use while requesting metadata for the audit logging database. There is no default. If watt.server.audit.schemaName is not set, Integration Server does not retrieve database metadata and assumes the lengths of the WMSERVICECUSTOMFLDS.STRINGVALUE and WMSERVICEACTIVITYLOG.FULLMESSAGE columns are 512 and 1024, respectively.
Note: Some databases are case-sensitive. When specifying the value for watt.server.audit.schemaName, you should match the case of the schema name with the schema name required by the database.
Note: If you change the value of this property, you must restart Integration Server for the changes to take effect.
watt.server.audit.um.sessionPool.min
Specifies the minimum number of sessions in the Universal Messaging session pool. Integration Server maintains a separate session pool for each Universal Messaging connection alias used by an audit logger. The value of this parameter must be an integer value greater than 0 and less than or equal to the value of watt.server.audit.um.sessionPool.max. The default value is 2.
If you specify an invalid value, Integration Server logs a warning message at start up and then uses the default value at runtime. However, Integration Server does not persist the default value over the invalid value you specified.
Note: If you change the value of this property, you must restart Integration Server for the changes to take effect.
watt.server.audit.um.sessionPool.max
Specifies the maximum number of sessions in the Universal Messaging session pool. Integration Server maintains a separate session pool for Universal Messaging connection alias used by an audit logger. The value of this parameter must be an integer greater than 0 and greater than or equal to the value of watt.server.audit.um.sessionPool.min. The default value is 10.
If you specify an invalid value, Integration Server logs a warning message at start up and then uses the default value at runtime. However, Integration Server does not persist the default value over the invalid value you specified.
Note: If you change the value of this property, you must restart Integration Server for the changes to take effect.
watt.server.audit.um.sessionPool.retryInterval
Specifies the number of seconds for Integration Server to wait between attempts to re-establish a session on the Universal Messaging server after an audit logger enters queue fail-fast mode. An audit logger enters queue fail-fast mode wdrehen it cannot establish a connection to the Universal Messaging server that contains the audit logging queue. Specify an integer greater than 0 (zero). The default is 30 seconds.
If you specify an invalid value, Integration Server uses the default value at runtime. However, Integration Server does not persist the default value over the invalid value you specified.
Note: If you change the value of this property, you must restart Integration Server for the changes to take effect.
watt.server.auth.cache.capacity
Specifies the number of user name and password combinations Integration Server stores in the authentication cache. The default value is 250.
watt.server.auth.cache.enabled
Specifies whether the authentication cache is enabled. When set to true, the authentication cache is enabled. The default value is true.
watt.server.auth.cache.timeout
Specifies the number of milliseconds that each cache entry can remain idle before Integration Server removes it from the authentication cache. The default is 300000 (5 minutes).
Note: Entries removed from the authentication cache are added again the next time the credentials are authenticated successfully.
Note: Once a user has changed the password and logged in successfully with the new password, Integration Server removes the old password from the authentication cache.
watt.server.auth.checkWithSession
When Integration Server receives an HTTP request that includes both an Authorization header and a Cookie header with a session identifier, this parameter specifies whether Integration Server should check that the user identified in the Authorization header is the owner of the session identified in the Cookie header. When set to true (the default), Integration Server confirms that the user of the Authorization header is the owner of the identified in the Cookie header. If the headers do not match, Integration Server returns an HTTP 401 status code with the following message:
The user identified in the request does not own the requested session.
Important: If you set watt.server.auth.checkWithSession to false, Integration Server allows HTTP requests to use mismatched credentials to access the services on Integration Server and, as a result, might put your applications at risk.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.auth.oauth.accessToken.useHeaderFields
Specifies whether Integration Server performs OAuth authentication when an inbound HTTP/S request includes an access_token in the header fields. Specify true to perform OAuth authentication. Specify false to skip OAuth authentication. The default is true.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.auth.oauth.accessToken.useQueryParameters
Specifies whether Integration Server performs OAuth authentication when an inbound HTTP/S request includes an access_token in the query parameter. Specify true to perform OAuth authentication. Specify false to skip OAuth authentication. The default is true.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.auth.samlResolver
Specifies the URL to the SAML artifact resolver endpoint on the My webMethods Server that will be used to validate My webMethods Server users on Integration Server. Along with configuring central user management, the value of this property allows single-sign on for My webMethods Server users. For more information, see Configuring the MWS Single Sign-On Resource Setting.
Note: Integration Server adds this property to the server.cnf file when you specify a value for the MWS SAML Resolver URL field on the Settings > Resources page of Integration Server Administrator. Software AG recommends that you use the MWS SAML Resolver URL field to specify the My webMethods Server SAML artifact resolver endpoint instead of changing the value of the watt.server.auth.samlResolver property.
watt.server.auth.session.retainJaasSubject
Specifies whether Integration Server should retain authentication credentials as part of a session. When set to true, Integration Server retains the authentication credentials until the session expires. If set to false (the default), Integration Server deletes the authentication credentials from the session after it handles the initial request from the client.
watt.server.auth.skipForMediator
Specifies whether Integration Server validates requests from Mediator to the native service. When this parameter is set to true, Integration Server skips authentication for Mediator requests. When set to false (the default) Integration Server authenticates all Mediator requests.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.broker.producer.multiclient
Specifies the number of sessions for the default client. The default client is the Broker client that the Integration Server uses to publish documents to the Broker and to retrieve documents delivered to the default client. When you set this parameter to a value greater than 1, the Integration Server creates a new multi-session, shared state Broker client named clientPrefix_DefaultClient_MultiPub, to use for publishing documents to the Broker. Using a publishing client with multiple sessions can lead to increased performance because it allows multiple threads to publish documents concurrently. The default is 1 session.
watt.server.broker.replyConsumer.fetchSize
Specifies the number of reply documents that the Integration Server retrieves from the Broker at one time. Increasing the reply documents the Integration Server retrieves for each call can reduce the number of calls the Integration Server makes to the Broker. The Integration Server maintains all reply documents in memory. You can reduce the amount of memory used for reply documents by decreasing the number of documents the Integration Server retrieves at one time. The default is 5 documents.
watt.server.broker.replyConsumer.multiclient
Specifies the number of sessions for the request/reply client. The request/reply client is the Broker client that the Integration Server uses to send request documents to the Broker and to retrieve reply documents from the Broker. Increasing the number of sessions for the request/reply client can lead to improved performance because it allows multiple requests and replies to be sent and retrieved concurrently. The default is 1 session.
watt.server.broker.replyConsumer.sweeperInterval
Specifies how often (in milliseconds) the Integration Server sweeps its internal mailbox to remove expired replies to published requests. The length of the interval should balance the amount of memory consumed by expired replies with retrieving the replies for waiting requests. The Integration Server uses one background thread to age and remove expired replies and uses multiple background threads to retrieve replies for waiting requests. When the sweeper thread removes expired replies, it blocks the threads attempting to retrieve replies. When then sweeper interval is too low, the frequent execution of the sweeper thread can degrade performance because other background threads cannot retrieve replies as often. A sweeper interval that is too high can cause an increase in memory usage because expired replies consume memory for a longer period of time. The default is 30000 milliseconds (30 seconds).
watt.server.brokerTransport.dur
Specifies the number of seconds of idle time that the Broker waits before sending a keep-alive message to Integration Server. If Integration Server does not respond within the amount of time specified by the watt.server.brokerTransport.max property, the Broker sends another keep-alive message to Integration Server. If Integration Server continues to be unresponsive, the Broker continues sending keep-alive messages until it reaches the retry limit specified by the watt.server.brokerTransport.ret property. If the Integration Server still has not responded to the keep-alive message, the Broker explicitly disconnects the Integration Server. The watt.server.brokerTransport.dur value must be an integer greater than or equal to zero but less than 2147483647. The default is 60 seconds.
For more information about using server parameters to configure the keep-alive setting with the Broker, see Setting Server Configuration Parameters for Keep-Alive Mode.
watt.server.brokerTransport.max
Specifies the number of seconds that the Broker waits for the Integration Server to respond to a keep-alive message. This value must be an integer between 0 and 2147483647. The default is 60 seconds.
For more information about using server parameters to configure the keep-alive setting with the Broker, see Setting Server Configuration Parameters for Keep-Alive Mode.
watt.server.brokerTransport.ret
Specifies the number of times the Broker re-sends keep-alive messages before disconnecting an un-responsive Integration Server. This value must be an integer between 1 and 2147483647. The default is 3 retries.
watt.server.cache.prefetchUser
Specifies the user authorized to prefetch cache service entries. The default is Administrator.
watt.server.cache.flushMins
Specifies how often (in minutes) the server sweeps the cache to remove expired cache entries and to prefetch cache service entries. The default is 10 minutes.
Note: This configuration parameter applies to the service-results caching feature. It does not affect the caching capabilities provided by Ehcache.
watt.server.cache.gcMins
Specifies how often (in minutes) the server sweeps the cache to perform garbage collection. The default is 60 minutes.
Note: This configuration parameter applies to the service-results caching feature. It does not affect the caching capabilities provided by Ehcache.
watt.server.cache.maxEntriesInCache
Specifies the default value for the Maximum Entries in Cache property for a distributed system cache used in an Integration Server cluster. The default is -1 which indicates that Integration Server does not set a default value for the Maximum Entries in Cache property. If you want Integration Server to set a default value for the Maximum Entries in Cache property, you must specify a value greater than 0.
watt.server.cachemanager.connectTimeout
Specifies the number of milliseconds a cache manager will wait while trying to connect to a server specified in the Terracotta Server Array URLs list. The default is 60000 milliseconds (i.e. 60 seconds).
Note: Regardless of the watt.server.cacheManager.connectTimeout value, a cache manager will wait for a maximum of 300 seconds to connect to a server in the Terracotta Server Array. For example, if this property is set to 60000, the cache manager will wait for 60000 milliseconds to connect to any of the available server. If a connection is not established to any of the servers in 60000 milliseconds, an exception is thrown and then Integration Server takes the action specified by the watt.server.cluster.action.errorOnStartup parameter.
watt.server.cachemanager.logsDirectory
Specifies the location where Ehcache will write log files. The default value of this folder is Integration Server_directory \instances\instance_name\logs\tc-client-logs
watt.server.cachemanager.parallelThreads
Specifies the maximum number of threads that you want Integration Server to use when initializing cache managers at startup.
If the server contains a large number of cache managers, distributed cache managers, or a cache manager with a large number of caches, the registration process at start up could take a long time. To avoid this, you can increase the number of threads used to initialize cache managers by setting the watt.server.cachemanager.parallel.threads property.
If you want Integration Server to initialize cache managers sequentially, set the value to 1. If you want Integration Server to initialize cache managers in parallel, set the value to 2 or higher. Software AG recommends that you do not exceed 10. The default value is 5.
watt.server.centralUsers.shutdownOnError
Specifies whether the Central Users component shuts down when it encounters an error. When this property is set to true, the Central User component shuts down when it encounters an error. When the Central Users component shuts down, the Integration Server must be restarted. When this property is set to false, the default, the Central User component does not shut down when it encounters an error.
watt.server.checkAclsInternally
Specifies whether Integration Server performs ACL checking when a service is directly invoked by a client or trigger and when it is invoked from other services. When set to true, Integration Server always checks the Execute ACL for a service, regardless of the value of the Enforce Execute ACL property for the service. When set to false, the value of the Enforce Execute ACL property determines whether or not Integration Server performs ACL checking when a service executes. The default is false.
watt.server.cgi.cache
Specifies whether the output pipeline should display all the elements in a response when using CGI content handlers to format the responses. When this property is set to false, the output pipeline displays all the elements in the response. When this property is set to true, if the response contains multiple non-string, non-null elements with the same value, the output pipeline will display only the first occurrence of the value. For each of the subsequent occurrences, the output will contain the string, *ObjectRef(className)*. The default is false.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.cgi.unicode
Specifies whether the CGI content handler should use Unicode encoding. When this property is set to false, the CGI content handler will use the encoding specified by the watt.server.netencoding property to encode responses. When this property is set to true, the CGI content handler will use Unicode to encode responses. The default is false.
watt.server.classloader.pkgpriority
Specifies the order in which Integration Server scans packages when loading a class file for which no package information is available. When no order is specified, Integration Server attempts to load the class by scanning all packages in the Packages directory, one by one. This could delay class loading. For example, when a trigger contains a reference to a Java class, the trigger does not have any package information. Integration Server scans all the packages for the specific class file in random order. Specifying the packages that Integration Server should scan first may reduce the time needed for class loading.
Use the watt.server.classloader.pkgpriority property to specify a comma delimited list of the packages whose class loader should load first. The syntax for this property is:
watt.server.classloader.pkgpriority=packageName, packageName
For more information about class loading, refer to How the Server Loads Java Classes.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.clientTimeout
Specifies the amount of time (in minutes) after which an idle user session times out. The default is 10.
watt.server.cluster.action.errorOnStartup
Specifies how Integration Server responds when an error at start up prevents Integration Server from joining the cluster. Select one of the following:
Value
Description
shutdown
If Integration Server encounters any errors that prevent it from joining the cluster at start up, Integration Server shuts down immediately. To make any changes to the clustering configuration, you must start Integration Server in safe mode, then edit the configuration, and then restart Integration Server.
shutdown corresponds to the Action on Startup Error parameter option Shut Down Integration Server on the Settings > Clustering > Edit screen.
standalone
If Integration Server encounters any errors that prevent it from joining the cluster at start up, Integration Server starts as a stand-alone, unclustered Integration Server. Integration Server continues to receive requests on inbound ports and serve requests. Integration Server does not use any distributed caches and instead uses local caches. You can use Integration Server to make changes needed to resolve the startup errors. When you restart Integration Server, Integration Server will rejoin the cluster if Integration Server does not encounter any start up errors that prevent the connection to the Terracotta Server Array.
This is the default value.
standalone corresponds to the Action on Startup Error parameter option Start as Stand-Alone Integration Server on the Settings > Clustering > Edit screen.
quiesce
If Integration Server encounters any errors that prevent it from joining the cluster at start up, Integration Server starts as a stand-alone, unclustered Integration Server in quiesce mode. When Integration Server is in quiesce mode, only the diagnostic port and quiesce port are enabled. Integration Server will not receive requests on inbound ports. However, you can use Integration Server and Integration Server Administrator to make changes needed to correct the startup errors. After correcting the errors, exit quiesce mode. When exiting quiesce mode, Integration Server starts all the cache managers and joins the cluster.
If Integration Server encounters any errors that prevent it from joining the cluster when exiting quiesce mode, Integration Server does not re-enter quiesce mode. Instead, Integration Server runs as an unclustered, stand alone server. Integration Server captures any errors that occurred while attempting to join the cluster in a report displayed in Integration Server Administrator when the server exits quiesce mode. Use the report and error logs to help correct the underlying configuration errors. Then, to rejoin the cluster, either restart Integration Server or enter and then exit quiesce mode.
To use the quiesce option, a quiesce port must be configured for Integration Server. If a quiesce port is not configured and the quiesce option is selected, when Integration Server encounters any errors that prevent it from joining the cluster at start up, Integration Server shuts down instead of entering quiesce mode.
quiesce corresponds to the Action on Startup Error parameter option Enter Quiesce Mode on Stand-Alone Integration Server on the Settings > Clustering > Edit screen.
For more information about quiesce mode, see Quiescing the Server for Maintenance.
The watt.server.cluster.action.errorOnStartup parameter displays the value specified in the Action On Startup Error parameter on the Settings > Clustering and Settings > Clustering >Edit screens of Integration Server Administrator. Software AG recommends that you specify the action to take when Integration Server cannot connect to the cluster on startup using the Action On Startup Error parameter on the Settings > Clustering > Edit screen instead of by changing the value of the watt.server.cluster.action.errorOnStartup parameter.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.cluster.aliasList
Specifies a comma-delimited list of aliases for remote Integration Servers in a cluster. The Integration Server uses this list when executing the remote invokes that update the other cluster nodes with trigger management changes. When this property is configured, the Settings > Messaging > webMethods Messaging Trigger Management > Cluster View screen will be visible and the Apply Change Across Cluster check box will be available when performing trigger management tasks.
This parameter is applicable only when you are using webMethods clustering. For more information, see the webMethods Integration Server Clustering Guide.
watt.server.cluster.aware
Specifies whether you want the server to participate in a cluster. A value of true indicates that clustering is enabled for the server. The default is false.
The value of the watt.server.cluster.aware parameter is tied to the value of the Clustering Status field on the Settings > Clustering screen in Integration Server Administrator. Software AG recommends that you use Integration Server Administrator to enable or disable clustering for an Integration Server instead of using the watt.server.cluster.aware property.
This parameter is applicable only when you are using this Integration Server in a cluster.
Important: You must restart Integration Server for changes to take effect.
Note: If watt.server.cluster.aware is set to true, you must also specify values for the watt.server.cluster.tsaURLs and watt.server.cluster.name parameters.
watt.server.cluster.name
Specifies the name of the cluster to which Integration Server belongs. If Integration Server does not belong to a cluster, this parameter is empty.
Keep the following in mind when specifying the cluster name:
*The cluster name cannot include any periods “.”. Integration Server converts any periods in the name to underscores when you save the cluster configuration.
*The cluster name cannot exceed 32 characters. If it does, Integration Server uses the first 20 characters of the supplied name and then a hash for the remaining characters.
The watt.server.cluster.name parameter displays the value specified in the Cluster Name parameter on the Settings > Clustering and Settings > Clustering >Edit screens of Integration Server Administrator. Software AG recommends that you specify the cluster name using the Cluster Name parameter on the Settings > Clustering > Edit screen instead of by changing the value of the watt.server.cluster.name parameter.
Important: You must restart Integration Server for changes to take effect.
Note: If watt.server.cluster.aware is set to true, you must also specify values for the watt.server.cluster.tsaURLs and watt.server.cluster.name parameters.
watt.server.cluster.SessTimeout
Specifies number of minutes that the server allows inactive session objects to remain in the cluster store before removing them. The default is 60.
This parameter is applicable only when you are using webMethods Integration Server Clustering. For more information, refer to the webMethods Integration Server Clustering Guide.
watt.server.cluster.tsaURLs
A comma-separated list of the Terracotta Server Array URLs that the cluster uses for distributed system caches. This parameter is applicable only when Integration Server belongs to a cluster.
The watt.server.cluster.tsaURLs parameter is tied to Terracotta Server Array URLs parameter on the Settings > Clustering and Settings >Clustering > Edit screen in Integration Server Administrator. Software AG recommends that you specify the Terracotta Server Array URLs using the Terracotta Server Array URLs parameter on the Settings > Clustering > Edit screen instead of by changing the value of the watt.server.cluster.tsaURLs parameter.
Important: You must restart Integration Server for changes to take effect.
Note: If watt.server.cluster.aware is set to true, you must also specify values for the watt.server.cluster.tsaURLs and watt.server.cluster.name parameters.
watt.server.coder.bincoder.trycontextloaderfirst
Specifies whether Integration Server uses the context loader before using the class loader for the currently executing thread when Integration Server encodes or decodes a pipeline. If a referenced class belongs to a particular package, it may be faster to use the context loader first. The default is false.
watt.server.compile
Specifies the compiler command that Integration Server uses to compile Java services that are developed using Designer, for example, javac -classpath {0} -d {1} {2}. This compiler command is also used from the jcode utility. If this property is omitted or empty, the server uses the JVM internal Java compile tool to compile Java services.
Note: If you use the watt.server.compile property to have Integration Server use a different compiler, and that compiler returns errors and warnings to standard out rather than standard error, set watt.server.compile.readFromStdErr to false so that the compiler errors and warnings will be read and displayed to the Java developer.
watt.server.compile.exitOnError
Specifies whether the jcode utility should stop processing after it fails. If set to true, the jcode utility stops processing at the package on which it fails. If set to false (the default), the jcode utility will continue processing despite the failure.
watt.server.compile.readFromStdErr
Specifies from where Integration Server reads compiler errors and warnings. The Software AG webMethods platform includes javac, the Java tool used to compile Java services in Designer and with the jcode utility. The javac compiler returns information about any errors or warnings it encountered during compilation to standard error. If you use the watt.server.compile property to have Integration Server use a different compiler, and that compiler returns errors and warnings to standard out rather than standard error, set watt.server.compile.readFromStdErr to false so that the compiler errors and warnings will be read and displayed to the Java developer. Set watt.server.compile.readFromStdErr to true for Integration Server to read compiler errors and warnings from standard error. The default is true.
watt.server.compile.unicode
Specifies the compiler command that Integration Server uses to compile Java services that are stored in Unicode encoding, for example, javac -encoding Unicode -classpath {0} -d {1} {2}. Note that the setting “javac -encoding Unicode -classpath {0} -d {1} {2}” works with the Oracle JDK compiler. This compiler command is also used from the jcode utility. If this property is omitted or empty, the server uses the JVM internal Java compile tool to compile Java services.
watt.server.content.type.default
Specifies what content type to use for HTTP requests that do not contain a Content-Type header. The default value is application/octet-stream.
Note: If you do not specify a value for watt.server.content.type.default and the Content-Type header is empty, Integration Server assigns the default value of application/octet-stream. In this case, you must create a content handler for application/octet-stream.
To specify that Integration Server should use a different Content-Type, change the value of watt.server.content.type.default to a different registered content type, such as text/xml or text/html. If you set the value of watt.server.content.type.default to an unregistered content type, Integration Server treats requests with a Content-Type header as if they are text/html.
Changes to this property take effect immediately.
watt.server.content.type.mappings
Maps wildcards found in the Accept header field of an HTTP client request to specific content types. The Accept header field specifies which content type or types the client will accept in a response. Integration Server selects an outbound content handler based on the allowed content type. The syntax for this parameter is:
watt.server.content.type.mappings=<wildcard> <content-type>,<wildcard> <content-type>,<wildcard> <content-type> ...
Where:
wildcard is a wildcarded content type, such as text/*
content-type is the specific content type to use
Use a space to separate the wildcarded content type from the specific content type. Use a comma to separate <wildcard> <content-type> pairs from other pairs. Consider the following examples:
To associate text/* with text/xml, specify:
watt.server.content.type.mappings=text/* text/xml
To associate text/* with text/xml, and multipart/* with multipart/related, specify:
watt.server.content.type.mappings=text/* text/xml,multipart/* multipart/related
Integration Server parses the Accept header and attempts to select a content type or types as defined in the W3C Hypertext Transfer Protocol specification.
The default setting is text/* text/xml. If this parameter is not specified, and an Accept header field specifies a wildcard, Integration Server selects a content handler based on the major content type specified, as shown below.
This Accept Header field...
Results in this content handler
text/*
XML
application/*
CGI
multipart/*
Multipart
The watt.server.http.useAcceptHeader property must be set to true for the watt.server.content.type.mappings parameter to work.
For more information about content handlers, refer to Content Handlers.
watt.server.control.controlledDeliverToTriggers.delayIncrementInterval
Specifies the interval used in conjunction with watt.server.control.controlledDeliverToTrigger.delays to determine the delay that Integration Server applies to services publishing documents locally when the trigger document store reaches 90% of its capacity. The default is 2000.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.control.controlledDeliverToTriggers.delays
Specifies a comma-separated list of values specifying the number of milliseconds that Integration Server delays services publishing local documents when the trigger document store is greater than or equal to 90% of its capacity. Integration Server changes the delay based on how long the trigger document store has continuously been at 90% or higher capacity. The default value is 500,2000,3000,3500,4000,4500,5000.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.control.controlledDeliverToTriggers.pctMaxThreshold
Specifies the trigger queue threshold at which the Integration Server slows down the delivery rate of locally published documents. This threshold is expressed as a percentage of the trigger queue capacity. For example, if you specify 80, the Integration Server decreases the rate at which it delivers locally published documents to a trigger queue when that trigger queue reaches 80% capacity. Integration Server resumes delivering documents at the normal rate when the trigger queue capacity drops below the specified threshold. The default is 90.
watt.server.control.freeMemoryThreshold
Specifies the threshold (as a percentage) at which Integration Server starts to warn of insufficient free memory. When the percentage of available free memory falls below the value of this property, Integration Server generates a warning in the server log. Valid values are 0 to 100. The default is 5.
watt.server.control.maxPersist
Specifies the capacity of the outbound document store. Integration Server places published documents in the outbound document store when the configured Broker is unavailable. When the number of documents in the outbound document store equals the capacity, the Integration Server blocks any threads executing services that publish documents. The Integration Server resumes execution of blocked threads after the Broker becomes available. Set this parameter to a whole number greater than 0. The default is 500,000 documents.
watt.server.control.maxPublishOnSuccess
Specifies the maximum number of documents that the server can publish on success at one time. For example, suppose that you set the maximum to 100 documents. ServiceA publishes 10 documents on success. ServiceB publishes 90 documents on success. ServiceC publishes 5 documents on success. ServiceA and ServiceB can publish documents concurrently. However, if ServiceC begins to publish documents before ServiceA or ServiceB completes, the Integration Server throws an exception for ServiceC because the documents published by ServiceC exceed the maximum number of documents that can be published on success at one time. If ServiceD publishes 125 documents on success and the maximum is 100, ServiceD will receive an exception every time it executes. The default is 50,000 documents.
watt.server.control.memorySensorInterval
The time interval (in milliseconds) at which the Integration Server will check the available free memory. The default is 300000 (5 minutes).
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.control.serverThreadThreshold
Specifies the threshold at which Integration Server starts to warn of insufficient available threads. When the percentage of available server threads goes below the value of this property, Integration Server generates a journal log message indicating the current available thread percentage and stating "Available Thread Warning Threshold Exceeded." When you receive this message in the journal log, you can adjust the thread usage to make server threads available.
The default is 15%.
Note: It is recommended that you use the Available Threads Warning Threshold field in the Edit Resource Settings page of the Integration Server Administrator to set the threshold value. For more information about setting an available threads warning threshold, see Managing the Server Thread Pool.
watt.server.control.threadSensorInterval
Specifies the interval, measured in milliseconds, at which Integration Server will monitor the thread usage. When the percentage of available server threads goes below the threshold value specified in the watt.server.control.serverThreadThreshold property, Integration Server will generate a journal log message to warn of insufficient available threads. The default is 2000 milliseconds.
watt.server.control.triggerInputControl.delayIncrementInterval
Specifies the interval used in conjunction with watt.server.control.triggerInputControl.delays to determine the frequency with which Integration Server polls a trigger client queue on the Broker if the queue was empty when it was last polled. The default is 10000.
Note: If an exception occurs when parsing the supplied values for watt.server.control.triggerInputControl.delays or watt.server.control.triggerInputControl.delayIncrementInterval, Integration Server resets both configuration parameters to the default values.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
For more information about controlling the polling frequency for trigger client queues on the Broker, see Delaying Polling Requests for webMethods Messaging Triggers.
watt.server.control.triggerInputControl.delays
Specifies a comma-separated list of values specifying the number of milliseconds that Integration Server delays the polling of a trigger client queue on the Broker. Integration Server changes the delay based on how long the trigger client queues has been empty. The default value is 500,1000,1500,5000.
Note: If an exception occurs when parsing the supplied values for watt.server.control.triggerInputControl.delays or watt.server.control.triggerInputControl.delayIncrementInterval, Integration Server resets both configuration parameters to the default values.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
For more information about controlling the polling frequency for trigger client queues on the Broker, see Delaying Polling Requests for webMethods Messaging Triggers.
watt.server.cors.allowedOrigins
Specifies the URIs from which Integration Server is to allow cross-origin requests to access resources.
As recommended by the CORS (Cross-Origin Resource Sharing) standard, Integration Server uses the values of this parameter to validate the request. Integration Server checks the URI specified in the Origin header of the CORS request. If it does not match a URI specified by this parameter, Integration Server refuses the request and returns an HTTP 403 status code with the following message:
Specified Origin is not allowed
If the URI matches a value specified by this parameter, Integration Server sends a response with the CORS Access-Control-Allow-Origin response header back to the requesting user agent.
To define this parameter, enter protocol://hostname or protocol://hostname:portnumber. You can specify the IP address or the name of the machine for hostname. The values are case-sensitive. Use a space or comma delimiter to specify multiple values.
Note: The IP address and host name cannot be used interchangeably. If you specify a host name, and a cross-origin request is received that uses the corresponding IP address or vice versa, Integration Server will reject the request.
You can use an asterisk (*) to indicate that any URI or origin is allowed.
Note: You cannot use the asterisk to indicate URIs if watt.server.cors.supportsCredentials is set to true.
You can also use regular expressions in the comma-separated list of allowed origin servers which can make the list of origin servers easier to maintain. Integration Server treats any value in the comma-separated list that begins with "r:" as a regular expression. Integration Server treats any value that does not begin with "r:" as a simple string. The server configuration parameter uses the Java regular expression syntax, as documented at https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html. A regular expression value must match the entire value of the Origin header in the HTTP request for it to be considered a match.
Example:
watt.server.cors.allowedOrigins=http://test1.domain.com,r:https?://.*.test2.domain.com:[0-9]+,r:.+\.[a-zA-Z]*-int.domain.com
Integration Server treats the first value, "http://test1.domain.com", as a simple string. If an Origin header contains this value, it will be allowed.
The second value, "r:https?://.*.test2.domain.com:[0-9]+", contains a regular expression. The "r:" is not part of the regular expression. The actual regular expression used to match supplied Origin headers is "https?://.*.test2.domain.com:[0-9]+".
The third value, "r:.+\.[a-zA-Z]*-int.domain.com", contains a regular expression. The "r:" is not part of the regular expression. The actual regular expression used to match supplied Origin headers is ".+\.[a-zA-Z]*-int.domain.com".
"Origin: http://test1.domain.com" will be allowed because it is equal to the first value.
"Origin: http://my.test2.domain.com:8080" will be allowed because it matches the second value.
"Origin: https://my.test2.domain.com:8088" will be allowed because it matches the second value.
"Origin: http://my.test2.domain.com" will not be allowed. If it had a port number, it would match the second value.
"Origin: nbps://example.prod-int.domain.com" will be allowed because it matches the third value.
"Origin: example.qa.staging-int.domain.com" will be allowed because it matches the third value.
"Origin: example.dev1-int.domain.com" will not be allowed. If the second token of the host name did not include any digits, it would have matched the third value.
Regular expressions that match any host name, IP address and port (e.g. "r:.+" and "r:.*") will have the same effect as "*".
Note: When CORS is enabled, Integration Server evaluates the list of regular expressions in watt.server.cors.allowedOrigins sequentially for every request. Integration Server performs a regular expression match operation on each regular expression until a match is found or all regular expressions in the list have been evaluated. Software AG recommends that you put the more frequently matched regular expressions at the beginning of the comma-separated list.
Note: You must specify a value if the watt.server.cors.enabled parameter is set to true.
watt.server.cors.enabled
Specifies whether Integration Server is to support CORS. If this parameter is set to true, Integration Server allows cross-origin requests. The default value is false.
Note: In a webMethods Enterprise Gateway configuration, enable support for CORS only on the Enterprise Gateway Server.
For more information about using CORS with Integration Server, see Using CORS with Integration Server . For instructions on how to configure Integration Server to allow cross-origin requests, see Configuring Integration Server to Accept CORS Requests.
watt.server.cors.exposedHeaders
Specifies the values Integration Server can include with the CORS Access-Control-Expose-Headers header in response to a CORS request. The CORS Access-Control-Expose-Headers header defines the headers that can be exposed to the user agent. Examine your client-side code to determine which response headers, if any, are retrieved by the client and need to be exposed.
The value for this parameter is case-sensitive. Use a space or comma delimiter to specify multiple values. For example:
watt.server.cors.exposedHeaders=<value1,value2,value3>
As determined by the CORS (Cross-Origin Resource Sharing) standard, the following are considered simple response headers and are always exposed: Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma.
watt.server.cors.host
Specifies the host and port on which clients send cross-origin requests to Integration Server. Integration Server uses this value to validate the Host header in the cross-origin request. For improved security, Software AG recommends that you define this parameter if support for CORS is enabled (that is, watt.server.cors.enabled is set to true).
To define this parameter, enter hostname:port or hostname. You can specify the IP address or the name of the machine for hostname. The value for this parameter is case-sensitive. If a value is not provided for this parameter, Integration Server does not validate the Host header in the request. If a value is provided but does not match the Host header in the request, Integration Server returns a 403 response with the message.
Note: The IP address and host name cannot be used interchangeably. If you specify a host name, and a cross-origin request is received that uses the corresponding IP address or vice versa, Integration Server will reject the request.
watt.server.cors.maxAge
Specifies the amount of time in seconds a user agent is allowed to cache the results of a preflight request. Integration Server uses this value in the CORS Access-Control-Max-Age response header.
The default is -1, which indicates the results do not remain on the client. The value must be an integer.
watt.server.cors.supportsCredentials
Specifies whether Integration Server is to set the CORS Access-Control-Allow-Credentials header in response to all CORS requests.
When set to true, Integration Server sets the CORS Access-Control-Allow-Credentials header to true in the response. When setting this parameter to true, keep the following points in mind:
*If the user credentials are valid and the user is authorized to access the resources, Integration Server will execute a CORS simple request with credentials. The user agent will display the response to the user.
*When Integration Server responds to a CORS preflight request, the response includes the Access-Control-Allow-Credentials header set to true so the user agent will allow the request with credentials.
Note: User credentials can be cookies, HTTP authentication, or client-side SSL certificates.
When set to false (the default), Integration Server does not set the CORS Access-Control-Allow-Credentials header in the response. When setting this parameter to false, keep the following points in mind:
*If the user credentials are valid and the user is authorized to access the resources, Integration Server will execute a CORS simple request with credentials. The user agent will not display the response to the user.
*When Integration Server responds to a CORS preflight request, the response does not include the Access-Control-Allow-Credentials header, so the user agent will not allow the request with credentials.
Note: For security reasons, Software AG recommends using the default setting (false) for this parameter. When set to false, the user agent ignores the cookies sent in the response. When this parameter is set to true, Software AG highly recommends using CSRF protection to safe guard your resources. For a more secure approach, consider using another standard, such as OAuth, for accessing authorized resources instead of relying on credentialed requests.
watt.server.cors.supportedHeaders
Specifies the request headers Integration Server will allow in cross-origin requests. Integration Server uses the value to validate the CORS Access-Control-Request-Header request header. If the header is not an exact match of a value specified by watt.server.cors.supportedHeaders, Integration Server refuses the request and returns an HTTP 403 status code with the following message:
Header not supported
If the header matches the value specified by this parameter, Integration Server responds with the CORS header Access-Control-Allow-Headers populated with the value of this parameter.
Examine your server-side code to determine which request headers, if any, are read by your server application and need to be explicitly allowed.
The value for this parameter is case-sensitive. Use a space or comma to separate multiple request headers. For example,
watt.server.cors.supportedHeaders=<header1,header2,header3>
As determined by the CORS (Cross-Origin Resource Sharing) standard, the following are considered simple request headers and are always exposed: Accept, Accept-Language, Content-Type (when the value is application/x-www-form-urlencoded, multiplart/form-data, or text/plain).
watt.server.cors.supportedMethods
Specifies the HTTP methods Integration Server will allow in cross-origin requests. Integration Server uses this value to validate the value of the CORS Access-Control-Request-Method request header. If the header is not an exact match of a value specified by watt.server.cors.supportedMethods, Integration Server refuses the request and returns an HTTP 403 status code with the following message:
Method not supported
If the header matches a value specified by this parameter, Integration Server responds with the CORS header Access-Control-Allow-Headers populated with the value of this parameter.
Use a space or comma to separate multiple HTTP methods. Possible values are OPTIONS, HEAD, GET, POST, PUT, PATCH, and DELETE. Integration Server accepts any of these values by default.
watt.server.createPackage.ignorePattern
Specifies the file types you do not want Integration Server to include when publishing packages. You can use this parameter to specify the file types to exclude when publishing packages through replication, publishing packages to VCS using the Version Control System Integration feature in Integration Server, and deploying packages. For example, to prevent Integration Server from publishing .svn files, you would specify the parameter as watt.server.createPackage.ignorePattern=.svn.
You can specify several file types using a semi-colon (;) as a delimiter, as follows:
watt.server.createPackage.ignorePattern=.svn;.java;.xml
Important: The WmVCS package, which provides the functionality for using the VCS Integration Feature, is deprecated as of Integration Server version 9.9. Software AG recommends that you use the local service development feature (Local Version Control Integration) to check package elements and their supporting files into and out of a version control system (VCS) directly from Designer.
watt.server.cronMaxThreads
The maximum number of threads maintained for the cronjob-based threadpool, which Integration Server uses for scheduled system tasks. If this maximum number is reached, Integration Server waits until processes complete and return threads to the pool before running more processes. The default is 5.
watt.server.cronMinThreads
The minimum number of threads maintained for the cronjob-based threadpool, which Integration Server uses for scheduled system tasks. When Integration Server starts, the thread pool initially contains this minimum number of threads. The default is 2.
watt.server.dateStampFmt
Specifies the date format to use in the log files. For the server log, this parameter specifies how the date format is displayed in the server log file as well as in Integration Server Administrator. For all other logs, such as the service, error, session, guaranteed delivery, and security logs, this parameter specifies how the date format is displayed only in Integration Server Administrator.
Note: In order to use this parameter to specify the date format for the service, error, session, guaranteed delivery, and security log files, the watt.server.audit.displayLogs.convertTime must be set to true. For usage information, see watt.server.audit.displayLogs.convertTime.
To specify the date format to use, you can use any format that is supported by the Java class java.text.SimpleDateFormat. For example, to display the date with the format 08-12-02 14:44:33:1235, specify dd-MM-yy HH:mm:ss:SSSS.
watt.server.date.SuppressPatternError
Specifies how the server should respond if no input is passed to the pub.date:dateTimeFormat service. When set to true, the server simply returns a null value for the value parameter. The default is for the server to throw an exception.
watt.server.db.blocktimeout
Specifies the maximum time in milliseconds the server is to block a request when waiting for a connection to a database. (The database must be defined by an alias in the WmDB package.) The default is to wait indefinitely. Specifying -1 also means to wait indefinitely. This property is global to all pools.
watt.server.db.connectionCache
Specifies how the server manages connections to a database.
Specifying server tells the server to maintain a pool of connections for each database that is defined to the server through an alias. If a request cannot be satisfied because the pool has reached its maximum number of connections, the server blocks the request and tries again later.
Specifying session tells the server to create a database connection per session. That is, when the server receives a service request that requires a database connection, it will create a new connection if one doesn't already exist for that session; otherwise the server will use the connection that was previously created for that session. If the attempt to create a connection for the session fails, for example because the database has no available slots for connections, the request fails. The default is session.
Although enabling database connection pooling creates a pool for each database defined to your server, you can control the characteristics of each pool individually by using the Edit Alias Information screen of the Integration Server Administrator. See the WmDB User’s Guide for more information about configuring the server to connect to a database.
watt.server.db.maintainminimum
Specifies how the server handles purging inactive connections that have timed out. With the parameter set to false, the server purges all of these connections. With the parameter set to true, the server purges these connections, but stops when a minimum number of connections in the pool has been reached. You specify the minimum when you define the alias. This property is global to all pools.
watt.server.db.share.ISInternal
Indicates whether the Integration Server ISInternal Functional Alias on the Integration Server Administrator JDBC Pools page refers to the same database that other Integration Servers use, even though the Integration Servers are not clustered. Set this property to true to indicate that the Integration Server shares the same ISInternal database. Setting the property to true is necessary if you want to use guaranteed delivery on multiple Integration Servers that are not clustered but share the ISInternal database. You must set this property to true for all Integration Servers that share the ISInternal database. Set this property to false if the Integration Server does not share the ISInternal database with other Integration Servers. The default is false.
Important: You must restart Integration Server for changes to take effect.
watt.server.db.testSQL
Specifies a SQL statement that can be used to test a database connection in a JDBC connection pool. If the watt.server.db.testSQL parameter specifies a SQL statement, when a caller requests a JDBC connection from a JDBC connection pool, Integration Server executes the specified SQL statement against the database used with the JDBC connection pool. If the SQL statement executes successfully, Integration Server considers the database connection to be valid and returns the connection to the caller. If the SQL statement does not execute successfully, Integration Server considers the database connection to be invalid and removes it from the JDBC connection pool. Integration Server than creates a new JDBC connection, places it in the JDBC connection pool, and returns the new connection to the caller. If no value is specified for watt.server.db.testSQL, Integration Server does not test database connections in the connection pool when a caller requests a JDBC connection. There is no default value for the parameter.
Note: Testing a database connection each time a JDBC connection is requested may impact performance as each test executes a SQL statement against the database.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.debugFIPS
Specifies whether Integration Server checks the FIPS encryption provider every time a user is authenticated. When this parameter is set to true, every time a user is authenticated, Integration Server checks the FIPS encryption provider by using the provider to create a java.security.MessageDigest instance. The provider check writes the name of the provider and the generated MessageDigest to standard error. When set to false, Integration Server does not check the encryption provider every time a user is authenticated. The default is false.
Important: You must restart Integration Server for changes to take effect.
watt.server.defaultContentHandler
Specifies to which content handlers Integration Server should register the text/html content type. If set to true (the default), then Integration Server registers the text/html content type with the ContentHandler_Default content handler. If set to false, then Integration Server registers the text/html content type with the ContentHandler_CGI content handler.
Important: You must restart Integration Server for changes to take effect.
watt.server.defaultCountry
Specifies the default country, a component of a Java Locale, that Integration Server uses when selecting strings from ResourceBundles to return to a client. Any ISO country code is a valid value. The default value for this property is US. The default locale is en-US.
Important: You must restart Integration Server for changes to take effect.
watt.server.defaultLanguage
The default language, a component of a Java Locale, that Integration Server uses when selecting strings from ResourceBundles to return to a client. Any ISO language code is a valid value. The default value for this property is en. The default locale is en-US.
Important: You must restart Integration Server for changes to take effect.
watt.server.defaultPackage
Specifies the name of the default package. If this value is not set, Integration Server uses WmRoot as the default package.
Note: If you start Integration Server in safe mode, WmRoot becomes the default value regardless of the value of watt.server.defaultPackage.
watt.server.deprecatedExceptionLogging
Specifies how the Integration Server logs service exceptions to the Integration Server error log. Set this parameter to true for basic exception logging or false (the default setting) for more detailed exception logging to help pinpoint the source of the exception.
When set to...
Integration Server...
true
*Logs the exception for each service in a nested stack as the exception moves up the stack. If a parent service catches the exception and does not rethrow it, the Integration Server still logs the exception for each child service it passed on its way up the stack.
*Displays the stack trace for each service.
false
*Logs the exception only once, at the top-level service, even if the exception occurred at a nested service. If any service in the stack catches the exception and does not rethrow it, the Integration Server does not log the exception.
Note: The exception may be logged more than once if a service in the call stack, or one of the core classes that the service uses, explicitly logs the exception.
*Displays, for logged exceptions, the stack trace of the innermost service where the exception first occurred. This stack trace often gets truncated from the log when watt.server.deprecatedExceptionLogging is set to true.
*Concatenates the error messages from each of the nested exceptions.
If this parameter is set to true, the cause of the exception becomes more difficult to trace. For this reason, Software AG recommends that you do not set this parameter to true unless you are executing services that catch exceptions and do not rethrow them.
For more information about interpreting the error log and using the log to help debug services, see Debugging Service Exceptions Using the Error Log.
watt.server.diagnostic.logFiles.maxMB
Specifies the maximum number of megabytes of data that Integration Server reads from the file system for an audit log while collecting diagnostic data. This parameter affects the collection of audit log files only. It does not affect audit log data read from the database, nor does it affect other log files such as the server log, stats log or terracotta-client logs. The default is 250 megabytes. You do not need to restart Integration Server for changes to this parameter to take effect.
watt.server.diagnostic.logperiod
Specifies how many hours of logs are returned when you run the diagnostic tool. The default is 6. When this property is set to 0, the diagnostic utility does not return any log files. It returns only the configurational and run-time data files.
watt.server.diagnostic.port
Specifies the diagnostic port through which you can access Integration Server when it is unresponsive. During installation, Integration Server automatically creates the diagnostic port at 9999. The default is 9999.
Note: This setting overrides the Port setting on the on the Edit Diagnostic Port Configuration screen.
If you are running multiple Integration Servers on the same host machine, the diagnostic port on each server must have a unique port number. Set this parameter for each Integration Server instance to use a unique port number. For more information about the diagnostic port and running multiple Integration Server instances, see Adding an HTTP Diagnostic Port.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect. To change the diagnostic port without restarting Integration Server, edit the default diagnostic port on the Security > Ports page of Integration Server Administrator. For more information, see Editing a Port.
watt.server.diagnostic.tabular
Specifies whether Integration Server should generate diagnostic files in tabular format. If set to false, Integration Server generates the files in non-tabular format. The default is true.
watt.server.dispatcher.comms.brokerPing
Specifies how often (in milliseconds) triggers (which are Broker clients) should ping the Broker. When there is a firewall between the Integration Server and the Broker, the firewall closes the connection between a trigger and the Broker when the connection becomes idle. To prevent connections from becoming idle, trigger Broker clients periodically ping the webMethods Broker. The default is 1800000 milliseconds (30 minutes).
watt.server.dispatcher.comms.connectionShareLimit
Specifies the number of BrokerClient objects that Integration Server can use to communicate with Broker. Integration Server passes this value to set the following Broker API: COM.activesw.api.client.BrokerConnectionDescriptor.setConnectionShareLimit (int value).
For more information, see webMethods Broker Java Client API Reference.
Each Broker connection represents a socket open to the Broker. While decreasing the value of the property can increase throughput, it also increases the number of resources and file descriptors Integration Server uses. Set this parameter to either 0 or a value greater than 1. When set to 0, connection sharing is turned off and each Broker client uses its own Broker connection. The default is 5.
Note: Broker does not support a value of 1. If the value is set to 1, Broker issues an exception.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.dispatcher.join.reaperDelay
Specifies how often (in milliseconds) that the Integration Server removes state information for completed and expired joins. The default is 1800000 milliseconds (30 minutes).
watt.server.dispatcher.messageStore.redeliverOriginalMessage
Specifies whether Integration Server stores and redelivers the original message or a modified message for subsequent trigger service execution when retry failure occurs for a trigger service invoked by webMethods messaging trigger. When set to true, Integration Server stores and redelivers the message originally sent to the webMethods messaging trigger. When set to false, Integration Server stores the message as it is at the point at which retry failure occurs. Integration Server delivers a modified message to the webMethods messaging trigger for subsequent processing. The default is false.
watt.server.displayDirectories
Specifies whether a browser user can view directories that reside on Integration Server without using Integration Server Administrator. When this parameter is set to true (the default), users can view Integration Server directories. When this parameter is set to false, no directories are displayed.
watt.server.email.charset
Specifies the default character set used for encoding portions that contain non-ASCII characters in email messages. Email fields that contain non-ASCII characters are subject, MIME headers, body text, and attachments. The pub.client:smtp service uses this property. The default is utf-8. For more information about the pub.client:smtp service, see webMethods Integration Server Built-In Services Reference.
watt.server.email.from
Specifies the email address the server presents as its From address when sending emails about errors. By default, the server uses Integration-Server@localhost for the From Address, where localhost is the name of the host on which the Integration Server is running.
watt.server.email.processReplyEmails
Specifies whether Integration Server should process the reply emails that it receives in its email port if the Subject line of the email contains the prefix "Re:". Set the watt.server.email.processReplyEmails property to true if you want Integration Server to process reply emails that contain the prefix "Re:" along with a valid service name in the Subject line. If the property is set to false, Integration Server does not process the email if the Subject line contains the prefix "Re:". Instead, Integration Server generates a server log message. The default is false.
watt.server.email.waitForServiceCompletion
Specifies whether Integration Server should wait for the email port to complete the processing of a message before returning the thread used to retrieve the message to the thread pool.
When retrieving and processing messages received by an email port, Integration Server uses one thread to retrieve a message and a second thread to execute the service that processes the message. By default, after using a thread to retrieve a message, Integration Server returns it to the server thread pool, making it available to perform other processing.
If the email port receives a large number of messages in a short period of time, the email port might monopolize the server thread pool for retrieving and processing messages. In addition, if the service that processes the messages executes slowly, it is possible that the email port message processing will negatively affect the performance of Integration Server.
To avoid this issue, you can limit the number of threads used to process messages received by an email port by setting the watt.server.email.waitForServiceCompletion property.
When the property is set to true, Integration Server does not return the thread used to retrieve the message to the thread pool until after the service that processes the message executes to completion. As a result, the maximum number of threads used to retrieve and process messages for an email port is equal to 2 or twice the value of the Number of threads if multithreading is turned on field.
*If the email port is for a POP3 email server, Integration Server can use up to 2 threads for retrieving and processing messages for the port (one thread to retrieve a message received by the email port and one thread to execute the service that processes the message).
*If the email port is for an IMAP email server and multithreading is disabled, Integration Server can use up to 2 threads for retrieving and processing messages for the port (one thread to retrieve a message received by the email port and one thread to execute the service that processes the message).
*If the email port is for an IMAP email server and multithreading is enabled, Integration Server can use a number of threads equal to twice the value of the Number of threads if multithreading is turned on field for retrieving and processing messages for the port. For example, if the value of the Number of threads if multithreading is turned on field is 5, Integration Server can use a maximum of 10 threads to retrieve and process messages for the email port (5 threads to concurrently retrieve messages for the email port and another 5 threads to process those messages).
When watt.server.email.waitForServiceCompletion is set to false, Integration Server does not wait for the service that processes the message to execute to completion before returning the thread used to retrieve the message to the thread pool.
The default is false.
Note: The watt.server.email.waitForServiceCompletion parameter applies to all email ports on an Integration Server.
watt.server.enableHotDeployment
This is an internal property. Do not modify.
watt.server.service.list.treatEmptyAsNull
Specifies whether Integration Server assigns a null value to all list data types like Document List, String List, Document Reference List, and Object list during the execution of a flow service without an input value. True indicates that the output of the service assigns a null value for the list data type. False indicates the output of the service would not assign a null value. The default is true.
watt.server.errorMail
Specifies the email address to which Integration Server sends messages about critical server log entries. There is no default.
watt.server.event.audit.async
Specifies whether the event handlers for the audit event are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to audit events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to audit events synchronously. The default is true.
watt.server.event.exception.async
Specifies whether the event handlers for the exception event, error event, or journal event are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to exception events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to exception events synchronously. The default is true.
watt.server.event.gd.async
Specifies whether the event handlers for guaranteed delivery events (gdStart and gdEnd) are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to guaranteed delivery events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to guaranteed delivery events synchronously. The default is true.
watt.server.event.jmsDeliveryError.async
Specifies whether the event handlers for JMS delivery failure events are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to JMS delivery failure events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to JMS delivery failure events synchronously. The default is true.
watt.server.event.jmsRetrievalError.async
Specifies whether the event handlers for JMS retrieval failure events are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to JMS retrieval failure events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to JMS retrieval failure events synchronously. The default is true.
watt.server.event.replication.async
Specifies whether the event handlers for replication events are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to replication events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to the replication events synchronously. The default is true.
watt.server.event.routing.runAsUser
Specifies the user who will invoke the service specified in the pub.event.routing:send and pub.event.routing:subscribe built-in services. Integration Server uses the user specified in this parameter only if no user is specified in the runAsUser input parameter of the pub.event.routing:send and pub.event.routing:subscribe services. The default is Administrator.
This user can be defined either internally or in an external directory but must belong to an existing group that has appropriate ACL permissions to invoke the specified service. Integration Server does not validate this user until the service is executed.
The new value of the parameter applies to existing subscriptions as well as new subscriptions created using pub.event.routing:subscribe.
watt.server.event.security.async
Specifies whether the event handler for security events is invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to security events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to security events synchronously. The default is true.
watt.server.event.session.async
Specifies whether the event handlers for session events (sessionStart, sessionEnd, and sessionExpire) are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to session events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to session events synchronously. The default is true.
watt.server.event.stat.async
Specifies whether the event handlers for stat (statistics) events are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to the statistics events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to the statistics events synchronously. The default is true.
watt.server.event.tx.async
Specifies whether the event handlers for the transaction events (txStart and txEnd) are invoked asynchronously or synchronously. When this parameter is set to true, Integration Server invokes the event handlers (services) that subscribe to transaction events asynchronously. When this parameter is set to false, Integration Server invokes the event handlers that subscribe to transaction events synchronously. The default is true.
watt.server.eventHandlerCreateSession
Controls whether Integration Server should create a session for the service that is invoked by the Event Manager. When set to true, Integration Server creates a session and associates it with the invoked service. When set to false, Integration Server does not create a session for the service that is invoked by the Event Manager. The default is false.
Note: When set to true, specify a timeout value for the session using the watt.server.eventHandlerSessionTimeout parameter.
watt.server.eventHandlerSessionTimeout
When watt.server.eventHandlerCreateSession is set to true, watt.server.eventHandlerSessionTimeout specifies the timeout value for sessions created by Integration Server for services that are invoked by the Event Manager. The default value is 60000 milliseconds.
watt.server.eventMgr.maxThreads
Specifies the maximum number of threads that you want Integration Server to use for the Event Manager thread pool. The default is 5.
Integration Server verifies that this value is greater than watt.server.eventMgr.minThreads. If the value of watt.server.eventMgr.maxThreads is less than the value of watt.server.eventMgr.minThreads, Integration Server sets the value of watt.server.eventMgr.maxThreads to one more than watt.server.eventMgr.minThreads. For example, if watt.server.eventMgr.minThreads is set to 6 and watt.server.eventMgr.maxThreads is set to 5, Integration Server sets the value of watt.server.eventMgr.maxThreads to 7.
watt.server.eventMgr.minThreads
Specifies the minimum number of threads that you want Integration Server to use for the Event Manager thread pool. The default is 2.
Integration Server verifies that this value is 1 or greater. If set to a value less than 1, Integration Server resets it to 1.
watt.server.fileEncoding
Specifies the encoding the server is to use when reading and writing text files. This setting has no effect on files stored as Unicode. The default is your JVM's file.encoding property.
Note: To process incoming XML files, use the watt.server.xml.encoding parameter. If you have configured Integration Server to use the character encoding specified in the watt.server.fileEncoding parameter to process incoming XML files, you must ensure that the value of watt.server.fileEncoding parameter is set to the same value specified for watt.server.xml.encoding.
watt.server.ftpConnect.message
Specifies the content of the 220 message that Integration Server returns to an FTP client when the client issues a connect request.
When this parameter is set to true (the default), Integration Server returns the following messages to the FTP client:
Connected to IS_hostname.
220 IS_hostname FTP server (webMethods Integration Server version n.n.n.n) ready.
When this parameter is set to false, Integration Server returns the following messages to the FTP client:
Connected to IS_hostname. 220
When this parameter is set to any other value, that value is returned in the 220 message. For example, if you specify Custom FTP connect message, Integration Server will return the following to the FTP client:
Connected to IS_hostname. 220 Custom FTP connect message.
watt.server.ftp.listingFileAge
Specifies the number of seconds that must elapse before a file that has been updated or created on an Integration Server functioning as an FTP server can be accessed. Files created or updated within the time specified by this parameter will not be part of the results of the FTP LIST command. The default value is 60 seconds.
watt.server.ftpLogin.message
Specifies the content of the 230 message that Integration Server returns to an FTP client when the client issues a login request.
When this parameter is set to true (the default), Integration Server returns the following message to the FTP client: 230 User userid logged in.
When this parameter is set to false, Integration Server returns the following message to the FTP client: 230
When this parameter is set to any other value, that value is returned in the 230 message. For example, if you specify Custom FTP login message, Integration Server will return the following to the FTP client:
230 Custom FTP login message.
watt.server.ftpSystem.message
Specifies the content of message 215 that Integration Server returns to an FTP client when the client issues a system request. When this parameter is set to true (the default), Integration Server returns the following message to the FTP client:
215 UNIX Type: L8 Version: webMethods IS FTP <Integration Server n.n.n.n>
When this parameter is set to false, Integration Server returns the following message to the FTP client:
215
When this parameter is set to any other value, that value is returned in the 215 message. For example, if you specify Custom FTP system message, Integration Server returns the following to the FTP client:
215 Custom FTP system message.
watt.server.ftp.usecommandip
Controls whether the pub.client:ftp service uses connection information from a NAT server when connecting to an FTP server.
When the pub.client:ftp service tries to transfer data to or from an FTP server, Integration Server first connects to the FTP server at the IP address specified by the pub.client:ftp service. In response, the FTP server sends back the IP address on the FTP server to which Integration Server should connect to perform the transfer. If the FTP server sits behind a NAT server, the NAT server intercepts this address, translates it, then sends it on to Integration Server.
This property controls whether Integration Server uses the address provided by the NAT server or the address already specified by the pub.client:ftp service.
When this parameter is set to true, Integration Server bypasses the translated address and tries the address specified by the service. If this attempt fails, Integration Server throws an exception.
When this parameter is set to false, the default, Integration Server tries the address provided by the NAT server. If that attempt fails, Integration Server tries the IP address specified on the pub.client:ftp service. If both attempts fail, Integration Server throws an exception.
watt.server.hostAccessMode
Specifies IP access for ports that do not have a custom IP access setting. When this parameter is set to include, the server accepts requests from all IP addresses, except those specifically denied on the Integration Server Administrator interface. When this parameter is set to exclude, the server denies requests from all IP addresses except those specifically allowed on the Integration Server Administrator interface. The default is include.
watt.server.hostAllow
Specifies the name of the host that is allowed service. There is no default.
watt.server.hotDeploymentAutoRecover
This is an internal property. Do not modify.
watt.server.hotDeploymentTimeout
This is an internal property. Do not modify.
watt.server.http.allowOptions
Indicates whether Integration Server allows a client to use the HTTP OPTIONS method to determine the HTTP methods supported by Integration Server. When this parameter is set to true, Integration Server allows the OPTIONS method. When this parameter is set to false (or any other value), OPTIONS requests from clients receive a ”405 Method Not Allowed” response.
The default is true.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.http.authorizationEncoding
Specifies the encoding that the HTTP client (such as a browser) uses when encoding the user name and password for Integration Server. The HTTP client sends the user name and password to Integration Server in the Authorization attribute in the header of the HTTP request. Set the watt.server.http.authorizationEncoding property to the encoding that your browser uses for the Authorization attribute. Consult the browser documentation, or contact the browser manufacturer, to find what encoding is used in your environment. The default is UTF-8.
Note: If two browsers use different encodings for the Authorization attribute, and both send non-ASCII passwords to Integration Server, only the browser whose Authorization encoding matches the value of the watt.server.http.authorizationEncoding property will work.
watt.server.http.header.useHttpOnly
Specifies whether Integration Server includes the HttpOnly attribute in the Set-Cookie header in the response to an HTTP client. When this property is set to true (the default), Integration Server includes the HttpOnly attribute in the Set-Cookie header of the HTTP response to an HTTP client. Software AG recommends setting this property to true because it prevents a client side script from accessing a protected cookie. If you are working with an HTTP client that does not support the HttpOnly attribute, set this property to false.
watt.server.http.header.useSecure
Specifies whether Integration Server includes the secure attribute in the Set-Cookie header in the response to an HTTP/S client. When the watt.server.http.header.useSecure property is set to true (the default), Integration Server includes the secure attribute in the Set-Cookie header of the HTTPS response to an HTTP/S client. Software AG recommends setting this property to true because it ensures that the cookie is always encrypted while being transmitted from client to server.
watt.server.http.interceptor.enabled
Specifies whether an HTTP interceptor is enabled for Integration Server When set to true, Integration Server uses the HTTP interceptor implementation identified in watt.server.http.interceptor.impl to intercept all HTTP requests and HTTP responses. When set to false, Integration Serverdoes not use an HTTP interceptor. The default is false.
Note: The first time you set this property to true for an HTTP interceptor implementation, you must restart Integration Server for changes to the property to take effect.
watt.server.http.interceptor.impl
Specifies the fully qualified name of the java class for the HTTP interceptor implementation. The provided class must implement the com.softwareag.is.interceptor.HttpInterceptorIFC interface and provide implementations of both methods in the class (preprocess and postProcess). The file for the HTTP interceptor implementation must be available on the server classpath.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.http.interceptor.preprocess.sizeLimit
Specifies the maximum number of bytes that an HTTP interceptor reads during preprocessing. If the HTTPRequest's input exceeds this value, the HTTP interceptor reads up to this limit and then ignores the rest of the input stream. The default is -1, which indicates that there is no limit to the number of bytes that the HTTP interceptor reads during preprocessing. The HTTP interceptor will read the entire input stream.
watt.server.http.jsonFormat
Specifies how Integration Server handles JSON content in HTTP client requests. When this property is set to parsed (the default), Integration Server parses JSON content into pipeline variables automatically. Clients can then use JSON to compose pipelines and execute existing services without having to call pub.json:jsonStreamToDocument.
If watt.server.http.jsonFormat is set to stream, Integration Server places a jsonStream variable containing the JSON content in the pipeline as an InputStream. You can then use pub.json:jsonStreamToDocument to parse jsonStream into pipeline variables.
If watt.server.http.jsonFormat is set to bytes, Integration Server places the incoming stream of JSON into a byte array.
You can override the behavior specified by watt.server.http.jsonFormat in individual requests by adding the jsonFormat query parameter to the request URI. For example, if watt.server.http.jsonFormat is set to parsed, a client can override this setting and instead specify a value of stream for the request by entering a URI as follows:
/invoke/myfolder/myservice?jsonFormat=stream
This will result in the request being placed in a jsonStream variable in the pipeline as an InputStream containing the JSON content.
watt.server.http.listRequestVars
Specifies how Integration Server handles duplicate query tokens in an HTTP request.
When set to...
Integration Server...
always
Converts duplicate and non-duplicate tokens into lists. For example:
http://host:5555/folder/service?arg1=X&arg1=Y&arg2=Z
becomes
INVOKE folder:service {arg1=X, arg1List=[X,Y], arg2=Z,
arg2List=[Z]}
asNeeded
Converts duplicate tokens into Lists. Non-duplicate tokens are not converted. For example:
http://host:5555/folder/service?arg1=X&arg1=Y&arg2=Z
becomes
INVOKE folder:service {arg1=X, arg1List=[X,Y], arg2=Z}
This is the default setting.
error
Throws a ServiceException if duplicate tokens are found in the URL query. Non-duplicate tokens are not converted. For example:
http://host:5555/folder/service?arg1=X&arg1=Y&arg2=Z
never
Ignores duplicate tokens found in the URL query. For example:
http://host:5555/folder/service?arg1=X&arg1=Y&arg2=Z
becomes
INVOKE folder:service {arg1=X, arg2=Z}
watt.server.http.preserveUriReservedChars
Specifies whether Integration Server should decode percent-encoded URI paths in requests before evaluating URI paths. When this property is set to true (the default), Integration Server defers decoding percent-encoded reserved characters until after evaluating URI paths. When set to false, Integration Server decodes percent-encoded reserved characters prior to evaluating the URI paths.
Note: The value of watt.server.http.preserveUriReservedChars is significant only for the REST requests that use the rest directive. For requests using the rest directive, the last tokens in the path identify the instance of a resource or provide application-specific information. These tokens become the $resourceID and $path variables in the pipeline. This portion of the URI path can contain percent-encoded reserved characters. When watt.server.http.preserveUriReservedChars is set to true, Integration Server decodes the percent-encoded characters after evaluating the URI path, but before invoking the service.
For requests that use the invoke directive, the entire path of the URI after "/invoke" refers to folders and services in the Integration Server namespace. Folders and services cannot contain any URI-reserved characters, therefore any request that uses the invoke directive and contains a percent-encoded reserved character in its path will never identify an actual Integration Server service and will always result in an HTTP 404 response.
watt.server.http.reauth.user-agent.list
Specifies a semicolon-delimited list of HTTP clients from which you want Integration Server to request re-authentication after an HTTP session expires. By default, this parameter is set to Firefox;MSIE so that requests from the Mozilla Firefox and Microsoft Internet Explorer browsers will be asked to re-authenticate if the associated HTTP session has expired. For user agents not specified on this list, Integration Server sends a new session cookie when the session expires.
If you remove this property and restart Integration Server, the value of this property resets to Firefox;MSIE.
watt.server.http.returnException
Specifies whether Integration Server should return a stack trace in the HTTP/SOAP response it sends to the invoking client when an invoked service ends in error. You can specify one of the following:
Value
Tells Integration Server...
true
To return a stack trace in the HTTP/SOAP response. This is the default.
false
Not to return a stack trace.
webMethods
Return a stack trace only if the client's HTTP user agent is set to webMethods or has the same value as the user agent specified on the watt.net.userAgent parameter.
watt.server.http.securityRealm
Specifies the name of the Integration Server security realm. This value is included in the headers of HTTP responses that Integration Server sends to clients that request authentication. The default value is Integration Server.
watt.server.http.uriPath.decodePlus
Specifies whether or not the '+' character is interpreted as a ' ' when it appears in the path component of the request URI using the new configuration property. When set to true, the default, Integration Server converts '+' to ' ' when processing the request URI. When set to false,Integration Server does not convert '+' to ' ' when processing the request URI. This setting affects only the handling of '+' characters in the request URI's path component. Any '+' characters that appear in the request URI's query will be converted to ' ' characters regardless of the value of watt.server.http.uriPath.decodePlus.
watt.server.http.useAcceptHeader
Specifies whether Integration Server supports the Accept header field in an HTTP request. The Accept header field specifies a content type or types the HTTP client will accept in the HTTP response. The default setting is true. This parameter must be set to true if you want to use the watt.server.content.type.mappings parameter to map wildcard content types in the Accept header field to specific content types.
watt.server.http.x-frame-options
Controls how Integration Server is to handle the X-Frame-Options attribute in response headers.
Note: Integration Server includes the X-Frame-Options attribute in the response header to requests for webpages, as defined in the HTTP Header Field X-Frame-Options specifications. X-Frame-Options is not included in responses to requests for service invocation, such as those including the invoke, rest, restv2, or soap directives. It is only included in responses to requests for webpages, such as https://my-server/MyPackage/my-page.html.
Set this parameter to one of the following values:
Specify...
To indicate that...
SAMEORIGIN
The client's browser is to allow Integration Server pages to be displayed in an HTML frame only if the frame is on a page from the same server. This is the default value.
ALLOW-FROM other_origin
The client's browser is to allow Integration Server pages to be displayed in an HTML frame only if the frame is on a page from the same server specified by other_origin.
Note: The value DENY is defined for the X-Frame-Options attribute but is not allowed for Integration Server. DENY means that the page can never appear in a frame, regardless of the frame's origin. This would cause Integration Server Administrator to be unusable. If watt.server.http.x-frame-options is set to DENY, that value is ignored and SAMEORIGIN is used instead.
If you do not want Integration Server to include the X-Frame-Options attribute in response headers, remove the value from the watt.server.http.x-frame-options property. For example: watt.server.http.x-frame-options= The property can be set on the Settings > Extended page of Integration Server Administrator. Changes to this property take effect immediately; the server does not need to be restarted.
watt.server.http.xmlFormat
Specifies whether Integration Server parses incoming XML documents automatically or passes them directly to the service. Use this property to set the default behavior for how Integration Server should pass XML documents via HTTP. Specify one of the following values:
Specify...
To indicate that...
bytes
Integration Server passes XML bytes directly to the requested service without parsing. When this parameter is set to bytes, the XML appears in the input pipeline of the service as byte array, named xmlBytes.
enhanced
Integration Server parses the XML automatically using the enhanced XML parser and passes it to the service as an enhanced node object named node that implements the org.w3c.dom.Node interface.
node
Integration Server parses the XML automatically using the legacy XML parser and passes it to the service in a parameter named node of type com.wm.lang.xml.Node. This is the default behavior.
stream
Integration Server passes XML streams directly to the requested service without parsing. When this parameter is set to stream, the XML appears in the input pipeline of the service as an InputStream, named xmlStream.
If a value for watt.server.http.xmlFormat is not specified or is invalid, the default XML parsing behavior is "node".
This feature can be used when submitting and receiving XML via HTTP of HTTPS only.
Note: The default established by this parameter can be overridden in any individual client request that uses the xmlFormat argument in the URL. For more information about the xmlFormat argument, see webMethods Service Development Help.
Note: Changing the default xmlFormat for all of Integration Server might cause existing services and applications to fail. Consider changing the xmlFormat on a service or application basis instead by using the Default xmlFormat property for a service. For more information about the Default xmlFormat property, see webMethods Service Development Help.
watt.server.httplog
Specifies whether Integration Server should log outbound HTTP/HTTPS requests to a separate log file. If set to true, Integration Server creates the Integration Server_directory \instances\instance_name\logs\http.log file, which logs data for HTTP/HTTPS requests. The http.log file is created separately from the data captured in the server log. The default is false.
Integration Server logs the following in http.log:
Parameter
Description
CURRENT-TIME
Time of the host Integration Server at the time the request is made.
SIZE-OF-RESPONSE
Size of the data (in bytes) in the response. This is either the current size of the in-memory byte buffer or the size of the input stream.
TIME-TAKEN
Time (in milliseconds) it takes the Integration Server to process the request. This parameter does not include transport time.
HOST-ADDRESS
IP address of the host Integration Server.
REQUESTED-URL
The URL requested by the client.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.hostDeny
Specifies the name of the host that is denied service. There is no default.
watt.server.idr.reaperInterval
Specifies the interval, measured in minutes, at which the scheduled system service Message History Sweeper executes and removes expired document history entries. The default is 10 minutes.
watt.server.illegalNSChars
Specifies the characters that you cannot use when naming a package, folder or service. The default is ?`-#&@^!%*:$.\ /';,~+=)(|}{][><.
watt.server.illegalUserChars
Specifies characters that you cannot use in user names and passwords. The default is "\<&.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
Important: Do not remove characters from this property. If you remove characters and create users that contain those characters, Integration Server cannot parse users.cnf and will be unable to start.
watt.server.inetaddress
Specifies the IP address on which the server is to listen for incoming requests. By default, Integration Server listens on all available IP addresses. To limit the server to listening on a single IP address, specify the IP address as the value of this property.
watt.server.invokeDirective
Specifies an alternative word to use for the invoke directive in URLs that invoke services on Integration Server. By default, this parameter is set as watt.server.invokeDirective=invoke, which means users must specify the invoke directive as invoke (http://host:port/invoke/folder/service_name). To allow users to specify the invoke directive as either invoke or an alternative word, set this parameter to the alternative word. For example, to allow users to specify the invoke directive as either invoke or submit, (http://host:port/invoke/folder/service_name or http://host:port/submit/folder/service_name ), set this parameter as watt.server.invokeDirective=submit.
watt.server.invoke.maxRetryPeriod
Specifies the total amount of waiting time (in milliseconds) that can elapse if the Integration Server makes the maximum attempts to retry a service. The default is 15,000 milliseconds (15 seconds). When configuring retries for an individual service, the value calculated by multiplying Max attempts value by the Retry interval cannot exceed the value set by this server parameter. For more information about configuring service retry, see webMethods Service Development Help.
watt.server.java.unicode
Specifies whether the source code for Java services is stored in Unicode encoding. The default is false. Set this value to true if the source code contains characters that cannot be rendered in the server's native encoding.
watt.server.jca.connectionPool.createConnection.interrupt.waitTime
Specifies the wait time, measured in milliseconds, that elapses before Integration Server interrupts a connection creation thread that is in a wait state. There is no default value.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
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.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
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.thresholdWaitingRequest
When enabled, this property represents the percentage value that is used in addition to the configured maximum number of connections (set by the Maximum Pool Size parameter on the Connections page) for the connection pool. For example, setting the property as watt.server.jca.connectionPool.thresholdWaitingRequest=20 sets the threshold to 120% of configured maximum number of connections.
If the property is not defined or if the value is less than or equal to zero, the feature remains disabled.
When this property is enabled, the connection pool ensures that the waiting connection requests plus the busy connections in the connection pool do not exceed the threshold limit.
watt.server.jca.transaction.rollbackOnWriteFailure
If Integration Server cannot store the status of a transaction and its participating resources in the XA recovery store (for example, because the store is corrupted), specifies whether Integration Server should try to continue with the transaction anyway (false) or try to roll it back (true). Setting the parameter to false involves some risk; if Integration Server ends abnormally, no statuses will have been saved to the XA recovery store, and Integration Server will not be able to resolve the uncompleted transaction or give you the chance to resolve it manually.
watt.server.jca.transaction.writeRecoveryRecord
Specifies whether Integration Server maintains XA transaction information for use with XA transaction recovery. If Integration Server does not save XA transaction information, uncompleted XA transactions cannot be recovered using Integration Server. That is, Integration Server does not attempt to recover incomplete XA transactions automatically and you cannot use Integration Server Administrator to manually recover or resolve an incomplete transaction. Specify true to enable XA transaction recovery. Specify false to disable XA transaction recovery. The default is true.
watt.server.jdbc.datadirect.snoop.default
Specifies the default settings for the DataDirect Snoop tool for DataDirect Connect JDBC drivers. The DataDirect Snoop tool logs network packets between Integration Server and an external RDBMS. The resulting log file can be used for tracing and diagnostic purposes.
Note: This option is for use with an external RDBMS only. It is not for use with the embedded IS internal database.
Set this parameter on each DataDirect Connect JDBC driver for which you want to log data.
Important: To enable this feature for use with Integration Server, you must select the Snoop option on either the Edit JDBC Connection Pool Alias screen or the Create JDBC Connection Pool Alias screen of the Integration Server Administrator.
The default value for this parameter is:

ddtdbg.ProtocolTraceEnable=true;ddtdbg.ProtocolTraceMaxline=16; ddtdbg.ProtocolTraceLocation=/logs/snoop/<alias_name>.log; ddtdbg.ProtocolTraceShowTime=true
Where <alias_name> is the name of the JDBC connection pool alias.
Note: For DB2, include the following command at the end of the value:
ddtdbg.ProtocolTraceEBCDIC=true
The default value defines the name and location of the log file and DataDirect Snoop tool attributes. Typically, you do not need to change the default value. However, you can modify the value if the attributes do not meet the needs of your system. If you change the log file location, be aware that the diagnostic tool collects data from the Integration Server_directory /instances/instance_name/logs/snoop directory. If you change the log file location, the diagnostic utility might not import the data logged by the DataDirect Snoop tool. For more information about using the diagnostic utility, see Using the Diagnostic Utility. For more information about setting the DataDirect Snoop tool attributes, consult the documentation on the DataDirect website.
Important: If you change the value of this parameter, you must restart the connection pool for the changes to take effect.
watt.server.jdbc.datadirect.spy.default
Specifies the default settings for the DataDirect Spy diagnostic feature for DataDirect Connect JDBC drivers. DataDirect Spy logs JDBC calls and SQL statement interactions between Integration Server and an external RDBMS. The resulting log file can be used for tracing and diagnostic purposes.
Note: This option is for use with an external RDBMS only. It is not for use with the embedded IS internal database.
Set this parameter for each DataDirect Connect JDBC driver for which you want to log data.
Important: To enable this feature for use with Integration Server, you must select the Spy option on either the Edit JDBC Connection Pool Alias screen or the Create JDBC Connection Pool Alias screen of the Integration Server Administrator.
The default value for this parameter is:
SpyAttributes=(log=(file)/logs/spy/<alias_name>.log;logTName=yes;timestamp=yes)
Where <alias_name> is the name of the JDBC connection pool alias.
The default value defines the name and location of the log file and DataDirect Spy attributes. Typically, you do not need to change the default value. However, you can modify the value if the attributes do not meet the needs of your system. If you change the log file location, be aware that the diagnostic tool collects data from the Integration Server_directory /instances/instance_name/logs/spy directory. If you change the log file location, the diagnostic utility might not import the data logged by DataDirect Spy. For more information about the diagnostic utility, see Using the Diagnostic Utility. For more information about setting DataDirect Spy attributes, consult the documentation on the DataDirect website.
Important: If you change the setting of this parameter, you must restart the connection pool for the changes to take effect.
watt.server.jdbc.defaultDriver
For use with WmDB. Specifies the name of the Java class for the driver you want to use to connect to databases when no driver name is supplied for a database alias.
watt.server.jdbc.derby.commitTolerance
Specifies the length of time, in milliseconds, that Integration Server waits for a commit to the embedded database to complete before removing the associated connection from the connection pool. Integration Server uses this property when it is configured to use the embedded database for any of the ISInternal, DocumentHistory, and Xref functions. If the commit process takes longer than the value defined by this property, Integration Server removes the associated connection from the connection pool so that a new connection can be initiated for future requests. The default value for this property is 150 milliseconds.
watt.server.jdbc.driverList
Specifies a comma-delimited list of JDBC drivers you want the server to load when it initializes. There is no default.
Note: This parameter is for use with the WmDB package only.
watt.server.jdbcLogFile
Specifies the name of the log file that contains JDBC log activity. When the watt.server.jdbcLogging property is enabled (set to on), the server logs activity to this file. The default value is jdbc.log. It is located in the Integration Server_directory \instances\instance_name\logs folder. Note that the log file is generated after WmDB makes a connection to the database.
Note: This parameter is for use with the WmDB package only.
watt.server.jdbc.loginTimeout
Sets the maximum time, in seconds, that the JDBC driver on Integration Server is to wait for a response while attempting to connect to a database. If Integration Server does not receive a response in the allotted time, it terminates the request, logs the error and moves on. The default value is 60 seconds.
If Integration Server is unable to connect to the audit logging database within the number of seconds specified by watt.server.jdbc.loginTimeout, Integration Server removes all connections from the ISCoreAudit JDBC connection pool and recreates them. If the connection problem is resolved quickly (such as a momentary network interruption), Integration Server reconnects to the audit logging database. If Integration Server is unable to connect to the audit logging database, such as when the database is offline, Integration Server writes an exception to the server log.
Important: If you change the setting of this parameter, you must restart the ISCoreAudit JDBC connection pool for the changes to take effect. To restart the pool, in Integration Server Administrator, go to the Settings > JDBC Pools page and click Restart for the ISCoreAudit functional alias.
watt.server.jdbcLogging
Specifies whether Integration Server is to enable logging on java.sql.DriverManager in order to log JDBC activity. When set to on, the server writes the log file data to the file specified by watt.server.jdbcLogFile. The default is off.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
Note: This parameter is for use with the WmDB package only.
watt.server.jdbc.moreResults
Specifies if the Integration Server is to process the stored procedure results from a single result set or multiple result sets. When set to true, Integration Server processes and returns information produced by multiple result sets. When set to false, Integration Server processes information produced from a single result set. The default is false.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
Note: This parameter is for use with the WmDB package only.
watt.server.jdbc.sp.mandateParams
Specifies whether the $data input parameter of the pub.db:call service expects values to invoke a stored procedure through the pub.db:call service. Set this property to false if you do not want to specify values for the $data input parameter. Set this property to true if you want the pub.db:call service to expect values for the $data input parameter. The default is true.
watt.server.jdbc.statementCache
Specifies whether Integration Server is to cache prepared statements for later use. When set to true, the server saves prepared statements in a local cache. When the server receives subsequent requests to a database, it can reuse the prepared statements in the cache instead of recreating them each time a request is made. To use Java heap space efficiently, the server removes cached statements automatically if it is not reused within 30 seconds. The default is false.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
Note: This parameter is for use with the WmDB package only.
watt.server.jms.csq.maxRedeliveryCount
Specifies the number of attempts to redeliver a document from the client side queue. Specify a positive integer value. The default is 5. If Integration Server is unable to deliver the document in the configured number of attempts, the document is dropped from the client side queue and not delivered. In this situation, Integration Server raises a JMSDeliveryFailureEvent.
Note: Specifying a large value for this property can impact Integration Server performance if the failure to deliver the document is not a transient error, such as the Broker being unavailable. If the reason a document cannot be delivered is because there is problem with the document itself, Integration Server performance is impacted because it will continue to attempt to redeliver the document for the number of times you configure.
watt.server.jms.connection.monitorPeriod
Specifies the frequency (measured in seconds) with which Integration Server checks the state of a connection to the JMS provider. The minimum is 1 second. If this parameter is set to less than 1, Integration Server uses the default value instead. The default is 45 seconds.
watt.server.jms.connection.pingDestination
Configures Integration Server to send a keep-alive message to a destination on the JMS provider, thereby preventing the firewall from terminating the connection between Integration Server and a third-party JMS provider. A keep-alive message is a blank, non-persistent JMS message with an immediate time out.
Set this parameter to one of the following values:
Specify...
To...
blank
Attempt to create a JMS session using the connection between Integration Server and the JMS provider. This is the default.
temp
Create a temporary queue on the JMS provider and send a keep-alive message to the temporary queue. Temp is not case-sensitive.
<destinationName>
Send a keep-alive message to the specified destination on the JMS provider. If the specified destination does not exist on the JMS provider, Integration Server periodically attempts to create a JMS session using the connection between Integration Server and the JMS provider.
Note: The frequency with which Integration Server sends a keep-alive message is determined by the value of watt.server.jms.connection.pingPeriod.
watt.server.jms.connection.pingPeriod
Specifies how often, measured in seconds, Integration Server should ping the JMS provider. The ping serves as a keep alive request sent to the JMS provider. The default is 300 seconds (5 minutes).
watt.server.jms.connection.retryPeriod
Specifies the length of time, in seconds, that Integration Server waits between connection attempts when a connection to the JMS provider or JNDI provider fails. The default is 20 seconds.
watt.server.jms.connection.update.blockingTime
Specifies the maximum amount of time, measured in milliseconds, that a pub.jms* service will wait for a connection while the connection used by the service is being updated. If Integration Server does not restart the connection before the blocking time elapses, Integration Server throws an ISRuntimeException and the sending service fails. A value of 0 (zero) indicates that Integration Server does not block the pub.jms* services while the JMS connection alias updates; Integration Server throws an ISRuntimeException immediately. The maximum value is 10,000 milliseconds (10 seconds). The default is 1000 milliseconds.
Integration Server resets the watt.server.jms.connection.update.blockingTime parameter to the default value if an invalid value is entered.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.connection.update.restartDelay
Specifies the length of time, measured in milliseconds, Integration Server waits for services sending JMS messages to execute to completion when the connection used by the services needs to be updated. After the restart delay elapses, Integration Server refreshes the connection using the updated connection factory object and then restarts the connection. If the restart delay elapses before the pub.jms*services execute to completion, Integration Server throws an ISRuntimeException and the sending service fails. The maximum value is 10,000 milliseconds (10 seconds). The default is 500 milliseconds.
Integration Server resets the watt.server.jms.connection.update.restartDelay parameter to the default value if an invalid value is entered.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.csq.batchProcessingSize
Specifies the maximum number of messages Integration Server retrieves from the client side queue and then sends to the JMS provider. Integration Server places sent messages in the client side queue when the connection to the JMS provider fails. Integration Server begins to drain the client side queue after the connection to the JMS provider becomes available. The default is 25.
watt.server.jms.debugTrace
Enables an extra level of verbose logging for JMS triggers that can be controlled globally or at the individual JMS trigger level.
*To enable debugTrace logging for all JMS triggers, set the watt.server.jms.debugTrace property to true. The default value is false.
For changes to this parameter to take effect, you need to disable and then enable all JMS triggers. For information about using Integration Server Administrator to enable and disable all JMS triggers, see About JMS Trigger Status and State.
*To enable debugTrace logging for an specific JMS trigger, append the fully qualified JMS trigger name to the watt.server.jms.debugTrace property and set that property to true. For example, to enable debugTrace logging for the JMS trigger named myFolder:myJMSTrigger, enter the following on the Edit Extended Settings page:
watt.server.jms.debugTrace.myFolder:myJMSTrigger=true
For this parameter and changes to this parameter to take effect, you need to disable and then enable the JMS trigger specified in the property. For information about using Integration Server Administrator to disable and enable an individual trigger, see About JMS Trigger Status and State.
For the increased logging to appear in the server log, you must set the logging level for server facility 0134 JMS Subsystem to Trace.
watt.server.jms.guaranteedMultisend.alwaysUseTxLogging
Specifies whether or not Integration Server always uses XA transaction logging when sending a JMS message in accordance with a multisend guaranteed policy. In XA transaction logging, Integration Server logs the state of each transaction. The XA transaction logging allows Integration Server to recover any transactions that did not complete due to Integration Server failure. While this is the most reliable way to ensure the integrity of a transaction, it may be expensive in terms of performance and may not always be necessary. When this property is set to true, Integration Server always uses XA transaction logging and can perform XA transaction recovery for a multisend guaranteed policy regardless of the connection transaction type When set to false, Integration Server uses XA transaction logging only if the connection transaction type is XA_TRANSACTION. The default is false.
watt.server.jms.nirvana.durableSubscriber.includeClientId
Specifies whether the client ID of the JMS connection alias will be used as the prefix in the names of durable subscribers created using Designer. Set to true to use the value of the Client ID property in the JMS connection alias as a prefix in the durable subscriber name. Even if the watt.server.jms.nirvana.durableSubscriber.includeClientId is set to true, if the Client ID property is empty the durable subscriber name will not have a client ID prefix. Set to false to omit the use of the client ID as a prefix. The default is true.
watt.server.jms.producer.pooledSession.timeout
Specifies the number of milliseconds for which an inactive entry remains in the default session pool or a destination-specific pool before Integration Server removes the entry. Integration Server uses this value when -1 is specified for the Idle Timeout field for a JMS connection alias. The default is 60000.
watt.server.jms.trigger.concurrent.consecutiveMessageThreshold
Specifies the consecutive number of successful requests for more messages that a concurrent JMS trigger must make before the trigger becomes multithreaded. For example, when this property is set to 1000, Integration Serverbegins using multiple threads for a concurrent JMS trigger when the JMS trigger retrieves messages fro the JMS provider in 1000 consecutive requests. The default for this property is 0, which indicates that Integration Server does not use a threshold to determine when JMS trigger become multithreaded. When threshold is not used, the concurrent JMS trigger will always be multithreaded when more than one message is available for processing. For more information about using a threshold for thread usage for a concurrent JMS trigger, see Establishing a Threshold for Using Multiple Threads with a Concurrent JMS Trigger.
Note: The threshold for using multiple threads with concurrent JMS triggers applies to all the concurrent JMS triggers on the Integration Server. This includes standard JMS triggers, SOAP-JMS triggers, and WS-Endpoint triggers.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.jms.trigger.concurrent.primaryThread.pollingInterval
Specifies the lengthy of time (in milliseconds) for which the primary server thread for a concurrent JMS trigger polls the JMS provider for more messages. Each concurrent JMS trigger has a server thread that retrieves messages from the JMS provider. This thread is considered to be the primary thread for the concurrent JMS trigger. A short polling interval increases the amount of CPU used by Integration Server and increases the load on the JMS provider. However, a short polling interval can improve performance under heavy load and in request-reply scenarios. The default is 500 milliseconds.
If a value of 0 is specified, Integration Server uses the javax.jms.MessageConsumer.receiveNoWait() API to retrieve messages from the JMS provider. The javax.jms.MessageConsumer.receiveNoWait() API may or may not be supported by all JMS providers. If the JMS provider from which a JMS trigger receives messages does not support this API then the JMS trigger will be disabled. If this happens, modify the value of watt.server.jms.trigger.concurrent.primaryThread.pollingInterval to be a positive integer. and enable the JMS trigger.
Note: The default value of 500 milliseconds is not optimal when connecting to Universal Messaging. To improve performance when Universal Messaging is the JMS provider, Integration Server uses a minimum primary polling interval of 3000 milliseconds. If the watt.server.jms.trigger.concurrent.primaryThread.pollingInterval property is set to a value greater than 3000, Integration Server uses the property value for connections to Universal Messaging.
Note: A longer polling interval may affect the performance of JMS triggers with joins because the JMS trigger must retrieve messages from multiple destinations. If one of the destinations from which a JMS trigger retrieves messages is empty, there will be a delay each time the JMS trigger requests a message from the destination. This can impact overall performance.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.jms.trigger.concurrent.secondaryThread.pollingInterval
Specifies the lengthy of time (in milliseconds) with which the secondary server threads for a concurrent JMS trigger poll the JMS provider for more messages. The secondary server threads are the additional threads that can be used to retrieve messages for a concurrent JMS trigger. The number of secondary server threads for a concurrent JMS trigger corresponds to the value Max execution threads property value minus 1. A short polling interval increases the amount of CPU used by Integration Server and increases the load on the JMS provider. A long polling interval can impact the time required for Integration Server to shut down as Integration Server must wait for the polling interval to elapse for each secondary thread used by concurrent JMS triggers. The default value is 1 millisecond.
The value of watt.server.jms.trigger.concurrent.secondaryThread.pollingInterval must be less than or equal to the value of watt.server.jms.trigger.concurrent.primaryThread.pollingInterval.
If a value of 0 is specified, Integration Server uses the javax.jms.MessageConsumer.receiveNoWait() API to retrieve messages from the JMS provider. The javax.jms.MessageConsumer.receiveNoWait() API may or may not be supported by all JMS providers. If the JMS provider from which a JMS trigger receives messages does not support this API then you may see unexpected behavior. If this happens, modify the value of watt.server.jms.trigger.concurrent.secondaryThread.pollingInterval to be a positive integer.
Note: The default value of 1 millisecond is not optimal when connecting to Universal Messaging. To improve performance, when Universal Messaging is the JMS provider, Integration Server uses a minimum secondary polling interval. If the JMS trigger that receives messages from Universal Messaging uses a join, Integration Server uses a minimum secondary polling interval of 10 milliseconds. If the JMS trigger does not use a join, Integration Server uses a minimum secondary polling interval of 3000 milliseconds. If the configured value is greater than the minimum, Integration Server uses the configured value instead.
Note: A longer polling interval affects the performance of JMS triggers with joins because the JMS trigger must retrieve messages from multiple destinations. If one of the destinations from which a JMS trigger retrieves messages is empty, there will be a delay each time the JMS trigger requests a message from the destination. This can impact overall performance.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.jms.trigger.extendedDelay.delayIncrementInterval
Specifies the time interval, measured in milliseconds, at which Integration Server introduces the polling delay for an inactive concurrent JMS trigger. If the JMS trigger remains inactive, the same time interval determines when Integration Server increases the extended delay. The default value is 0 which indicates that Integration Server does not use an extended polling delay for inactive concurrent JMS triggers. For more information about delaying polling requests, see Delaying Polling Requests for Concurrent JMS Triggers.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.trigger.extendedDelay.delays
Specifies the length of the delay that an inactive concurrent JMS trigger waits before polling the JMS provider for more messages. To increase the delay while the JMS trigger remains inactive, specify a comma-separated list of increasing integers. The watt.server.jms.trigger.extendedDelay.delays parameter is measured in milliseconds and has a default value of: 0, 1000, 2000, 3000.
For more information about delaying polling requests, see Delaying Polling Requests for Concurrent JMS Triggers.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.trigger.groupTag
Specifies the group tag used in the names of JMS triggers that belong to a trigger group. Integration Server treats JMS triggers with the specified group tag in the name as members of a trigger group. All triggers in a trigger group use the following format for the name: folder.subfolder:originalJmsTriggerName_groupTag_Id
The default is WMTG. If you set the parameter to null(blank), Integration Server does not use trigger groups and the methods in the com.wm.app.b2b.server.jms.consumer.JMSTriggerGroupFacade class cannot be used to create triggers.
Note: If you change the value of the watt.server.jms.trigger.groupTag parameter and a trigger group already exists on Integration Server, the triggers that were created with the previous group tag will no longer be treated as members of a trigger group.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.trigger.maxDeliveryCount
Specifies the maximum number of times the JMS provider can deliver a message to Integration Server. The default is 100.
watt.server.jms.trigger.maxPrefetchSize
Specifies the maximum number of messages that the webMethods Broker API for JMS will retrieve and cache per request for a JMS trigger. Using pre-fetch cache can speed up the retrieval of messages from the webMethods Broker. Because messages will be placed in Integration Server memory, you may want to decrease this setting if you have JMS triggers receiving very large messages. Otherwise, memory issues can occur. This property only applies to JMS triggers receiving messages from the webMethods Broker. The default is 10 messages.
Integration Server checks this value when a JMS trigger starts. To apply a new value to all JMS triggers, use Integration Server Administrator to disable and then enable JMS triggers. For information about using Integration Server Administrator to disable and enable an individual trigger, see Managing JMS Triggers.
This property only takes effect when the trigger's prefetch property is set to -1.
When working in a cluster of Integration Servers, the behavior controlled by this property might appear at first to be misleading. For example, suppose that you have a cluster of two Integration Servers. Each Integration Server contains the same JMS trigger. Twenty messages are sent to a destination from which JMS trigger receives messages. It might be expected the JMS trigger on Integration Server 1 will receive the first message, the JMS trigger on Integration Server 1 will receive the second message, and so forth. However, what may happen is that the JMS trigger on Integration Server 1 will receive the first 10 messages and the JMS trigger on Integration Server 2 will receive the second 10 messages.
watt.server.jms.trigger.monitoringInterval
Specifies the interval, measured in seconds, at which Integration Server executes resource monitoring services for JMS triggers. A resource monitoring service is a service that you create to check the availability of resources used by a JMS trigger service. After Integration Server suspends a JMS trigger because all retry attempts have failed, it schedules a system task to execute the resource monitoring service assigned to the JMS trigger. The default is 60 seconds. Changes to this property take effect the next time Integration Server schedules a system task to execute a resource monitoring service for a JMS trigger.
For more information about building resource monitoring services for JMS triggers, see Using webMethods Integration Server to Build a Client for JMS.
watt.server.jms.trigger.pollingSession.timeout
Specifies the frequency (measured in minutes) with which Integration Server refreshes an inactive connection for a JMS trigger. A JMS trigger session is considered to be inactive when the JMS trigger does not use the session to retrieve messages. The default is 30 minutes.
watt.server.jms.trigger.pooledConsumer.timeout
Specifies the length of time, in milliseconds, that an inactive pooled consumer remains in the consumer pool before it is removed. Integration Server uses a pool of consumers to retrieve and process messages for concurrent JMS triggers. When the timeout value elapses, Integration Server deletes the inactive pooled consumer. For the Integration Server to retrieve more messages for the concurrent JMS trigger, Integration Server must create a new consumer, which entails creating a javax.jms.MessageConsumer and javax.jms.Session. For some JMS providers, this can be an expensive operation. Setting a high value for watt.server.jms.trigger.pooledConsumer.timeout server property results in the JMS session and messageConsumer remaining open for a long period of time. If the load on Integration Server is high, a long timeout value reduces the frequency with which the pooled consumers must be created. However, when the timeout value is high and the load on Integration Server is low there may be unused pooled consumers.There is no default timeout value.
watt.server.jms.trigger.raiseEventOnException
Indicates whether Integration Server generates a JMS retrieval failure event when a JMS trigger experiences a fatal exception, such as a non-transient error or a message that cannot be reprocessed, during message processing. Specify true if you want Integration Server to generate a JMS retrieval failure event. The default is true.
watt.server.jms.trigger.raiseEventOnRetryFailure
Indicates that Integration Server generates a JMS retrieval failure event when a JMS trigger experiences a retry failure. A retry failure can occur when the JMS provider has reached the max delivery count for a message or when an ISRuntimeException is thrown and the JMS trigger is not configured to recover the message (for example, if retry failure handling for a non-transacted JMS trigger is set to "Throw exception" instead of "Suspend and Retry Later".) When set to true, Integration Server generates a JMS retrieval failure event for a JMS trigger when retry failure occurs. The default is true.
watt.server.jms.trigger.retryOnConsumerError
Determines whether or not Integration Server attempts to re-enable JMS triggers automatically when an error unrelated to the connection to the JMS provider causes the JMS trigger to be disabled. Set watt.server.jms.trigger.retryOnConsumerError to true to instruct Integration Server to re-enable JMS triggers automatically. Set the property to false to instruct Integration Server to leave JMS triggers disabled when the message consumer encounters an unexpected error unrelated to the connection to the JMS provider. The default is true.
watt.server.jms.trigger.reuseJmsTxSession
Specifies whether or not sessions can be reused across multiple transactions for a transacted JMS trigger. When set to true, a transacted JMS trigger will reuse the same JMS session for receiving messages from the JMS provider. When set to false, Integration Server creates and closes a session for each message a transacted JMS trigger receives and processes. The default value is true.
Some JMS providers might not support the use of a single session across multiple transactions. When working with these JMS providers, set watt.server.jms.trigger.reuseJmsTxSession to false.
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.trigger.reuseSession
Indicates whether instances of a JMS trigger use the same session on Integration Server. When this property is set to true, the JMS trigger uses a shared session. Each of the trigger services executed by the JMS trigger will use the same session ID. When this property is set to false, Integration Server uses a new session for each instance of a JMS trigger. Reusing sessions for a JMS trigger might improve performance. However, this property does not work with all adapters. If you are working with an adapter, such as the SAP adapter, that requires the session ID to be unique, set this property to false. The default is false.
watt.server.jms.trigger.serial.primaryThread.pollingInterval
Specifies the length of time (in milliseconds) for which the server thread for a serial JMS trigger polls the JMS provider for messages. A short polling interval increases the amount of CPU used by Integration Server and increases the load on the JMS provider. However, shorter polling intervals can improve performance under heavy load and in request-reply scenarios. The default is 500 milliseconds.
If a value of 0 is specified, Integration Server uses the javax.jms.MessageConsumer.receiveNoWait() API to retrieve messages from the JMS provider. The javax.jms.MessageConsumer.receiveNoWait() API may or may not be supported by all JMS providers. If the JMS provider from which a JMS trigger receives messages does not support this API then the JMS trigger will be disabled. If this happens, modify the value of watt.server.jms.trigger.serial.primaryThread.pollingInterval to be a positive integer and then enable the JMS trigger.
Note: The default value of 500 milliseconds is not optimal when connecting to Universal Messaging. To improve performance when Universal Messaging is the JMS provider, Integration Server uses a minimum primary polling interval of 3000 milliseconds. If the trigger uses a join, Integration Server uses a secondary polling interval which is set to 10 milliseconds. Note that the secondary polling interval is not configurable for a serial JMS trigger
Note: A longer polling interval affects the performance of JMS triggers with joins because the JMS trigger must retrieve messages from multiple destinations. If one of the destinations from which a JMS trigger retrieves messages is empty, there will be a delay each time the JMS trigger requests a message from the destination. This can impact overall performance.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.jms.trigger.startupFailure.retryCount
Determines the maximum number of retry attempts that Integration Server makes to start a JMS trigger after the trigger fails to start. After the initial trigger startup failure, Integration Server waits an interval of 1000 milliseconds and then retries starting the trigger. If startup of the trigger fails, Integration Server waits 1000 milliseconds and then makes another attempt to start the trigger. Integration Servercontinues in this way until the JMS trigger starts successfully, the JMS connection alias stops running, or the JMS trigger becomes disabled. When starting the trigger fails after Integration Server makes the maximum number of retry attempts, Integration Server can take no further action to start the trigger. Integration Server logs an exception which will be visible in the JMS Trigger Management page of Integration Server Administrator. The JMS trigger remains inactive until the problem is resolved and the trigger is manually restarted (i.e. enabled).
The watt.server.jms.trigger.startupFailure.retryCount parameter must be set to an integer greater than or equal to 0. When the parameter is set to 0, the default, Integration Server does not make any retry attempts. Excessive retry attempts may cause the JMS connection alias startup time to be delayed.
Important: If you change the setting of this parameter, you must restart for the changes to take effect.
watt.server.jms.trigger.stopRequestTimeout
Specifies the maximum amount of time, measured in seconds that Integration Server waits after a JMS trigger is disabled before forcing the JMS trigger to stop processing messages. The minimum value is 0. The default is 3 seconds.
Note: If you set watt.server.jms.trigger.stopRequestTimeout to 0, the JMS trigger immediately stops processing messages after a JMS trigger is disabled. In this case, Integration Server stops the trigger immediately and does not wait for any processing to complete. This can result in a javax.jms.IllegalStateException.
You can disable a JMS trigger by invoking the pub.trigger:disableJMSTrigger service or by using or via the Settings > Messaging > JMS Trigger Management screens in Integration Server Administrator. For information about disabling JMS triggers, see About JMS Trigger Status and State.
When you save a JMS trigger in Designer, Integration Server stops and then restarts the trigger. In this situation, Integration Server waits 3 seconds before forcing the JMS trigger to stop processing messages. This value cannot be configured.
Note: when a JMS trigger is disabled while it is processing messages,
Important: You must restart Integration Server for the new value to take effect.
watt.server.jms.trigger.wmjms.clientIDSharing
Indicates that Integration Server attempts to receive messages from durable subscribers in a load-balanced fashion. When set to true, Integration Server does the following:
*If the durable subscriber specified by the JMS trigger does not exist, Integration Server creates the durable subscriber on the Broker and enables state sharing. Integration Server also uses the message processing mode to set the Shared State Order mode for the durable subscriber. (A message processing mode of serial maps to a shared state order mode of publisher, a message processing mode of concurrent maps to a shared state order mode of none.)
If the durable subscriber already exists, Integration Server does not make any changes to the durable subscriber when it saves the JMS trigger.
*Indicates to the Broker that client identifiers can be shared by setting the com.webmethods.jms.clientIDSharing property within Integration Server to true.
This property only applies when the JMS trigger uses a JMS connection alias that connects to the webMethods Broker using the native webMethods API.
The default is true.
Important: You must restart Integration Server for a new value to take effect.
watt.server.jms.wmjms.lms.readTimeout
Specifies the amount of time (measured in milliseconds) that Integration Server waits for the next portion of an input stream before throwing WmReadTimeoutException. The read timeout only applies after Integration Server retrieves the initial piece of the input stream. The default is 30000 milliseconds.
watt.server.jndi.searchresult.maxlimit
Specifies the maximum number of records that Integration Server displays when searching for users or groups in the LDAP or central directory and no search criteria are specified. The default is 0. When set to 0, Integration Server displays all available records.
watt.server.json.allowUnquotedFieldNames
The JSON standard requires that field names be enclosed in double quotes. However, when parsing legacy JavaScript as JSON text it may be helpful to allow unquoted field names as JavaScript does not require field names to be enclosed in double quotes. If this parameter is set to true, the pub.json:jsonStringToDocument and pub.json:jsonStreamToDocument services allow unquoted field names in any supplied JSON text. If this parameter is set to false, the services throw a ServiceException when encountering unquoted field names. The default is false.
The watt.server.json.allowUnquotedFieldNames parameter also affects the process of creating document types from a JSON text. If watt.server.json.allowUnquotedFieldNames is set to true and a JSON text with unquoted fields is used as the source for a document type, the resulting document type contains fields that correspond to the unquoted fields as well as the quoted fields. When watt.server.json.allowUnquotedFieldNames is set to false and a JSON text with unquoted fields is used as the source for a document type, Designer throws an exception and does not create the document type.
Important: You must restart Integration Server for a new value to take effect.
watt.server.json.decodeIntegerAsLong
Converts an integer that Integration Server retrieves from JSON content to either a Long or Integer Java wrapper type. If this parameter is set to true, Integration Server converts the JSON integer to a Long Java wrapper type. If this parameter is set to false, Integration Server converts the JSON integer to a Integer Java wrapper type. The default is true (Long).
watt.server.json.decodeRealAsDouble
Converts a real number that Integration Server retrieves from JSON content to either a Float or Double Java wrapper type. If this parameter is set to true, Integration Server converts the real number to a Double Java wrapper type. If this parameter is set to false, Integration Server converts the real number to a Float Java wrapper type. The default is true (Double).
watt.server.json.decodeRealAsString
Converts a real number that Integration Server retrieves from JSON content to String. If this parameter is set to true, Integration Server converts the real number to a String. If this parameter is set to false, Integration Server does not convert the real numbers to String instead, real numbers are converted to either Float or Double Java wrapper type depending on the values specified in decodeRealAsDouble. The default is false.
Note: Error occurs if both watt.server.json.decodeRealAsString and watt.server.json.decodeRealAsDouble parameters are set to true.
watt.server.json.optimizeForUniqueKeys
Controls how Integration Server parses JSON documents based on whether the documents have unique keys or duplicate keys. Integration Server can parse JSON documents faster when you set this parameter based on the nature of the documents you expect to receive. If you expect to process JSON documents that have unique keys or only a few duplicate keys, set this property to true (the default). If you expect to process JSON documents that have a lot of duplicate keys, set this property to false.
Note: You must restart Integration Server for changes to go into effect.
watt.server.json.prettyPrint
Specifies whether the output of JSONCoder.encode() is formatted with carriage returns and indentation to make the output easier to read. When Integration Server responds to a client request with JSON content, the format of that response is controlled by this property. If this parameter is set to true, Integration Server encodes JSON with carriage returns and indentation to ease readability. The default is false. For more information about JSONCoder, see webMethods Integration Server Java API Reference.
You can override this setting in individual requests that use the invoke, rest, or restv2 directives by including a query parameter of jsonPrettyPrint=true or jsonPrettyPrint=false in the URL used to invoke a service.
Note: You cannot override this setting when using other directives, such as soap or ws.
You can also set watt.server.json.prettyPrint to specify whether the pub.json:documentToJSONString service uses pretty print formatting in the jsonString output parameter. For more information about pub.json:documentToJSONString, see the webMethods Integration Server Built-In Services Reference.
watt.server.json.quoteFieldNames
Specifies whether or not the pub.json:documentToJSONString service encloses all generated JSON field names in double quotes. The JSON standard requires that field names be enclosed in double quotes. However, you may need the service to produce unquoted field names if the generated JSON text will be processed by an older JavaScript interpreter. Set this parameter to true instruct the pub.json:documentToJSONString service to enclose field names in quotes in the output JSON text. Set this parameter to false to instruct the service to omit the double quotes around field names in the generated JSON text. The default is true.
Note: Use caution when setting watt.server.json.quoteFieldNames to false as this causes the pub.json:documentToJSONString service to generate non-standard JSON text. This can cause interoperability issues if the JSON text is sent to other organizations.
Note: You must restart Integration Server for changes to take effect.
watt.server.key
Specifies the license key for the server. There is no default.
watt.server.ldap.cleanContext
Specifies whether Integration Server should close the TCP/IP connection and clean the LDAP context (the connectionHandle object) after processing a pub.client.ldap service request. When this property is set to true, Integration Server closes the connection and cleans the underlying LDAP context; Integration Server does not return the LDAP context to the pipeline. When this property is set to false (the default), Integration Server does not close the connection and returns the LDAP context to the pipeline.
For more information about the pub.client.ldap services, see webMethods Integration Server Built-In Services Reference.
watt.server.ldap.DNescapeChars
Specifies the characters Integration Server can escape (using the \ character) in distinguished names presented to an LDAP server. By default, this property is set to null, meaning no characters are escaped.
Use this parameter if the distinguished names you are using include special characters that Integration Server needs to escape. For example, if your LDAP server maintains userids such as abc/def, specify the following:
watt.server.ldap.DNescapeChars = /
If you need to escape the \ character, specify it twice:
watt.server.ldap.DNescapeChars = \\
watt.server.ldap.DNescapePairs
Specifies the characters in LDAP distinguished names that Integration Server should not double-escape prior to their presentation to an LDAP server. To escape special characters in a distinguished name, you must precede the character with a backslash (\). By default, the following characters are never double-escaped, and should not be specified in watt.server.ldap.DNescapePairs:
, = + < > # ; / \
If the distinguished names in your LDAP server contain special characters other than those specified above, add them to watt.server.ldap.DNescapePairs so that Integration Server does not double-escape the characters. For example, do not add an equal sign (=) to watt.server.ldap.DNescapePairs, since this is never double-escaped by default. However, if the LDAP distinguished name contains an ampersand (&) and it should be double-escaped, add an ampersand character to watt.server.ldap.DNescapePairs as follows:
watt.server.ldap.DNescapePairs=&
This property has no default value. If no value is supplied, no special characters beyond the set listed above are protected from double-escape. This property is not dynamic. Changes to its value go into effect after Integration Server is restarted.
watt.server.ldap.DNescapeURL
Indicates whether Integration Server should ignore the first three forward slashes (/) in domain names, or to treat them as escape characters. If set to false (the default), Integration Server ignores the first three slashes in a domain name. Integration Server treats the slashes as part of the domain name, not as escape characters, regardless of the escape characters defined in the watt.server.ldap.DNescapeChars and watt.server.ldap.DNescapePairs server configuration parameters.
If set to true, Integration Server treats the forward slashes as escape characters and escapes domain names in accordance to the settings of watt.server.ldap.DNescapeChars and watt.server.ldap.DNescapePairs.
Important: You must restart Integration Server after you modify the value of this property.
watt.server.ldap.DNstripQuotes
Specifies whether Integration Server should strip leading and trailing quotes from domain names presented to an LDAP server. When set to true (the default), Integration Server strips the quotes from domain names that contain special characters.
Note: If watt.server.ldap.DNstripQuotes is set to false, Integration Server retains the quotes in the domain names that have them. This could cause lookups to break.
Important: You must restart Integration Server after you modify the value of this property.
watt.server.ldap.doNotBind
Specifies whether the Integration Server authenticates against the LDAP server. If your Integration Server uses a custom authentication module and you do not require users to be authenticated against the LDAP directory, set this property to true to prevent unnecessary requests to the LDAP server. The default is false.
watt.server.ldap.extendedMessages
Controls whether the Integration Server displays additional information returned from the LDAP server when an authentication error occurs. This information is available only if the LDAP server provides it. Active Directory is an LDAP server that provides this additional information. The default is false.
When set to false, an error message might look like this:
2005-03-08 15:40:33 EST [ISS.0002.0035E] Invalid credentials connecting to
ldap://10.3.33.203:389/dc=KQA,dc=webMethods,dc=com as
CN=bob,OU=ISUsers,DC=KQA,DC=WEBMETHODS,DC=COM
When set to true, the same error would be displayed like this:
2005-03-08 15:40:33 EST [ISS.0002.0035E] Invalid credentials connecting to
ldap://10.3.33.203:389/dc=KQA,dc=webMethods,dc=com as
CN=bob,OU=ISUsers,DC=KQA,DC=WEBMETHODS,DC=COM: [LDAP: error code 49 -
80090308: LdapErr: DSID-0C09030F, comment: AcceptSecurityContext error,
data 52e, vece]
For Active Directory users, the data code (data 52e above) contains the reason the authentication failed. You can convert the code to decimal and look it up on http://msdn.microsoft.com/library/en-us/debug/base/system_error_codes.asp to determine the problem.
watt.server.ldap.extendedProps
Specifies LDAP environment properties that the Integration Server will pass directly to an LDAP implementation when initializing a JNDI context. It takes this form:
For example, if you are using a specialized JNDI provider other than the default, or if your LDAP directory requires a special JNDI property to be passed into the environment when a context is created, you could set the property customProperty to customValue:
watt.server.ldap.extendedProps=java.naming.customProperty=customValue
There is no default.
watt.server.ldap.memberInfoInGroups
Controls where Integration Server looks for LDAP group membership information. When set to true, the default, the Integration Server looks for group membership information in the group object. When set to false, the Integration Server looks for group membership information in the user object.
watt.server.ldap.retryCount
Specifies how many times Integration Server should automatically try to reconnect to an LDAP server after a network outage or LDAP server restart. If set to 0, the default, Integration Server will prompt the LDAP user for credentials rather than retrying the connection. If set to a positive integer, Integration Server will retry the connection the number of times specified. The default is 0.
watt.server.ldap.retryWait
Specifies how long Integration Server should wait before trying to reconnect to an LDAP server after a network outage or LDAP server restart. When set to 0, if there is a transient failure while communicating with LDAP, Integration Server will not try to reconnect to the LDAP server. If set to a positive integer, Integration Server will retry the connection the number of times specified in watt.server.ldap.retryCount and will wait the amount of time specified in watt.server.ldap.retryWait between retry attempts. The default is 0.
watt.server.licenses
Specifies the number of licenses. The default is 1.
watt.server.log.alertMaxEntries
Specifies the number of entries that you can display in the Logs > logName page beyond which Integration Server Administrator displays an alert message. If the value entered in the Number of entries to display field in the Logs > logName page is more than the value specified for watt.server.log.alertMaxEntries, Integration Server Administrator displays a message informing that the number of requested entries exceeds the threshold and that displaying more entries might affect Integration Server performance. If no value is specified for watt.server.log.alertMaxEntries, Integration Server Administrator does not display any alert message.
watt.server.log.maxEntries
Specifies the default number of log entries to be displayed in the log viewing utility. The default is 35 entries (the most recent entries). For complete information, see Changing the Display Permanently for All Logs.
watt.server.log.orphanLoggers
Specifies the orphan loggers that you want to be adopted by the IS logging hierarchy. Some Integration Server logs become filled with debug messages even though the logging level is set to be higher than debug. This can happen when Integration Server has orphan loggers (loggers that are not part of the IS logging tree hierarchy) and a custom application configures the root logger of log4j. If there is not a custom configuration of log4j, the orphan loggers will inherit the logging levels specified in the IS logging tree hierarchy. However, if a custom application reconfigures the root logger in the log4j configuration file, the orphaned loggers inherit the logging level from the root logger. Consequently, if the log4j.rootLogger is set to DEBUG, the orphaned loggers will log at the Debug level.Use this parameter to prevent orphan loggers from logging at the modified log4j.rootLogger level. Use a comma to separate multiple orphan loggers. For example:
watt.server.log.orphanLoggers=WEBMETHODS.DEFAULT,log4j.logger.com.softwareag
.wsstack,log4j.logger.com.softwareag.security,Debug.com.webmethods.lwq,com
.webmethods.jms.db.DbJMSClient
This is the default value.
watt.server.log.queued
Specifies whether the server is to queue log entries written by its facilities in memory, then use a background thread to write them to the server log. The default is true (queue log entries). For complete information, see the webMethods Audit Logging Guide.
watt.server.log.refreshInterval
Specifies the length of time (in seconds) that Integration Server Administrator refreshes the displayed server log. The default is 90 seconds. For complete information, see Changing the Display Permanently for All Logs.
watt.server.logEncoding
Specifies the encoding that Integration Server uses for reading and writing text to the log files or to the console. The default is UTF-8.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.logRotateInterval
Specifies the length of the log recycle interval (in milliseconds) for log entries. Starting with Integration Server 9.7, this server configuration parameter has been renamed watt.server.statsLogRotateInterval.
The watt.server.logRotateInterval parameter was removed from Integration Server after 8.2 SP2. When it was reintroduced for the following fixes, the scope of the parameter changed so that it affected only the stats.log:
*IS_9.0_SP1_Core_Fix6
*IS_9.5_SP1_Core_Fix3
*IS_9.6_Core_Fix2
If you migrate from Integration Server 9.6 or earlier to Integration Server 9.7 or higher, Integration Server:
*Changes the name of the server configuration parameter in server.cnf from watt.server.logRotateInterval to watt.server.statsLogRotateInterval
*Converts the value of the server configuration parameter from milliseconds to minutes
*Uses watt.server.statsLogRotateInterval to set the log recycle interval for the stats.log file
watt.server.loginFailureLimit
Specifies the number of times a user can supply the wrong login credentials before Integration Server alerts the administrator and resets the count of login failures to 0. For example, if watt.server.loginFailureLimit is set to 5, when a user supplies the wrong login credentials for the sixth time, Integration Server sends an email alert to the administrator and resets the count of login failures to 0. The default value is 5.
watt.server.login.userFtpDir
Specifies whether the user who has connected to Integration Server through an FTP listener is to be placed in the default FTP root directory or the client user directory. When this property is set to false (or not specified), the user is logged into the FTP root directory. The user must then issue the cd command to access the client user directory. When this property is set to true, the user is logged into the client user directory. The default value is false.
The FTP root directory can be the default directory named userFtpRoot in your Integration Server home directory or a directory defined by the user using the watt.server.userFtpRootDir property.
Important: You must restart Integration Server after you modify the value of this property.
watt.server.logs.dateStampFmt
Specifies the format of the date and timestamp to be used in audit log files (FailedAudit_*, WMERROR*, WMSESSION*, WMTXIN*, WMTXOUT*). The format you specify must adhere to the java.text.SimpleDateFormat class. If the watt.server.logs.dateStampFmt property is not set, Integration Server uses the default format, which is yyyy-MM-ddThh:mm:ss.SSSZ (for example, 2010-04-19T19:07:21.505Z).
watt.server.logs.dateStampTimeZone
Specifies the time zone to be used in audit log files (FailedAudit_*, WMERROR*, WMSESSION*, WMTXIN*, WMTXOUT*). The format you specify must adhere to the java.util.TimeZone class (for example, watt.server.logs.dateStampTimeZone=EST). If this property is not set, Integration Server uses local time zone hosting. For this property to take effect, the watt.server.logs.dateStampFmt must also be specified.
watt.server.math.floatOperation.mode
Specifies whether the pub.math:*Floats services return the exact result of an operation involving two floating point numbers, the result as calculated by the JVM, or the result based on a fixed number of decimal places.
Set this parameter to one of the following values:
Specify...
If you want pub.math:*Floats services to...
dynamic
Return the precise result of the math operation. For example, when using pub.math:addFloats to add 62.98 and 23, the service returns a sum of 85.98.
default
Return the result of the math operation as calculated by the JVM.
For example, when using pub.math:addFloats to add 62.98 and 23, the service returns a sum of 85.97999999999999.
This is the default behavior.
fixed
Return the result rounded to a pre-determined number of decimal places. For the pub.math:addFloats and pub.math:subtractFloats services, Integration Server rounds the result to 3 decimal places.
For the pub.math:multiplyFloats service, Integration Server rounds the product to 16 decimal places.
For the pub.math:divideFloats service, Integration Server rounds the result to 17 decimal places.
Note: If you specify a value for the precision input parameter in pub.math:*Floats services, the precision value is given precedence over the value of the property 'watt.server.math.floatOperation.mode. For more information about the pub.math:*Floats services, see webMethods Integration Server Built-In Services Reference.
Important: You must restart Integration Server for a new value to take effect.
watt.server.mediator.directives
Specifies a comma-separated list of directives used to detect Mediator requests. When Integration Server receives a request that uses the directives specified by the watt.server.mediator.directives server configuration parameter, Integration Server checks to see if the web service invoked by the request is a Mediator service. If the web service is a Mediator service, Integration Serverassigns the default user to the request. The default Mediator directives are "'ws,mediator".
watt.server.messaging.debugTrace
Enables an extra level of verbose logging for webMethods messaging triggers that receive messages from Universal Messaging or through Digital Event Services. You can configure the additional logging globally or at the individual webMethods messaging trigger level.
*To enable debugTrace logging for all webMethods messaging triggers, set the watt.server.messaging.debugTrace property to true. The default value is false.
For changes to this parameter to take effect, you need to disable and then enable the messaging connection aliases used by the triggers.
*To enable debugTrace logging for a specific webMethods messaging trigger, append the fully qualified webMethods messaging trigger name to the watt.server.messaging.debugTrace property and set that property to true. For example, to enable debugTrace logging for the webMethods messaging trigger named myFolder:myMessagingTrigger, enter the following on the Edit Extended Settings page:
watt.server.messaging.debugTrace.myFolder:myMessagingTrigger=true
For this parameter or changes to this parameter to take effect, you need to disable and then enable the webMethods messaging trigger specified in the property. For information about using Integration Server Administrator to disable and enable an individual trigger, see Suspending or Resuming Document Processing for a Specific webMethods Messaging Trigger
Note: For the increased logging to appear in the server log, you must set the logging level for server facility 0153 Dispatcher (Universal Messaging) to Trace.
watt.server.metadata.registry.timeout
The number of minutes a connection to a CentraSite registry can remain inactive before Integration Server closes it. Integration Server connects to one or more CentraSite registries to publish and retract metadata for your Integration Server assets. If no assets are published to or retracted from a CentraSite registry for a period of time, Integration Server closes the connection to that registry. The default period is 10 minutes.
watt.server.mime.decodeHeaders
Determines the global default behavior for how the pub.mime:createMimeData service handles header decoding. The property can have one of the following values:
Specify...
To indicate that...
NONE
Specifies that by default the pub.mime:createMimeData service does not decode the MIME header or body part headers. This is the default.
ONLY_MIME_HEADER
Specifies that by default the pub.mime:createMimeData service decodes the MIME header only.

ONLY_BODY_PART _HEADERS
Specifies that by default the pub.mime:createMimeData service decodes the body part headers only.
BOTH
Specifies that by default the pub.mime:createMimeData service decodes the MIME header and the body part headers.
Note: The values are not case sensitive.
Note: Integration Server uses the value of the watt.server.mime.decodeHeaders to determine whether or not to decode headers in a MIME message only when the pub.mime:createMimeData service specifies no value for the decodeHeaders input parameter. For information about the pub.mime:createMimeData service and the decodeHeaders input parameter, see the webMethods Integration Server Built-In Services Reference.
watt.server.netEncoding
Specifies the encoding the server is to use when reading and writing text to the network. This setting has no effect on text that is explicitly encoded in a particular encoding. The default is UTF-8. The encoding parameter in the pub.client:soapHTTP service, if set, overrides the watt.server.netEncoding setting. For more information about pub.client:soapHTTP, see webMethods Integration Server Built-In Services Reference.
watt.server.new.http.session.context
Specifies whether Integration Server should create a new session object when executing the pub.client:http service. When this property is set to true, Integration Server ignores the values from the session object of the last invocation of pub.client:http and creates a new session object. When this property is set to false, Integration Server uses the values from the existing session object. The default value is false.
watt.server.noObjectURL
Specifies the URL to which the server redirects a request after three attempts to log on to the Integration Server Administrator have failed because the server cannot find the document the user is requesting. The default is for the server to display an HTML screen saying "No such object."
watt.server.noAccessURL
Specifies the URL to which the server is to redirect a request after three attempts to log on to the Integration Server Administrator have failed because the user does not have access to the requested document. The default is for the server to display an HTML screen saying "Access denied."
watt.server.ns.backupNodes
Specifies whether services are removed completely when they are deleted. When set to true, service node.ndf files will be renamed to node.bak when they are deleted. The default is false.
watt.server.ns.dependencyManager
Specifies whether the dependency checking features are enabled or disabled. When set to true, the dependency checking features identify elements that will be affected by moving, renaming, or deleting another element. For optimization in a production environment, you might set this parameter to false. The default for this parameter is true.
watt.server.ns.decodeJavaService
Specifies whether Integration Server decodes and Designer displays non-ASCII Unicode characters in the body of a Java service. When you save Java services, Integration Server encodes non-ASCII Unicode characters as ASCII Unicode escape sequences. By default, Integration Server does not decode the escape sequences. Therefore, when Integration Server sends Java service code to Designer, escape sequences appear in Designer instead of the original Unicode characters. Set to true if you want Integration Server to decode the escape sequences so that Designer displays the original Unicode characters instead of the escape sequences. The default is false.
watt.server.ns.hideWmRoot
Indicates whether Integration Server should hide the WmRoot package from the Software AG Designer workspace. When set to true (the default), Designer does not display the WmRoot package in the workspace.
watt.server.ns.lockingMode
Specifies whether file locking is enabled on the Integration Server:
*To enable use of the Version Control System Integration feature, set this value to vcs.
*To enable local locking on the Integration Server, set this value to full. This is the default value.
*To disable user locking and show no locks, set this value to none.
*To disable user locking but show system locks, set this value to system. This value is required to use the Local Service Development feature.
Important: The WmVCS package, which provides the functionality for using the VCS Integration Feature, is deprecated as of Integration Server version 9.9. Software AG recommends that you use the local service development feature (Local Version Control Integration) to check package elements and their supporting files into and out of a version control system (VCS) directly from Designer.
watt.server.ns.logDuplicateDocTypeRegistrationAsError
Indicates whether to suppress or continue logging of error messages related to registration of duplicate universal names for a document type.
When the same WSDL document is used to generate multiple consumer Web service descriptors and multiple WSDL first provider Web service descriptors, Integration Server creates multiple document types with the same explicit universal name. It is when loading a package containing these document types that Integration Server logs error messages specifying duplicate universal name registrations multiple times, which can clutter the log file.
Set the value of the parameter to false to suppress the logging of the error messages and true to resume the logging. The default value of this parameter is true.
Note: Setting watt.server.ns.logErrorsOnRegisteringMultipleDocTypesForAUniversalName to false suppresses the error messages about duplicate universal names only. It does not resolve the duplicate names.
watt.server.oauth.approvalpage.footer
Specifies the footer information that Integration Server displays on the OAuth approval page. There is no default.
watt.server.oauth.approvalpage.header
Specifies the heading information that Integration Server displays on the OAuth approval page. The default is Resource access approval.
watt.server.oauth.approvalpage.logo
Specifies the URL of the image file that Integration Server displays on the OAuth approval page. Keep the following points in mind when specifying an image file:
*Image files can be of any width, but can be no larger than 92 pixels high.
*You can specify an image of any image file format (for example, .gif, .png, .jpeg, or another image file format) that your browser can display.
*The image file does not have to reside on Integration Server. If the image file is hosted on another server, provide the absolute path.
The default is /WmPublic/images/fw_logo_sag.gif, which is 234x92 pixels.
watt.server.oauth.approvalpage.title
Specifies the title that Integration Server displays on the OAuth approval page. The default is Access Approval.
watt.server.oauth.authCode.expirySeconds
Specifies the amount of time (in seconds) before the OAuth authorization code expires. A value of -1 indicates that the authorization code never expires. The maximum value is 2147483647. The default is 600.
The value of the watt.server.oauth.authCode.expirySeconds parameter is tied to the value of the Authorization code expiration interval field on the Security > OAuth > Edit OAuth Global Settings screen in Integration Server Administrator. Software AG recommends that you use Integration Server Administrator to specify the expiration time for the OAuth authorization code instead of using the watt.server.oauth.authCode.expirySeconds property. For more information about setting the expiration time for the OAuth authorization code, see Configuring OAuth.
watt.server.oauth.authServer.alias
Specifies the alias of the remote server that Integration Server uses as an authorization server. The value should match the Alias field on the Settings > Remote Servers page of Integration Server Administrator. For example, local.
Note: You must add the remote server on the Settings > Remote Servers page of Integration Server Administrator before specifying the alias in watt.server.oauth.authServer.alias.
The value of the watt.server.oauth.authServer.alias parameter is tied to the value of the Authorization server field on the Security > OAuth > Edit OAuth Global Settings screen in Integration Server Administrator. Software AG recommends that you use Integration Server Administrator to specify the remote server alias to use as an authorization server instead of using the watt.server.oauth.authServer.alias property. For more information about specifying the remote server alias, see Configuring OAuth.
watt.server.oauth.custom.responseHeader
When set to true, OAuth and OpenID errors that are returned to client applications and to end users appear in the HTTP response header with a header attribute name of X-OAuth-Error. For most OAuth and OpenID errors, Integration Server returns a status code in the range of 400 - 599 and the error message is returned in the body of the HTTP response. Some browsers do not display the response body when the status code is not successful (200 - 299). Problems with your applications that use OAuth or OpenID can be easier to troubleshoot when the error message is in the response header. When the Server logging facility "0038 HTTP Header" is set to TRACE, the response header is visible in the server log. If watt.server.oauth.custom.responseHeader is true, OAuth and OpenID error messages will appear as X-OAuth-Error response header attributes in the server log.
The default value for watt.server.oauth.custom.responseHeader is false.
watt.server.oauth.requireHTTPS
Indicates whether Integration Server requires that client applications use HTTPS to access the pub.oauth* services. If you set the value of this property to false, Integration Server allows client applications to use HTTP to access the pub.oauth* services. The default is true.
If you set the value of this property to true and the client application accesses any of the pub.oauth services over HTTP, Integration Server issues an HTTP 400 error response to the client and writes a service exception to the error log.
Note: To conform to the OAuth 2.0 Authorization Framework, you must set this property to true.
Important: To simplify development, you can set watt.server.oauth.requireHTTPS to false, but you should require HTTPS in production in accordance with the OAuth Framework. If you do not require HTTPS, the authorization server transmits access tokens in clear text, making them vulnerable to theft.
The value of the watt.server.oauth.requireHTTPS parameter is tied to the value of the Require HTTPS field in the Security > OAuth > Edit OAuth Global Settings page of the Integration Server Administrator. Software AG recommends that you use Integration Server Administrator to indicate whether Integration Server requires HTTPS for applications to access OAuth services instead of using watt.server.oauth.requireHTTPS. For more information about requiring HTTPS for accessing OAuth services, see Configuring OAuth.
For more information about the pub.oauth services, see webMethods Integration Server Built-In Services Reference.
watt.server.oauth.requirePost
Indicates whether Integration Server requires that client applications use HTTP POST method to access the pub.oauth* services. If you set the value of this property to false, Integration Server allows client applications to use the HTTP GET method to access the pub.oauth* services. The default is true.
If you set the value of this property to true and the client application accesses any of the pub.oauth services using an HTTP method other than POST, Integration Server issues an HTTP 400 error response to the client and writes a service exception to the error log.
Note: To conform to the OAuth 2.0 Authorization Framework, you must set this property to true.
Important: To simplify development, you can set watt.server.oauth.requirePOST to false, but you should require the HTTP POST method in production in accordance with the OAuth Framework.
watt.server.oauth.token.defaultExpirySeconds
Specifies the amount of time (in seconds) that access tokens are valid before expiring. A value of -1 indicates that authorization tokens never expire. The maximum value is 2147483647. The default is 3600.
The value of the watt.server.oauth.token.defaultExpirySeconds parameter is tied to the value of the Access token expiration interval field in the Security > OAuth > Edit OAuth Global Settings page of the Integration Server Administrator. Software AG recommends that you use Integration Server Administrator to set the expiration time for access tokens instead of using watt.server.oauth.token.defaultExpirySeconds. For more information about the Access token expiration interval field, see Configuring OAuth.
watt.server.package.parallel.threads
Specifies the maximum number of threads that you want Integration Server to use when loading IS packages at startup. The threads are from a thread pool that Integration Server uses only at startup and specifically for package loading. If you want Integration Server to load packages sequentially, set the value to 1. If you want Integration Server to load packages in parallel, set the value to 2 or higher. It is recommended that you do not exceed 10. The default value is 6.
Note: If you set watt.server.package.parallel.threads to 0 or a negative number, Integration Server loads packages sequentially.
watt.server.package.pre82WSD.loadExternalResources
Specifies whether, at package load time, Integration Server loads the external resources for a consumer web service descriptor or a WSDL first provider web descriptor created on a pre-8.2 version of Integration Server with the Pre-8.2 compatibility mode property set to true.
When this parameter is set to true, Integration Server resolves all the import and include statements in the source WSDL document and related XML Schema definition files for consumer web service descriptors or WSDL first provider web service descriptors at the package load time.
When this parameter is set to false, Integration Server skips loading the external resources contained in the source WSDL document used to create the web service descriptor. In some environments, setting this parameter to false may speed up the loading of web service descriptors. The default is true.
watt.server.partner
Specifies the IP address or domain name of a hub server. This setting allows the partner server to issue a remote invoke request to a remote Integration Server. Integration Server will ignore a port number if you specify one as part of an IP address.
watt.server.password.minDigits
Specifies the minimum number of digits a password must contain for non-Administrator users. When a non-Administrator user changes a password, he or she must create a password containing at least the number of digits specified by this parameter. If the minimum number of digits is not met, Integration Server sends a warning message to the Administrator user. The default is 1.
watt.server.password.minLength
Specifies the minimum number of characters a password must contain for non-Administrator users. The character length includes upper and lower case alphabetic characters, digits (0-9), and special characters combined. When a non-Administrator user changes a password, he or she must create a password containing at least the number of characters specified by this parameter. If the minimum length is not met, Integration Server sends a warning message to the Administrator user. The default is 8.
watt.server.password.minLowerChars
Specifies the minimum number of lowercase alphabetic characters a password must contain for non-Administrator users. When a non-Administrator user changes a password, he or she must create a password containing at least the number of lowercase characters specified by this parameter. If the minimum is not met, Integration Server sends a warning message to the administrator user. The default is 2.
watt.server.password.minSpecialChars
Specifies the minimum number of special characters, such as asterisk (*), period(.), and question mark(?), a password must contain for non-Administrator users. When a non-Administrator user changes a password, he or she must create a password containing at least the number of special characters specified by this parameter. If the minimum is not met, Integration Server sends a warning message to the Administrator user. The default is 2. The use of special characters is regulated by the following restrictions:
*A password cannot begin with an asterisk (*).
*A password cannot contain quotation marks ("), backslashes (\), ampersands (&), or less-than signs (<).
Use the watt.server.illegalUserChars configuration property to restrict the use of additional characters.
watt.server.password.minUpperChars
Specifies the minimum number of uppercase alphabetic characters a password must contain for non-Administrator users. When a non-Administrator user changes a password, he or she must create a password containing at least the number of uppercase characters specified by this parameter. If the minimum is not met, Integration Server sends a warning message to the Administrator user.
watt.server.password.mode
Specifies whether or not to enforce the password restrictions when setting passwords for administrator or non-administrator users. When set to strict, the password restrictions are enforced and when set to lax, the password restrictions are not enforced. The default is lax.
watt.server.pipeline.processor
Specifies whether to globally enable or disable the Pipeline Debug feature. When set to true, Integration Server checks the Pipeline Debug values for the service at run time. You can view and set the Pipeline Debug values in the Properties view in Designer. When set to false, Integration Server ignores the Pipeline Debug options set for the service in Designer. The default is true.
Enable this property in development environments where testing and debugging is performed. In a production environment, however, disabling this property is recommended.
Important: You must restart Integration Server for the new value to take effect.
watt.server.port
Specifies the port number of the Integration Server's primary port. The default is 5555.
watt.server.portQueue
Specifies the size of the port queue for HTTP and HTTPS ports. The port queue is the number of outstanding inbound connections that are queued in the TCP/IP stack. The default is 65534. If your server runs on AS/400, set this number to 511.
watt.server.publish.local.rejectOOS
Specifies whether Integration Server should reject locally published documents when the queue for the subscribing trigger is at maximum capacity.
When this parameter is set to true, before placing a locally published document into a subscribing trigger's queue, Integration Server first checks the trigger's queue size. If the queue already contains the maximum number of documents allowed by the trigger's Capacity property, Integration Server rejects the locally published document for that trigger queue only.
When this parameter is set to false, Integration Server continues to place locally published documents into a subscribing trigger's queue even when the queue is at capacity. This is the default.
Note: Multiple triggers can subscribe to the same document. Integration Server places the document in any subscribing trigger queue that is not at capacity.
Note: This parameter applies only to documents published locally using the pub.publish:publish or pub.publish.publishAndWait services.
watt.server.publish.useCSQ
Specifies whether Integration Server uses outbound client-side queuing if documents are published when the Broker is unavailable. Set this parameter to always to send published documents to the outbound document store when the Broker is not available. Set this parameter to never to instruct the publishing service to throw a ServiceException when the Broker is not available. The default is always.
watt.server.publish.drainCSQInOrder
If client-side queuing is enabled, this parameter specifies whether Integration Server should empty the outbound document store in publication order or in parallel with newly published documents. When this parameter is set to true, Integration Server sends all newly published documents (guaranteed and volatile) to the outbound document store until the outbound store has been emptied. This allows the Integration Server to maintain publication order. When this parameter is set to false, the outbound store is emptied while new documents are being published to the Broker. The default is true.
Note: This server configuration parameter applies to documents published to Broker only.
watt.server.publish.usePipelineBrokerEvent
Specifies whether Integration Server should bypass encoding that is normally performed when documents are published to the Broker. If this property is set to true, Integration Server checks the pipeline for an object called $brokerEvent. If the object is found and is of type BrokerEvent, Integration Server sends its value to the Broker and no additional encoding is performed. Set this parameter to true if Integration Server is sending native Broker events. The default is false.
For more information about publishing native Broker events, see the Publish-Subscribe Developer’s Guide.
watt.server.publish.validateOnIS
Specifies whether Integration Server validates published documents. Set this parameter to one of the following values:
Specify...
To...
always
Perform document validation for all published documents. This includes instances of publishable document types for which the Validate when published property is set false.
never
Disable document validation for all publishable document types. This includes instances of publishable document types for which the Validate when published property is set true.
Some reasons for disabling document validation include the following:
*You want to improve performance.
*You want to validate the documents manually.
*You know that the system that sent Integration Server the data has already validated the data.
*You prefer to have the messaging provider, rather than Integration Server, validate the documents.
*Integration Server is sending or receiving native Broker events.
perDoc
Perform document validation only for instances of publishable document types for which document validation is enabled. That is, Integration Server validates published documents that are instances of publishable document types for which the Validate when published property is set true.
This is the default behavior.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
For information about handling native Broker events and specifying validation for an individual publishable document type, see the Publish-Subscribe Developer’s Guide.
watt.server.recordTodocument.bufferSize
Specifies the size of the buffer that Integration Server uses to write an XML string when converting a document (IData) to an XML string. Increase the buffer size if the majority of the created XML strings will be greater than 4 KB. Decrease the buffer size if the majority of the created XML strings will be small documents less than 4 KB in size. The default size is 4 KB.
watt.server.remoteInvoke.queryCSRFToken
Indicates if, during a remote service invocation, Integration Server queries the remote server for the CSRF token for the current session and then includes the token in the service request. If an Integration Server uses Cross-Site Request Forgery (CSRF) guard, requests sent to the server must include a CSRF token. If the request does not include a CSRF token, the server rejects the request. When an Integration Server performs a remote invoke to execute a service on another Integration Server that uses CSRF guard, the request needs to include the CSRF token. To ensure that the request includes a CSRF token, the requesting Integration Server obtains the CSRF token for the current session from the remote Integration Server. The requesting Integration Server then modifies the request to include the CSRF token. However, this is only necessary if the remote Integration Server uses CSRF guard. Set the watt.server.remoteInvoke.queryCSRFToken to true if remote Integration Servers use CSRF guard and you want the requesting Integration Server to query for the current CSRF token and include that token in the request. Set to false if the remote Integration Servers does not use CSRF guard. The default is true.
watt.server.requestCerts
Specifies whether the Integration Server requests a digital certificate from clients that connect to it through SSL. Set this parameter to true if you want the server to request certificates. Set it to false if you do not want the server to request certificates. The default is false.
watt.server.RESTDirective
Specifies an alternative word to use for the rest directive in URLs that access resources on Integration Server. By default, this parameter is set as watt.server.RESTDirective=rest, which means users must specify the rest directive as rest (for example, GET http://host:port/rest/resource/resourceID). To allow users to specify the rest directive as either rest or an alternative word, set this parameter to the alternative word. For example, to allow users to specify the rest directive as either rest or process, (GET http://host:port/rest/resource/resourceID) or GET http://host:port/process/resource/resourceID), set this parameter as watt.server.RESTDirective=process.
*If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
*When you restart Integration Server after changing the setting of this parameter, all the URL aliases that point to URL paths containing the previous setting of the parameter and created using the Integration Server Administrator will not work. Therefore, you must edit the URL path for each of the impacted URL aliases from the Integration Server Administrator to include the updated setting of the parameter. This restriction does not apply to the URL aliases created using Software AG Designer.
watt.server.RESTDirective.V2
Specifies an alternative word to use for the restv2 directive in URLs that access resources on Integration Server. By default, this parameter is set as watt.server.RESTDirective=restv2, which means users must specify the rest directive as restv2 (for example, GET http://host:port/restv2/resource/resourceID). To allow users to specify the rest directive as either restv2 or an alternative word, set this parameter to the alternative word. For example, to allow users to specify the directive as either restv2 or process, (GET http://host:port/restv2/resource/resourceID) or GET http://host:port/process/resource/resourceID), set this parameter as watt.server.RESTDirective.V2=process.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.response.displayISErrorCode
Indicates whether the HTTP response from Integration Server to a client application in the case of an error situation includes the Integration Server error code in the header and the body of the response.
If you set the value of this parameter to false, the HTTP response during error situations includes the error message text without the Integration Server error code in both the header and the body of the response. If you set the value to true, the HTTP response during error situations includes the Integration Server error code and the corresponding error message text in the header and body of the response. The default value of the parameter is true.
watt.server.revInvoke.proxyMapUserCerts
For webMethods Enterprise Gateway only. Specifies whether an Enterprise Gateway Server is to perform client authentication itself in addition to passing authentication information to the Internal Server for processing. The default is false. If this property is set to true, Enterprise Gateway Server will reject all anonymous requests (no certificate and no username/password supplied), even if the request is for an unprotected service on the Internal Server. See Configuring webMethods Enterprise Gateway for more information.
watt.server.rg.internalregistration.timeout
For webMethods Enterprise Gateway configuration only. Set this value on the Internal Server to specify the time (in seconds) the Internal Server will wait before closing an unresponsive connection to the Enterprise Gateway Server. The default is 0, which means the Internal Server will not time out (a timeout period of infinity).
Important: Set the value of watt.server.rg.internalregistration.timeout on the Internal Server to a value greater than the ping values defined by the watt.net.socketpool.sweeperInterval server configuration parameter on the Enterprise Gateway Server. Setting watt.server.rg.internalregistration.timeout to a value that is lower than watt.net.socketpool.sweeperInterval will cause the Internal Server to close the connection to the Enterprise Gateway Server and re-establish a new connection regularly.
watt.server.rg.internalsocket.timeout
Specifies the length of time, in milliseconds, that Enterprise Gateway Server allows a client request to wait for a connection to the Internal Server before terminating the request with an HTTP 500 Internal Server Error. If a connection to the Internal Server becomes available within the specified timeout period, Enterprise Gateway Server forwards the request to the Internal Server. If a connection does not become available before the timeout elapses, Enterprise Gateway Server returns a HTTP 500-Internal Server Error to the requesting client and writes the following message to the error log:
"Enterprise Gateway port {port_number} is unable to forward the request to Internal Server because there are no Internal Server connections available."
The default value of this parameter is 0 which means that the client request waits indefinitely for a connection to the Internal Server.
watt.server.scheduler.deleteCompletedTasks
Specifies whether or not scheduled tasks that have expired should be automatically deleted. When set to true, Integration Server deletes expired tasks when they expire. Set this parameter to false if you want Integration Server to wait until the next server restart to delete expired tasks. The default is true.
watt.server.scheduler.ignoreReferenceValidationErrors
Specifies whether Integration Server creates or executes a scheduled task if the scheduled service has a broken reference. Set the property to true to indicate that Integration Server ignores broken references for the scheduled service when executing a scheduled task. Set it to false to indicate that Integration Server should not execute a scheduled task if the scheduled service has one or more broken references. The default is false.
watt.server.scheduler.logical.hostname
Specifies a unique logical name to identify Integration Server instances in a cluster hosted on a single machine. By default, Integration Server uses the host name to identify itself while scheduling tasks. However, when a cluster of Integration Servers are hosted on a single machine, the host name itself cannot uniquely identify the individual Integration Server instances. In such cases, use the watt.server.scheduler.logical.hostname property to specify a unique logical name to identify individual Integration Server instances.
The default value for this parameter is the host name.
Keep the following points in mind when setting the watt.server.scheduler.logical.hostname property:
*Set this property only if you are running multiple Integration Servers in a cluster on a single machine.
*Set this property on each Integration Server instance in the cluster before scheduling any tasks.
*The logical host name you specify must be unique.
*The logical host name you specify cannot contain a semicolon (;).
This property is also useful when Integration Server is installed on a virtual server whose host name or IP address might change over time. You can use watt.server.scheduler.logical.hostname to provide a fixed value that identifies each server in a cluster.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.scheduler.maxWait
Maximum time in seconds Integration Server waits between queries of the task queue. The server periodically checks the queue for tasks that are scheduled to run. If there are no tasks waiting to run, the server waits the maxWait time before checking the queue again. If there are tasks waiting to run, the server checks again at the task's schedule execution time, or after the maxWait time, whichever is earlier. For example, if the pending task is due to execute in 30 seconds and the maxWait time is 60, the server will check the queue again in 30 seconds. The default is 60.
Note: You must ensure that the value you specify for this parameter must be less than the minimum time interval set for a scheduled task.
If you run a cluster of Integration Servers and schedule a task to run on all servers in the cluster, you might notice tasks starting at different times on the different servers if the servers have different settings for this property. For this reason, if you are running in a clustered environment, all the servers in your cluster should have the same settings for this property. See the webMethods Integration Server Clustering Guide for more information about configuring Integration Servers in a cluster.
watt.server.scheduler.threadThrottle
Percentage of Integration Server threads the scheduler process is permitted to use. The default is 75%.
watt.server.serverlogFilesToKeep
Specifies the number of server log files that Integration Server keeps on the file system, including the current server log file. When Integration Server reaches the limit for the number of server log files, Integration Server deletes the oldest archived server log file each time Integration Server rotates the server log. If you set watt.server.log.filesToKeep to 1, Integration Server keeps the current server.log file and no previous server.log files. When Integration Server rotates the server.log, Integration Server does not create an archive file for the previous server log. If you set watt.server.log.filesToKeep to 0, or any value less than 1, Integration Server keeps an unlimited number of server log files.
The default value of watt.server.log.filesToKeep is -1, indicating that there is no limit to the number of server log files that Integration Server maintains.
For more information about setting the maximum number of server log files that Integration Server keeps, see Setting Up the Server Log.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.serverlogRotateSize
Specifies the file size at which Integration Server rolls over the server.log file. Set this property to N[KB|MB|GB], where N is any valid integer. The minimum size at which Integration Server rotates the server.log file is 33KB. If you use KB as the unit of measure, you must set N to a value greater than or equal to 33. If you do not specify a unit of measure, Integration Server treats the supplied N value as bytes. In this case, N must be greater than or equal to 32768 to take effect. Do not include any spaces between the integer and the unit of measure.
There is no default value for this parameter. That is, by default, the parameter has no value. If no value is specified for watt.server.serverlogRotateSize, Integration Server rotates the server.log file at midnight only.
If an invalid value is specified, Integration Server resets the parameter to -1. Note that a value of -1 results in the same behavior as specifying no value for the parameter.
For more information about the server.log, see Setting Up the Server Log.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.serverlogQueueSize
Controls the number of entries allowed in the server log queue. This property is related to the watt.server.log.queued property, which controls whether the server is to write entries directly to the server log, or queue them in memory first and then use a background thread to write them to the server log. If your configuration has the watt.server.log.queued property set to true and you notice that expected server log entries are not included in the log, try increasing the queue size. For more information about the server log and the server log queue, see Specifying Whether to Queue Server Log Entries. The default queue size is 8192.
watt.server.serverclassloadername
This is an internal property. Do not modify.
watt.server.service.lazyEval
Controls whether Integration Server initializes Java services during startup. When set to true (the default), Integration Server does not initialize Java Services until they are referenced during runtime. This can increase performance if the server initializes a lot of Java Services at start up.
watt.server.serviceMail
Specifies the email address to which Integration Server sends messages about service failures. There is no default.
When you specify an email address on this parameter, Integration Server creates a simple scheduled task to perform the notification. This task requires a thread, which Integration Server takes from the cronjob-based thread pool. See the watt.server.cron.maxThreads and watt.server.cron.minThreads parameters for more information about this thread pool.
watt.server.serviceResults.cache
Specifies the name of the public cache to use for service results caching. If no value is specified for the watt.server.serviceResults.cache parameter, Integration Server uses the ServiceResults cache in the cache manager specified in the watt.server.serviceResults.cacheManager parameter as the service results cache. If the cache manager in the watt.server.serviceResults.cacheManager parameter does not contain a cache named ServiceResults, Integration Server throws an error at start up and does not cache service results.
Note: To use the ServiceResults system cache located in the SoftwareAG.IS.Services system cache manager as the service results cache, do not specify a value for watt.server.serviceResults.cache or watt.server.serviceResults.cacheManager.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.serviceResults.cacheManager
Specifies the name of the public cache manager that contains the public cache to use for service results caching. If no value is specified for this parameter, Integration Server uses the SoftwareAG.IS.Services system cache manager as the service results cache manager. If the SoftwareAG.IS.Services system cache does not contain a cache with a name that matches the value of the watt.server.serviceResults cache, Integration Server throws an error at startup and does not cache service results.
Note: To use the ServiceResults system cache located in the SoftwareAG.IS.Services system cache manager as the service results cache, do not specify a value for watt.server.serviceResults.cache or watt.server.serviceResults.cacheManager.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.serviceResults.copyOnRead
Specifies how the cache should copy elements that it returns. The default value true returns the results by value, while the value false returns results by reference.
watt.server.serviceResults.copyOnWrite
Specifies how the cache should copy elements that it writes. The default value true returns the results by value, while the value false returns results by reference.
watt.server.serviceUsageDSP.RefreshInterval
Specifies the interval, measured in seconds, that elapses before Integration Server Administrator refreshes the data on the Server > Statistics page. The default is 90 seconds. The change to the parameter takes effect the next time the Server > Statistic page is reloaded.
watt.server.session.locale.ignore
Specifies whether the default locale for the pub.date* services is the server locale or the locale from the session used by the client that invoked the service. When set to true, when executing a pub.date* service for which a locale input parameter value is not specified, Integration Server uses the server locale as the value of the locale parameter. When set to false, when executing a pub.date* service for which a locale input parameter value is not specified, Integration Server uses the locale from the session used by the client that invoked the service. The default is false.
watt.server.session.stateful.enableLimit
Controls whether the stateful session limit feature is enabled. When this property is set to true, Integration Server allows stateful sessions to be created as needed until it reaches the maximum allowed, which is specified by the watt.server.session.stateful.max property. You can view statistics for stateful sessions on the Server > Statistics screen in Integration Server Administrator.
watt.server.session.stateful.max
Specifies the number of concurrent stateful sessions allowed on the Integration Server. If a user attempts to access the server and execute a stateful service while the maximum number of stateful sessions are in use, the server rejects the request and returns an error to the user.
The value for watt.server.session.stateful.max must be a positive integer. If a value is not specified or the watt.server.session.stateful.enableLimit property is set to false, the maximum number of concurrent sessions is defined by your Integration Server license.
Note: It is recommended that you use the Maximum Stateful Sessions field in the Edit Resource Settings page of the Integration Server Administrator to set the maximum value. For more information about setting a maximum limit for stateful sessions, see Managing Server Sessions.
watt.server.session.stateful.warning
Specifies the threshold at which Integration Server starts to warn of insufficient available stateful sessions. When the percentage of available stateful sessions is equal to or less than the value of this property, Integration Server generates a server log message stating:
The default is 25%.
Note: It is recommended that you use the Enable Stateful Session Limit field in the Edit Resource Settings page of the Integration Server Administrator to set the threshold value. For more information about setting an available stateful sessions warning threshold, see Managing Server Sessions.
watt.server.setResponse.pre82Mode
Specifies the order in which the pub.flow:setResponse service looks for and uses the deprecated input parameters when neither of the input parameters responseString or responseBytes are provided.
When set to true, the pub.flow:setResponse service follows a precedence order similar to what was available in Integration Server 7.1x and 8.0x. Specifically, the service looks for the deprecated parameters in the following order and uses the value of the first parameter that it finds: response, string, bytes
When set to false, the pub.flow:setResponseservice follows a precedence order similar to what was available in Integration Server 8.2 and later. Specifically, the service looks for the deprecated parameters in the following order and uses the value of the first parameter that it finds: string, bytes, response
The default is false.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.sftp.dateStampFmt
Specifies the format of date to be used in the SFTP client public services, specifically the pub.client.sftp* services in the WmPublic package. To specify the date format to use, you can use any format that is supported by the Java class java.text.SimpleDateFormat. For example, to display the date with the format 08-12-02 14:44:33:1235, specify dd-MM-yy HH:mm:ss:SSSS. The default format for watt.server.sftp.dateStampFmt property is yyyy-MM-dd HH:mm:ss z.
watt.server.smtpServer
Specifies the SMTP server to use for server error logging and service error email notification. There is no default.
watt.server.smtpServerPort
Specifies the number of the listening port on the SMTP server to which the Integration Server is to send server error logging and service error email notification. The default is 25.
watt.server.smtpTransportSecurity
Specifies the type of SSL encryption that Integration Server uses when communicating with an SMTP server.
Set this property to any one of the following values:
When set to...
Integration Server...
None
Uses a non-secure mode when communicating with an SMTP server.
When you specify None, the SMTP server authenticates the SMTP client using only the username and password.
Explicit
Uses explicit security when communicating with an SMTP server. With explicit security, Integration Server establishes an un-encrypted connection to the SMTP server and then upgrades to the secure mode.
Implicit
Uses implicit security when communicating with an SMTP server. With implicit security, Integration Server always establishes an encrypted connection to the SMTP server. Only clients that support SSL will be permitted access.
watt.server.smtpTrustStoreAlias
Specifies the alias for the truststore that contains the list of certificates that Integration Server uses to validate the trust relationship between Integration Server and the SMTP server. If you do not specify a truststore alias, the default truststore alias specified in the watt.security.trustStoreAlias property will be used. For more information about truststore alias, see Creating Truststore Aliases.
watt.server.SOAP.addEmptyHeader
Specifies whether Integration Server should create an empty header entry in the SOAP message created by executing the pub.soap.utils:createSoapData or pub.soap.utils:stringToSoapData services. When this property is set to true, Integration Server creates an empty header in the SOAP message. When this property is set to false, Integration Server does not create a header entry in the SOAP message. The default is true.
The addEmptyHeader parameter in the pub.soap.utils:createSoapData or pub.soap.utils:stringToSoapData services, if set, overrides the watt.server.SOAP.addEmptyHeader setting.
For more information about pub.soap.utils:createSoapData and pub.soap.utils:stringToSoapData services, see webMethods Integration Server Built-In Services Reference.
watt.server.SOAP.completeLoad
Specifies whether the XML node added by pub.utils:addBodyEntry, pub.utils:addHeaderEntry, pub.utils:addTrailer will be completely loaded before adding to the SOAP message. When set to true, Integration Server loads the entire XML node. When set to false, Integration Server does not completely load the XML node before adding it to the service. The default is true.
watt.server.soap.convertPlainTextHTTPResponseIntoSOAPFault
Specifies how Integration Server returns the response from a web service invocation when it is acting as a client and the web service results in a plain text HTTP response. This parameter applies only when the web service connector was created using:
*Integration Server version 8.2 or later, but the web service descriptor’s Pre-8.2 compatibility mode property is true
*A version of Integration Server prior to version 8.2
When the watt.server.soap.convertPlainTextHTTPResponseIntoSOAPFault parameter is set to true (the default), Integration Server converts the plain text HTTP response and returns the information from the HTTP response within web service connector's output parameters.
*If the web service connector was created using Integration Server version 8.2 or later and the Pre-8.2 compatibility mode property is true, Integration Server returns the converted HTTP payload in the web service connector’s fault/reasons output parameter.
*If the web service connector was creating using a version of Integration Server prior to version 8.2, Integration Server returns the converted HTTP payload in one of the following based on the SOAP protocol in use:
*SOAP-FAULT/Fault_1_1/faultstring
*SOAP-FAULT/Fault_1_2/SOAP-ENV:Reason/SOAP-ENV:Text
Having the plain text HTTP response converted and returned in the web service connector’s output parameter can be helpful because it might contain the cause of the exception.
If you set the parameter to false, when the web service results in a plain text HTTP response, Integration Server throws an exception indicating that an invalid SOAP envelope is received.
Important: After updating this parameter, you must restart Integration Server for changes to this parameter to take effect.
watt.server.soap.decodeElementWithPrefix
Specifies whether Integration Server recognizes document types that have defined XML namespace URIs but do not have prefixes associated with each namespace. By default, in Integration Server version 8.2 SP2 and higher, if document types that have a defined XML namespace URI but do not have a prefix associated with each namespace are specified as inputs to services, the SOAP processor fails to recognize the document types at run time. If the watt.server.soap.decodeElementWithPrefix property is set to true, Integration Server recognizes the document types that have defined XML namespaces but do not have prefixes associated with each namespace.
The default is false.
The watt.server.soap.decodeElementWithPrefix server configuration parameter value affects how Integration Server decodes inbound SOAP messages for web service descriptors created on Integration Server version 7.1.x. Specifically, the parameter affects how Integration Server decodes SOAP response messages received by a 7.1.x web service connector and SOAP request messages received by a 7.1.x web service provider.
*When watt.server.soap.decodeElementWithPrefix is set to true, when decoding an inbound SOAP message, Integration Server does not consider namespace and/or prefix declarations when decoding the SOAP message to IData for any web service or web service connector that is part of a web service descriptor created in 7.1.x. Integration Server will map namespace qualified elements in the XML string to fields in an IS document type even if the field names do not include a prefix. That is, when the parameter is set to true Integration Server uses the decoding behavior available in version 7.1.x. for any web service or web service connector that is part of a web service descriptor created in Integration Server 7.1.x.
Note: The Integration Server 7.1.x decoding behavior described above is invalid. However, the stricter decoding process in Integration Server 8.2 and later can result in missing or extraneous fields which, in turn, results in validation errors. Setting the watt.server.soap.decodeElementWithPrefix to true allows the 7.1.x behavior and does not require changes to the 7.1.x web service descriptors.
*When watt.server.soap.decodeElementWithPrefix is set to false, when decoding an inbound SOAP message, Integration Server considers namespace and/or prefix declarations when decoding a SOAP message to IData for any web service or web service connector that is part of a web service descriptor created in Integration Server 7.1.x. Integration Server does not map namespace qualified elements in the XML string to fields in an IS document type if the field names do not include a prefix. That is, when the parameter is set to false, Integration Server uses the decoding behavior available in version 8.2 SP2 and later for any web service or web service connector that is part of a web service descriptor created in Integration Server 7.1.x and later.
Note: For web service descriptors created in Integration Server 8.2 SP2 onwards, you must associate a prefix with an XML namespace URI for fields in the service signature.
The watt.server.soap.decodeElementWithPrefix server configuration parameter also determines whether or not the pub.xml.xmlNodeToDocument service considers namespace and/or prefix declarations when decoding namespace qualified elements to corresponding fields in an IS document type.
*When watt.server.soap.decodeElementWithPrefix is set to true, the pub.xml:xmlNodeToDocumentservice does not consider namespace and/or prefix declarations. The service will map namespace qualified elements in the XML string to fields in an IS document type even if the field names do not include a prefix. Note that this behavior is considered invalid but is allowed to provide backward compatibility with services developed on earlier versions of Integration Server.
*When watt.server.soap.decodeElementWithPrefix is set to false, the pub.xml:xmlNodeToDocument service considers namespace and/or prefix declarations. The service does not map namespace qualified elements in the XML input to fields in an IS document type if the field names do not include a prefix. The pub.xml:xmlNodeToDocument service does not populate non-prefixed fields. Instead the service adds new fields that use the prefix:name structure and populates those fields with values from the XML instance.
Important: After updating the watt.server.soap.decodeElementWithPrefix parameter, you must restart Integration Server for changes to the parameter to take effect.
watt.server.SOAP.default.endpointHTTP
Specifies the default provider web service endpoint alias for the HTTP protocol. If the value of this parameter is empty, there is no default provider web service endpoint alias for HTTP.
There is no default value for this parameter.
The watt.server.SOAP.default.endpointHTTP parameter displays the value specified in the HTTP parameter on the Settings > Web Services > Set Default Provider Endpoint Aliases screen in Integration Server Administrator. Software AG recommends that you specify the default provider endpoint alias using the HTTP parameter on the Settings > Web Services > Set Default Provider Endpoint Aliases screen instead of by changing the value of the watt.server.SOAP.default.endpointHTTP parameter. For more information about setting a default provider endpoint alias, see Setting a Default Endpoint Alias for Provider Web Service Descriptors.
watt.server.SOAP.default.endpointHTTPS
Specifies the default provider web service endpoint alias for the HTTPS protocol. If the value of this parameter is empty, there is no default provider web service endpoint alias for HTTPS.
There is no default value for this parameter.
The watt.server.SOAP.default.endpointHTTPS parameter displays the value specified in the HTTPS parameter on the Settings > Web Services > Set Default Provider Endpoint Aliases screen in Integration Server Administrator. Software AG recommends that you specify the default provider endpoint alias using the HTTPS parameter on the Settings > Web Services > Set Default Provider Endpoint Aliases screen instead of by changing the value of the watt.server.SOAP.default.endpointHTTPS parameter. For more information about setting a default provider endpoint alias, see Setting a Default Endpoint Alias for Provider Web Service Descriptors.
watt.server.SOAP.defaultProtocol
Specifies the default protocol that Integration Server uses for new SOAP messages. Specify SOAP 1.1 Protocol or SOAP 1.2 Protocol. The default is SOAP 1.1 Protocol.
watt.server.SOAP.directive
Specifies a different word to use for the SOAP directive in URLs that route requests to the Integration Server SOAP handler. By default, this parameter is set as watt.server.SOAP.directory=soap, which means users must specify the SOAP directive as soap (http://host:port/soap). To allow users to specify the SOAP directive as a different word instead, set this parameter to that word. For example, to allow users to specify the SOAP directive as endpoint, (http://host:port/endpoint), set this parameter as watt.server.SOAP.directive=endpoint.
watt.server.SOAP.encodeXSIType
Indicates where the xsi:type will appear as an attribute for an element in a SOAP message that specifies RPC/Encoded. A value of true indicates that Integration Server includes the xsi:type attribute for an element. False indicates that the xsi:type attribute will be omitted. The default is true. Software AG recommends using a value of true for this parameter.
watt.server.SOAP.encodeXSITypeValue
Indicates whether Integration Server should include the xsi:type attribute and its value for an element of xsd:anyType in SOAP requests and responses. When set to false, Integration Server omits the xsi:type attribute and its value for an element of xsd:anyType in SOAP requests and responses. When set to true, Integration Server includes the xsi:type attribute and its value for an element of xsd:anyType in SOAP requests and responses. The default is true.
Note: The watt.server.SOAP.encodeXSITypeValue server configuration parameter affects only those SOAP requests and responses created by Integration Server.
watt.server.SOAP.generateNilTags
Specifies whether or not Integration Server generates an xsi:nil attribute for an element in a SOAP message. When set to true, Integration Server generates an xsi:nil attribute for an element that is nillable (the Allow null property for the corresponding field is set to true) and the field is null at run time. When watt.server.SOAP.generateNilTags is set to false, Integration Server omits the xsi:nil attribute for an element even if the corresponding field is nillable and the field is null at run time. The default is true.
watt.server.SOAP.generateRequiredTags
Specifies whether or not a SOAP message generated by Integration Server includes empty element tags for required parameters for which a value was not supplied at run time. When set to true, Integration Server generates empty element tags for required parameters for which a value is not specified. When watt.server.SOAP.generateRequiredTags is set to false, Integration Server omits empty element tags for required parameters for which a value is not specified. The default is true.
watt.server.SOAP.hideEPRHostInFault
Hides the endpoint reference host name and IP address details in the SOAP fault. When this parameter is set to true, Integration Server replaces the host name and IP address with *:* in the SOAP fault. When this parameter is set to false, Integration Server includes the host name and IP address details of the endpoint reference in the SOAP fault. The default is false.
Note: This parameter applies only when the Pre-8.2 compatibility mode property of the web service descriptor is set to false.
watt.server.SOAP.HTTP.useMailWriter
Configures the Axis stack to use an alternate multipart writer implementation based on the JavaMail API. Changing the multipart writer implementation used by Axis allows Mediator to handle non-ASCII characters in SOAP XML requests with multipart attachments. Set to true to configure the AXIS stack to use the alternate multipart writer implementation. The default value is false.
Note: The alternate multipart writer implementation based on JavaMail relies on undocumented behavior of an Axiom Writer implementation.
watt.server.SOAP.ignoreMissingResponseHeader
Determines whether missing required headers in a SOAP response results in an error. When set to true, a SOAP response that does not contain a required header will not result in an error. When set to false, a SOAP response that does not contain a required header results in an error. The default is false.
Note that all headers in a web service descriptor, whether generated from the original WSDL document or added to the web service descriptor, are treated as required. This is an application of the WS-I basic profile rules declaring that all headers in a WSDL be treated as required. Prior to Integration Server version 9.0, when processing a SOAP response received by a web service descriptor, Integration Server did not properly validate that all of the SOAP headers were present. As a result, Integration Server did not throw an error when a SOAP response was missing a SOAP header. Beginning in Integration Server version 9.0, Integration Server properly validates SOAP responses for required headers. If a required header is not present, Integration Server throws the following error: “[ISS.0088.9443] One or more required Headers <headerName> are not present in the SOAP response.” While failure when a required header is missing is the correct behavior, Integration Server provides a configuration property to control whether missing required headers in a SOAP response results in an error. This can be useful in migration situations.
watt.server.SOAP.MTOMStreaming.cachedFiles.location
Specifies the absolute path to the hard disk drive space that Integration Server uses to temporarily store inbound SOAP messages when performing MTOM streaming. This parameter takes effect only when MTOM streaming is enabled (i.e., watt.server.SOAP.MTOMStreaming.enable is set to true).
You can specify a directory on the same machine as the Integration Server or in any other location accessible to Integration Server, such as a mapped logical drive or network directory. The default value is Integration Server_directory \instances\instance_name\temp\mtom\cached files.
Note: If your Integration Server is in a clustered environment, you must set this property in all the servers in the cluster. See webMethods Integration Server Clustering Guide for more information about configuring Integration Server in a cluster.
watt.server.SOAP.MTOMStreaming.enable
Indicates whether MTOM streaming is enabled for inbound SOAP messages and whether HTTP chunking is enabled for outbound requests. Set this property to true to enable MTOM streaming for inbound SOAP messages and HTTP chunking for outbound requests. Set this property to false to disable MTOM streaming and HTTP chunking. The default is false.
watt.server.SOAP.MTOMStreaming.threshold
Specifies the maximum number of bytes for Integration Server to handle an inbound MTOM attachment field as an in-memory ByteStream. Integration Server writes an inbound MTOM attachment field exceeding this size to a temporary disk file and processes the inbound MTOM Streams as a FileStream. This parameter takes effect only when MTOM streaming is enabled (watt.server.SOAP.MTOMStreaming.enable is set to true). The default is 4000 bytes.
The watt.server.SOAP.MTOMStreaming.cachedFiles.location value determines the location of the temporary disk files.
watt.server.SOAP.MTOMThreshold
Specifies the field size, in kilobytes, that determines whether Integration Server handles base64binary encoded data in an outbound SOAP request as a MIME attachment or whether it sends it inline in the SOAP message. If the web service descriptor for the SOAP message enables attachments for the SOAP request, Integration Server passes as MIME attachments any base64 fields in a SOAP message that are larger than the threshold. The default is 0.
watt.server.SOAP.pre82WSD.ignoreVersionMismatch
For a web service provider that was created in an Integration Server release earlier than 8.2.2 and for which the Pre-8.2 compatibility mode property is set to true, specifies whether to emulate pre-8.2 behavior for process SOAP requests. In Integration Server 7.1.3, Integration Server allowed web service providers to process SOAP requests with a SOAP version that did not match the SOAP version that was declared in the WSDL binding. When set to true, this property provides backward compatibility so that consumers do not have to update their SOAP requests.
When set to false, Integration Server uses stricter validation that does not allow processing when this mismatch exists. The default value is false.
Changes to this property take effect immediately.
watt.server.SOAP.request.timeout
Specifies the length of time, in seconds, Integration Server will wait for the SOAP response from the server hosting the remote procedure. If Integration Server does not receive a response in the allotted time, it terminates the request. The default value is -1, which indicates that Integration Server will use the value set for the watt.net.timeout property.
watt.server.SOAP.setNamespaceURIsToRoot
Specifies how Integration Server declares XML namespaces in a SOAP response. When the watt.server.SOAP.setNamespaceURIsToRoot property is set to true, Integration Server declares the namespace and prefix once at the root element of the SOAP response and then uses the prefix for each element in the response. When set to false, Integration Server declares the namespace the way it is defined in the original document, either defining each element explicitly with the full namespace or declaring the namespace and prefix just once at the root element. The default value for this property is false.
watt.server.SOAP.streamHandlers
Specifies the custom SOAP handlers that expect stream inputs. Enter the SOAP handlers as a semi-colon (;) separated list. There is no default.
watt.server.SOAP.treatNilAsNull
Indicates whether or not Integration Server, when decoding a SOAP message, generates an @xsi:nil field for an element for which the xsi:nil attribute is set to true. When set to true, Integration Server treats an element that carries the xsi:nil attribute as a null value and does not create an @xsi:nil attribute for the element. When this parameter is set to false, Integration Server generates an @xsi:nil field for an element that carries the xsi:nil=true attribute. This configuration parameter affects all web services running on Integration Server. The default is true.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.SOAP.useMultiReference
For elements that appear in multiple places in a SOAP message, specifies whether Integration Server serializes each occurrence of the element or serializes it in on only one place and uses the href attribute in the other locations. When set to true, Integration Server serializes one location and uses the href attribute in other locations. This parameter applies to RPC/Encoded web services only. The default is true.
watt.server.SOAP.useStringforAnyTypewithSimpleValue
Specifies how Integration Server decodes an xsd:anyType element with simple content in SOAP responses. When set to false, Integration Server decodes xsd:anyType elements with simple content into an IData with an @xsi:type field to retain the xsi:type value and a *body field to contain the element value. This is the default behavior.
When the watt.server.SOAP.useStringforAnyTypewithSimpleValue server configuration parameter is set to true, Integration Server decodes xsd:anyType elements with simple content into a String type field that contains the element value. The element's xsi:type information will be gone. You do not have to restart Integration Server for the change to take effect.
watt.server.soap.validateResponse
Enables or disables SOAP response validation. When set to true, Integration Server validates the SOAP response received by a web service connector. When set to false, Integration Server does not validate the received SOAP response. The default is true.
watt.server.SOAP.validateSOAPMessage
When Integration Server acts as the web service provider, indicates whether Integration Server validates inbound SOAP requests and outbound SOAP responses. When set to true, Integration Server validates inbound SOAP requests and outbound SOAP responses against the SOAP schema. Be aware that the validation process checks only that the message envelope is structured correctly. For example, Integration Server checks that the message has at least one body element and there is at most one header element. Integration Server does not validate any of the data carried by the message. The default is true.
If you are operating in a production environment where the validity of the messages submitted to the server is assured, you might set watt.server.SOAP.validateSOAPMessage to false to optimize performance.
watt.server.SOAP.warnOnPartValidation
When creating a web service descriptor from a WSDL document, indicates whether Integration Server should treat message parts that are defined by the type attribute instead of the element attribute as a warning and not an error. Set this parameter to true to indicate that Integration Server should return a warning and allow the web service descriptor to be created. Set this parameter to false to indicate that Integration Server should return an error and not allow the web service descriptor to be created. The default is false.
watt.server.soapJMS.defaultMessageType
Specifies the default message type for web service request messages sent using SOAP over JMS. Set this parameter to "BytesMessage" to send a message whose body contains a stream of uninterrupted bytes. Set this parameter to "TextMessage" to send a message whose body contains a Java string. BytesMessage is considered to be a more efficient way of sending JMS messages. However, you may want to set the parameter to TextMessage for debugging purposes because the resulting messages will be in a human-readable format. Keep in mind that the message type of the request message determines the message type of the response message. The default is BytesMessage.
Important: You must restart Integration Server for changes to this parameter to take effect.
Note: The default message type can be overwritten during web service connector execution by setting the jms.messageType property in the transportHeaders input parameter.
Note: If you set this parameter to TextMessage, Integration Server sends all web service responses as TextMessage. If the request message is a BytesMessage and watt.server.soapJMS.defaultMessageType is set to TextMessage, Integration Server overrides the request message type and sends the response as a TextMessage. This can be useful in debugging situations.
watt.server.soapjms.request.timeout
Specifies the number of seconds that Integration Server waits for a response to a SOAP request sent using SOAP over JMS. This value must be an integer greater than or equal to zero. A value of 0 indicates that Integration Server will wait indefinitely for a response. The default is 10 seconds.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.SoapRPC.checkHeaders
Indicates whether Integration Server should check SOAP headers for SOAP RPC requests. The default is true.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.SoapRPC.distinguishDuplicateElements
Indicates whether Integration Server should differentiate identically named arrays in the SOAP response for a SOAP/RPC web service. When set to true, Integration Server appends a number to the xsi:type value to distinguish between identically named array elements in the SOAP response, for example elementName and elementName1. When set to false, Integration Server does not differentiate identically named arrays in the SOAP response. The default is true.
watt.server.SoapRPC.useSecondaryType
Instructs Integration Server to use a second type definition when creating the SOAP response for a service whose input or output signatures contain identically named variables of different types. When creating a WSDL from a provider web service descriptor that contains a service with identically named fields of different types, Integration Server renames the second instance of the field type in the WSDL. At run time, for RPC-Encoded SOAP binding, Integration Server encodes the types in the SOAP response. When this property is set to true, the SOAP response refers to the renamed type definition. When set to false, the SOAP response refers to the original type definition instead of the renamed one. The default is false. This property is applicable to RPC-Encoded SOAP binding only.
watt.server.ssl.keyStoreAlias
Name of the keystore alias for the Integration Server keystore that contains the information needed to establish an SSL connection with an SSL-enabled external server. There is no default value for this parameter. For more information about storing keystore information for an SSL connection to an external server, see Storing SSL Information for the Integration Server JVM in a Secure Manner.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.ssl.trustStoreAlias
Name of the truststore alias for the Integration Server truststore that contains the information needed to establish an SSL connection an SSL-enabled external server. There is no default value for this parameter. For more information about storing truststore information for an SSL connection to a an external server, see Storing SSL Information for the Integration Server JVM in a Secure Manner.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.stats.avgTime
Specifies the time period (in seconds) for which performance metrics are averaged. The default is 10.
watt.server.stats.logfile
Specifies the name of the file to receive statistics. The file contains the data that appears on the Server > Statistics page. The default file name is logs\stats.log.
watt.server.stats.logFilesToKeep
Specifies the number of stats.log files that Integration Server keeps on the file system, including the current log file. When Integration Server reaches the limit for the number of stats.log files, each time Integration Server rotates the stats.log, Integration Server deletes the oldest archived stats.log file. If you set watt.server.stats.logFilesToKeep to 1, Integration Server keeps the current stats.log file and no previous stats.log files. That is, when Integration Server rotates the stats.log, Integration Server does not create an archive file for the previous stats.log. If you set watt.server.stats.logFilesToKeep to 0, or any value less than 1, Integration Server keeps an unlimited number of stats.log files. The default value of watt.server.stats.log.filesToKeep is 0.
If you reduce the number of stats.log files that Integration Server keeps and then restart Integration Server, the existing logs will not be pruned until Integration Server rotates the stats.log.
Integration Server uses the following naming format for the archived stats.log files: stats.yyymmdd_hhmmss.log where the timestamp indicates the time at which Integration Server archived the log file
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.stats.logRotateSize
Specifies the file size at which Integration Server rolls over the stats.log. Set this property to N[KB|MB|GB], where N is any valid integer. The minimum size at which Integration Server rotates a stats.log is 33KB. If you use KB as the unit of measure, you must set N to a value greater than or equal to 33. If you do not specify a unit of measure, Integration Server treats the supplied N value as bytes. In this case, N must be greater than or equal to 32768 to take effect. Do not include any spaces between the integer and the unit of measure. If an invalid value is specified, Integration Server proceeds as if no value was specified for the parameter. If you set the value using the Extended Settings page in Integration Server Administrator, validation prevents an invalid value from being saved.
There is no default value for this parameter. That is, by default, the parameter has no value. If no value is specified for watt.server.stats.logRotateSize, Integration Server rotates the stats.log at the interval specified by watt.server.statsLogRotateInterval only.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.stats.pollTime
Specifies the number of seconds between updates of statistics loggings. For a stand-alone Integration Server, the watt.server.stats.pollTime must be an integer greater than or equal to 0 (zero). For an Integration Server in a cluster, the watt.server.stats.pollTime must be an integer greater than 0 (zero) but less than or equal to 60. The default is 60.
Integration Server Administrator displays this value as the interval of the Statistics Log task on the Server > Scheduler > View System Tasks page.
watt.server.statsLogRotateInterval
Specifies the length of the log recycle interval (in minutes) for the stats.log file. The recycle interval is the period of time that Integration Server retains statistics log records. The default is 1440 (24 hours).
Integration Server Administrator displays the watt.server.statsLogRotateInterval value as the interval for the Stats Log Recycle task on the Server > Scheduler > View System Tasks page. Integration Server Administrator displays this value in seconds instead of minutes. For example, if you set watt.server.statsLogRotateInterval to the default value of 1440, Integration Server Administrator displays the value for the Log Recycle interval as 86400 seconds. For more information about viewing system tasks, see Viewing Scheduled User Tasks.
After Integration Server startup, Integration Server immediately begins rotating the stats.log at the time specified by the watt.server.statsLogRotateInterval. If you set watt.server.statsLogRotateInterval to 2 minutes and Integration Server started at 9:30 pm, Integration Server rotates the stats.log at 9:32, 9:34, 9:36, and so forth. An exception to this behavior is that when the log recycle time is greater than the time from Integration Server startup to midnight, Integration Server first rotates the stats.log at midnight. Thereafter, Integration Server rotates the log at the specified interval. For example, if the watt.server.statsLogRotateInterval is set to 300 minutes (5 hours) and Integration Server starts up at 9:30 pm, Integration Server rotates the stats.log file at midnight and thereafter rotates the stats.log every 5 hours
Note: The watt.server.statsLogRotateInterval server configuration parameter was previously named the watt.server.logRotateInterval.
watt.server.storage.addKeyToStoreIfNotPresent
Specifies whether the pub.storage:lock service adds the specified key to the data store if the key does not exist in the data store at the time the service executes. Set this parameter to true to have the pub.storage:lock service add the specified key to the data store if the key does not exist at the time the service executes. The pub.storage:lock service creates the specified key, assigns it a NULL value, and then locks the entry in the data store. Set this parameter to false if you do not want the pub.storage:lock service to add the key to the data store. The pub.storage:lock service is a NOP (no operation) if the specified key value does not exist in the data store. The default value is false. For more information about the pub.storage services, see the webMethods Integration Server Built-In Services Reference.
watt.server.storage.lock.maxDuration
Specifies the maximum number of milliseconds a pub.storage service will hold a lock. The default value is 180000 milliseconds (3 minutes). For more information about the pub.storage services, see the webMethods Integration Server Built-In Services Reference.
watt.server.storage.lock.maxWait
Specifies the maximum number of milliseconds a pub.storage service will wait to obtain a lock. The default value is 240000 milliseconds (4 minutes). For more information about the pub.storage services, see the webMethods Integration Server Built-In Services Reference.
watt.server.storage.lock.sweepInterval
Specifies how often (in seconds) Integration Server deletes expired pub.storage locks. An expired pub.storage lock is one that is older than the value specified on the watt.server.storage.lock.maxDuration parameter. The default is 5 seconds. If the watt.server.storage.lock.sweepInterval parameter is set to a value less than one, Integration Server ignores the setting and uses 5 seconds instead. Integration Server does not have to be restarted for changes to this property to take effect. For more information about the pub.storage services, see the webMethods Integration Server Built-In Services Reference.
watt.server.strictAccessExceptionLogging
Specifies whether Integration Server will log HTTP 401 Access Denied as an error and trigger a notification. When this property is set to true, Integration Server will log HTTP 401 AccessDenied as an error and trigger notifications. When this property is set to false, Integration Server will not log HTTP 401 Access Denied as an error and will not trigger a notification. The default is false.
watt.server.suppresscwarn
Specifies whether, when running a C service in Designer, Integration Server should write the warning messages issued about the missing variables to the server log. When this property is set to true, Integration Server does not write these messages to the server log. When this property is set to false, Integration Server writes messages about missing variables to the server log. The default is false.
watt.server.sync.timeout
Specifies the time period that a lock object exists for a given key for which a notification has been issued. After calling a pub.sync:notify service to create the notification, a pub.sync:wait can receive the notification. Any thread that is waiting for a notification for the key, receives the notification as long as the lifespan of the wait request overlaps with the lifespan of the notification. However, if a thread with an exclusive wait is registered for the notification key before any other service is waiting, the notification ends as soon as the exclusive wait receives the notification. The default is 60 seconds.
watt.server.thread.aging.limit
Specifies the length of time, in minutes, a thread can remain in the thread pool. When this length of time is reached and the thread has been used the maximum number of times as specified by the watt.server.thread.usage.limit parameter, Integration Server waits until the service is complete and releases the thread from the pool. A value of -1 indicates that threads can remain indefinitely in the thread pool. The default is 60 minutes.
Note: Integration Server releases an expired thread only when the values for both watt.server.thread.aging.limit and watt.server.thread.usage.limit are reached. Both parameters must be set to a positive integer. If either or both parameters have a value of -1, both parameters will be disabled.
Important: Use this setting with extreme care because it will affect server performance and throughput.
watt.server.thread.usage.limit
Specifies the maximum number of times a pooled thread can be used. When this maximum number is reached and the length of time specified by the watt.server.thread.aging.limit parameter is reached, Integration Server waits until the service is complete and releases the thread from the pool. A value of -1 indicates that threads can be reused indefinitely. The default is 1000.
Note: Integration Server releases a used thread only when the values for both watt.server.thread.aging.limit and watt.server.thread.usage.limit are reached. Both parameters must be set to a positive integer. If either or both parameters have a value of -1, both parameters will be disabled.
Important: Use this setting with extreme care because it will affect server performance and throughput.
watt.server.threadKill.enabled
Controls whether the thread kill facility is enabled. This facility allows you to cancel or kill service threads in cases where a service is unresponsive. When you cancel a thread, Integration Server frees up resources that are held by the thread. When you kill a thread, Integration Server stops the thread, releases it from the thread pool, and replenishes the thread pool. The default is true. When the thread kill facility is enabled, you can cancel or kill threads by going to the Server > Statistics > System Threads screen. For more information about canceling and killing threads, refer to Canceling and Killing Threads Associated with a Service.
watt.server.threadKill.interruptThread.enabled
Specifies whether Integration Server should interrupt a service for which a timeout is triggered or is cancelled. If set to true, when a timeout is triggered or the service is cancelled, Integration Server interrupts the service thread that is executing a service. The default is false.
Important: If you change the value of this property, you must restart Integration Server for the change to take effect.
watt.server.threadKill.timeout.enabled
Controls how Integration Server handles the timeout setting of flow steps. Flow steps have a timeout property that controls how long the step can run. By default (true), when the step has exceeded the timeout period, Integration Server raises a FlowTimeoutException, and flow execution continues with the next step. When this property is set to false, it is possible for the flow step to run beyond its timeout period, in some cases. For instance, if a flow step calls another service, for example ServiceA, and ServiceA is executing when the timeout period has passed, ServiceA will continue executing past the timeout period. When ServiceA ends, it passes control back to the parent flow service, which then issues an exception.
watt.server.threadPool
Specifies the maximum number of threads that the server maintains in the thread pool that it uses to run services. If this maximum number is reached, the server waits until services complete and return threads to the pool before running more services. The default is 75.
watt.server.threadPoolMin
Specifies the minimum number of threads that the server maintains in the thread pool that it uses to run services. When the server starts, the thread pool initially contains this minimum number of threads. The server adds threads to the pool as needed until it reaches the maximum allowed, which is specified by the watt.server.threadPool setting. The default is 10.
watt.server.transaction.recovery.abandonTimeout
If an error occurs while Integration Server tries to resolve an uncompleted XA transaction, specifies the maximum length of time (in minutes) during which Integration Server should make additional attempts. The default is 5 minutes.
watt.server.transaction.recovery.sleepInterval
If an error occurs while Integration Server tries to resolve an uncompleted XA transaction, specifies the length of time (in seconds) that Integration Server waits between additional attempts. The default is 30 seconds.
watt.server.transaction.xastore.maxTxnPerFile
Specifies the maximum number of unique XA transactions in an XA recovery log file. When the XA recovery log file reaches the maximum number of transactions, Integration Server creates a new file. The default is 2000 transactions.
Consider increasing the maximum number of unique XA transactions for the XA recovery log file if there are more than 2000 active XA transactions and Integration Server exhibits a performance delay due to input/output. Increasing the number of unique XA transactions allowed per file decreases the number of files used for the XA recovery log, which, in turn, may result in fewer files for Integration Server to search when performing XA recovery.
Decreasing the number of unique XA transactions stored in file may help during transaction recovery as it might decrease the time to read and consolidate open transactions.
watt.server.transaction.xastore.performXALogging
Specifies whether Integration Server writes transaction information to the XA recovery store. Set to true to instruct Integration Server to log information about the state and progress of each XA transaction. Set to false to instruct Integration Server to skip logging XA transaction information. The default is true.
Important: If you set this property to false, Integration Server does not log any information to the XA recovery story while processing a transaction, making transaction recovery impossible. If you want Integration Server to automatically resolve incomplete transactions or you want to manually resolve incomplete transactions, Integration Server must perform XA logging.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.trigger.interruptRetryOnShutdown
Specifies whether or not a request to shut down the Integration Server interrupts the retry process for a webMethods messaging trigger service. If this parameter is set to false, Integration Server waits for the maximum retry attempts to be made before shutting down. Integration Server will also shut down if the trigger service executes successfully during a retry attempt. If this parameter is set to true, Integration Server waits for the current service retry to complete. If the webMethods messaging trigger service needs to be retried again (the service ends because of an ISRuntimeException), the Integration Server stops the retry process and shuts down. Upon restart, the transport (Broker, Universal Messaging, or, for a local publish, the transient store) redelivers the document to the trigger for processing. The default is false.
watt.server.trigger.keepAsBrokerEvent
Specifies whether Integration Server should bypass decoding that is normally performed when documents are retrieved from the Broker on behalf of a webMethods messaging trigger. If this property is set to true, Integration Server passes the value of the Broker event to the trigger service in an object called $brokerEvent and no decoding is performed. Set this parameter to true if Integration Server is receiving native Broker events. The default is false.
For more information about publishing native Broker events, see the Publish-Subscribe Developer’s Guide.
watt.server.trigger.local.checkTTL
Specifies whether Integration Server should strictly enforce a locally published document's time-to-live. When this parameter is set to true, before processing a locally published document in a trigger queue, Integration Server determines whether the document has expired. Integration Server discards the document if it has expired. The default is false.
watt.server.trigger.managementUI.excludeList
Specifies a comma-delimited list of triggers to exclude from the webMethods Messaging Trigger Management pages in Integration Server Administrator. Integration Server also excludes these webMethods messaging triggers from trigger management changes that suspend or resume document retrieval or document processing for all triggers. Integration Server does not exclude these webMethods messaging triggers from changes to capacity, refill level, or maximum execution threads that are made using the global trigger controls (Queue Capacity Throttle and Trigger Execution Threads Throttle).
Note: This server configuration parameter affects only webMethods messaging triggers that receive messages from the Broker.
You can specify the fully qualified names of all the webMethods messaging triggers that you want to exclude. You can also use pattern matching to exclude a group of triggers by specifying the beginning portion of the fully qualified name and following it with an asterisk (*). The Integration Server excludes all triggers that begin with the supplied pattern. For example, if you want to exclude all triggers located in the pub.prt folder, specify:
watt.server.trigger.managementUI.excludeList = pub.prt*
watt.server.trigger.monitoringInterval
Specifies the interval, measured in seconds, at which Integration Server executes resource monitoring services for webMethods messaging triggers. A resource monitoring service is a service that you create to check the availability of resources used by a trigger service. When it suspends a webMethods messaging trigger because all retry attempts have failed, Integration Server executes the resource monitoring service to determine if all the resources are available. The default is 60 seconds.
For more information about resource monitoring services, see the Publish-Subscribe Developer’s Guide.
watt.server.trigger.preprocess.monitorDatabaseOnConnectionException
Indicates whether Integration Server schedules a system task to monitor the document history database when a ConnectionException causes a transient error occurs during trigger preprocessing. A ConnectionException indicates that the document history database is not enabled for exactly-once processing or is not properly configured.
When this property is set to true, Integration Server schedules a system task that executes an internal service that monitors the connection to the document history database. When the document history database is enabled for exactly-once processing or is properly configured, the internal service indicates that the connection to the document history database is available. Then, Integration Server resumes the trigger and re-executes it when the connection to the document history database is available.
When this property is set to false, Integration Server does not schedule a system task to check for the database's availability and will not resume the trigger automatically. You must manually resume the trigger after configuring the document history database properly.
The default is false
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.trigger.preprocess.suspendAndRetryOnError
Indicates whether Integration Server suspends a trigger if an error occurs during the preprocessing phase of trigger execution. The preprocessing phase encompasses the time from when the trigger retrieves the document from its local queue to the time the trigger service executes. When this property is set to true, the trigger property On Retry Failure is set to Suspend and retry later, or the trigger property On Transaction Rollback is set to Suspend and recover, Integration Server suspends a trigger if one of the following occurs during preprocessing:
*A transient error occurs because the document history database is not available when Integration Server performs duplicate detection for the trigger. For more information about transient error handling during trigger preprocessing, see webMethods Service Development Help.
If the document history database is properly configured, Integration Server suspends the trigger and schedules a system task that executes a service that checks for the availability of the document history database. Integration Server resumes the trigger and re-executes it when the service indicates that the document history database is available.
If the document history database is not properly configured, Integration Server throws a ConnectionException. To determine how Integration Server handles a ConnectionException during trigger preprocessing, see watt.server.trigger.preprocess.monitorDatabaseOnConnectionException.
*The document resolver service ends because of an ISRuntimeException. Integration Server suspends the trigger and schedules a system task to execute the trigger's resource monitoring service (if one is specified). Integration Server resumes the trigger and retries trigger execution when the resource monitoring service indicates that the resources used by the trigger are available. If a resource monitoring service is not specified, you will need to resume the trigger manually (via the Integration Server Administrator or the pub.trigger* services).
When this property is set to false and the trigger property On Retry Failure is set to Throw Exception or the trigger property On Transaction Rollback is set to Recover only, Integration Server does not suspend the trigger if a trigger preprocessing error occurs. If the document history database is not available, Integration Server
*If the trigger specifies a document resolver service, Integration Server executes the document resolver service to determine the status of the document. If the document resolver service ends because of an ISRuntimeException, Integration Server assigns the document a status of In Doubt, acknowledges the document, and uses the audit subsystem to log the document.
*If a document resolver service is not specified, Integration Server assigns the document a status of In Doubt, acknowledges the document, and uses the audit subsystem to log the document.
Note: Integration Server uses the audit subsystem to log documents for webMethods messaging triggers.
The default value for watt.server.trigger.preprocess.suspendAndRetryOnError is false.
Important: You must restart Integration Server for changes to this parameter to take effect.
For more information about building a resource monitoring service, see the Publish-Subscribe Developer’s Guide or Using webMethods Integration Server to Build a Client for JMS. For more information about transient error handling during trigger preprocessing, see webMethods Service Development Help.
watt.server.trigger.removeSubscriptionOnReloadOrReinstall
Specifies whether Integration Server deletes document type subscriptions for webMethods messaging triggers when the package containing the trigger reloads or an update of the package is installed. If this property is set to true (the default) and a package reloads or an update of the package is installed, Integration Server deletes and then recreates any document type subscriptions for webMethods messaging triggers in the package. (If Integration Server connects to a Broker, Integration Server deletes and recreates the subscriptions on the trigger client on the Broker.) This creates a small window of time during which the document type subscriptions do not exist. During this window, the trigger will not receive documents to which it normally subscribes.
If this property is set to false, Integration Server does not delete and then recreate document type subscriptions for webMethods messaging triggers when the package reloads or is updated. Although Integration Server creates new document type subscriptions for triggers, Integration Server does not modify existing subscriptions. Specifically, if a trigger deleted a document type subscription, the subscription will not be removed when the package reloads or is updated. Consequently, when this property is set to false, the trigger might receive document types to which it no longer subscribes because the deleted document type subscriptions still exist on the trigger client on the Broker. When working with a 6.5.2 version of webMethods Broker, you can use My webMethods to delete the obsolete document type subscriptions from the trigger client on the Broker. The default is true.
Note: This property does not affect webMethods messaging triggers running in a cluster of Integration Servers nor does it affect webMethods messaging triggers that receive documents from Universal Messaging.
watt.server.trigger.reuseSession
Indicates whether instances of a webMethods messaging trigger use the same session on Integration Server when the document locale is the same as the default locale of Integration Server. When this property is set to true, Integration Server checks the locale of the document before processing it. If the document locale is the same as the default locale of Integration Server, or no locale is specified, the trigger uses a shared session. If the document locale is different from the default, then Integration Server creates a new session for the trigger to use to process that document. When this property is set to false, Integration Server uses a new session for each instance of a trigger. The default is false.
Reusing sessions for a webMethods messaging trigger might improve performance. However, this property does not work with all adapters.
watt.server.trigger.suspendOnAuditErrorWhen
Specifies when Integration Server should suspend a webMethods messaging trigger. A trigger can be suspended when both the following occur:
*The trigger service fails.
*The trigger service cannot write audit data to the audit database because an audit exception occurs.
When Integration Server suspends a webMethods messaging trigger, it halts document processing and document retrieval for the trigger. Suspending the trigger prevents Integration Server from acknowledging the document and prevents the messaging provider from discarding the document. After suspending the trigger, Integration Server monitors the connection to the audit database and resumes the trigger (document processing and document retrieval) when the connection to the audit database is re-established. Integration Server retrieves the unacknowledged document from the messaging provider and attempts to process it again.
Set the watt.server.trigger.suspendOnAuditErrorWhen parameter to one of the following values:
Specify...
To...
Never
Indicate that Integration Server does not suspend a trigger if the trigger service ends because of an error and an audit exception occurs when the trigger service attempts to write data to the audit database.
Error
Indicate that Integration Server suspends a trigger if the trigger service ends because of an error and an audit exception occurs when the trigger service attempts to write data to the audit database.
ErrorPipelineEnabled
Indicate that Integration Server suspends a trigger if the trigger service ends because of an error, the trigger service is configured to include the service pipeline in the audit log, and an audit exception occurs when the trigger service attempts to write data to the audit database. The default is ErrorPipelineEnabled.
Important: You must restart Integration Server for changes to this parameter to take effect.
The watt.server.trigger.suspendOnAuditErrorWhen configuration parameter only applies when the audit subsystem is configured to write data synchronously.
watt.server.tspace.location
Specifies the absolute directory path of the hard disk drive space in which the Integration Server is to temporarily store large documents rather than keep them in memory. Each file that the Integration Server stores in this directory is given the name DocResxxxxx.dat, where xxxxx is a value that can vary in length and character. Specify the absolute directory path to a directory on the same machine as the Integration Server. The default value is JVM's temporary directory (i.e., the value of java.io.tmpdir).
Example: If you want the Integration Server to use the LargeDocTemp directory on your D drive, specify the following:
watt.server.tspace.location=D:\LargeDocTemp
If you have a cluster of Integration Servers, each one must have its own Tspace.
Important: You must restart Integration Server after you modify the value of this property.
watt.server.tspace.max
Specifies the maximum number of bytes that can be stored at any one time in the hard disk drive space that you defined using the watt.server.tspace.location property. If the Integration Server attempts to write a large document to the hard disk drive space that will cause the number of bytes you specify to be exceeded, an error message is displayed on the server console, and the document is not stored. Specify a positive whole number of bytes. The default value is 52,428,800 bytes (50 MB).
Example: To set the maximum number of bytes that can be stored to 30,000,000 bytes, specify the following:
watt.server.tspace.max=30000000
Tip: The size of the hard disk drive space for temporarily saving documents will vary based on the number of documents that you process concurrently and the size of the documents that you process. For example, if your typical concurrent document load is 10, you would need a hard disk drive space that is 10 to 15 times the combined size of the documents being processed concurrently.
Important: You must restart the Integration Server after you modify the value of this property.
watt.server.tspace.timeToLive
Specifies the amount of time in milliseconds that documents can remain in the Tspace before they are deleted. If a document remains in the Tspace longer than the value defined by this parameter, the document expires and becomes eligible for removal from the Tspace. Expired Tspace documents are removed when the Tspace begins to run low on free disk space. The default is 0.
Important: You must restart the Integration Server after you modify the value of this property.
watt.server.txMail
Specifies the email address of an administrator to notify when guaranteed delivery capabilities are disabled due to an error (for example, if the Integration Server encounters a disk full condition or if the audit-trail log is full). There is no default.
watt.server.tx.cluster.lockBreakSecs
Specifies the number of seconds a cluster server waits before breaking a lock on a job in a cluster job store. The default is 120.
You must be using webMethods Integration Server Clustering to use this setting. For more information, refer to the webMethods Integration Server Clustering Guide.
watt.server.tx.cluster.lockTimeoutMillis
Specifies the number of milliseconds a cluster server sleeps between attempts to place an update lock on a job in a cluster job store. The default is 100.
You must be using webMethods Integration Server Clustering to use this setting. For more information, refer to the webMethods Integration Server Clustering Guide.
watt.server.tx.heuristicFailRetry
Specifies whether the Integration Server is to re-execute services for guaranteed delivery transactions in the job store that are pending when the Integration Server is restarted after a failure. If a transaction is pending, the service began execution before the Integration Server failed.
If the setting is true, the Integration Server resets the transaction status from pending to new, and the service will be re-executed. If the setting is false, the Integration Server resets the transaction status from pending to fail to indicate the heuristic failure, and the service will not be re-executed. The default is true.
watt.server.tx.sweepTime
Specifies the number of seconds between sweeps (clean up) of the job store for inbound guaranteed delivery transactions. The server sweeps the job store to remove expired transactions. The default is 60.
watt.server.um.producer.transaction.commitRetryCount
Specifies the number of attempts made by Integration Server in publishing a guaranteed document to a Universal Messaging server, after the initial attempt at publishing fails because of a transaction failure. The maximum number of retries is nine. If you try to assign a value greater than nine, Integration Server automatically sets the value of the property to nine. The default is zero.
When setting a retry value, you must ensure that the value of the total transaction timeout does not exceed the value of the MaxTransactionTime property. The total transaction timeout value is calculated by multiplying the total number of retry attempts with the value of the EventTimeout property. For example, if the retry value is set to 9, and the EventTimeout is set to 60s, the total transaction timeout is 60(9+1)= 600s.
Note: You can configure the values of the MaxTransactionTime and EventTimeout properties in the Universal Messaging Enterprise Manager.
watt.server.url.alias.partialMatching
Specifies whether Integration Server enables partial matching on URL aliases. If you set this server configuration parameter to true and define a URL alias in Integration Server Administrator, Integration Server enables partial matching on URL aliases. The default is false.
When partial matching is enabled Integration Server considers an alias a match if the entire alias matches all or part of the request URL, starting with the first character of the request URL path.
For information about partial matching and defining URL aliases, see Setting Up HTTP URL Aliases. For specific information about partial matching for REST resources configured using the legacy approach, see REST Developer’s Guide.
Important: If you change the setting of this parameter, you must restart Integration Server for the changes to take effect.
watt.server.userFtpRootDir
Specifies the FTP root directory that the Integration Server will create at startup. When any Integration Server user logs into the FTP Listener, the server creates that user's FTP home directory in this root directory, for example FtpRoot/username. You can specify any directory to be the root directory, including a mapped network directory. If this property is not defined, a default directory named userFtpRoot is created in your Integration Server home directory.
The user who connects to Integration Server through FTP listener is placed either in the default FTP root directory or the client user directory as defined in the watt.server.login.userFtpDir property.
Administrators, Replicators, and non-privileged users can perform put and get operations in the following directories:
This user...
Can access...
Administrator
*admin (in the Integration Server home directory)
*The Administrator's own user directory
*The entire namespace for all packages, including WmRoot
*All other user directories
Replicator
*The Integration Server_directory \instances\instance_name\replicate directory
*Any services in the namespace that have Replicator ACL or lower
*The Replicator's own user directory
Non-privileged user
*The user's own user directory
*Any services that have an ACL at or below the level of the user's ACL
When a user completes a put command in his or her own user directory (that is, when the STOR command is completed on the server side but before the server acknowledges the client with return code 226), an event is fired to notify interested parties by publishing a pub.client.ftp:putCompletedNotification document to the webMethods Broker. EDI packages will subscribe to this document and will retrieve the file just put onto the server.
Note: The STOU command is not supported on the Integration Server. However, it is supported for clients. See the following built-in services in the webMethods Integration Server Built-In Services Reference: pub.client.ftp, pub.client.ftp:put, and pub.client.ftp:mput.
watt.server.ws.71xHandlerChainBehavior
Specifies whether Integration Server uses the 7.1x handler chain processing behavior when executing handlers for a web service descriptor created in 7.1x. When set to true, Integration Server uses the handler chain processing behavior available in Integration Server version 7.1x for a 7.1x web service descriptor. When set to false, Integration Server uses the handler chain processing behavior available in Integration Server 8.0 for a 7.1x web service descriptor. The default is false.
watt.server.ws.defaultNamespace
This is an internal property. Do not modify.
watt.server.ws.defaultPrefix
Specifies the prefix assigned to the namespace http://www.webMethods.com/2001/10/soap/encoding for use in details for SOAP faults. The default is webM.
watt.server.ws.responseTNS.from.request
For a provider web service descriptor for which thePre-8.2 compatibility mode property is set to true, specifies whether the target namespace of the top-level element in the response uses the target namespace of the top-level element in the request. When set to true, a web service response sent by the Integration Server uses the target namespace of the top-level element in the request as the top-level namespace of the response. While this is incorrect behavior, it provides backward compatibility. If existing web service clients failed because the client expected a response that used the namespace of the top-level element of the request and you want to allow existing clients to continue to process responses without any changes to the client, set watt.server.ws.responseTNS.from.request to true.
When set to false, Integration Server uses the target namespace of the provider web service descriptor as the namespace of the top-level element in the response. This is the correct behavior. The default value is false.
Note: After upgrading to Integration Server 9.10 or later from a version of Integration Server earlier than 9.10, if you have web service providers that specify Pre-8.2 compatibility mode = true with existing web service clients that expect the namespace of the response to match the namespace of the request, they may fail due to the namespace mismatch. Software AG recommends regenerating those web service clients using a WSDL document retrieved from current provider web service descriptor. Alternatively, set watt.server.ws.responseTNS.from.request to true, which will revert to behavior of using the namespace of the request on the response rather than using the namespace as specified in the current WSDL document. While this behavior may be backward compatible, it may generate a response that does not match the current WSDL of the provider web service descriptor. For this reason, Software AG discourages setting watt.server.ws.responseTNS.from.request to true.
watt.server.ws.security.timestampMaximumSkew
Specifies the maximum number of seconds that the web services client and host clocks can differ so that the timestamp expiry validation does not fail. Integration Server validates the inbound SOAP message only if the creation timestamp of the message is less than the sum of the timestamp maximum skew value and the current system clock time.
You can use this parameter to set the timestamp maximum skew value when Integration Server uses WS-Security policy to implement security and if you have not set a value in the Timestamp Maximum Skew field in the Create web Service Endpoints Alias screen. The value must be a positive integer or zero. The default is 300 seconds.
watt.server.ws.security.timestampPrecisionInMilliseconds
Specifies whether the timestamp placed in the Timestamp element of the security header of an outbound message is precise to seconds or milliseconds. If you set the precision to milliseconds, Integration Server uses the timestamp format yyyy-MM-dd'T'HH:mm:ss:SSS'Z'. If you set the precision to seconds, Integration Server uses the timestamp format yyyy-MM-dd'T'HH:mm:ss'Z'.
You can use this parameter to set the precision when Integration Server uses WS-Policy to implement WS-Security and if you have not set a value in the Timestamp Precision field in the Create Web Service Endpoints Alias screen. Set this property to true, if you want the timestamp precision set to milliseconds. Set this property to false, if you want the timestamp precision set to seconds. The default is true.
watt.server.ws.security.timestampTimeToLive
Specifies the time-to-live value for an outbound message in seconds. Integration Server uses this value to set the expiry time in the Timestamp element of outbound messages.
You can use this parameter to set the time-to-live value when Integration Server uses WS-Policy to implement WS-Security and if you have not set a value in the Timestamp Time to Live field in the Create web Service Endpoints Alias screen. The value must be an integer greater than 0. The default is 300 seconds.
watt.server.wsdl.debug
Specifies whether Integration Server prints debug information to standard out and stack traces to standard error while generating or consuming WSDL. When set to true, Integration Server prints debug information to standard out and stack traces to standard error. The default is false.
watt.server.xml.encoding
Specifies the encoding that Integration Server must use when processing incoming XML files.
If an encoding is not defined in the XML header, Integration Server attempts to process the XML file using the charset encoding of the http or ftp request. If charset encoding is not available in the request header, then Integration Server uses the character encoding specified in the watt.server.xml.encoding server configuration parameter. There is no default value for this parameter.
Note: If you have configured Integration Server to use the character encoding specified in the watt.server.fileEncoding parameter to process incoming XML files previously, ensure that the value of watt.server.fileEncoding parameter is set to the same value specified for watt.server.xml.encoding. If you have not configured watt.server.fileEncoding for processing XML files previously, after installing this fix or after upgrading to a higher version of Integration Server, you can configure watt.server.xml.encoding to process incoming XML files. You can use watt.server.fileEncoding to process all files other than incoming XML files.
Important: You must restart Integration Server for changes to this parameter to take effect.
watt.server.xml.enforceEntityRef
Specifies whether the server will throw an exception when the XML parser detects a malformed entity. If the value is set to true, the server will throw an exception when it detects a malformed entity in an XML or DTD. If the value is set to false (the default), the server will allow malformed entities and does not throw an exception.
watt.server.xml.xmlNodeToDocument.keepDuplicates
Specifies whether the pub.xml:xmlNodeToDocument service keeps additional occurrences of an element in an XML node when arrays are not created (the makeArrays input parameter is set to false). This parameter also determines whether or not the pub.event.eda:eventToDocument service keeps additional occurrences of an element in the XML document passed into the service. When set to true, the document produced by the pub.xml:xmlNodeToDocument service contains multiple occurrences of the element. When set to false, the document produced by the pub.xml:xmlNodeToDocument service keeps only the last occurrence of the element. The default is true.
For example, suppose the following XML node is provided as input to the pub.xml:xmlNodeToDocument service:
<?xml version="1.0" encoding="UTF-8"?><myDoc><e1
e1Attr="attrValue1">e1Value1</e1><e2>e2Value</e2><e1
e1Attr="attrValue2">e1Value2</e1></myDoc>
When watt.server.xml.xmlNodeToDocument.keepDuplicates is set to true, the pub.xml:xmlNodeToDocumentservice produces this document:
When watt.server.xml.xmlNodeToDocument.keepDuplicates is set to false, the pub.xml:xmlNodeToDocument service produces this document:
Note that only the last <e1> element in the source XML is retained in the resulting document.
watt.server.xml.xmlNodeToDocument.makeArrayforWS
Specifies how Integration Server decodes duplicate elements contained in an anyType element. Set watt.server.xml.xmlNodeToDocument.makeArrayforWS to true if you want Integration Server to create an array for duplicate elements contained in an element of type anyType. Set this parameter to false if you want Integration Server to leave duplicate elements as separate, repeated elements in the element defined to be of type anyType. When set to false, Integration Server does not create an array for elements that appear more than once in the element defined to be of type anyType. The default is false.

Copyright © 2017-2018 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release