Configuring the RVIAttach Listener


Each Relay server maintains a list of attachment points, which is used to direct relayed messages to available Execution engines. Attachment points are characterized by a service name, an IP address, and a port. The Relay service channel is configured with the service name, which is resolved at run time to the target IP and port. Service names should be descriptive, but need not be related to a message type, channel name or host name. Multiple attach points for the same service name may be registered with one relay server, in which case, the connections they represent are assigned to relay events using algorithms which maintain a balanced work distribution (for example, Least Recently Used).

The purpose of the RVIAttach listener is to process attach messages from running Execution Channels in order to construct the attachment point list. The RVIAttach logic maintains the integrity of the attach point list by removing connections which have become unavailable. When that happens, other attach points offering the same named service are not affected.

To configure the RVIAttach listener, you must create a channel for your application project using the Channel Builder in iWay Integration Tools (iIT) and select RVIAttach as the listener type for your inlet. For more information, see Configuring a Listener Using iWay Integration Tools.

For a complete description of the configuration parameters that are available for the RVIAttach listener, see RVIAttach Listener Configuration Parameters.

Reference: RVIAttach Listener Configuration Parameters

The following table lists and describes parameters for the RVIAttach listener.



Port (required)

Port on which the attach listener is listening to receive service attachments.

Local Bind Address

On a server with multiple physical network interfaces, this specifies the interface to which the listener is bound. This can usually be left blank.

SSL Context Provider

Defined iWay Security Provider for SSL Context.

Allowable Clients

Optional host name or IP address, which, if entered, limits connections to those from the designated host or IP address. Only one host name or IP address is allowed per RVIAttach listener. If you wish to allow a set of Executor hosts to connect, one RVIAttach listener must be configured for each.


Frequency with which the attach point checks for stop requests. The default value is 2 seconds.

Keep Alive

The interval at which to poll to ensure that a connection is still available. If an interval is specified, the attach point sends a keep alive message on each attached link. Care should be taken in setting this property, as overly short polling intervals can impact bandwidth and CPU utilization. The default value is 0; 60 seconds is recommended.