Home

OpenRPG User's Guide

OpenRPG transpiles IBM RPG IV source code into portable C++17 and optionally compiles it to a native executable. Both free-format and classic column-based fixed-format source are accepted, and the two can be mixed in one file. Programs can run on macOS, Linux, or any platform with a C++ compiler — no IBM i required.

Generated from docs/GUIDE.md in the main repository by scripts/sync-wiki.py — edit the guide there, not these pages.

Contents

1. Installation
2. Quick Start
3. CLI Reference
4. Language Basics
5. Data Types
6. Variables and Constants
7. Data Structures
8. Arrays
9. Varying-Dimension Arrays
10. Control Flow
11. Procedures
12. Procedure Overloading
13. Built-In Functions
14. Error Handling
15. Operation Extenders
16. Enumerations
17. Program Status Data Structure
18. Data Areas
19. SND-MSG
20. Embedded SQL
21. Record-Level Access
22. Display Files (WORKSTN)
23. Program-Described Files (I-Specs and O-Specs)
24. DATA-INTO and DATA-GEN
25. XML-INTO
26. Fixed-Format Source
27. Database Connections
28. Multi-Module Programs
29. Environment Variables
30. Testing
31. Complete Example: Employee Report