Use this command to display entries from the Message Queue Interface (MQI)
trace table in chronological order.
Requirements and Restrictions
You can enter this command only after Systems Network Architecture (SNA)
restart is completed.
Format
- All
- displays all the entries in the MQI trace table.
- nbr
- is the number of entries to display in the MQI trace table beginning with
the entries at the end of the table.
- ERR
- displays only the replies to MQI functions that were returned with an
error; that is, the completion code (CompCode) value does not equal
0.
- REP
- displays only the replies to MQI functions.
- REQ
- displays only the requests for MQI functions.
- CHANNEL-name
- displays only the MQI trace table entries that were processed for channel
name, where name is a 1- to 20-character channel name. A
channel name can contain percent signs (%), slashes (/),
underscores (_), periods (.), letters in either uppercase
(A-Z) or lowercase (a-z), and digits (0-9). A channel
name cannot begin or end with a period and cannot contain two consecutive
periods.
- PGM-progname
- displays only the MQI trace table entries that were processed by the
application program, where progname is the 4-character alphanumeric
name of the application program. If entered in lowercase,
progname is translated to uppercase.
- ECB-address
- displays only the MQI trace table entries that were processed by the entry
control block (ECB) at a specified address, where address is the 1-
to 8-digit hexadecimal system virtual memory (SVM) address.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZMQIT HELP
ZMQIT ?
Examples
The following information is displayed in the examples:
- O
- indicates that the MQI function request is outbound to the MQ
server.
- I
- indicates that the MQI function request is being returned to the
application program.
- CHANNEL
- is the channel name of the MQ server connection; that is, the MQI
channel directory (MQICD) entry currently being used as a transport to the MQ
server where the MQI function is processed.
- COMPCODE
- is the completion code returned to the application program after the MQI
function is processed. COMPCODE is displayed only for replies to the
application program.
- REASON
- is returned to the application program after the MQI function is
processed. REASON is displayed only for replies to the application
program.
- FUNC TYPE
- is the type of MQI function.
- PGM
- is the name of the application program that is processing the MQI
function.
- ECB ADDR
- is the (system virtual memory) SVM address of the ECB processing the MQI
function.
- TIME
- is the number of seconds between the time the application program
processed the MQI function and the time the application program received the
results. The time is displayed only for replies to the application
program.
The last four entries in the MQI trace table are displayed in the following
example.
+--------------------------------------------------------------------------------+
|User: ZMQIT 4 |
| |
|System: NMQT0001I 09.04.31 MQI TRACE TABLE |
| I FUNC ECB |
| O CHANNEL COMPCODE REASON TYPE PGM ADDR TIME |
| O OS2QMGR1CHN1 MQPUT MQA1 311000 |
| I OS2QMGR1CHN1 00000000 00000000 MQPUT MQA1 311000 0.054 |
| O OS2QMGR2CHN2 MQPUT1 MQA4 301000 |
| I OS2QMGR2CHN2 00000000 00000000 MQPUT1 MQA4 301000 0.153 |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
The last three replies to MQI functions processed over channel OS2QMGR1CHN1
are displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZMQIT 3 REP CH-OS2QMGR1CHN1 |
| |
|System: NMQT0001I 09.04.31 MQI TRACE TABLE |
| I FUNC ECB |
| O CHANNEL COMPCODE REASON TYPE PGM ADDR TIME |
| I OS2QMGR1CHN1 00000000 00000000 MQOPEN MQA1 311000 0.104 |
| I OS2QMGR1CHN1 00000000 00000000 MQPUT MQA1 311000 0.054 |
| I OS2QMGR2CHN1 00000000 00000000 MQCLOSE MQA4 301000 0.013 |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF ACF/SNA Network Generation for more
information about how to define the MQI trace table.