INSTRUCTIONS FOR APPLYING THE 2.0.0.1 PATCH FOR AIX:

The 2.0.0.1 patch is delivered with the following files:

 
lib\CrossWorlds.jar
 

Caution: Unzipping this patch will OVERWRITE your existing installation's
files. CrossWorlds recommends backing up the existing files before 
applying this patch.

To apply the patch, create a %CROSSWORLDS%\patches directory, place the
2.0.0.1_for_AIX.zip file into this directory and unzip the file to your
%CROSSWORLDS% (c:\crossworlds by default) directory.

The patch installs the following files:
	 
		 
	in your %CROSSWORLDS%\lib directory:
	 	CrossWorlds.jar
		 
 

 


-----------------------------------------------------------------------------------
CrossWorlds 2.0.0.1 patch for AIX contains the following enhancement:

CR 14715 (APAR JR17276) - provide 'exactly once' event delivery for connectors (Guaranteed Event Delivery).


In this patch, the Guaranteed Event Delivery (GED) is implemented for the JMS event store.

To activate this enhancement, users are expected to specify several additional properties 
using the connector configurator tool. 


This enhancement will enable the connector infrastructure to manage the JMS event store and guarantees that events are never lost and will never sent twice between the source JMS event store to Destination JMS queue. 

To activate this enhancement, users are expected to specify several additional properties using the connector configurator tool.

Several new configurations properties are required in the local configuration file for connector infrastructure to maintain and read events from the source JMS event store ( Source Queue) and deliver them to destination queue.

ContainerManagedEvents = JMS

Following standard properties are required, if ContainerManagedEvents property is set to JMS. 
SourceQueue 
PollQuantity
 
[DataHandlers]
MimeType 
DHClass 
DataHandlerConfigMOName  

 
Details for those extra propertes are -

1. ContainerManagedEvents = JMS
This property has to be set to JMS to turn on the GED feature. Otherwise, connector behaves normally by polling events thru User-agent written part of the code. 

2. SourceQueue = SOURCE Queue name
This property has to be set. Note: the sourceQueue is on the same MQ manager with other queues.

3. PollQuantity = 1 to 500
PollQuantity is the number of events to be retrieved from the sourcequeue for each poll.

4. PollFrequency =  # in mini second
This property tells the connector how frequent to retrieve event.

5. MimeType = the DataHander mine type (specified in DataHandlers section)
When the MimeType is set, this property alone is used to construct a proper datahandler, i.e. the DHClass property is ignored. NOTE: for the swift datahandler, this property has to be set to swift (in lower case).

6. DHClass = datahandler class location 
Only when the MimeType is NOT set, DHClass is used to locate the datahandler class. 

7. DataHandlerConfigMOName = MO_DataHandler_Default
This is a property that has to be set when using with swift datahandler.