Running a test case

You can run a z/OS® Automated Unit Testing Framework (ZUnit) test case from an executable file or load library, from a source COBOL or PL/I program for which a test case has been generated and built, from JCL, from TSO, from z/OS UNIX System Services, or for Db2 source.

Before you begin

To run a ZUnit test case, you need access to the following resources:
  • A z/OS system with the XML Toolkit for z/OS installed.
  • Rational Developer for System z version 8.5 or later installed on Windows.
  • Rational Developer for System z version 8.5 or later data sets FEL.SFELSAMP and FEL.SFELLOAD installed on z/OS.
  • A connection to a z/OS system that is defined in the Remote Systems view.

About this task

The ZUnit test runner is a z/OS batch mode application called AZUTSTRN. It takes as input a configuration file that instructs the runner to fetch and run test cases and to generate a report with the results. The runner operates in a try-catch mode so that it can continue to run tests in the event of failed assertions or unexpected exceptions, such as SOC4s.

When the test case is invoked with an older version of ZUnit host part, the test ends with an error message about "API xxxx is not found".

The simplest way to run a test case is from an executable file or load library. The following topics provide instructions for this method and for several other methods.