Run the BlackBerry System Requirements Tool from the command prompt

  1. On the computer that hosts the BlackBerry System Requirements Tool, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server Resource Kit > BlackBerry Analysis Monitoring and Troubleshooting Tools > BlackBerry System Requirements Tool.
  2. In the command prompt window, type BBCheckCmd and any of the following parameters (parameters in brackets are optional):



    [-r <test_name>]

    [-run <test_name>]

    This parameter specifies the name of the test that you want to run. You can specify a single test, or you can type -r all or -run all to run all available tests. The test name is not case-sensitive when you use it as a parameter.

    You can specify any of the following tests. If a test name contains an embedded space, you must enclose the test name in quotation marks ( " " ), and you can include only one space between any two words.
    • "General Information"
    • "BES Information"
    • "Service Account"
    • "Exchange Permissions"
    • "MAPI Subsystem"
    • GC
    • Database
    • "DB BES Instance Versions"
    • Java
    • ".NET Framework"
    • MSMQ
    • Network
    • "SRP Connectivity"
    • "System Information"
    • "System Hotfixes"
    • "Current Processes"

    If you want to use a single command to run multiple tests, but you do not want to run all of the tests, you can use a test confuration file (.testconfig) and the -f <file_path>] parameter.

    [-f <file_path>]

    [-file <file_path>]

    If you want to use a test configuration file (.testconfig) to specify the tests that you want to run, use this parameter to specify the file path to the .testconfig file and the name of the file. If the file path includes a space, enclose the path in quotation marks ( " " ).

    [-v <level>]

    This parameter specifies the level of detail that is written to the log files. The options are TRACE, DEBUG, or INFO. The default log level is INFO.

Example: Running a single test

BBCheckCmd -r "General Information"

BBCheckCmd -r all

BBCheckCmd -f "C:\Documents and Settings\jpalmer\Application Data\Research In Motion\AMT\Custom.testconfig"

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