IBM Support

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

Technote (troubleshooting)


An IBM MQ on z/OS queue manager is experiencing a problem with startup and you need to collect MustGather data to find a solution.


The instructions apply only to IBM MQ V9.0, V8.0, 7.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:

  • What startup problem did you observe on the system?
  • What changes may have been made prior to the problem?
  • Was this a new install/migration and is the QMGR within a queue-sharing group?

Step 1: Generate Data

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

  1. Obtain / generate dump and collect additional output.

  2. Level 2 may provide a slip trap to generate a dump if a dump is not automatically generated.

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 WebSphere MQ level

    3. Record the operating system version and maintenance level

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.

Product Alias/Synonym


Document information

More support for: WebSphere MQ

Software version: 7.1, 8.0, 9.0

Operating system(s): z/OS

Reference #: 1634791

Modified date: 02 August 2017

Translate this page: