Moving, or removing, a queue manager to, or from, an independent auxiliary storage pool

An example program to move a queue manager to an independent auxiliary storage pool (IASP) and commands to remove a queue manager from an IASP.

About this task

In the following example, note that:

• [MANAGER NAME] is the name of our queue manager.
• [IASP NAME] is the name of our IASP.
• [MANAGER LIBRARY] is the name of our queue manager library.
• [MANAGER DIRECTORY] is the name of our queue manager directory.

Procedure

1. Identify your primary node and your backup nodes.
2. Carry out the following procedure on your primary node:
   1. Make sure your queue manager has ended.
   2. Make sure your IASP is vary on by using the command

      VRYCFG CFGOBJ([IASP NAME]) CFGTYPE(*DEV) STATUS(*ON)

   3. Create the queue managers directory under the IASP. There will be a directory under root with the name of our IASP, which is:

      QSH CMD('mkdir -p /[IASP_NAME]/QIBM/UserData/mqm/qmgrs/')

   4. Move the IFS objects of our manager to the queue managers directory you have just created under the IASP using the following command:

      QSH CMD('mv /QIBM/UserData/mqm/qmgrs/[MANAGER NAME] 
      /[IASP NAME]/QIBM/UserData/mqm/qmgrs')

   5. Create a temporary save file named MGRLIB by using the command:

      CRTSAVF QGPL/MGRLIB

   6. Save your queue manager library to the MGRLIB save file, by using the following command:

      SAVLIB LIB([MANGER LIBRARY]) DEV(*SAVF) SAVF(QGPL/MGRLIB)

   7. Delete the queue manager library by using the following command, and ignore all the inquiry messages:

      DLTLIB [MANAGER LIBRARY]

   8. Restore your queue manager library to the IASP by using the following command:

       
      RSTLIB SAVLIB([MANAGER LIBRARY]) DEV(*SAVF) SAVF(QGPL/MGRLIB) 
      RSTASPDEV([IASP NAME])

   9. Delete the temporary save file by using the following command:

       DLTF FILE(QGPL/MGRLIB)

   10. Create a symbolic link to the queue manager IFS objects under the IASP, by using the following command:

       ADDLNK OBJ('/[IASP NAME]/QIBM/UserData/mqm/qmgrs/[MANAGER NAME]') 
       NEWLNK('/QIBM/UserData/mqm/qmgrs/[MANAGER NAME]')

   11. Attach to the IASP by using the following command:

       SETASPGRP [IASP NAME]

   12. Start your queue manager by using the command:

       STRMQM [MANAGER NAME]

3. Carry out the following procedure on your backup node, or nodes:
   1. Create a temporary queue manager directory by using the following command:

      QSH CMD('mkdir -p /[IASP NAME]/QIBM/UserData/mqm/qmgrs/[MANAGER NAME]')

   2. Create a symbolic link to the queue manager temporary directory by using the following command:

      ADDLNK OBJ('/[IASP NAME]/QIBM/UserData/mqm/qmgrs/[MANAGER NAME]') 
      NEWLNK('/QIBM/UserData/mqm/qmgrs/[MANAGER NAME]')

   3. Delete the temporary directory by using the following command:

      QSH CMD('rm -r /[IASP NAME]')

   4. Add the following at the end of the file /QIBM/UserData/mqm/mqs.ini:

      QueueManager: 
      Name=[MANAGER NAME] 
      Prefix=/QIBM/UserData/mqm 
      Library=[MANAGER LIBRARY] 
      Directory=[MANAGER DIRECTORY] 

4. To remove a queue manager from an IASP, issue the following commands:
   1. VRYCFG CFGOBJ([IASP NAME]) CFGTYPE(*DEV) STATUS(*ON)
   2. SETASPGRP [IASP NAME]
   3. ENDMQM [MANAGER NAME]
   4. DLTMQM [MANAGER NAME]

Parent topic: Overview of combining IBM i clustering capabilities with IBM MQ clustering