gtpo1maeOperations

ZMQSC DISPLAY-Display TPF MQSeries Information

Use this command to display:

Requirements and Restrictions

Format






















PROCESS
specifies the name of the process object to be displayed, where:

processname
specifies the name of a process object that is defined on the local queue manager, where processname is the 1- to 48-character process name. A process name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If processname is enclosed in single quotation marks, the characters can be mixed case.

partprocessname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of process objects that are defined on the local queue manager. For example, to display information about all process objects beginning with WEB, enter:

ZMQSC DISPLAY PROCESS-WEB*

ALL
displays all the process names.

QMGR
displays the current TPF MQSeries profile.

CHL
specifies the name of the channel definition you want to display, where:

name
is the 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). If the name is enclosed in single quotation marks, the characters can be mixed case.

partname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of channel names. For example, to display information about all channel names beginning with WEB, enter:

ZMQSC DISPLAY CHL-WEB*

ALL
displays all the channels for the specified central processing unit (CPU).

CPU
displays the message channel definitions or status for the specified CPU, where:

cpuid
is a 1-character CPU ID.

localid
is the local CPU ID from which the command is currently running. This is the default.

CHS
specifies the name of the channel definition for which status information is displayed, where:

name
is the 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). If the name is enclosed in single quotation marks, the characters can be mixed case.

partname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of channel names. For example, to display information about all channel names beginning with WEB, enter:

ZMQSC DISPLAY CHS-WEB*

ALL
displays the current status for all channels.

QL
specifies the local queue definition to be displayed, where:

qlname
is a 1- to 48-character single local queue name. A queue name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

partqlname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of local queue names. For example, to display information about all local queue names beginning with WEB, enter:

ZMQSC DISPLAY QL-WEB*

ALL
displays all the local queues.

QR
specifies the remote queue definition to be displayed, where:

qrname
is a 1- to 48-character single remote queue name. A queue name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

partqrname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of remote queue names. For example, to display information about all remote queue names beginning with WEB, enter:

ZMQSC DISPLAY QR-WEB*

ALL
displays all the remote queues.

QA
specifies the queue alias definition to be displayed, where:

qaname
is a 1- to 48-character single alias queue name. A queue name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

partqaname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of alias queue names. For example, to display information about all alias queue names beginning with WEB, enter:

ZMQSC DISPLAY QA-WEB*

ALL
displays all the alias queues.

Queue
specifies the queue definition to be displayed, where:

qname
is a 1- to 48-character single queue name. A queue name can contain percent signs (%), slashes (/), underscores (_), periods (.), letters in either uppercase (A-Z) or lowercase (a-z), and digits (0-9). If the name is enclosed in single quotation marks, the characters can be mixed case.

partqname
is the first few characters of a channel name followed by an asterisk (*) as a wildcard character to specify a group of queue names. For example, to display information about all queue names beginning with WEB, enter:

ZMQSC DISPLAY Q-WEB*

ALL
displays all the queues.

AUTOSTART
displays whether a channel starts automatically or not.

BATCHES
displays the total number of batches processed by a channel.

BATCHSZ
displays the negotiated batch size currently being used on a channel.

BUFSRCVD
displays the total number of buffers received from the remote channel.

BUFSSENT
displays the total number of buffers sent to the remote channel.

BYTESRCVD
displays the total number of bytes received from the remote channel.

BYTESSENT
displays the total number of bytes sent to the remote channel.

CHLTYPE
displays the type of channel that is being displayed.

CHNAME
displays a channel name of a local queue.

COMMON
displays whether a local queue is common or not.

CONNAME
displays the host Internet Protocol (IP) address or host name for the remote channel.

CRDATE
displays the date when a defined local queue was created.

CRTIME
displays the time when a defined local queue was created.

CURDEPTH
displays the total number of messages currently on a local queue.

CURLUWID
displays the logical unit of work identifier (LUWID) for the last message processed by a channel.

CURSEQNUM
displays the sequence number for the last message processed (sent or received) by a channel.

CURSPID
displays the current sweep persistent identifier (PID) for a local queue.

DATESTART
displays the date when a channel was started.

DEFPSIST
displays the default persistence for a queue.

DELETED
displays whether or not a queue has been deleted.

DELPND
displays whether there is a pending delete on a local queue.

