Restoring journal receivers for a particular queue manager
The most common action is to restore a backed-up journal receiver to a queue manager library, if a receiver that has been removed is needed again for a subsequent recovery function.
This is a simple task, and requires the journal receivers to be restored using the standard i5/OS RSTOBJ command:
RSTOBJ OBJ(QMQMDATA/AMQA000005) OBJTYPE(*JRNRCV) .........A series of journal receivers might need to be restored, rather than a single receiver. For example,
AMQA000007 is the oldest receiver in the WebSphere MQ libraries, and both
AMQA000005 and AMQA000006 need to be restored.
In this case, restore the receivers individually in reverse chronological order. This is not always necessary, but is good practice. In severe situations, you might need to use the i5/OS command
WRKJRNA to associate the restored journal receivers with the journal.
When restoring journals, the system automatically creates an attached journal receiver with a new name in the journal receiver sequence. However, the new name generated might be the same as a journal receiver we need to restore. Manual intervention is needed to overcome this problem; to create a new name journal receiver in sequence, and new journal before restoring the journal receiver.
For instance, consider the problem with saved journal AMQAJRN and the following journal receivers:
- AMQA000000
- AMQA100000
- AMQA200000
- AMQA300000
- AMQA400000
- AMQA500000
- AMQA600000
- AMQA700000
- AMQA800000
- AMQA900000
When restoring journal AMQAJRN to a queue manager library, the system automatically creates journal receiver AMQA000000. This automatically generated receiver conflicts with one of the existing journal receivers (AMQA000000) you want to restore, which we cannot restore.
The solution is:
- Manually create the next journal receiver (see WebSphere MQ for iSeries journals):
CRTJRNRCV JRNRCV(QMQRLIB/AMQA900001) THRESHOLD(XXXXX)- Manually create the journal with the above journal receiver:
CRTJRN JRN(QMGRLIB/AMQAJRN) MNGRCV(*SYSTEM) + JRNRCV(QMGRLIB/AMQA9000001) MSGQ(QMGRLIB/AMQAJRNMSG)- Restore the local journal receivers AMQA000000 to AMQA900000.