CLIENTRECONNECTOPTIONS

Options governing reconnection.

Applicable Objects

ConnectionFactory, QueueConnectionFactory, TopicConnectionFactory

JMS administration tool long name: CLIENTRECONNECTOPTIONS

JMS administration tool short name: CROPT

Programmatic access

Setters/getters

• MQConnectionFactory.setClientReconnectOptions()
• MQConnectionFactory.getClientReconnectOptions()

Values

QMGR

The application can reconnect, but only to the queue manager to which it originally connected.

An error with reason code MQRC_RECONNECT_QMID_MISMATCH is returned if the queue manager that the application tries to connect to, as specified in the connection name list, has a different QMID to the queue manager that it originally connected to.

Use this value if an application can be reconnected, but there is an affinity between the IBM MQ classes for JMS application, and the queue manager to which it first established a connection.

Choose this value if you want an application to automatically reconnect to the standby instance of a highly available queue manager.

To use this value programmatically, use the constant WMQConstants.WMQ_CLIENT_RECONNECT_Q_MGR.

ANY

The application can reconnect to any of the queue managers specified in the connection name list.

Use the reconnect option only if there is no affinity between the IBM MQ classes for JMS application and the queue manager with which it initially established a connection.

To use this value from a program, use the constant WMQConstants.WMQ_CLIENT_RECONNECT.

DISABLED

The application will not be reconnected.

To use this value programmatically, use the constant WMQConstants.WMQ_CLIENT_RECONNECT_DISABLED.

ASDEF

Whether the application will reconnect automatically depends on the value of the IBM MQ channel attribute DefReconnect.

To use this value from a program, use the constant WMQConstants.WMQ_CLIENT_RECONNECT_AS_DEF.