Creating a test runner configuration file

Use the New ZUnit Runner Configuration wizard to create a test runner configuration file.

About this task

If you use the Run As Test Case or Run All As Test Case or Run Test Case action to run a test case, you do not have to create a configuration file. The test runner generates a configuration file for you. For more information about these actions, see Running a test case from an executable file or load library and Running a test case from a source file.

Use Opening a test runner configuration file to create a new runner configuration that supports skipping specific tests in running.

Procedure

  1. To start the New ZUnit Runner Configuration wizard, do one of these steps:
    • From the main menu bar, do these steps:
      1. Click File > New > Other. The Select a wizard window opens.
      2. Expand z/OS Development > z/OS Automated Unit Testing Framework (ZUnit).
      3. Select ZUnit Runner Configuration and click Next.
    • In the z/OS Projects or Enterprise Projects view or in the Remote Systems view, do these steps:
      1. Select one or more load modules (.exe files).
      2. Right-click and select z/OS Automated Unit Testing Framework (ZUnit) > Open Runner Configuration.
    The New ZUnit Runner Configuration wizard opens.
  2. From the Select destination container list, choose one of these locations to store the test runner configuration file:
    • A z/OS® UNIX folder on a remote z/OS system. You must have write access to the folder.
    • A partitioned data set on a remote system or in a remote MVS™ subproject. The data set must have a record format of VB or VBA. If you select a data set with the wrong record format, the wizard displays a warning message.
    • A folder in a local z/OS project.
  3. In the New file name field, type a name for the configuration file.
    The wizard appends the .azucfg file extension to the file name. The wizard warns you if you specify a name for an existing file or a name that is not a valid MVS data set member name.
  4. Click Finish.

Results

The configuration file is created in the location that you selected and opened in the IBM z/OS Automated Unit Testing Framework (ZUnit) Runner Configuration editor.
  • If you started the wizard from the main menu bar, the file contains one sample test case entry. The name of the test case is based on the name that you entered for the configuration file. For example, if you created a configuration file that is called MYCONFIG.azucfg, then the name of the sample test case is MYCONFIG.
  • If you started the wizard by selecting one or more load modules, the file contains one test case entry for each load module that you selected. The names of the test cases match the names of the load modules. For example, if you selected load modules named AZUTC001.exe and AZUTC002.exe, then the names of the test cases are AZUTC001 and AZUTC002.

What to do next

Use the IBM z/OS Automated Unit Testing Framework (ZUnit) Runner Configuration editor to add more test cases or to set options for running the test cases.