FIRSTSPID
displays the first sweep PID for a local queue.

GET
displays whether or not applications can retrieve messages from a queue.

GETCOUNT
displays the MQGET calls that have been issued to a local queue.

INDOUBT
displays whether a channel is in an in-doubt condition or not.

INSTID
displays the instance ID of a queue.

IPADDR
displays the Internet Protocol (IP) address of one remote host or all remote hosts, where:

host
is a 1- to 256-character host name (alphanumeric characters and periods) or the host IP address (numeric characters and dotted decimal notation).

ALL
displays the IP address of all remote hosts.

LOCALIP
displays the local IP address that is used when establishing a connection.

LSTLUWID
displays the LUWID for the last message acknowledged.

LSTMSGDAT
displays the date when the last message was processed.

LSTMSGTIM
displays the time when the last message was processed.

LSTSEQNUM
displays the sequence number for the last message that has been acknowledged.

MAXDEPTH
displays the maximum number of messages allowed on a memory queue.

MAXMSGL
displays the maximum message length of a local queue.

MEMORY
displays whether or not a local queue is a memory queue.

MESSAGES
displays the total number of messages processed by a channel.

MODIFIED
displays whether or not a queue was modified

MRDATA
displays the data that will be passed to the channel message retry user exit.

MREXIT
displays whether the channel message retry user exit is called or not.

MSGDATA
displaysthe data that will be passed to the channel message user exit.

MSGEXIT
displays whether the channel message user exit is called or not.

MSGLPNTRS
displays information about the message list pointers for a local queue.

MSGSWEPT
displays the number of messages that were swept for a local queue.

NPERMSGS
displays the number of nonpersistent messages on a local queue.

NPMSPEED
displays the speed at which nonpersistent messages are transported on a channel.

NUMMQCLOSE
displays the number of closed queues on a local queue.

NUMMQOPEN
displays the number of open queues on a local queue.

PERMSGS
displays the number of persistent messages on a local queue.

PROCESS
displays the name of a process object that is defined on a local queue manager.

PUT
displays whether applications can add messages to a local queue or not.

QADDRESS
displays the queue address in system heap for a local queue.

QDEPTHHI
displays the percentage of messages that are allowed before a warning message is sent to the console.

QMGRNAME
displays the queue manager name for a queue.

QSWEEP
displays whether there is a queue sweep in progress for a local queue.

RCVR
displays all receiver channels.

RNAME
displays the name of a remote queue.

RQMNAME
displays the name of a remote queue manager.

SCYDATA
displays the data passed to the security exit.

SCYEXIT
displays whether the channel security exit is called or not.

SDR
displays all sender channels.

SEQWRAP
displays the sequence wrap value for a channel.

SOCKBUF
displays the socket buffer size.

SOCKNO-socknum
displays the channel instance of a socket number, where socknum is the 6- to 8-digit hexadecimal socket descriptor.

SWEEP
displays whether sweeping is on or off for a local queue.

SWEPTPID
displays the number of swept PIDs for a local queue.

SWTARGET
displays the swing target of a local queue.

TARGQ
displays the base queue name.

TIMESTART
displays the time when a channel was started.

TRIGGER
displays whether or not triggering is active for a local queue.

TRIGDATA
displays the data that the queue manager inserts into the trigger message when a message arrives on a local queue.

TRIGTYPE
displays the type of triggering used for a local queue.

TRPTYPE
displays the type of communication protocol for a channel.

USAGE
displays the usage of a local queue.

XMITQ
displays the transmission queue used by the sender channel.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZMQSC HELP

ZMQSC ?

Examples

The following example displays information about the CreditCard process .

+--------------------------------------------------------------------------------+
|User:    ZMQSC DISP PROCESS-'CreditCard'                                        |
|                                                                                |
|System:  MQSC0702I 09.17.22 PROCESS CreditCard DISPLAY :                        |
|             APPLICID -  CDEF                                                   |
|             USERDATA - RUN CREDIT CHECK                                        |
|             ENVIRDATA -                                                        |
|             DESCR -                                                            |
|             APPLTYPE - TPF                                                     |
+--------------------------------------------------------------------------------+

The following example displays the current status for channel TPF.TO.NT.1, where:

 CHLTYPE 
displays the type of the channel for which status is being displayed.

 CONNAME 
