Prepare for migration

 

Before performing a slip install or side-by-side install, carry out the following procedure:

  1. Sign on to the system with a user profile that has *ALLOBJ special authority, for example QSECOFR.

  2. Stop all applications that are using the existing version of MQ. (On MQ 5.3 and later, use the command WRKMQM, option 22 "Work with queue manager jobs", to help find them).

  3. End all MQ channels for all queue managers on the system. To do this, use the WRKMQMCHL command and select option 15.

  4. On each queue manager, end the MQ command server. To do this, enter the command:

    ENDMQMCSVR MQMNAME(QMGRNAME) OPTION(*IMMED)
    where QMGRNAME is the name of the queue manager.

  5. Remove any unwanted messages from your MQ queues.

  6. Resolve any in-doubt messages that are held by sender or server channels. To do this, use the WRKMQMCHST command and select option 17.

  7. On each queue manager, save the latest media recovery checkpoint. To do this enter the following command:

    RCDMQMIMG OBJ(*ALL) OBJTYPE(*ALL) MQMNAME(QMGRNAME) DSPJRNDTA(*YES)

  8. Quiesce the product. To do this, refer to Quiescing MQ.

  9. End the QMQM subsystem by entering the command:

    ENDSBS SBS(QMQM)

  10. Save your MQ data:

    1. Create a save file for every queue manager library on your system. To do this, issue the command:

      CRTSAVF FILE(QGPL/queue-manager-library)
      where the queue-manager-library name consists of the name of the queue manager preceded by QM.

    2. Save your queue manager libraries into the save files. To do this, issue the commands:

      SAVLIB LIB(queue-manager-library) DEV(*SAVF) 
      SAVF(QGPL/queue-manager-library)

    3. Remove all unwanted FDC data from directory QIBM/UserData/mqm/errors.

      Remove old FDC files with the command:

      RMVLNK OBJLNK('/QIBM/UserData/mqm/errors/*.FDC')
      This cleans up all files with an extension of 'FDC' in the IFS.

      Remove old JOB files with the command:

      RMVLNK OBJLNK('/QIBM/UserData/mqm/errors/*.JOB')
      This cleans up all files with an extension of 'JOB' in the IFS.

    4. Remove all unwanted trace data from directory QIBM/UserData/mqm/trace (or remove the whole directory)

      Remove all trace files with the command:

      RMVLNK OBJLNK('/qibm/userdata/mqm/trace/*')

    5. Create a save file for MQ IFS data. To do this, issue the command:

      CRTSAVF FILE(QGPL/QMUSERDATA)

    6. Save your MQ IFS data, using the command:

      SAV DEV('/QSYS.LIB/QGPL.LIB/QMUSERDATA.FILE') OBJ('/QIBM/UserData/mqm')

  11. If you are moving from running MQ on any machine to WebSphere MQ on a new machine, transfer the save files to the new machine.

 

Parent topic:

Migrating from MQ V5.1 or later