Skip to Content

Canceling clients automatically

Typically, persistent socket clients remain connected to IBM IMS Connect, even when they are idle and no longer required. Manually removing persistent idle clients can be a slow process, particularly for users who have hundreds or thousands of active persistent clients connected at one time.

With the Auto cancel clients option on the IMS Connect Options panel, you can now cancel idle clients automatically.

Warning

Note

Non-persistent clients do not appear in the LIST CLIENT command. Hence, there are no non-persistent clients for auto cancellation cycle to cancel. Currently, only persistent client cancellation is supported.

For each client, you can define a rule in the rules table of the IMS/IMS Connect PROCLIB data set to specify the following information:

  • Whether to cancel the client when idle or keep it active until the connection closes

    Information
    Example

    For clients connected to the same port, you can set rules to cancel some clients but leave others connected (active). For example, you might want to keep frequently used clients always active.

  • For a client identified for cancellation, the wait seconds (waiting period, in seconds) after which Energizer can cancel the client

After you create cancellation rules and activate Auto cancel clients option, the cancellation process runs every 30 minutes (1,800 seconds) by default. This frequency is called the auto cancel frequency.

The auto cancel cycle is the entire process of canceling the clients. You can set the cycle for a client during initialization or RELOAD functions. During the cycle, Energizer issues the IBM z/OS cancel command for open socket connections that match the cancellation criteria in the rules table.

Warning

Note

Open socket connections include all OTMA connections from distributed applications over TCP/IP and z/OS terminals connected using IMS Connect.


Automatically canceling idle clients with Energizer for IMS Connect.png

In addition to simplifying client removal, the Auto cancel clients option allows you to connect new or required clients more frequently.

If IBM's IDLETO parameter is defined, the process with lower wait seconds takes priority to automatically cancel the open socket connections. The IDLETO parameter is coded in the TCP/IP statement in the IMS Connect configuration member.

Information
Example

Assume the IDLETO parameter is defined at 200 seconds and the Auto cancel clients rule is set at 100 seconds.

In this case, Energizer processes the auto cancellation rules based upon the Auto cancel clients option.

BMC recommends to use the Auto cancel clients option as you can define auto cancel rules for every client and port number.

This section contains the following procedures for automatically canceling clients:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Energizer for IMS Connect 1.8