IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > IBM i > Plan for adapter implementation > Migrating to version 7.5.0.3

Migration considerations

WebSphere Adapter for IBM i version 7.5.0.3 may have some features and updates that might affect your existing adapter applications. Before migrating applications that use WebSphere Adapter for IBM i, you must consider some factors that might affect your existing applications.


Compatibility with earlier versions

WebSphere Adapter for IBM i version 7.5.0.3 is fully compatible with the custom business objects (XSD files) and data bindings that are created using the adapter version 7.5.0.2 and enables the existing business objects and data bindings to work well in the latest version of the adapter.

Run the migration wizard if you want your applications to use features and functionality present inversion 7.5.0.3 of the adapter.

The migration wizard replaces (upgrades) version 7.5.0.2 of the adapter with version 7.5.0.3 and enables version 7.5.0.3 features and functionality for use with your applications.

The migration wizard does not create components or modify existing components, such as mappers and mediators to work with version 7.5.0.3 of the adapters. If any of your applications embed an adapter that is version 7.5.0.2 or earlier and you are upgrading to version 7.5.0.3, and you want your applications to take advantage of the features and functions in version 7.5.0.3, you might need to change to those applications.

If the artifacts within a module have inconsistent versions, the entire module is marked as unavailable for migration and cannot be selected for migration. Version inconsistencies are recorded in the workspace log, as this might be a symptom of project corruption.

If the IBM Integration Designer version is not equal to the WebSphere Adapter for IBM i version, they fail to run together as depicted in the scenarios here.

The following scenario is not supported:

When you migrate the business objects for the putqueue operation fromIBM Integration Designer 7.0 to the current version, the following migration exception error message will appear in the problems pane ofIBM Integration Designer 7.5 workspace:

"Response BO object not found. Add response BO to the project".

WSDL: The element http://schemas.xmlsoap.org/wsdl/#fault'' is not permitted as constrained by “http; //schemas. xmlsoap.org/wsdl/#fault”.

This is because of a version mismatch between an earlier business object that has a putqueue operation, and IBM Integration Designer 7.5 version. You encounter this error only with the putqueue operation and not with other operations, such as getqueue, RPG via PCML, COBOL via PCML, and so on. To resolve this error:

  1. Right click the error message and select the Quick Fix menu option.

  2. Select the fix for Response BO object not found. Add Response BO to the project in the Quick Fix screen.
  3. Follow the remaining suggestions in this screen.

You can then migrate a business object fromIntegration Designer 7.0, to theIntegration Designer 7.5 workspace.


Decide whether to upgrade or to upgrade and migrate

The default processing of the migration wizard is to perform an upgrade of the adapter and to migrate the application artifacts so that the applications can use features and functions in version 7.5.0.3 of the adapter. When you choose to upgrade the adapter by selecting a project, the wizard automatically selects the associated artifacts for migration.

If you decide that you want to upgrade the adapter from version 7.5.0.2 to version 7.5.0.3, but you do not want to migrate the adapter artifacts, you can do so by clearing the adapter artifacts from the appropriate area of the migration wizard.

Running the migration wizard without selecting any adapter artifacts installs and upgrades your adapter, but your artifacts are not migrated and your applications cannot take advantage of the features and capabilities that exist in version 7.5.0.3 of the adapter.


Run the migration wizard in a test environment first

Because adapter migration might require you to change those applications that use version 7.5.0.3 of WebSphere Adapter for IBM i, you must always perform the migration in a development environment first and test your applications before deploying the application to a production environment.

The migration wizard is fully integrated with the development environment.

Migrating to version 7.5.0.3 of WebSphere Adapter for IBM i