Patch Notes for
Version 2.3.2 of the WBI Adapter for MQ

(forCrossWorlds Infrastructure versions 4.x and WBIA versions 2.x) 

The patch notes contain the following sections:
 

CONNECTOR REVISIONS

UPGRADE INSTRUCTIONS

USAGE NOTES


 

ADAPTER REVISIONS

This patch contains fixes for the following CRs based on customer-reported cases


 

Available as of Version

CR Number/APAR #

Description

2.3.2

22682,22691,22716/JR18335
  • CR22682: Added support to fail the events when an message with an unsupported message class is encountered, rather than shutting down the adapter.
  • CR22691: Fixed the adapter to report the error message to the ReplyToQueue specified for synchronous event processing.
  • CR22716: Fixed the adapter to have the correct CorrelationId written to the request messages when concurrent requests with different correlation ids specified in the dynamic MO are passed to the adapter.

2.3.1

17738,22341,22345/JR18114
  • CR17738: The purpose of this enhancement is to provide customers with a way to configure the frequency that the ReplyTo Queue is checked for incoming messages. Specify a value for adapter configuration property "ReplyToQueuePollFrequency"  in milliseconds. Note: this fix was originally released in the 2.2.2 version of the adapter but because of the timing of the patch, it was not included into the 2.3.0 version of the adapter. 
  • CR22341: Populate the dynamic MO attributes including ‘MessageID’, with the message headers of the input message polled. 
  • CR22345: Fix to have the correct priority populated in the dynamic MO during polling.

UPGRADE INSTRUCTIONS

To perform an upgrade to this version of the connector:

  1. Apply the changes prescribed in each table below, beginning with the entries at the bottom of each table and working up to the most recent patch. 

Add, replace, or remove the following files and directories as indicated:
 

For Adapter Version

Platform [WIN; UNIX]

Add / Replace / Remove

File (Starting from %CROSSWORLDS%/$CROSSWORLDS)

2.3.2

WIN;UNIX

Replace

/connectors/MQSeries/CWMQSeries.jar, /connectors/MQSeries/CWJMSCommon.jar

2.3.1

WIN;UNIX

Replace

/connectors/MQSeries/CWMQSeries.jar, /connectors/MQSeries/CWJMSCommon.jar

Add or remove the following connector properties using CSM:
 

For Adapter Version

Platform [WIN; UNIX]

Add / Replace / Remove

Property (Case-Sensitive)

2.3.2

WIN;UNIX

none

 

2.3.1

WIN;UNIX

Add

ReplyToQueuePollFrequency

USAGE NOTES

CR17738

Add a connector configuration property called "ReplyToQueuePollFrequency" which takes as it's value a number in milliseconds representing the frequency which messages will be checked for on the ReplyTo queue.

CR22341
Configure the dynamic MO with attributes to be populated with the message headers during polling. See MQSeries Connector Guide for details on configuring the dynamic MO.

CR22345
Configure the dynamic MO with an attribute for the priority value of the input message to be populated during polling. See MQSeries Connector Guide for details on configuring the dynamic MO.

CR22682

To use the feature fixed in this update send an empty message to the input queue of the adapter and check that the adapter now logs and fails the event without shutting down itself.

 

CR22691

To use the feature fixed in this update send a synchronous event to the input queue of the adapter and check that the adapter populates the response to the ReplyToQueue of the request event.

 

CR22716

To use the feature fixed in this update send concurrent requests to the adapter with different values specified in the CorrelationID attribute of the dynamic meta objects.

 

January 31, 200304:05 PM

© 2003 IBM Proprietary and Confidential. All Rights Reserved.