Upgrading From v0.3.2 to v2.0.0
There are no experiences regarding to upgrading from the original version 0.3.2 of
RPGUnit. Therefore, first of all:
| Test your existing test suites carefully in a sandbox
environment, before upgrading to iRPGUnit 2.0.0. |
Unit test, that uses the following assertions run and compile fine with all
versions of RPGUnit:
- assert()
- aEqual()
- iEqual()
- fail()
You should be aware of the following changes:
- RPG data structure AssertFailEvt_t has been changed.
- RPG data structure CallStk_t has been changed.
- RPG data structure ExcpMsgInfo_t has been replaced with Msg_t.
- RPG data structure MsgSendet_t has been changed.
- RPG data structure TestResult_t has been changed.
- RPG data structure TestSuite_t has been changed.
- The test reports got a left margin.
Most of the compile errors and failing self tests are due to these changes.
The following test cases (compiled with v0.3.2) do not successfully run with iRPGUnit:
- Test cases TESTASSERTWITHFAILURE of test suite ASSERTT.
- Test cases TESTASSERTWITHSUCCESS of test suite ASSERTT.
- Test cases TESTBIGINTEGEREQUALITY of test suite ASSERTT.
- Test cases TESTGOODBYEISNOTHELLO of test suite ASSERTT.
- Test cases TESTHELLOEQUALSHELLO of test suite ASSERTT.
- Test cases TESTTWOANDTWOEQUALSFOUR of test suite ASSERTT.
- Test cases TESTTWOANDTWOISNOTEQUALTOFIVE of test suite ASSERTT.
- All test cases of test suite CMDRUNT.
- Test cases TESTACTIVATETESTSUITE of test suite EXTTSTT.
- Test cases TESTNOMSGINJOBLOG of test suite JOBLOGT.
- All test cases of test suite RUACPTST.
- Test cases TEST_LOADTESTSUITE of test suite RUNT.
- Test cases TEST_RUNTEST_FAILUREINTEST of test suite RUNT.
- Test cases TEST_RUNTEST_SUCCESSFULTEST of test suite RUNT.
- Test cases TEST_RUNTEST_WITHSETUPANDTEARDOWN of test suite RUNT.
- Test cases TEST_RUNTESTPROC_ERRORINSETUP of test suite RUNT.
- Test cases TEST_RUNTESTPROC_ERRORINTEARDOWN of test suite RUNT.
- Test cases TEST_RUNTESTPROC_ERRORINTEST of test suite RUNT.
- Test cases TEST_RUNTESTPROC_FAILUREINTEST of test suite RUNT.
- Test cases TEST_RUNTESTPROC_TEARDOWNAFTERERRORINSETUP of test suite RUNT.
The following test suites do not compile with iRPGUnit:
- Test suite ASSERTT: For example: callStkEnt of AssertFailEvt_t has been renamed to callStk.
- Test suite CMDRUNT: For example: ExcpMsgInfo_t does no longer exist.
- Test suite CMDRUNLOGT: For example: callStkEnt of AssertFailEvt_t has been renamed to callStk.
- Test suite PGMMSGT: For example: ExcpMsgInfo_t does no longer exist.
- Test suite RUCRTTSTT: /COPY member RUCRTTST has been renamed to CRTTST and number of parameters of getCrtRpgModCmd() and getCrtSrvPgmCmd() have changed.
- Test suite RUNT: /COPY member RUCRTTST has been renamed to CMDRUNSRV and callStkEnt of AssertFailEvt_t renamed to callStk.
Test cases that call procedure getAssertFailEvt() have to be validated, because
data structure AssertFailEvt_t has been changed.