WhatsUp Gold User's Guide v8.0 - Using the Command Line for Outage Reports

Using the Command Line for Outage Reports

Wugrpt.exe is a utility that can generate reports from the Activity 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. If you DO NOT use any other arguments, AND you only provide a map name, the report will be a detailed report for all dates in the activity log.

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 activities for the selected map in the specified period. Summary generates a report by device for any down or up state changes 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 Outage Reports for the Boston1 map:
         wugrpt -m"c:\program files\whatsup\Boston1.wup" 
Generates a detailed report for all days in the log (uses defaults).
         wugrpt -m"c:\program files\whatsup\Boston1.wup"  
         -s20020301 -e20020331 
Generates a detailed 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.

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 activities for the selected map in the specified period. Summary generates a report by device for any down or up state changes 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.

Ipswitch, Inc.
http://www.ipswitch.com


©Ipswitch 2003