Run the BlackBerry Message Pending Delivery Tool from the command prompt

  • See Prepare to run the log analysis tools.
  • Copy the BlackBerry Messaging Agent log files to the computer that hosts the BlackBerry Message Pending Delivery Tool and BlackBerry Enterprise Server Log Analysis Tool.
  1. On the computer that hosts the BlackBerry Message Pending Delivery Tool, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Analysis Monitoring and Troubleshooting Tools > BlackBerry Message Pending Delivery Tool.
  2. In the command prompt window, type Pending 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)
  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.

    -pending <#>

    This parameter specifies the minimum number (#) of pending messages that the tool tracks.

    By default, the value is 0.

    -onlyhigh

    This parameter specifies that the tool prints the single highest pending count for a user account that is greater than the count you specify for -pending.

    -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.

    -time <start time>

    -time <start-stop time>

    This parameter specifies the starting time for the query or the interval for the query.

    For example, to process all log entries that are created after 16:00:00, type pending -p E -u all -time 16:00:00.

    To process log entries that are created between 16:00:00 and 17:00:00, type pending -p E -u all -time 16:00:00-17:00:00.

    -agent <abbreviation>

    This parameter specifies the abbreviation for the BlackBerry Messaging Agent log files. If you do not specify a name, the tool uses MAGT.

    -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 debugging file.

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

Example: Querying all user accounts for more than one pending message, and printing out information for the user account with the highest pending count

Pending -p E -u all -output all -pending 1 -onlyhigh

  • If you want to view the help information for the tool, including the list of available parameters, in the command window, type Pending -? or Pending -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.