Configuring the RVI Relay Service

How to:

The RVI Relay service is responsible for passing messages to the Executor Server from a channel running on the Proxy Server. To accomplish this, the service uses its service name to find a matching attachment point in the attachment point list. If there are several matching attachment points, the system applies a load balancing algorithm to select which attachment point to use. The RVI Relay service may be configured with the service name property defined as an expression, in which case the expression will be evaluated dynamically for each invocation (for example, for each message which will be relayed) prior to determining the attachment point.

The RVI Relay service can be added to a Channel definition through the iWay Service Manager Administration Console, or may be used in a process flow that is constructed using iWay Designer.

Note: This section describes how to configure an RVI Relay service. To construct a fully populated iWay Service Manager channel, incorporate the service into a process and then include the process as a route of the channel. For more information on how to design and build a channel, see the iWay Service Manager User's Guide.


Top of page

x
Procedure: How to Configure the RVI Relay Service

To configure the RVI Relay service for use in a channel:

  1. In the left console pane of the Registry menu, select Services.

    The Services pane opens, as shown in the following image.

    The table that is provided lists any existing services and a short description for each.

  2. Click Add.

    The Select the type for the new Service object definition pane opens.

  3. Select the RVI Relay {com.ibi.agents.RVIRelay} service from the drop-down list, then click Next.

    The Configuration parameters for RVI Relay service pane opens.

  4. Provide the appropriate property values for the RVI Relay service, as defined in the following table.

    Note: An asterisk indicates a required property.

    Property

    Definition

    Service Name*

    Name of the service that is supported by an Executor Server attach point. Service names should be short and descriptive. Service names are case-sensitive and may not contain punctuation or other special characters. This service name must be identical to the service name that is specified during the configuration of the gateway listener, since it refers to the service offered by the gateway.

    Tolerance

    The period to wait for an Execution server offering the correct service to be available.

    Timeout*

    Maximum time period to wait for a response from the executing service.

    Attempt Retry*

    If set to true, failed connections to the execution server will be retried.

  5. Click Next.

    The Provide a name and description for the new Service object definition pane opens.

  6. Provide a name and optionally, a description, for the RVI Relay service, and click Finish.

    The newly created RVI Relay service is added to the list in the Services pane.


iWay Software