Technical data

Managing the Queue Manager and Queue Database
13.9 Saving and Restoring the Queue Database
Example
The following example is a simple procedure showing how to save the queue
database.
$ SET DEFAULT SYS$COMMON:[SYSEXE]
$ CONVERT/SHARE QMAN$MASTER.DAT MASTERFILE_9SEP.KEEP;
$ CONVERT/SHARE SYS$QUEUE_MANAGER.QMAN$QUEUES QFILE_9SEP.KEEP;
$ INITIALIZE MUA0: QDB
$ MOUNT/FOREIGN MUA0:
%MOUNT-I-MOUNTED, QDB mounted on _LILITH$MUA0:
$ BACKUP/LOG MASTERFILE_9SEP.KEEP,QFILE_9SEP.KEEP MUA0:QDB_9SEP.SAV/LABEL=QDB
%BACKUP-S-COPIED, copied SYS$COMMON:[SYSEXE]MASTERFILE_9SEP.KEEP;
%BACKUP-S-COPIED, copied SYS$COMMON:[SYSEXE]QFILE_9SEP.KEEP;
$ DISMOUNT MUA0:
13.9.2 Restoring Queue Database Files
When you restore queue database files, all queue, form, characteristic, and queue
manager information is restored. However, information about jobs in the queues
is not restored.
How to Perform This Task
1. If the queue manager is running, stop it by entering the
STOP/QUEUE/MANAGER/CLUSTER command.
2. Delete all three queue database files. (You must delete all three files, even if
only one or two of them are lost.)
Caution
When starting a queue manager on OpenVMS, the queue manager process
always opens version number one of the queue journal file (SYS$QUEUE_
MANAGER.QMAN$JOURNAL;1). For this reason, when you restore the
queue system files with the Backup utility, you must ensure that the
latest version of the queue journal file is version number one.
3. Use the MOUNT command to mount the disk or tape containing the queue
database backup.
4. Use the Backup utility (BACKUP) to restore the queue file and master file
from the save set you created in step 3 of Section 13.9. If the master file or
queue file is stored in a location other than the default, make sure you restore
it to the correct location or that you specify the new location when you start
the queue manager.
Caution
When starting a queue manager on OpenVMS, the queue manager process
always opens version number one of the queue journal file (SYS$QUEUE_
MANAGER.QMAN$JOURNAL;1). For this reason, when you restore the
queue system files with the Backup utility, you must ensure that the
latest version of the queue journal file is version number one.
13–14 Managing the Queue Manager and Queue Database