gtpo1m9yOperations

ZMQIT-Display the MQI Trace Table Entries

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.