Migrating a Version 5.0 User Name Server to Version 6.0 on z/OS

Migrate a Version 5.0 User Name Server to Version 6.0.

Before you start
  • Ensure that you are familiar with the steps involved in creating a User Name Server on z/OS®.
  • The JCL job uses the mqsimigratecomponents command to migrate a User Name Server on z/OS. This command takes many parameters, which you must understand fully before you attempt to migrate the User Name Server.

To migrate a WebSphere® Message Broker Version 5.0 User Name Server to Version 6.0 on z/OS:

  1. Stop the Version 5.0 User Name Server.
  2. Create a new User Name Server PDSE.
  3. Copy all User Name Server JCL from the Version 6.0 installed SBIPPROC and SBIPSAMP PDSEs to the new User Name Server PDSE and customize them all.

    You must take a backup copy of your Version 5.0 ENVFILE, which is stored in the directory referenced by the ++HOME++ JCL variable, before you submit BIPGEN from the Version 6.0 component data set. Subsequently, if you want to migrate back to Version 5.0, restore ENVFILE, either from the backup file location, or by submitting BIPGEN from the Version 5.0 component data set, before you start the Version 5.0 User Name Server.

    1. Customize the BIPEDIT file using values that are defined in the mqsicompcif file for the Version 5.0 User Name Server. Equivalent z/OS customization variables in mqsicompcif and BIPEDIT lists the customization variables that are used in the Version 5.0 mqsicompcif file, and the equivalent variables in the Version 6.0 BIPEDIT file.
    2. Copy any additional changes that you have made to the environment file, ENVFILE, to BIPUPROF in the component data set. Submit the BIPGEN job to create the environment file, ENVFILE.
    3. Customize and submit the BIPMGCMP job.
  4. Copy the started task JCL (BIPUNSP) to the procedures library. When you copy the started task, keep a second copy of the original in a safe place for backup purposes.
  5. The verification program runs when you start the Version 6.0 User Name Server.
When you have migrated the User Name Server, ensure that you have migrated the rest of the components:

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

Related concepts
User Name Server
Related tasks
Starting and stopping the User Name Server
Creating a User Name Server on z/OS
Creating the User Name Server PDSE
Customizing the User Name Server JCL
Copying the User Name Server started task to the procedures library
Migrating from WebSphere Business Integration Message Broker Version 5.0 to WebSphere Message Broker Version 6.0
Related reference
Equivalent z/OS customization variables in mqsicompcif and BIPEDIT
Sample BIPEDIT file
Installation Guide
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:22:09

ah23844_