HELPLIB.HLB  —  PMDF  COUNTERS  /CLEAR
    Clear the node-specific, in-memory cache of counters.

    Syntax

      COUNTERS/CLEAR

    Command Qualifiers             Defaults

    /ASSOCIATIONS                  /ASSOCIATIONS
    /CHANNELS                      /CHANNELS

1  –  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.

2  –  Parameters

    None.

3  –  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.

4  –  Command Qualifiers

4.1    /ASSOCIATIONS

       /ASSOCIATIONS (default)
       /NOASSOCIATIONS

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

4.2    /CHANNELS

       /CHANNELS (default)
       /NOCHANNELS

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