Run the BlackBerry MAPI and CDO Error Monitoring 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 MAPI and CDO Error Monitoring Tool and BlackBerry Enterprise Server Log Analysis Tool.
  1. On the computer that hosts the BlackBerry MAPI and CDO Error Monitoring Tool, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Analysis Monitoring and Troubleshooting Tools > BlackBerry MAPI and CDO Error Monitoring Tool.
  2. In the command prompt window, type MapiCdoErrors and the following parameters:

    Parameter

    Description

    -p E

    This parameter specifies that you use the tool in a Microsoft Exchange environment.

    -u <SMTP_address>

    -u all

    This parameter specifies the SMTP email address of the user account that you want to monitor.

    To monitor all user accounts, type -u all.

  3. Type any of the following optional parameters:

    Parameter

    Description

    -input <filename.txt>

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

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

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

    -events <“event_ids”>

    This parameter specifies the events that the tool monitors. You use commas to separate the events in the list.

    By default, the tool monitors all events that are associated with BlackBerry Enterprise Server startup, versions, and user account settings.

    -override

    This parameter is used with the -events parameter to specify that the tool ignores the default events list and processes only specified events.

    -eventsfile <filename.txt>

    This parameter specifies the name of the input file that contains the events that the tool monitors for.

    This parameter overrides the default list of events that the tool monitors. The tool does not check for duplicates or valid events, but it verifies that the events are in numerical order.

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

    -raw

    This parameter specifies that the tool creates an output .txt file instead of a .csv file.

    -list

    This parameter specifies that the tool displays the default list of monitored events on the screen.

    -L <path>

    This parameter specifies the location of the debug log files that you want to query if the files are not in the same folder as the tool.

    -OL <path>

    This parameter specifies the folder where the tool writes the output files.

    -agent <acronym>

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

    -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: Finding two events that might create MAPI and CDO errors

MapiCdoErrors -p E -input users.txt -L C:\logs -output all -events “20018,20055” -override -raw

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