Upgrading to version 5.3.x from version 4.0.x

This section explains:

Meta-object changes

The MO_JTextConnector_Default meta-object contains three new attributes (PartialArchiveExt, UnsubscribedArchiveExt, and OriginalArchiveExt) that expand the flexibility of archive processing.

You must add these attributes to the JText top-level meta-object, and configure values for them. Use Business Object Designer to add the new attributes, provide your own default values for them, and save the changes to the definition.

Add the three new attributes to each of the meta-objects that you have customized from MO_JTextConnector_Default. For example, if you have created your own meta-object for the Customer and Item business objects, add the new attributes to these meta-objects, provide your own default values for them, and save the changes to the repository.

For more information, see Table 13.

Architecture changes

This section explains:

Naming convention changes

Changes to the connector's architecture require the name of your formatter meta-objects to not conform to the naming convention for JText top-level meta-objects.

Some previous releases of the connector delivered a DHFormatter meta-object named MO_JTextConnector_DHFormatter. This name is no longer valid. An acceptable name for this meta-object must not have Connector specified in the second position; for example, MO_JText_Default_DHFormatter is a valid name for this meta-object.

If your formatter meta-objects use the same naming convention as JText top-level meta-objects, you must change their name and change the type of every business- object attribute that represents this meta-object. To make this change:

  1. Rename the existing formatter meta-object to the new meta-object name.
  2. In the top-level meta-object, change the type of every attribute that represents the formatter meta-object from the previous meta-object name to the new name.
  3. Edit the connector's configuration to remove the old meta-object from its list of supported business objects, and add the new formatter meta-object to the list.
  4. Remove the old formatter meta-object from the integration broker repository.

For more information, see JText meta-object naming conventions.

Configuration property changes

The InRecoveryWindow, OutRecoveryWindow, and EventRecoveryEnabled connector-specific configuration properties no longer exist. A new property, EventRecovery, has been added.

To take advantage of the connector's new archiving feature:

  1. Edit the JText connector in Connector Configurator to remove the old properties and add the new property.
  2. Set the value of the new property to "abort" or "retry".

For more information about this property, see EventRecovery.

Jar file changes

The CwJTFormatter.jar file is no longer delivered. All product-delivered formatters have been moved to the CwJText.jar file.

If you use custom formatters, which you have placed in the CwJTFormatter.jar file, do one of the following:

Copyright IBM Corp. 1997, 2003