README for showstat.exe, version 1.0
copyright 2002, Julian Robichaux
www.nsftools.com


DESCRIPTION
showstat is a command-line program that displays server statistics, just like the "Show Statistics" command will do at the server console. You can get the statistics for the local machine or a remote server, and you can filter statistics by using a wildcard filter.


REQUIREMENTS
Windows 95/98/NT/2000
Notes Client 4.6 or higher


INSTALLATION
Copy the showstat.exe program to your Notes executable directory (the directory that has the nnotes.dll file). Run it from a command prompt, as described below.


USAGE
showstat [ServerName [StatFilter]]

  ServerName      The name of the server to get stats from.
  StatFilter      An optional wildcard filter you can use to retrieve only
                  certain statistics (like server*). If you use this option,
                  and you are getting stats for the local machine, make sure
                  you use "" for the ServerName argument.


EXAMPLES
To display all the stats for the local machine:
  showstat

To display all the stats for a remote server named 'MyServer':
  showstat MyServer

To send all the stats for a remote server named 'MyServer' to a text file called c:\stats.txt:
  showstat MyServer > c:\stats.txt

To display only the stats that contain the word 'server' in the description, for a remote server named 'MyServer':
  showstat MyServer *server*

To display only the stats that start with the letter 'm' in the description, for the local machine:
  showstat "" m*


KNOWN PROBLEMS
1.  Sometimes when you run this program and the Notes client isn't already running in the background, remote servers that aren't registered in DNS or HOSTS (and have to be accessed through connection docs) will error out with "Notes API Error: The remote server is not a known TCP/IP host". I don't know why. Occasionally when this happens, you can run the program against another server, and then try the non-responsive server and it will work. It's some strange API issue.


VERSION HISTORY
Version 1.0
-  Initial release

