Updating the session message limit

Use the Update > Session Message Limit context option in the Status Monitor of the Operations Console to activate or deactivate session message limits on selected systems or to change the threshold. The setting is changed both in-memory and in the repository definition.

About this task

The Session Message Limit option allows you to automatically respond to the failure of an IMS™ Connect system by balancing the number of TCP/IP sessions directed to each remaining live IMS Connect system. The Limit threshold specifies the maximum number of input messages for a persistent session. When the threshold is reached, the session is closed by IMS Connect Extensions with the expectation that the remote client will create a new session. Session balance is gradually restored as the existing session expires and new sessions are routed to the IMS Connect with the lowest session totals.

The Read Exit Msg Cnt field on the Sessions tab displays the number of input messages received so far by the session.

Procedure

To implement automatic session re-balancing, perform the following steps:

  1. Right-click on an IMS Connect system and select Update > Session Message Limit from the context menu.
  2. Under Session Message Limit:
    • To activate session message limiting, select Active. In the Limit threshold field, specify the number of input messages a persistent session can receive before it will be closed. This value must be between 1 and 999999.
      Figure 1. Updating the session message limit in IMS Connect Extensions Operations Console for z/OS® Explorer
      Limit threshold specifies the number of imput messages a persistent session can receive before IMS Connect Extensions closes the session.
    • To deactivate session message limiting, select Inactive.
  3. Click Next. The old and new values are displayed for each selected system.
    • To confirm the changes, click Finish.
    • To retain the old settings, click Back, select No Change, and then click Cancel.