Multiple mode reconnect for CICS

For enterprise server regions configured to run CICS applications, you can configure the XA reconnect process to operate in a multiple attempt mode by setting the ES_XA_%xaname%_OPTIONS environment variable.

When the ES_XA_%xaname%_OPTIONS environment variable specifies an RM and a wait time, each time a transaction is about to be executed an xa-ping is attempted. If it fails the XA reconnect processing will loop on the xa-close, xa-open, and xa-ping. Waiting a specified duration, in seconds, before repeating until the xa-ping receives a return code of 0. If at the end of the loops, the connection has not been re-established, the RM will be disabled and a severe error will be sent to the console to indicate that the RM has been disabled.

To re-enable the target RM, Dynamic XA should be used. Dynamic XA provides the ability to disable and re-enable an XA RM during the life of a region.

When set with ES_XA_RECONNECT=Y, configures the XA reconnect process to operate in a multi-attempt mode.

Syntax

ES_XA_%xaname%_OPTIONS={reconnect_attempts,wait-time|EX}

Parameters

%xaname%: The name of the RM as specified in MFDS or ESCWA.
reconnect_attempts: The number of reconnect attempts to the target RM. Maximum is 9999.
wait-time: The number of seconds to delay between each attempt.
EX: Exclude the target RM from XA reconnect processing.

Default

Not set.

Comments

ES_XA_%xaname%_OPTIONS must be set along with ES_XA_RECONNECT=Y.

You might need to set ES_XA_%xaname%_OPTIONS multiple times — once for each RM that you require to operate in a multiple-attempt mode.

Examples

Specify that an XA reconnect processing attempts to reconnect to MQPROD 100 times and waiting for 10 seconds between each reconnect attempt:

ES_XA_MQPROD_OPTIONS=100,10

Specify that the XA reconnect processing is to exclude MQPROD from the XA reconnect processing:

ES_XA_MQPROD_OPTIONS=EX