Skip to main content

Viewing %UnitTest Results

You can view the results of your tests in any of the following ways:

Viewing %UnitTest Results Programmatically

Test asserts, including test results, are logged in the %UnitTest.Result.TestAssertOpens in a new tab table for structured access to the data. The table includes the following fields:


Logical Value Meaning
0 failed
1 passed
2 skipped

The name of the $$$AssertX macro used to perform the test. Note that the leading $$$ are not included in the table.


The value of the test_description argument you passed to the $$$AssertX macro. If test_description was not passed, this field defaults to the string representation of the first argument to the $$$AssertX macro. See Macros of the %UnitTest.TestCase Class for details about $$$AssertX macro arguments.


The location in the test class from which the test assert originates, in label[+offset]^[|"ns"|]doc.ext format.

Troubleshooting Test Assert Locations

Under certain circumstances, it is possible the test assert locations may not be properly mapped back to the classes. For example, if all of the locations are in generated INT routines. In such cases, you should run your tests with the /keepsource and /generatemap qualifiers in the qualifiers argument to RunTest()Opens in a new tab. This enables the test manager to resolve the routine locations back to the source classes.

Viewing %UnitTest Reports in the Management Portal

Executing tests generates a hierarchical report, available in the Management Portal, containing results related to all tests executed.

If the report indicates a test has passed, that means the relevant $$$AssertX macro returned true: Your test produced the expected result. Test failure indicates the macro returned false: Your test did not produce the expected result, and you may need to debug the method being tested.

Follow these steps to view the report in the Management Portal:

  1. Grant access for the %UnitTest classes to access the UnitTest Portal in the USER namespace:

    USER>set $namespace = "%SYS"
    %SYS>set ^SYS("Security", "CSP", "AllowPrefix", "/csp/user/", "%UnitTest.")=1

    This step must be executed once, for security reasons, or you will not be able to navigate to Unit Test Portal in the Management Portal.

  2. In the Management Portal, navigate to System Explorer > Tools > UnitTest Portal, and switch back to the USER namespace.

  3. To launch UnitTest Portal and view your test report, click Go. Your report displays.

  4. Drill down in the report by following the links in the report to find increasingly specific information.

    • The first page provides a summary for all test suites.

    • The second page displays results by each test suite.

    • The third page displays the results by each test case.

    • The fourth page displays the results broken out by test method.

    • The final page displays results for each $$$AssertX macro used in a test method.

FeedbackOpens in a new tab