Listener Configuration Parameters

The following table lists and describes common parameters used by the HTTP, Secure HTTP (HTTPS), and nHTTP Server listeners.

Parameter

Description

Whitespace Normalization

Specifies how the parser treats whitespace in Element content. Choose preserve to turn off all normalization as prescribed by the XML Specification. Choose iWay 5.x Compatibility for compatibility with earlier versions. The compatibility mode is designed to remove newlines in pretty-printed documents while preserving the whitespace in text-only elements.

Accepts non-XML (flat) only

If true, the listener expects non-XML (flat). Automatic parsing is not performed.

Optimize Favoring

Use this option to customize how the listener performs. For smaller transactions, select performance. For large input documents that could monopolize the amount of memory used by iWay Service Manager, select memory.

Multithreading

Indicates the number of documents that can be processed in parallel for this listener. Setting this to a value of greater than 1 enables the listener to handle a second request while an earlier request is still being processed. The total throughput of a system can be affected by the number of threads operating. Increasing the number of parallel operations may not necessarily improve throughput.

The default is 1.

The max value is 99.

Maximum Threads

The parallel threads can grow to this count automatically on demand. Over time, the worker count will decrease back to the multithreading level. Use this parameter to respond to bursts of activity.

Execution Time Limit

Time limit for document execution (in seconds) before cancellation is attempted. (Also see system property "Kill Interval". This applies to agent stacks and sets a lower limit for process flows.)

Default Java File Encoding

The default encoding if the incoming message is not self-declaring (that is, XML).

Agent Precedence

Sets the order by which iWay Service Manager selects agents. iWay Service Manager selects the agent or agents to process the document by searching through the configuration dictionary. Usually, it looks for a document entry in the configuration and when a match is found, the agent specified in that document entry is selected. If a matching document entry is not found, or no agent is specified, the engine looks in the input protocol configuration (listener). To have the processing agent taken directly from the listener (thus ignoring the document entry), use <listener> overrides <document>.

Possible values are <document> overrides <listener> and <listener> overrides <document>.

The default value is <document> overrides <listener>.

Always reply to listener default

If set to true, the default reply definition is used in addition to defined replies.

Error Documents treated normally

If set to true, error documents are processed by any configured preemitters.

Listener is Transaction Manager

If true, agents/services run within a local transaction managed by the listener. In this case the process flow serves as the transaction boundary and use of the fail service or an error can trigger a rollback. The message is considered to be acquired and does not roll back to the original source. Use Retry Queues or other application-specific services to handle such a case.

Record in Activity Log(s)

If set to true, activity on this channel will be recorded in the activity logs, otherwise the activity will not be recorded.

AES Key

If the channel will receive encrypted AFTI messages, set the AES key (maximum 16 characters) to be used for decryption.

Failed ReplyTo Flow

Name of a published process flow to run if a message cannot be emitted on an address in its reply address list.

Dead Letter Flow

Name of a published process flow to run if an error cannot be emitted on an address in its error address list.

Channel Failure Flow

Name of published process flow to run if this channel cannot start or fails during message use. The server will attempt to call this process flow during channel close down due to the error.

Startup Dependencies

A comma-separated list of channel names that must be started before this one is called.


iWay Software