Collecting information for shared queue problems on z/OS

If you need assistance to resolve a shared queue problem on IBM® MQ for z/OS®, you might need to collect troubleshooting information to include with your support case to help find a solution to the problem.

Before you begin

Before you start this task, answer the following questions about the problem:

What is the name of the shared queue having a problem?
What is the name of the IBM MQ Coupling Facility structure (CFSTRUCT) associated with the problematic shared queue?
What is the message id associated with the problem?
What is the name of the queue sharing group?
What time did the problem occur?
Which queue manager in the queue sharing group is involved?

About this task

If you can reproduce the shared queue problem or the problem is happening right now, you can generate data to provide more information about the problem.

After collecting the troubleshooting information, you can send it to IBM.

Procedure

Generate the following traces while the problem is happening:
Collect the data.
The following steps include an example of dumping both application structure and the IBM MQ Administration structure.
1. Record the version, release, and maintenance levels your software:
  - For IBM MQ, find the version in the CSQY000I message in the MSTR job log.
  - For the z/OS operating system, find the version in the output of /D IPLINFO in SDSF.
  - For any other products involved with the problem, look for the version in the job log for the product.
2. Collect the IBM MQ MSTR and CHIN joblogs and, optionally, collect the syslog.
3. Collect a z/OS LOGREC report.
  See A LOGREC report and SYS1.LOGREC information on z/OS.
4. Save any z/OS dumps that you generated from IBM MQ.
  IBM MQ dumps are located in a system dump data set and can be identified by their title. The title for a dump requested by IBM MQ starts with the four-character subsystem name of the queue manager. For example:
```
CSQ1,ABN=5C6-00E20016,U=SYSOPR ,C=MQ900.910.DMC -CSQIALLC,M=CSQGFRCV,LOC=CSQSLD1 .CSQSVSTK+00000712
```
  Comm dumps might not contain the queue manager name, depending on the comment specified in the dump command. Check the syslog for an IEA611I or IEA911E message to determine the dump data set name and also to see whether the dump is complete or partial. For example:
```
IEA611I COMPLETE DUMP ON DUMP.MQT1MSTR.DMP00074
DUMPID=074 REQUESTED BY JOB(MQT1MSTR)
FOR ASID(005E)

IEA911E PARTIAL DUMP ON SYS1.MCEVS4.DMP00039
DUMPID=039 REQUESTED BY JOB(DMSGTODI)
FOR ASID(00D2)
```
5. Collect Coupling Facility Structure dumps for the application Structure and the IBM MQ Administration Structure:
```
/DUMP COMM=(title)
/R nnn,SDATA=(ALLNUC,LPA,PSA,RGN,SQA,TRT,CSA,XESDATA,COUPLE,GRSQ),CONT
/R nnn,JOBNAME=(ssidMSTR),CONT
/R nnn,STRLIST=(STRNAME=QSGnameStructurename,(LISTNUM=ALL,
ADJUNCT=CAPTURE,ENTRYDATA=UNSER),EVENTQS,(EMCONTROLS=ALL),
/R nnn,STRNAME=QSGnameCSQ_ADMIN,(LISTNUM=ALL,ADJUNCT=CAPTURE,
ENTRYDATA=UNSER),EVENTQS,(EMCONTROLS=ALL)),END
```
  where ssid is the subsystem ID for the queue manager.
  
  An example of QSGnameStructurename is QSG1APPLICATION where QSG1 is the queue sharing group name.
  
  An example of QSGnameCSQ_ADMIN is QSG1CSQ_ADMIN.
  The following example shows dumping the application structure solely:
```
/DUMP COMM=(title)
/R xx,STRLIST=(STRNAME=QSGnameStructurename,(LISTNUM=ALL,
ADJUNCT=CAPTURE,ENTRYDATA=UNSER),EVENTQS,(EMCONTROLS=ALL))
```
  An example of QSGnameStructurename is QSG1APPLICATION where QSG1 is the queue sharing group name.
Use the AMATERSE utility before uploading to ECUREP, and ensure you specify the case number with which the data is associated.

For more information, see Using AMATERSE in the z/OS Communications Server: IP Diagnosis Guide.
Send the information that you have collected to IBM.

A good description of the problem and the data is the most important information you can provide to IBM. Do not send data without providing a description!

For FTP and email instructions, see Exchanging information with IBM Software Support.

To open or update a case, go to the IBM My Support site.
Note: Always update your case to indicate that data was sent.

If you need to speak with IBM Software Support, contact your country representative. If you need to speak with IBM Support in the US, you can call 1-800-IBM-SERV.