Define - RV Connection Details

From the Define - Connections: RV page, click Add or double-click an existing RV connection, and then the RV Connection Details page is displayed.

The following table describes the items that are available on the RV Connection Details page:

Item Description
Name Type an RV connection name.
Description Type a short description for the RV connection.
Startup If you want this ESB to be started during the initialization of Substation ES, select this check box.
RV Endpoint Type an RV endpoint, or click the icon to select one.
Service Port

Type the UDP service port.

The default value is 7555.

Network Type the service group by network IP address.
Network Code Page Type the set value for the network code page. The set value must be same to the one that you specified for the host code page. If you change this value, make sure that all sending and receiving programs or processes use the same code-page settings.
Host Code Page Type a different host code-page set value that causes string conversions to be treated differently.
Policy Select one of the following options from the Policy list to determine how RV discards events from the dispatcher queue when the number of events exceeds the value of RV-EQ-MAX-EVENTS:
  • Discard None
  • Discard New
  • Discard First
  • Discard Last

By default, Discard First is selected.

Maximum Events Enter the maximum number of events that are held on the dispatcher queue for Substation ES to process.

Valid values for this field are in the range 0 - 300000. The default value is 20000.

TCP/IP Stack Name Type the IBM stack name to be used with this connection.

If this TCP/IP stack name is different from the default name defined with the STACK-NAME parameter in the Substation SIP member, the stack name specified in this field is used for this connection.

Interfaces Click the icon to select an interface, and you can also click the icon to add one more interface.
RV Distributed Queue If you want to use the Rendezvous-distributed queue processing for the specified interface, select this check box. Normally, you have two or more ESB interfaces with this value set.
Note: If only one interface participates in a distributed queue, do not select this check box.
When you select the RV Distributed Queue check box, the Distributed Queue Details panel is displayed with the following items:
Scheduler This parameter determines whether the ESB is a worker or a scheduler in the distributed queue:
  • 0 designates the ESB as a worker.
  • 5 indicates that the ESB is always a scheduler.
  • All other numbers allow the ESB to act as scheduler as needed. The higher the number, the more likely this ESB becomes a scheduler.
Workers

Enter the number of worker tasks for each listener. A value of zero indicates that no worker is assigned.

Memory Limit (K) Enter the maximum amount of memory that the ESB can use in KB.

When this specified limit is reached, the ESB rejects incoming messages until the memory in use falls below this limit.

Message Limit Enter the maximum number of messages that can be in the distributed queue.

When this specified limit is reached, the ESB rejects incoming messages until the number of messages in the queue falls below this limit.

Identity The value in this field is concatenated to the end of the RV distributed queue name, ensuring that the RV distributed queue name is unique on the network. The name specified in this field has to follow the RV distributed queue naming conventions.