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

Parameters

channel

Optional channel name indicating the channel(s) for which to show counters. May contain wildcards.

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.

Command Qualifiers

/HEADER (default)

/NOHEADER

Controls whether or not a header line describing each column in the table of counters is output.

/OUTPUT=file-spec

Direct the output to the specified file. By default the output appears on your display.

/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.

/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.

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>