Creates a "Change State" handle to contain the state of the SonicMQ Broker connection changes.

Note: The JMS providers other than SonicMQ do not support this method.

Syntax

PROCEDURE createChangeStateConsumer
DEFINE INPUT PARAMETER procHandle AS HANDLE.
DEFINE INPUT PARAMETER procName AS CHARACTER.
DEFINE OUTPUT PARAMETER consumerHandle AS HANDLE.

Applies to

Session objects (ClientConnect and ServerConnect only).

Notes

  • Only applicable for Fault Tolerant connections.
  • Call createChangeStateConsumer procedure after beginSession procedure.
  • In the "Change State" handler, the character header property "state" will contain one of the following values: "active", "reconnecting", "failed", or "closed".
  • Setting up a change-state handler is optional. If not done, the default is to not notify the application of state changes.

See also

setFaultTolerant procedure, getFaultTolerant function, isFaultTolerant function, createChangeStateConsumer procedure, setFaultTolerantReconnectTimeout procedure, getFaultTolerantReconnectTimeout function, setInitialConnectionTimeout procedure, getInitialConnectionTimeout function, setClientTransactionBufferSize procedure, getClientTransactionBufferSize function

For more information, see the Fault tolerance and the Fault tolerance.