Clear the node-specific, in-memory cache of counters.

Syntax

COUNTERS/CLEAR

Command Qualifiers	Defaults
/ASSOCIATIONS	/ASSOCIATIONS
/CHANNELS	/CHANNELS

restrictions

WORLD privilege is required to in order to use this utility. If the in-memory section did not already exist (so that a new one must be created), then SYSGBL and PRMGBL privileges are also required. If a new cluster-wide, on-disk database must be created, then privileges sufficient to create a file in the PMDF_TABLE: directory are required.

Parameters

None.

Description

The PMDF COUNTERS/CLEAR command is used to clear the values in the node-specific, in-memory section of counters. The command creates the node-specific, in-memory section of association and channel counters if it does not already exist. Then it zeros all fields in the in-memory section. Note that the counters will be zeroed without first merging their values into the cluster-wide database of channel counters. If a cluster-wide, on-disk database does not already exist, a new one will be created. Finally, the fields in the on-disk database for numbers of stored messages, message recipients, and message volumes are set based on the entries in the PMDF queue cache database.

Either the association counters, or channel counters, or both, may be cleared. The default is to clear both association and channel counters.

If you want to update the on-disk database with the old in-memory values before clearing them, then you should issue a

$ PMDF COUNTERS/SYNCHRONIZE

command before issuing the PMDF COUNTERS/CLEAR command.

You may also want to issue a

$ PMDF CACHE/SYNCHRONIZE

command before issuing the PMDF COUNTERS/CLEAR command, to ensure that the queue cache database values (which will be used to set some of the on-disk database values) are themselves current.

Command Qualifiers

/ASSOCIATIONS (default)

/NOASSOCIATIONS

This qualifier specifies whether to clear the in-memory cache of association counters.

/CHANNELS (default)

/NOCHANNELS

This qualifier specifies whether to clear the in-memory cache of channel counters.