Use this command to display:
- Channel definitions
- Channel status
- TPF MQSeries profiles
- Queue definitions.
Requirements and Restrictions
- You can enter this command only in NORM state.
- You must define the queue manager profile by entering the ZMQSC DEF MQP
command before entering this command.
- Without single quotation marks (' ') specified, characters are
handled as uppercase only. If a TPF MQSeries object needs to be
case-sensitive, enclose the object in single quotation marks.
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.