gtpo1m9xOperations

ZMQID DISPLAY-Display the MQI Channel Directory

Use this command to display a Message Queue Interface (MQI) channel directory entry or summary information for a set of entries.

Requirements and Restrictions

None.

Format




CHannel-name
specifies the 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.
Note:
Use the asterisk (*) as a wildcard character to specify a group of channel names. For example, to display information about all channel names beginning with MVSCHL, enter:

ZMQID DISP CHANNEL-MVSCHL*

CHL-name
specifies the channel name, where name is a 1- to 20-character channel name. A channel name can contain percent signs (%), slashes (/), underscores (_), period (.), 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.
Note:
Use the asterisk (*) as a wildcard character to specify a group of channel names. For example, to display information about all channel names beginning with OS2CHL, enter:

ZMQID DISP CHL-OS2CHL*

QMname-qmname
specifies the queue manager name to which an MQI application can request a connection, where qmname is a 1- to 48-character queue manager name. A queue manager name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). A queue manager name cannot begin or end with a period and cannot contain two consecutive periods.
Note:
Use the asterisk (*) as a wildcard character to specify a group of queue manager names. For example, to display information about all queue manager names beginning with AIXQM, enter:

ZMQID DISP QM-AIXQM*

Additional Information

Examples

The following information is displayed in the examples.

 CHANNEL 
is the name of the MQI client channel.

 CONNECTION 
is the network-qualified name of the remote partner LU (the LU name defined on the server), a host name, or Internet Protocol (IP) address.

 TRPTYPE 
is the type of communication protocol being used.

 MODE 
is the LU 6.2 mode name to use for a connection to the server. If the TRPTYPE parameter is set to TCP, this field is not displayed.

 TPNAME 
is the transaction program name on the server. If the TRPTYPE parameter is set to TCP, this field is not displayed.

 QMNAME 
is the queue manager name to which the MQI application can request a connection.

 DESCR 
is the description of the channel entry.

 RCVDATA 
is the data passed to the channel receive exit.

 RCVEXIT 
is the name of the channel receive exit program.

 SCYDATA 
is the data passed to the channel security exit.

 SCYEXIT 
is the name of the channel security exit program.

 SENDDATA 
is the data passed to the channel send exit.

 SENDEXIT 
is the name of the channel send exit program.

 MAXMSGL 
is the maximum message length supported on the client side of the connection.

A single MQI client channel entry is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMQID DIS CH-OS2CHL1                                                    |
|                                                                                |
|System: MQID0012I 10.48.54 START OF ZMQID DISPLAY                               |
|        CHANNEL      OS2CHL1                                                    |
|        CONNECTION   NET1.OS2MQLU1                                              |
|        TRPTYPE      APPC                                                       |
|        MODE         FASTPIPE                                                   |
|        TPNAME       OS2MQTP                                                    |
|        QMNAME       OS2QMGR1                                                   |
|        DESCR        MQ CLIENT CHANNEL TO QMGR1                                 |
|        RCVDATA      OS2COMPRESS                                                |
|        RCVEXIT      USR1                                                       |
|        SCYDATA      ENCRYPT1                                                   |
|        SCYEXIT      USR3                                                       |
|        SENDDATA     OS2COMPRESS                                                |
|        SENDEXIT     USR2                                                       |
|        MAXMSGL      30000                                                      |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Summary information about all the MQI channel entries that have a name beginning with the AIX characters is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMQID DISP CHANNEL AIX-*                                                |
|                                                                                |
|System: MQID0013I 13.16.12  START OF ZMQID DISPLAY                              |
|                                                                                |
|        CHANNEL       AIXCHL1                                                   |
|         CONNECTION    NET1.AIXLU01                                             |
|         QMNAME        AIXQMGR1                                                 |
|        CHANNEL       AIXCHL2                                                   |
|         CONNECTION    AIXLU02                                                  |
|         QMNAME        AIXQMGR1                                                 |
|        CHANNEL       AIXCHL3                                                   |
|         CONNECTION    USANET01.AIXLU03                                         |
|         QMNAME        AIXQMGR3                                                 |
|        CHANNEL       AIXCHL1                                                   |
|         CONNECTION    NET1.AIXLU01                                             |
|         QMNAME        AIXQMGR1                                                 |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Summary information about all the MQI channel entries that have a queue manager name beginning with the QMGR1 characters is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMQID DISP QMNAME-QMGR1*                                                |
|                                                                                |
|System: MQID0014I 13.16.12  START OF ZMQID DISPLAY                              |
|                                                                                |
|        QMNAME       QMGR1                                                      |
|         CONNECTION  NET1.AIXQLU1                                               |
|         CHANNEL     CHL1                                                       |
|        QMNAME       QMGR10                                                     |
|         CONNECTION  MQSVRLU1                                                   |
|         CHANNEL     CHL10                                                      |
|        QMNAME       QMGR11                                                     |
|         CONNECTION  USANET1.MQMVSLU1                                           |
|         CHANNEL     CHL11                                                      |
|        QMNAME       QMGR12                                                     |
|         CONNECTION  MQMVSLU1                                                   |
|         CHANNEL     CHL12                                                      |
|        QMNAME       QMGR13                                                     |
|         CONNECTION  MQMVSLU1                                                   |
|         CHANNEL     CHL13                                                      |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Summary information about all the MQI channel entries defined in the system is displayed in the following example.

+---------------------------------------------------------------------------------------------+
|User:   ZMQID DISP CH-*                                                                      |
|                                                                                             |
|System: MQID0013I 13.16.12  START OF ZMQID DISPLAY                                           |
|                                                                                             |
|        CHANNEL      chl1                                                                    |
|         CONNECTION  1.2.3.4                                                                 |
|         QMNAME      TPF.QMGR                                                                |
|        CHANNEL      chl2                                                                    |
|         CONNECTION  2.3.4.5                                                                 |
|         QMNAME      MVS.QMGR                                                                |
|        CHANNEL      chla12                                                                  |
|         CONNECTION  TPFNET.MQLU                                                             |
|         QMNAME      TPF.QMGR01                                                              |
|        END OF DISPLAY                                                                       |
+---------------------------------------------------------------------------------------------+

Related Information

See the MQSeries Distributed Queue Management Guide and MQSeries Command Reference for more information about MQSeries client and server channels.