**This is an old revision of the document!**
PCBSTATS
Syntax
PCBSTATS /FILE:[filename] /NODE:[number] /parameter
Required Command Line Parameters
These two command line parameters listed in this section are required for PCBSTATS to function properly. If you specify an invalid filename or node number, the program will display an error instead of running.
/FILE:[filename]
In place of the [filename] shown with this command line parameter, enter the location and name of your Statistics Files (PCBSetup > File Locations > System Files).
/NODE:[number]
In place of the [number] shown with this command line parameter, enter the node number that you want to show statistics. Even if you use a parameter that displays system statistics, you must specify this parameter for PCBStats to function properly.
Command Line Parameters to Update Statistics
If you want to use PCBStats to update the PCBSTATS.DAT file, pick one of the command line parameters listed in this section.
/RESETNODE
Resets the fields and statistics for the node number specified with the /NODE: parameter.
/RESETALL
Resets the fields and statistics for all nodes in your system.
/MAKELOCAL
Modify all nodes so that the local statistics are shown on all call-waiting screens in your system.
/KEEPCALLER
This parameter should only be used in conjunction with either the /RESETNODE or /RESETALL parameters. Normally these parameter will reset not only the statistics, but also the last caller to each node. If you want to keep the last caller information in the file while still resetting all of the statistics, use this parameter.
/MSGS:[number]
This parameter will add the number of new messages that you specify to the statistics of the node you specify. Replace [number] with any number between -9,999,999 and 9,999,999. If you specify a negative number, the number of messages will be subtracted rather than added.
/UP:[number]
This parameter will add the number of new uploads that you specify to the statistics of the node you specify. Replace [number] with any number between -9,999,999 and 9,999,999. If you specify a negative number, the number of uploads will be subtracted rather than added.
/DOWN:[number]
This parameter will add the number of new downloads that you specify to the statistics of the node you specify. Replace [number] with any number between -9,999,999 and 9,999,999. If you specify a negative number, the number of downloads will be subtracted rather than added.
/NAME:[name]
This parameter specifies the name of the last caller to the node that you specify. Replace [name] with the user name of the caller. This parameter should only be used when you are running a third-party program that does the logoff processing. Otherwise, PCBoard automatically updates this information.
/CITY:[city]
This parameter specifies the city of the last caller to the node that you specify. Replace [city] with the city of the caller. This parameter should only be used when you are running a third-party program that does the logoff processing. Otherwise, PCBoard automatically updates this information.
Command Line Parameters to View Statistics
These command line parameters give the ability to print statistics about a single node, the system or each of your nodes to the screen. If you want to capture one of these reports to disk, refer to redirecting command input or output in your DOS manual.
/SHOWSYS
This parameter will show a single line that summarizes the statistics for all of the nodes in your system. The format of the report is shown by the following example:
SYSTEM -> Calls: 52 Messages: 30 Downloads: 82 Uploads: 3
/SHOWNODE
This parameter will display that statistics for the node number specified.
The format of the report is as follows:
Node 15 -> Calls: 0 Messages: 0 Downloads: 0 Uploads: 0
/SHOWALL
This parameter will produce a report for your entire system and each of the nodes on your system (whether active or not). The first 4 lines of this report may resemble the following:
SYSTEM -> Calls: 52 Messages: 30 Downloads: 83 Uploads: 3 Node 1 -> Calls: 4 Messages: 0 Downloads: 6 Uploads: 0 Node 2 -> Calls: 8 Messages: 1 Downloads: 12 Uploads: 0 Node 3 -> Calls: 9 Messages: 3 Downloads: 7 Uploads: 0
Examples
If your PCBSTATS.DAT file is located in C:\ you would type the following to add one upload to node number 3:
PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /UP:1
To reset the statistics for the same node (leaving the last caller to the node intact), enter the following:
PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /RESETNODE /KEEPCALLER
To produce a report that lists the statistics for the entire system, you would enter the following:
PCBSTATS /FILE:C:\PCBSTATS.DAT /NODE:3 /SHOWSYS