Start of change

Migrating a Version 5.0 broker to Version 6.0 on z/OS

Before you start

This task is part of the following larger task: See the larger task to understand the context of this task and what you must do before you start this task.

To migrate a Version 5.0 broker on z/OS to Version 6.0, complete the following steps:

  1. Install WebSphere Business Integration Event Broker Version 6.0 in a location other than where WebSphere Business Integration Event Broker Version 5.0 is installed; this can be a different location on the same system, or on a second system. For detailed instructions, see Installation Guides.
  2. Stop the Version 5.0 broker. For detailed instructions, see the WebSphere Business Integration Event Broker Version 5.0 information center.
  3. Create a Version 6.0 broker. You can use the mqsicompcif from the Version 5.0 broker as a basis for the new broker, modifying the old values as required. Follow the instructions in Creating a broker on z/OS with the following modifications:
    1. When you customize the JCL, copy any additional changes that you have made to the environment file ENVFILE and the ODBC initialization file dsnaoini to BIPBPROF and BIPDSNAO in the component dataset. Submit the BIPGEN job to create the environment file ENVFILE.
    2. When you copy the Started Task, keep a second copy of the original in a safe place for backup purposes.
    3. Do not start the broker.
  4. Migrate the broker database tables. For detailed instructions, see Migrating a Version 5.0 broker's database tables on z/OS.
  5. In the directory migrated broker's directory/registry/broker name, complete the following steps:
    1. Copy the file BrokerUUID from the corresponding directory of the original broker.
    2. Compare the contents of the directory, both the files and their contents, with the contents of the corresponding directory of the original broker:
      • The contents of the files LilPath, FilePath, and WorkPath will be different to the contents of the corresponding files of the original broker. You do not need to modify these files of the Version 6.0 broker to match the files of the original broker.
      • The contents of the remaining files will be identical to the contents of the corresponding files of the original broker unless you have changed any of the original broker's files. If you have made changes, incorporate the changes into the migrated broker's files.
      • Copy into the directory any files that you have added to the corresponding directory of the original broker.
  6. Start the Version 6.0 broker. For detailed instructions, see Starting the broker. When you start the broker, the verification program will run.
Related concepts
Broker
Related tasks
Starting the broker
Migrating a Version 5.0 broker's database tables on z/OS
Creating a broker on z/OS
Migrating a broker from WebSphere Business Integration Event Broker Version 5.0 to WebSphere Business Integration Event Broker Version 6.0
Installation Guides


End of change