displays the host Internet Protocol (IP) address or host name for the remote channel.

 NPMSPEED 
displays the speed at which nonpersistent messages are transported on the channel (FAST or NORMAL).

 XMITQ 
displays the transmission queue used by this channel if CHLTYPE is SDR.

 INDOUBT 
displays if the channel is in an in-doubt condition (YES or NO).

 CUR SEQ NUM 
displays the sequence number for the last message processed (sent or received) by the channel.

 LST SEQ NUM 
displays the sequence number for the last message that has been acknowledged.

 LST MSG TIM 
displays the time when the last message was processed.

 TIMESTARTED 
displays the time when the channel was started.

 LST MSG DAT 
displays the date when the last message was processed.

 DATESTARTED 
displays the date when the channel was started.

 CUR LUWID 
displays the logical unit of work identifier (LUWID) for the last message processed by the channel.

 LAST LUWID 
displays the LUWID for the last message acknowledged.

 MESSAGES 
displays the total number of messages processed by the channel.

 BATCHES 
displays the total number of batches processed by the channel.

 BYTES RCVD 
displays the total number of bytes received from the remote channel.

 BYTES SENT 
displays the total number of bytes sent to the remote channel.

 BUFS RCVD 
displays the total number of buffers received from the remote channel.

 BUFS SENT 
displays the total number of buffers sent to the remote channel.

 BATCHSIZE 
displays the negotiated batch size currently being used on the channel.

 SEQ WRAPVAL 
displays the sequence wrap value for the channel.
+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS CHS-TPF.TO.NT.1                                              |
|                                                                                |
|System:  MQSC0085I 06.57.41 CHANNEL TPF.TO.NT.1 READY                           |
|         CHLTYPE     - SDR                                                      |
|         CONNAME     - 9.117.147.92                                             |
|         NPMSPEED    - NORMAL                                                   |
|         XMITQ       - TPFXMITQ1              INDOUBT     - NO                  |
|         CUR SEQ NUM - 37                     LST SEQ NUM - 37                  |
|         LST MSG TIM - 11.57.32               TIMESTARTED - 11.57.30            |
|         LST MSG DAT - 2002-01-16             DATESTARTED - 2002-01-16          |
|         CUR LUWID   - B0FFF011C35E3A01       LAST LUWID  - B0FFF00F7161BC07    |
|         MESSAGES    - 48                     BATCHES     - 14                  |
|         BYTES RCVD  - 544                    BYTES SENT  - 28045               |
|         BUFS RCVD   - 19                     BUFS SENT   - 56                  |
|         BATCHSIZE   - 10                     SEQ WRAPVAL - 999999999           |
|         SOCK BUFFER - Default                LOCAL IP    -                     |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays the local queue manager name and TPF MQSeries profile.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DISPLAY QMGR                                                     |
|                                                                                |
|System:  MQSC0203I 08.11.25 QUEUE MANAGER PROFILE DISPLAY                       |
|         QManager Name              - TPFQMGR                                   |
|         QManager Version           - 2                                         |
|         Current State              - STARTED                                   |
|         Default QDEPTHHI           - 25                                        |
|         Q Depth Check Interval     - 15                                        |
|         Default Batch Size         - 500                                       |
|         Default Max Message Length - 1040000                                   |
|         Default Max Queue Depth    - 500                                       |
|         Default Sweep              - ON                                        |
|         Checkpoint Interval        - 5                                         |
|         Dead Letter Queue Name     - DEAD.LETTER.QUEU                          |
|         QUEUE MANAGER STARTED ON: B                                            |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays information for normal usage local queue TPFLOCALQ1, where:

 Current Depth 
displays the total number of messages currently on the queue.

 Persistent Msgs 
displays the total number of persistent messages, along with their total length in bytes, that were placed on the queue since the queue manager was last started.

 NonPersist Msgs 
displays the total number of nonpersistent messages, along with their total length in bytes, that were placed on the queue since the queue manager was last started.

 Num of MQOPEN 
displays the total number of times that applications have issued MQOPEN for the queue.

 Num of MQCLOSE 
displays the total number of times that applications have issued MQCLOSE for the queue.

 Default Sweep 
