Formatting an IBM MQ for z/OS dump
Use this topic to understand how to format a queue manager dump using line mode IPCS commands.
The IPCS VERBEXIT CSQWDMP invokes the IBM MQ for z/OS dump formatting program (CSQWDPRD), and enables you to format an SVC dump to display IBM MQ data. We can restrict the amount of data that is displayed by specifying parameters.
IBM Service Personnel might require dumps of our coupling facility administration structure and application structures for the queue sharing group, with dumps of queue managers in the queue sharing group, to aid problem diagnosis. For information on formatting a coupling facility list structure, and the STRDATA subcommand, see the MVS IPCS Commands book. Note: This section describes the parameters required to extract the necessary data. Separate operands by commas, not blanks. A blank that follows any operand in the control statement terminates the operand list, and any subsequent operands are ignored. Table 1 explains each keyword that we can specify in the control statement for formatting dumps.| Keyword | Description |
|---|---|
| SUBSYS= aaaa | Use this keyword if the summary dump portion is not available, or not to be used, to give the name of the subsystem to format information for. aaaa is a 1 through 4-character subsystem name. |
| ALL (default) | All control blocks and the trace table. |
| AA | Data is displayed for all IBM MQ for z/OS control blocks in all address spaces. |
| DIAG=Y | Print diagnostic information. Use only under guidance from IBM service personnel. DIAG=N (suppresses the formatting of diagnostic information) is the default. |
| EB= nnnnnnnn | Only the trace points associated with this EB thread are displayed (the format of this keyword is EB= nnnnnnnn where nnnnnnnn is the 8-digit address of an EB thread that is contained in the trace). We must use this in conjunction with the TT keyword. |
| LG | All control blocks. |
| PTF=Y, LOAD= load module name | A list of PTFs at the front of the report (from MEPL). PTF=N (suppresses the
formatting of such a list) is the default.
The optional load subparameter allows you to specify the name of a load module, up to a maximum of 8 characters, for which to format a PTF report. |
| SA= hhhh | The control blocks for a specified address space. Use either of the following formats:
where h represents a hexadecimal digit. |
| SG | A subset of system-wide control blocks. |
| TT
,HANDLES=x ,LOCKS=x ,INSYNCS=x ,URINFO=ALL/LONG |
Format trace table
Indicate threads with greater than x handles Indicate threads with greater than x locks Indicate threads with greater than x insync operations Show UR info for ALL threads or for long-running threads |
Table 2 details the dump formatting keywords used to format the data relating to individual resource managers.
We cannot use these keywords in conjunction with any of the keywords in Table 1.| Keyword | What is formatted |
|---|---|
| BMC=1
BMC=2( buffer pool number ) BMC=3(xx/yyyyyy) BMC=4(xx/yyyyyy) |
Buffer manager data. BMC=1 formats control blocks of all buffers.
BMC=2 formats data relating to the buffer identified in the 2-digit buffer pool number. BMC=3 and BMC=4 display a page from a page set, if the page is present in a buffer. (The difference between BMC=3 and BMC=4 is the route taken to the page.) |
| BUFL= nnnnnnnnnnn | Storage access buffer allocation sz. |
| CALLD=Y
=W |
Show arrow for call depth in TT.
and indent trace entry. |
| CALLTIME=Y | Print call time on exit trace. |
| CB=(addr/[strmodel]) | Format address as IBM MQ block. |
| CBF=1 | CBF report level 1. |
| CCB=S | Show the Composite Capability Block (CCB) for system EBs in TT. |
| CFS=1 | CFS report level 1. |
| CFS=2 | CFS report level 2. |
| CHLAUTH=1/2
ONAM=20 chars |
CHLAUTH report level.
The optional ONAM subparameter allows you to specify the object name, up to a maximum of 20 characters, to limit data printed to objects starting with characters in ONAM. |
| CLXQ=1 | Cluster XMITQ report level 1. |
| CLXQ=2
ONAM=20 chars |
Cluster XMITQ report level 2.
The optional ONAM subparameter allows you to specify the object name, up to a maximum of 20 characters, to limit data printed to objects starting with characters in ONAM. |
| CMD=0/1/2 | Command trace table display level. |
| D=1/2/3 | Detail level for some reports. |
| Db2 =1 | Db2 report level 1. |
| DMC=1,
ONAM=48 chars |
DMC report level 1.
The optional ONAM subparameter allows you to specify the object name, up to a maximum of 48 characters, to limit data printed to objects starting with characters in ONAM. |
| DMC=2,
ONAM=48 chars |
DMC report level 2.
The optional ONAM subparameter allows you to limit the objects printed to those with names beginning with the characters specified in ONAM (up to a maximum of 48 characters). |
| DMC=3,
ONAM=48 chars |
DMC report level 3.
The optional ONAM subparameter allows you to limit the objects printed to those with names beginning with the characters specified in ONAM (up to a maximum of 48 characters). |
| GR=1 | Group indoubt report level 1. |
| IMS=1 | IMS report level 1 |
| Keyword | What is formatted |
|---|---|
| JOBNAME= xxxxxxxx | Job name |
| LKM=1 | LKM report level 1. |
| LKM=2/3,
,NAME=up to 48 chars ,NAMEX= xxxxxxxxxxxxxxxx ,NAMESP=1/2/3/4/5/6/7/8 ,TYPE=DMCP/QUALNM/TOPIC/ STGCLASS ,QUAL=GET/PUT/CRE/DFXQ/ PGSYNC/CHGCNT/ DELETE/EXPIRE LKM=3 LKM=4 ,JOBNAME= xxxxxxxx ,ASID= xxxx |
LKM report level 2/3.
Name (character) Name (Hex) Namespace Lock type
Lock qualification
LKM report level 3 LKM report level 4
|
| LMC=1 | LMC report level 1. |
| MAXTR= nnnnnnnnn | Max trace entries to format |
| MHASID= xxxx | Message handle ASID for properties |
| MMC=1
OBJ=MQLO/MQSH/MQRO/ MQAO/MQMO/MCHL/ MNLS/MSTC/MPRC/ : ' MAUT ONAM |
MMC report level 1
Object type The optional ONAM subparameter allows you to limit the objects printed to those with names beginning with the characters specified in ONAM (up to a maximum of 48 characters). |
| MMC=2
ONAM=48 chars |
MMC report level 2
The optional ONAM subparameter allows you to limit the objects printed to those with names beginning with the characters specified in ONAM (up to a maximum of 48 characters). |
| MSG=nnnnnnnnnnnnnnnn
MASID=xxxx LEN=xxxxxxxx MSGD=S/D |
Format the message at pointer.
MASID allows storage in other address spaces. LEN limits amount of storage to format. MSGD controls level of detail. |
| MSGD=S/D | Message details in DMC=3, BMC=3/4, PSID reports.
The parameter controls level of details, S is summary and D is detailed. |
| MSGH = nnnnnnnnnnnnnnnn | Message handle |
| MT | Message properties trace |
| MQVCX | MQCHARVs in hexadecimal format |
| PROPS= nnnnnnnnnnnnnnnn | Message properties pointer |
| PSID= nnnnnnnn | Page set to format page |
| PSTRX | Properties strings in hex format |
| Keyword | What is formatted |
|---|---|
| RPR= nnnnnnnn | Page or record to format |
| SHOWDEL | Show deleted records for DMC=3 |
| SMC=1/2/3 | Storage manager |
| TC=
* A E 0 |
TT data char format, concatenated
print all in suitable character set always print ASCII always print EBCDIC never print either |
| TFMT=H/M | Time format - human or STCK |
| THR= nnnnnnnn | Thread address |
| THR=*/2/3 | Set thread report level |
| TOP=1 | TOP report level 1 |
| TOP=2 | TOP report level 2 |
| TOP= nnnnnnnnnnnnnnnn
/TSTR=48 chars
/TSTRX=hex 1208 str |
Tnode 64bit address or
Topic string (wildcard with % at start or end)' This will be converted EBCDIC to ASCII, but only invariant characters Hexadecimal of topic string in 1208 always wildcard character at start. |
| TOP=3 | TOP report level 3 |
| TOP=4 | TOP report level 4 |
| TSEG=M(RU)/Q(P64)
I(NTERPOLATE) F(WD) D(EBUG) |
Search process for 64-bit trace
Guess missing TSEG address or addresses Force forward sort Debug search process |
| TSEG=(M,Q,I,F,D) | Specify multiple TSEG options |
| W=0/1/2/3 | TT width format |
| XA=1 | XA report level 1 |
| ZMH = nnnnnnnnnnnnnnnn | ZST message handle |
If the dump is initiated by the operator, there is no information in the summary portion of the dump. Table 5 shows additional keywords that we can use in the CSQWDMP control statement.
| Keyword | Description |
|---|---|
| SUBSYS= aaaa | Use this keyword if the summary dump portion is not available, or not to be used, to give the name of the subsystem to format information for. aaaa is a 1 through 4-character subsystem name. |
| SUMDUMP=NO | Use this keyword if the dump has a summary portion, but we do not want to use it. (You would usually only do this if so directed by the IBM support center.) |
- For default formatting of all address spaces, using information from the summary portion of the
dump, use:
VERBX CSQWDMP
- To display the trace table from a dump of subsystem named MQMT, which was initiated by an
operator (and so does not have a summary portion) use:
VERBX CSQWDMP 'TT,SUBSYS=MQMT'
- To display all the control blocks and the trace table from a dump produced by a subsystem abend,
for an address space with ASID (address space identifier) 1F, use:
VERBX CSQWDMP 'TT,LG,SA=1F'
- To display the portion of the trace table from a dump associated with a particular EB thread,
use:
VERBX CSQWDMP 'TT,EB= nnnnnnnn '
- To display message manager 1 report for local non-shared queue objects with a name begins with
'ABC' use:
VERBX CSQWDMP 'MMC=1,ONAM=ABC,Obj=MQLO'
Table 6 shows some other commands that are used frequently for analyzing dumps. For more information about these subcommands, see the MVS IPCS Commands manual.
| Subcommand | Description |
|---|---|
| STATUS | To display data usually examined during the initial part of the problem determination process. |
| STRDATA LISTNUM(ALL) ENTRYPOS(ALL) DETAIL | To format coupling facility structure data. |
| VERBEXIT LOGDATA | To format the in-storage LOGREC buffer records present before the dump was taken. LOGDATA locates the LOGREC entries that are contained in the LOGREC recording buffer and invokes the EREP program to format and print the LOGREC entries. These entries are formatted in the style of the normal detail edit report. |
| VERBEXIT TRACE | To format the system trace entries for all address spaces. |
| VERBEXIT SYMPTOM | To format the symptom strings contained in the header record of a system dump such as stand-alone dump, SVC dump, or an abend dump requested with a SYSUDUMP DD statement. |
| VERBEXIT GRSTRACE | To format diagnostic data from the major control blocks for global resource serialization. |
| VERBEXIT SUMDUMP | To locate and display the summary dump data that an SVC dump provides. |
| VERBEXIT DAEDATA | To format the dump analysis and elimination (DAE) data for the dumped system. |
Related concepts