Performing in-place migration for an integration node on z/OS

Migrate an integration node on z/OS to use the enhanced facilities available in IBM® Integration Bus Version 10.0 by using in-place migration.

Before you begin

  • Plan your migration; see Preparing for migration.
  • Perform any pre-migration tasks; see Performing pre-migration tasks.
  • Ensure that you are familiar with the steps involved in creating an integration node on z/OS; see Creating an integration node on z/OS.
  • Ensure that you are familiar with the mqsimigratecomponents command that the JCL (Job Control Language) file uses to migrate an integration node.
  • Check that you have no aggregations in progress. When you migrate an integration node to Version 10.0, any live data that is being stored for aggregations in progress is lost.
  • If the integration node runs in a locale that is not listed in Locales, check that the code page is one of the supported code pages and that the locale is set up correctly.

About this task

To migrate an integration node from a previous version to Version 10.0 on z/OS, complete the following steps.

Procedure

  1. Stop all channels that are connected to the integration node.
  2. If any web browsers are connected to the web user interface for the integration node, close the web user interface browser window and clear the browser cache.
  3. Stop the integration node.
  4. Complete the steps that are defined in Creating an integration node on z/OS to create a new PDSE with customised Version 10.0 JCL scripts, but stop before you deploy IBM Integration Bus.
  5. Customize and submit the BIPMGCMP (mqsimigratecomponents) job.
    This job migrates the registry and queue.
  6. Complete the steps that are defined in Creating an integration node on z/OS to replace the Started Task JCL that is in the procedures library with the Version 10.0 Started Task JCL.
  7. Start the Version 10.0 integration node.
    The verification program checks the configuration of the integration node.

What to do next

When you have completed migration, see Performing post-migration tasks for information about tasks that you might want to perform after migration.