Display the contents of the cluster-wide database of channel
counters.
Syntax
COUNTERS SHOW [channel]
Command Qualifiers Defaults
/HEADER /HEADER
/OUTPUT=file-spec None
/SYNCHRONIZE /SYNCHRONIZE
/TIMEOUT=seconds /TIMEOUT=120
1 – Parameters
channel
Optional channel name indicating the channel(s) for which to show
counters. May contain wildcards.
2 – Description
The contents of the cluster-wide channel counter database may be
displayed with the COUNTERS SHOW command. By default, before the
counters are displayed, an implicit COUNTERS SYNCHRONIZE command
will be executed, to attempt to synchronize each node-specific
cache with the main cluster-wide database. Specify /NOSYNCHRONIZE
to merely display the current contents of the database without
first synchronizing the node-specific caches.
Note that SYSLCK privilege is required to perform the
synchronization step.
Note that the output of PMDF QM's COUNTERS SHOW command is
currently not as detailed as the output of the DCL level PMDF
COUNTERS/SHOW command.
3 – Command Qualifiers
3.1 /HEADER
/HEADER (default)
/NOHEADER
Controls whether or not a header line describing each column in
the table of counters is output.
3.2 /OUTPUT
/OUTPUT=file-spec
Direct the output to the specified file. By default the output
appears on your display.
3.3 /SYNCHRONIZE
/SYNCHRONIZE (default)
/NOSYNCHRONIZE
Before displaying the counters, attempt to synchronize each of
the node-specific caches with the cluster-wide database. Specify
/NOSYNCHRONIZE to skip this synchronization step.
3.4 /TIMEOUT
/TIMEOUT=seconds
By default, QM will wait upwards of 120 seconds for the node-
specific caches to be synchronized with the cluster-wide
database. Should the synchronization step not be completed before
the specified time period, then QM will stop waiting and proceed
to display the information from the database. You may specify a
different period of time to wait with the /TIMEOUT qualifier.
This qualifier has no effect when /NOSYNCHRONIZE is specified.
4 – Examples
To display the counters information for all TCP/IP channels,
use the command
qm.maint> COUNTERS SHOW *tcp_*
Channel Messages Recipients Blocks
------------------------ ---------- ---------- ----------
tcp_local
Received 33 41 95
Stored 0 0 0
Delivered 33 41 95
Submitted 1 1 3
tcp_internal
Received 632 758 1453
Stored 1 2 10
Delivered 631 756 1443
Submitted 3 6 12
qm.maint>