IBM Support

Collect IBM MQ MustGather data to solve shutdown problems on z/OS

Technote (troubleshooting)


An IBM MQ queue manager is experiencing a problem with shutdown (eg. abend or hang) and you need to collect MustGather data to find a solution.


The instructions apply only to IBM MQ V8.0, 7.1, and 7.0.1 on z/OS. Refer to the IBM MQ Read First page for instructions on other operating systems.

Resolving the problem

Please answer these questions about the problem and then follow the steps below:

  • Was shutdown accompanied by an abend in either the queue manager or channel initiator ?
  • Was shutdown associated with an apparent wait or hang ?
  • Was any rise in CPU noted or possible loop condition?

Step 1: Generate Data

If the shutdown problem is reproducible or is happening right now, generate data to provide more information about the problem:

  1. If shutdown abends then provide the dump produced; otherwise manually generate a dump.

  2. Some additional useful diagnostics for shutdown problems include :

Step 2: Prepare Data to Send

  1. Preparatory steps apply to dumps, traces and joblogs.

  2. Use TRSMAIN/AMATERSE utility before uploading to ECUREP and ensure PMR#, B/O#, Country# is specified.

    1. Joblogs may be emailed if not too large.

  3. FTP must be done in BINARY mode only.

    Use Email to provide summary information

    1. Email address :

      Subject line must include PMR#, B/O#, Country#


    2. See message CSQY000I for z/OS MQ level and for distributed MQ see here.

    3. Record the operating system version and maintenance level on both sides of the channel.

Step 3: Send Data to IBM

  1. Send your data to the IBM ECuRep repository After confirmation, emails may be sent to

  2. While the data is transferring, send an email or use the IBM Service Request tool to update your PMR with your description of the problem and of the data you are sending.

  3. Contact your country representative if you need to speak to an IBM technical support representative, or in the US call 1-800-IBM-SERV. Refer to the IBM Software Support Handbook for more information on working with IBM.

Cross reference information
Segment Product Component Platform Version Edition
Business Integration IBM MQ Shutdown z/OS

Product Alias/Synonym


Document information

More support for: WebSphere MQ

Software version: 5.3.1, 6.0, 7.0, 7.0.1, 7.1, 8.0, 9.0

Operating system(s): z/OS

Reference #: 1634794

Modified date: 20 August 2014