Sun Java System Messaging Server 6.3 Administration Reference

counterutil

The counterutil utility displays and changes counters in a counter object. It can also be used to monitor a counter object every 5 seconds.

Requirements: Must be run locally on the Messaging Server.

Location: msg-svr-base/sbin/

Syntax


counterutil -l 

counterutil -o counterobject [-i interval] [-n numiterations]
counterutil -s -o counterobject -c counter

Options

The options for this command are:

Option  

Description  

-c counter

Specifies a particular counter associated with a counter object. 

-i interval

Specifies, in seconds, the interval between reports. The default is 5.

-l

Lists the content of the counter registry. 

-n numiterations

Specifies the number of iterations. The default is infinity. 

-o counterobject

Displays the contents of a particular counter object at specified intervals (by default, every 5 seconds). The valid counter objects are: 

imapstat

popstat

httpstat

alarm

diskusage

serverresponse

Each counter object has a list of counters. When you monitor a counter object, counterutil displays the counters associated with it.

-s

Resets the counter to 0. 

Examples

To list all counter objects in a given server’s counter registry:


counterutil -l

To monitor the content of a counter object imapstat every 5 seconds:


counterutil -o imapstat

To reset the counter global.maxconnections, associated with the counter object imapstat, to zero:


counterutil -s -o imapstat -c global.maxconnections

For complete details on counterutil, refer to the counterutil in Sun Java System Messaging Server 6.3 Administration Guide.