Examples

Running test suites

The following command runs all test cases in myFullTestsuite, using the default options:

mfurun myFullTestsuite.dll

The following command only runs the mySecondTestcase test case within the test suite, producing verbose output:

mfurun -testcase:mySecondTestcase -verbose myFullTestsuite.dll

The following command runs all test cases in myFullTestsuite and produces a JUnit-style report (.xml file), and also produces a core dump file for each test case that encounters an error:

mfurun -report:junit -jit:core myFullTestsuite.dll

The following command runs all test cases in myFulltestsuite, and invokes just-in-time debugging each time a test case encounters an error. The test run continues when the debugger is closed:

mfurun -jit:debug myFulltestsuite.dll

The following command runs all test cases in myFulltestsuite, ignoring any errors encountered:

mfurun -ignore-return-code:true myFulltestsuite.dll

Creating Framework-Compatible Executables

The following set of commands rebuild an executable program so that it can be called from a test suite. The example uses an executable and main entry point called bookmaint that also consists of a number of other program files.

The following command will generate a new main entry point (using the original entry point name) in a file named mfunit_application_entrypoint.cbl.

mfurun -verbose -generate-app-exe-ep:bookmaint

You now need to rebuild the executable, utilizing the new entry point. The following command rebuilds the executable to include the newly-generated program and entry point:

cbllink -Mmfunit_application_entrypoint bookmaint.cbl booklibrarian.cbl HomeBookCatalogue.cbl mfunit_application_entrypoint.cbl

A test fixture can now call into the executable to test its source code. Run it through the testing framework using the -application-exe option:

mfurun -application-exe:bookmaint.exe tests.dll

To run the executable outside of the testing framework, run it as normal; none of the additional programs/entry points are used or required.

Running JCL tests

The following command tests whether a JCL job card was successfully submitted to a JES environment:

(The submission of the JCL emulates the cassub /r command.)

mfurun -es-server-name:ESDEMO -es-use-mfcc:false -es-syscat:c:\ESDEMO\CATALOG.DAT MYJCL.JCL

The following command runs the MFUT_TXTDIFF1.dll test program, which specifies the JCL job card to submit to the enterprise server region corresponding to the -es-service details.

(The submission of the JCL emulates the cassub /s command.)

mfurun -sp -es-service:tcp:localhost:9003 -es-syscat:c:\ESMFUJCL\CATALOG.DAT MFUT_TXTDIFF1.dll

Creating and running test fixture files

The following command produces an .mfu file with the same base name as the test suite file:

mfurun -generate-mfu myFulltestsuite.dll

The following command runs all test cases in the test fixture file:

mfurun myFulltestsuite.mfu

The following command runs all test cases in the test fixture file, but any options in the .mfu are ignored:

mfurun -ignore-options-in-mfu:true myFulltestsuite.mfu