WebSphere Message Brokers
File: ah23844_
Writer: Kate Hostler

Task topic

This build: July 31, 2007 21:30:37

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

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

To migrate a Version 5.0 User Name Server to Version 6.1 on z/OS, complete the following steps:

  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.1 installed SBIPPROC and SBIPSAMP PDSEs to the new User Name Server PDSE and customize them all.

    When you customize the new Version 6.1 JCL for this migration, do not make the ++HOME++ JCL variable the same value as the existing Version 5.0 component directory, otherwise the previous ENVFILE will be overwritten when you submit the BIPGEN job. Set the ++HOME++ variable to the Started Task user ID home directory (for example, /u/mq01uns).

    1. Customize the BIPEDIT file using values that are defined in the User Name Server's Version 5.0 mqsicompcif file. 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.1 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.1 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.1
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, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:30:37

ah23844_ This topic's URL is: