High Availability for the WSMQ Output Adapter
To enable high availability in the WebSphere MQ Output adapter, configure the adapter parameters for multiple queue destinations, or deploy a client channel definition table (CCDT) saved on file.
The WebSphere MQ Output Adapter supports the configuration of multiple queue destinations. With high availability, the WSMQ adapter selects the first available destination as the active destination, and outputs data to that active queue manager. If the active destination is not available, the WSMQ adapter selects another queue manager for the new active destination, and outputs data to the new active queue manager. In order to track queue output, the WSMQ adapter writes the currently active queue manager name to the log file. If none of the configured queues are available, the WSMQ adapter fails and stops.
Each queue destination is defined by the parameters QueueManagerName, Queue Name, SystemName, Port, and Channel, all of which are set in the ESP Studio adapter properties dialog, and attached to a project using the ATTACH ADAPTER statement. A ";" separates multiple values for each parameter in the statement script. The first value of each parameter defines the first destination, and the second value of each parameter defines the second destination, and so on.
If you use the CCL ATTACH ADAPTER statement to attach an adapter, you must supply the adapter type.
Below is an example of an adapter configured to three separate destinations:
ATTACH OUTPUT ADAPTER wsmqout1 TYPE wsmq_out TO W1 PROPERTIES QueueManagerName='QM1;QM2;QM3', QueueName='Queue1;Queue2;Queue3', SystemName='10.128.103.51;10.128.103.51;10.128.103.51', Port='1430;1432;1434', Channel='Channel1;Channel2;Channel3', enableGDMode=false;
- Queue Destination 1: QM1/Queue1/10.128.103.51:1430/Channel1
- Queue Destination 2: QM2/Queue2/10.128.103.51:1432/Channel2
- Queue Destination 3: QM3/Queue3/10.128.103.51:1434/Channel3
Alternatively, the values for multiple queue destinations can be stored into a client channel definition table file, and that file is deployed by setting the ClientConnDefinitionTable parameter. If a CCDT is used to connect to the WSMQ server, and more than one queue destination is configured, the CCDT file must contain all of the connection information to these queue managers. The file path is required when using a CCDT.
The following example uses a CCDT file that would contain all of the same queue information as the above example:
ATTACH OUTPUT ADAPTER wsmqout1 TYPE wsmq_out TO W1 PROPERTIES QueueManagerName='QM1;QM2;QM3', QueueName='Queue1;Queue2;Queue3', ClientConnDefinitionTable='C:path/to/your/file/AMQCLCHL.TAB', enableGDMode=false;