displays whether memory queues are moved (swept) to a TPF collection support (TPFCS) persistent collection when the number of messages on the queue are increasing
+--------------------------------------------------------------------------------+
| User:   ZMQSC DIS QL-TPFLOCALQ1                                                |
|                                                                                |
|System:  MQSC0201I 09.37.17 LOCAL QUEUE DISPLAY:                                |
|         Queue Name      - TPFLOCALQ1                                           |
|         QManager Name   - TPFQM                                                |
|         Queue Type      - LOCAL                                                |
|         Usage           - NORMAL                                               |
|         Delete Pending  - NO                                                   |
|         Common          - NO                                                   |
|         Max Msg Length  - 10240                                                |
|         Current Depth   - 0                                                    |
|         Put             - ENABLED                                              |
|         Get             - ENABLED                                              |
|         Persistent Msgs - 0 (0 Bytes)                                          |
|         NonPersist Msgs - 0 (0 Bytes)                                          |
|         Num of MQOPEN   - 0                                                    |
|         Num of MQCLOSE  - 0                                                    |
|         Process Name    -                                                      |
|         Trigger Data    -                                                      |
|         Trigger Control - ON                                                   |
|         Trigger Type    - FIRST                                                |
|         QDEPTHHI        - 0%                                                   |
|         MAXDEPTH        - 5000                                                 |
|         SWEEP           - ON                                                   |
|                  END OF DISPLAY                                                |
+--------------------------------------------------------------------------------+

The following example displays information for a normal local processor shared queue:

+--------------------------------------------------------------------------------+
| User:   ZMQSC DIS QL-TPFCOMMONQ1                                               |
|                                                                                |
|System:  MQSC0201I 09.37.55 LOCAL QUEUE DISPLAY:                                |
|         Queue Name      - TPFCOMMONQ1                                          |
|         QManager Name   - TPFQM                                                |
|         Queue Type      - LOCAL                                                |
|         Usage           - NORMAL                                               |
|         Delete Pending  - NO                                                   |
|         Common          - YES                                                  |
|         Max Msg Length  - 10240                                                |
|         Current Depth   - 0                                                    |
|         Put             - ENABLED                                              |
|         Get             - ENABLED                                              |
|         Persistent Msgs - 0 (0 Bytes)                                          |
|         NonPersist Msgs - 0 (0 Bytes)                                          |
|         Num of MQOPEN   - 0                                                    |
|         Num of MQCLOSE  - 0                                                    |
|         Process Name    -                                                      |
|         Trigger Data    -                                                      |
|         Trigger Control - OFF                                                  |
|         Trigger Type    - FIRST                                                |
|                  END OF DISPLAY                                                |
+--------------------------------------------------------------------------------+

The following example displays information for local transmission queue TPFXMITQ1, where:

 XmitQ Override 
displays the target transmission queue if the ZMQSC SWQ command has been issued for the queue.

 Current Depth 
displays the total number of messages currently on the queue.

 Persistent Msgs 
displays the total number of persistent messages, along with their total length in bytes, that were placed on the queue since the queue manager was last started.

 NonPersist Msgs 
displays the total number of nonpersistent messages, along with their total length in bytes, that were placed on the queue since the queue manager was last started.

 Num of MQOPEN 
displays the total number of times that applications have issued MQOPEN for the queue.

 Num of MQCLOSE 
displays the total number of times that applications have issued MQCLOSE for the queue.

 Channel Name 
displays the channel used by this transmission queue to send messages.
+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS QL-TPFXMITQ1                                                 |
|                                                                                |
|System:  MQSC0201I 09.38.35 LOCAL QUEUE DISPLAY:                                |
|         Queue Name      - TPFXMITQ1                                            |
|         QManager Name   - TPFQM                                                |
|         Queue Type      - LOCAL                                                |
|         Usage           - TRANSMIT                                             |
|         Delete Pending  - NO                                                   |
|         Common          - NO                                                   |
|         Max Msg Length  - 10240                                                |
|         Current Depth   - 0                                                    |
|         Put             - ENABLED                                              |
|         Get             - ENABLED                                              |
|         Persistent Msgs - 0 (0 Bytes)                                          |
|         NonPersist Msgs - 0 (0 Bytes)                                          |
|         Num of MQOPEN   - 0                                                    |
|         Num of MQCLOSE  - 0                                                    |
|         QDEPTHHI        - 0%                                                   |
|         MAXDEPTH        - 5000                                                 |
|         SWEEP           - ON                                                   |
|         Channel Name    - CHL1                                                 |
|         Swing Target    -                                                      |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays information for remote queue TPFREMOTE2, where:

 Remote Queue Name 
