Upgrading From v2.4.2 to v3.0.0

The most important thing you need to know is, that iRPGUnit 3.* requires at least IBM i 7.1. Older versions are no longer supported.

You need to update your RPGUNIT product library when upgrading the plug-in to 3.0.0, in order to take advantage of all new features.

But it is not a show stopper when you updated the plug-in and afterwards notice that you cannot update the library for whatever reasons. The plug-in can run with a 2.* library. However some new features may not be available, such as the new XML stream file output.

All your existing unit test suites should run fine with iRPGUnit 3.0.0. However:

Test your existing test suites carefully in a sandbox environment, before upgrading to iRPGUnit 3.0.0.

The following RPGUnit self-tests (compiled with v2.4.2) run fine with iRPGUnit:

CMDRUNLOGT
CMDRUNT
CRTTSTT
EXTTSTT
LIBLT
PGMMSGT
STRINGT

The following RPGUnit self-tests (compiled with v2.4.2) do not run with iRPGUnit:

Test case testAssertWithFailure of test suite ASSERTT, because of internal changes.
Test case testGoodByeIsNotHello of test suite ASSERTT, because of internal changes.
Test case testTwoAndTwoIsNotEqualToFive of test suite ASSERTT, because of internal changes.

Test suite CALLPROCT, because service program RURUNNER has been dropped.
Test suite EXTPRCT, because service program RURUNNER has been dropped.
Test suite JOBLOGT, because service program RURUNNER has been dropped.
Test suite RUNT, because service program RURUNNER has been dropped.

Test suite RUACPTST, because source file RPGUNITF1 has been renamed to QTESTCASES. Some test cases succeed, when QTESTCASES is duplicated to RPGUNITF1. Though some test cases will still fail, because of different statement numbers due to internal changes.

Existing test suites cannot be compiled with iRPGUnit 3.0, because source member TESTCASE has been moved to source file QINCLUDE.

Follow these steps to fix the problem:

Open the source member of an existing v2.x test suite.
Locate the /copy statement that includes source member TESTCASE.
Change that statement to include TESTCASE of source file QINCLUDE.

Example:

Before iRPGUnit 3.0:

/copy RPGUNIT1,TESTCASE

With iRPGUnit 3.0:

/copy QINCLUDE,TESTCASE

Another option to fix the problem is to duplicate member TESTCASE of source file QINCLUDE to source file RPGUNIT1.

CRTSRCPF FILE(RPGUNIT/RPGUNIT1) RCDLEN(112)
CPYF FROMFILE(RPGUNIT2/RPGUNIT1) TOFILE(RPGUNIT/RPGUNIT1) FROMMBR(TESTCASE) TOMBR(*FROMMBR) MBROPT(*ADD)

For a period of transition iRPGUnit is shipped with a duplicate of member TESTCASE in file RPGUNIT1.