Skip to content

Commit 8601786

Browse files
Add RPGUnit preconditions
Signed-off-by: Sanjula Ganepola <Sanjula.Ganepola@ibm.com>
1 parent 7326217 commit 8601786

File tree

2 files changed

+31
-12
lines changed

2 files changed

+31
-12
lines changed

src/content/docs/developing/testing/overview.mdx

Lines changed: 25 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,24 @@ The following extensions can be installed from the Visual Studio Code Marketplac
3737

3838
The `RPGUNIT` library must be be installed on your IBM i in order to leverage the framework and assertions that it provides. It can be installed easily via the extension using the steps below which is the recommended approach or manually using the instructions [here](https://irpgunit.sourceforge.io/help/).
3939

40-
<Aside type="note">
41-
By default, `RPGUNIT` is the name of the RPGUnit product library which will be installed on the host. This can be configured if necessary by going to the extension's settings and searching for the **Product Library** setting.
42-
![Product Library](Testing_ProductLibrary.png)
43-
</Aside>
40+
#### Preconditions
41+
RPGUnit requires OS400 7.5 for the latest features. It can also be installed on 7.4 and 7.3 if the following PTFs have been installed:
42+
43+
**7.4**
44+
* ILE RPG runtime: SI71537
45+
* ILE RPG compiler: SI71536
46+
* SQL Precompile support UTF-8 stream files: SI70942
47+
48+
**7.3**
49+
* ILE RPG runtime: SI71535
50+
* ILE RPG compiler: SI71534
51+
* SQL Precompile support UTF-8 stream files: SI70936
52+
53+
If the PTFs have not been installed, the library must be recompiled to disable the latest features, such as `assertEqual()`. PTFs SI70942 and SI70936 are required for compiling test suites from UTF-8 (CCSID: 1208) source stream files.
4454

45-
To install the library via the extension, follow these steps:
55+
#### Library Installation via Extension
56+
57+
Once the PTFs are installed, you can install the library via the extension using the folllowing steps:
4658

4759
<Steps>
4860
1. Connect to your IBM i system.
@@ -58,9 +70,14 @@ To install the library via the extension, follow these steps:
5870
![Installation Logs](Testing_InstallationLogs.png)
5971
</Steps>
6072

73+
<Aside type="note">
74+
By default, `RPGUNIT` is the name of the RPGUnit product library which will be installed on the host. This can be configured if necessary by going to the extension's settings and searching for the **Product Library** setting.
75+
![Product Library](Testing_ProductLibrary.png)
76+
</Aside>
77+
6178
### 3. CODECOV
6279

6380
To generate code coverage results, the `CODECOV` command must be installed on your IBM i via PTF:
64-
* **V7R3**: PTF SI80728
65-
* **V7R4**: PTF SI80737 & SI81204
66-
* **V7R5**: PTF SI81216 & SI81217
81+
* **7.3**: PTF SI80728
82+
* **7.4**: PTF SI80737 & SI81204
83+
* **7.5**: PTF SI81216 & SI81217

src/content/docs/developing/testing/writing.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,8 @@ import { Aside, CardGrid, Card, Tabs, TabItem } from '@astrojs/starlight/compone
1010

1111
In RPGUnit, a test case is an exported procedures that starts with the name `test`. This also means that you should not export procedures starting with `test` if they are not intended to be a test case.
1212

13-
**Example test cases:**
13+
Listed below are some example test case names that follow this naming convention:
14+
1415
* `test_getEmployeeDetail`
1516
* `test_getDeptDetail`
1617
* `testIsPalindrome`
@@ -24,13 +25,14 @@ A test suite consists of one or more test cases in a file or source member. This
2425
* **Source Members**: Source members can be put in any source file, but it is recommended to store them in a source file named `QTESTSRC`. By default this is where the extension will look for test suites in your library list. You can configure the extension to search other source files by going to the extension's settings and searching for the **Test Source Files** setting.
2526
![Test Source Files](Testing_TestSourceFiles.png)
2627

27-
**Example test suites:**
28-
* Local Files
28+
Listed below are some example test suite names that follow this naming convention:
29+
30+
* **Local Files**
2931
* `employee.test.rpgle`
3032
* `department.test.rpgle`
3133
* `string.test.rpgle`
3234
* `math.test.rpgle`
33-
* Source Members
35+
* **Source Members**
3436
* `QTESTSRC` source file with members:
3537
* `EMPLOYEE.RPGLE`
3638
* `DEPARTMENT.RPGLE`

0 commit comments

Comments
 (0)