IBM Support

Cold Start Procedure for IBM MQ for IBM i

Troubleshooting


Problem

STRMQM fails to start the Manager successfully.

Symptom

STRMQM fails to start the IBM MQ Manager.  Possible errors:
AMQ7432 "IBM MQ journal entry not available for replay" or
AMQ7017 "Log not available"

Cause

This situation is usually caused by an IBM MQ Administrator deleting journal receivers that are required by the IBM MQ product for successful startup.

Diagnosing The Problem

STRMQM does not successfully start the Manager.  DSPJOBLOG after the STRMQM shows errors with IBM MQ log replay.
AMQ7432 "IBM MQ journal entry not available for replay"
AMQ7017 "Log not available"
Most of these problems occur because journal receivers required for STRMQM processing were deleted.  Consider restoring the missing journal receivers from a save (where all the missing journal receivers were fully saved) as an alternate to the Cold Start.

Resolving The Problem

WARNING
This procedure MAY discard some message data. This risk varies depending on many factors.
Managers quiesced with ENDMQM that completed successfully are least likely to have data loss.
Persistent message loss can occur with the Cold Start procedure when the Manager was previously crashed instead of quiesced with the ENDMQM command.  
('Crash' could be from IPL, ENDSBS QMQM, ENDJOB, or any other ending of the Manager without using the ENDMQM command)
Non-persistent messages are not retained for any Manager restart (ENDMQM or crash down).
To minimize the risk of data loss during recovery, do not Cold Start.  Instead, restore the missing journal receivers from a proper backup instead of performing the Cold Start.

With modern versions of IBM MQ, try Step 4 to delete the Manager's QMQMCHKPT file and then try STRMQM.  This action is often called a "Cool Start"
If the Manager still fails to start, perform all 15 steps.
_________________________________________________________________________________
Cold Start Procedure:
NOTES:
     Qmgrlib is the name of library used by the Manager.  Check this library name with command DSPF '/qibm/userdata/mqm/mqs.ini' and find the stanza
for that Manager.
     QmgrName is the name of your queue manager.
     There maybe other considerations like High Availability products replicating data.  Consult that product documentation for any concerns.
     You can copy these steps into an editor and use "find/replace" to replace the Qmgrlib and QmgrName with your values.
  1.     Collect the following journal information
        a. WRKJRNA JRN(Qmgrlib/AMQAJRN)
        Manage receivers: ______________________
        Delete receivers: _______________________
        b. Press F17(Display attached receiver attributes) and record the threshold value for the currently attached journal receiver.
        Threshold (K): ______________________
        c. DSPOBJAUT OBJ(Qmgrlib/AMQAJRN) OBJTYPE(*JRN)
        By default QMQM has *ALLOBJ authority to AMQAJRN. If you have other user profiles that have authority to AMQAJRN note them here. *PUBLIC is normally *EXCLUDE.
        _______________________
        _______________________
  2. DLTJRN JRN(Qmgrlib/AMQAJRN)
  3. DLTJRNRCV JRNRCV(Qmgrlib/AMQA*) DLTOPT(*IGNINQMSG)
  4. RMVLNK OBJLNK('/QIBM/UserData/mqm/qmgrs/QmgrName/qmqmchkpt')
  5. CRTJRNRCV JRNRCV(Qmgrlib/AMQA000000) THRESHOLD(See Step 1b)
  6. CHGOBJOWN OBJ(Qmgrlib/AMQA000000) OBJTYPE(*JRNRCV) NEWOWN(QMQM)
  7. CHGOBJPGP OBJ(Qmgrlib/AMQA000000) OBJTYPE(*JRNRCV) NEWPGP(QMQMADM)
  8. CRTJRN JRN(Qmgrlib/AMQAJRN) JRNRCV(Qmgrlib/AMQA000000) MSGQ(Qmgrlib/AMQAJRNMSG) MNGRCV(See Step 1a)
  9. CHGOBJOWN OBJ(Qmgrlib/AMQAJRN) OBJTYPE(*JRN) NEWOWN(QMQM)
  10. CHGOBJPGP OBJ(Qmgrlib/AMQAJRN) OBJTYPE(*JRN) NEWPGP(QMQMADM)
  11. If needed, GRTOBJAUT OBJ(Qmgrlib/AMQAJRN) OBJTYPE(*JRN) USER(See Step 1c) AUT(*ALL)
  12. If needed, GRTOBJAUT OBJ(Qmgrlib/AMQA000000) OBJTYPE(*JRNRCV) USER(See Step 1c) AUT(*ALL)
  13. Sign off on all IBM i sessions and sign on to one session
  14. STRMQM
  15. RCDMQMIMG OBJ(*ALL) OBJTYPE(*ALL) MQMNAME(QmgrName)

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"ARM Category":[{"code":"a8m0z00000008OqAAI","label":"Components and Features->Logging \/ Recovery \/ RRS"},{"code":"a8m0z00000008LUAAY","label":"Crashes->Cold Start"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Version(s)"}]

Document Information

Modified date:
01 November 2021

UID

swg21140850