Hello world RPGLE Tutorial takes you through the steps to create and run a RPG IV program.
In this tutorial, I am going to show how to create a simple free format RPGLE program step by step using IBM Rational Developer and Program Development Manager in AS400 emulator which is commonly use as green screen or 5250 emulator.
Following are the parts we will discuss in this tutorial,
- Initial setup for RPGLE Free format
- Entering free format RPGLE code
- Compilation of RPGLE code
- Run the program
First of all, I assume you are using one of two ways to do your coding:
- IBM RDi
If you are wondering what IBM Rdi is ?, it’s an IDE which provides an integrated development environment to create, maintain and modernise applications on the IBM i platform. I have wrote a comprehensive article about IBM Rdi here – IBM Rational Developer for i
- PDM and SEU through some type of 5250 emulator
If you are new to SEU editor I propose you to go through Use of SEU Editor which explains dozen if SEU line commands which will improve your experience in SEU editor.
Initial setup for RPGLE Free format
If you are using IBM RDi:
Create a connection to your IBM i.
Then create a library and remember the name of the library you create because you need it later when you call your first program. (Replace yourlibrary in the instructions with the name of the library you created.)
After that, Create a source file.
And create a source member in the file called
Open the member in the editor.
If you are using SEU:
Log on to a session on your IBM i.
Create a library by using the CRTLIB command.
Create a source file by using the CRTSRCPF command.
If you are not familiar with Creating Libraries and Source Physical Files, you can follow Create Library and Source Physical Files article which explains creating libraries and conventions of source physical file naming step by step.
WRKMBRPDM specifying your library and source file.
Create a source member HELLO in the file by using F6 in WRKMBRPDM or by using the ADDPFM command, giving it type RPGLE.
Open the member in SEU by using the “2” option.
Entering the RPGLE Free Format program statements
Type the following code and When you type be sure that the first **FREE goes in column 1 of line 1. If you are using RDi, the editor shows you all the columns but if you are using SEU, the editor does not show you columns 1-5 by default, so the first column you see is column 6. Use F19 to shift the code left so you can see column 1.
Differences between Free format RPG and conventional RPG can be found here Differences between Free Format vs Legacy Fixed Format
Compile RPGLE Free Format program
If you are using RDi, you can compile from the menu within the editor, or you can save your changes and compile by right-clicking on the member in the navigation. Either way, select the CRTBNDRPG command, and take all the defaults.
If you are using SEU, exit the editor by using F3, and compile by using option 14 also You could compile from the command line by using the CRTBNDRPG command, and by using F4 to prompt the command.
Warning: SEU gives errors for every free-form H, F, D, or P statement Therefore RPG syntax checker used by SEU was last updated in 6.1, so it does not understand the new syntax. If you still want to use SEU, you have to exit with errors after you save your source.
Run the Program
If you are using RDi, log on to a session on the IBM i by using an emulator
If you are using PDM, you are already logged on,
Use the CALL command to call the HELLO program, substituting the name of your library for yourlibrary.
It puts up a message saying “DSPLY Hello World”
Just press ENTER to end the program and That is the end of Hello World RPGLE Tutorial, In next chapter we can focus on compilation error handling.
Source : IBM Developer Portal