Run the BlackBerry Usage Monitoring Tool from the command prompt

  • See Prepare to run the log analysis tools.
  • Copy the BlackBerry Dispatcher (DISP) log files to the computer that hosts the BlackBerry Usage Monitoring Tool and BlackBerry Enterprise Server Log Analysis Tool. If you want the tool to process usage information over multiple days, you must copy the log files for those days to the same folder.
  1. On the computer that hosts the BlackBerry Usage Monitoring Tool, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Analysis Monitoring and Troubleshooting Tools > BlackBerry Usage Monitoring Tool.
  2. In the command prompt window, type OutofCoverage and the following parameters:

    Parameter

    Description

    -p E[xchange]

    -p D[omino]

    -p G[roupWise]

    This parameter specifies the messaging platform.

    -u <account>

    -u all

    This parameter specifies the user account.

    To query all user accounts in the log files, type -u all.

    To query a specific user account, type the user name in one of the following formats:

    • Microsoft Exchange: SMTP email address (for example, jpalmer@<domain>.net)
    • IBM Lotus Domino: canonical name (for example, Julie Palmer/Organization)
    • Novell GroupWise: first name and last name (for example, Julie Palmer)

    -t <minutes>

    This parameter specifies the frequency, in minutes, that the tool checks for gaps (between 10 and 1440 minutes).

  3. Type any of the following optional parameters:

    Parameter

    Description

    -input <filename.txt>

    This parameter specifies the name of the file that contains the list of user accounts that you want to monitor.

    Use the appropriate format as described for the -u parameter.

    Use a carriage return to separate each entry in the file.

    This parameter overrides the value that is specified with the -u parameter.

    -output user

    -output all

    This parameter specifies how to organize the data in output files.

    To create one file for each user account, type -output user.

    To create one file for all user accounts, type -output all. This is the default value.

    -dispatcher <abbreviation>

    This parameter specifies the abbreviation for the BlackBerry Dispatcher log files.

    If you do not specify a name, the tool uses DISP.

    -L <path>

    This parameter specifies the location of the debug log files that you want to query if they are not in the same folder as the tool. If the path contains spaces, enclose the path in quotation marks ( " " ).

    -OL <path>

    This parameter specifies the folder where the tool writes the output files. If the path contains spaces, enclose the path in quotation marks ( " " ).

    -debug <filename.txt>

    This parameter specifies that the tool creates a more detailed output file for debugging purposes, and it specifies the name of the debug file.

    If you do not specify a file name, the tool displays the debug information on the screen.

Example: Checking in specified log files whether a user account has not sent or received data packets for 25 minutes

OutofCoverage -p E -u jpalmer@test.rim.net -t 25 -L C:\BRK\logs

  • If you want to view the help information for the tool, including the list of available parameters, in the command window, type OutofCoverage -? or OutofCoverage -help.
  • If you configured the tool to use a UAC-compliant file path, the output file is located at <drive>:\Users\<user_name>\AppData\Roaming\Research In Motion\AMT\ or <drive>:\Documents and Settings\user_name\Application Data\Research In Motion\AMT\. If you did not configure the tool to use a UAC-compliant file path, the output file is located in a file path relative to the current working directory, for example, <drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server Resource Kit \BlackBerry AMT Tools.


Was this information helpful? Send us your comments.