specifies the name of the queue on the remote queue.

 Remote Queue Manager 
specifies the name of the remote queue manager on which the remote queue is defined.

 Transmit Queue Name 
specifies the name of the transmission queue to be used for forwarding messages to the remote queue. The MQPUT function is either ENABLED or DISABLED for this queue.
+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS QR-RQ1                                                       |
|                                                                                |
|System:  MQSC0200I 07.03.00 REMOTE QUEUE DISPLAY:                               |
|         Queue Name           - TPFREMOTE2                                      |
|         Queue Manager Name   - TPFQM                                           |
|         Remote Queue Name    - RQ1                                             |
|         Remote QManager Name - RQM1                                            |
|         Transmit Queue Name  - XQ1                                             |
|         Put                  - ENABLED                                         |
|                           END OF DISPLAY                                       |
+--------------------------------------------------------------------------------+

The following example displays information for alias queue AQ1.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS QA-AQ1                                                       |
|                                                                                |
|System:  MQSC0204I 07.01.51 ALIAS QUEUE DISPLAY:                                |
|         Queue Name         - AQ1                                               |
|         QManager Name      - TPFQM                                             |
|         Queue Type         - ALIAS                                             |
|         Base Queue         - RQ1                                               |
|         Put                - ENABLED                                           |
|         Get                - ENABLED                                           |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays information for channel TPF.TO.NT.1.

The following example displays the current status for all channels.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS CHS-ALL                                                      |
|                                                                                |
|System:  MQSC0208I 07.01.51 CHANNEL STATUS DISPLAY:                             |
|         CHANNEL          CHL          CURRENT                                  |
|         NAME             TYPE         STATUS                                   |
|         ----------------------------------------                               |
|         CHL1             SDR          READY                                    |
|         CHL2             SDR          STOPPED                                  |
|         CHL3             SDR          STOPPED                                  |
|         MVS.TO.TPF       RCVR         READY                                    |
|         NT.TO.TPF        RCVR         STOPPED                                  |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays the current status for all channels and indicates whether the channel is in an in-doubt condition or not.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DIS CHS-ALL INDOUBT                                              |
|                                                                                |
|System:  MQSC0208I 07.01.51 CHANNEL STATUS DISPLAY:                             |
|         CHANNEL          CHL          CURRENT      INDOUBT                     |
|         NAME             TYPE         STATUS       STATE                       |
|         ---------------------------------------------------                    |
|         CHL1             SDR          READY         -                          |
|         CHL2             SDR          STOPPED       N                          |
|         CHL3             SDR          STOPPED       Y                          |
|         MVS.TO.TPF       RCVR         READY         -                          |
|         NT.TO.TPF        RCVR         STOPPED       -                          |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays the default persistence of all the local queues.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DISP QL-ALL DEFPSIST                                             |
|                                                                                |
|System:  MQSC0201I 13.38.51 LOCAL QUEUE DISPLAY:                                |
|         Queue Name                    DEFPSIST                                 |
|         ----------------------------- ----------                               |
|         DEAD.LETTER.QUEUE             - Not Persistent                         |
|         SPECIAL.RECOVERY.QUEUE        - Not Persistent                         |
|         SYSTEM.TEMPORARY.QUEUE        - Not Persistent                         |
|         XQ1                           - Not Persistent                         |
|         LOCAL.TPF.QUEUE               - Persistent                             |
|         XMITQ2                        - Persistent                             |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

The following example displays the channel-type definitions of each channel.

+--------------------------------------------------------------------------------+
|User:    ZMQSC DISP CHL-ALL CHLTYPE                                             |
|                                                                                |
|System:  MQSC0225I 13.48.46 CHANNEL DISPLAY FOR PROCESSOR B:                    |
|         Channel Name             CHLTYPE                                       |
|         ------------------------ ------------                                  |
|         NT.TO.TPF                RCVR                                          |
|         TPF.TO.OS390             SDR                                           |
|         TPFTONT                  SDR                                           |
|         END OF DISPLAY                                                         |
+--------------------------------------------------------------------------------+

Related Information

See MQSeries Command Reference for more information about the MQSeries product.