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 your queue manager.
[IASP NAME] is the name of your IASP.
[MANAGER LIBRARY] is the name of your queue manager library.
[MANAGER DIRECTORY] is the name of your queue manager directory.

Procedure

Identify your primary node and your backup nodes.
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 your IASP, which is:
```
QSH CMD('mkdir -p /[IASP_NAME]/QIBM/UserData/mqm/qmgrs/')
```
4. Move the IFS objects of your 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]
```
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] 
```
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]