Using the Command Line for Event Reports
Wugrpt.exe is a utility that can generate reports from the Event Log (EV-yyyy-mm-dd.tab) data. You can invoke wugrpt from the Windows Command Prompt (MS-DOS prompt). By default, the report is displayed in the Command Prompt or MS-DOS window.
Basic Command Syntax
wugrpt -mmapname [-syyyymmdd] [-eyyyymmdd] [-llogfile]
[-osortmode] [-rreport] [-tmaptitle]
Note: You must use the -m argument to specify the name of the WhatsUp Gold map to use for the report. All other arguments are optional.
| Argument |
Explanation |
| -mmapname |
The mapname must include the full path. The path and name must be enclosed in quotes. For example, wugrpt -m"C:\Progam Files\whatsup\network1.wup" |
| -syyyymmdd |
Use -s to specify the start date for the report. The default is the oldest date in the log. |
| -eyyyymmdd |
Use -e to specify the end date for the report. The default is the most recent date in the log. |
| -llogfile |
Use -l to specify an alternate log file. |
| -osortmode |
Use -o to specify one of the sort modes: Ascend sorts by device name in ascending order (this is the default value); Descend sorts by device name in descending order; Score sorts by the device's "score," which is determined by the sum of polls missed. Score sorts from highest to lowest value. |
| -rreport |
Use -r to specify one of the report types: Detail generates a report by device for all events for the selected map in the specified period. Summary generates a report by device for any down or up events in the selected map in the specified period. Export generates a tab delimited file of the raw data. |
| -tmaptitle |
Use -t to specify the title to use at the top of the report. The default title is the map name. |
| -? |
Use -? to see a summary of argument options. |
Examples
The following examples create Event Reports for the Boston1 map:
wugrpt -m"c:\program files\whatsup\Boston1.wup"
Generates a detail report for all days in the log (uses defaults).
wugrpt -m"c:\program files\whatsup\Boston1.wup"
-s20010301 -e20010331
Generates a detail report for one month of log data.
Return Codes
Wugrpt returns 1 if it performed at least one of the requested operations; it returns 0 if it failed.
