フリーフォームRPG入門|開発環境の準備と最初のプログラム
IBM iで使われるプログラミング言語「RPG(ILE RPG)」の、フリーフォームの書き方を、入門者向けに説明します。必要な環境や権限、開発環境の準備、そして、最小のサンプルを載せます。ここでいうRPGは、ゲームを作る「RPG制作ソフト」とは別のものです。
このページの内容
実機の確認について。IBM i実機では未検証です。文法は、IBM i 7.3のドキュメントの説明(更新2026年7月12日)に基づく最小の例です。コンパイル結果や実行結果は、掲載していません。
この資料の対象と、確認した範囲
| 対象環境 | IBM i(ILE RPG)。開発用のPCはWindows 11を想定 |
|---|---|
| Windowsでの確認 | Windowsで確認したのは、VS Codeの導入と、Code for IBM i拡張の導入の画面までです(別ページ) |
| IBM i実機での確認 | IBM i実機では未検証です。サンプルのコンパイル・実行は行っていません。 |
| 確認日 | 2026年11月14日 |
RPGとは
RPG(現在はILE RPGと呼ばれます)は、IBM iで、業務プログラムを書くために長く使われてきた言語です。伝票処理や、データベースの更新などを、短い記述で書けることが特徴です。
「RPG」という名前は、ロールプレイングゲームを作る制作ソフトにも使われます。このページの内容は、ゲームとは関係ありません。
フリーフォームの特徴
昔のRPGは、プログラムの行の「どの桁に何を書くか」が決まっていました(固定形式)。フリーフォームは、他の言語のように、文を自由な位置に書ける書き方です。IBM i 7.3のドキュメントには、次のことが書かれています。
- ソースの1行目が
**FREEのとき、完全なフリーフォームです。文は、1桁目から行の終わりまでのどこにでも書け、行の長さに制限はありません。 **FREEがないときは、桁制限つきです。文は、8〜80桁に書き、6〜7桁は空白にします。- 文は、セミコロン(
;)で終わります。 //から行末までは、コメントです。- 文は、多くの場合、
CTL-OPT、DCL-F、DCL-DS、DCL-PROCなどの命令コードで始まります。
完全フリーフォームが使えるリリースや、必要な修正(PTF)は、お使いのIBM iの公式資料で確認してください。
必要な環境と権限(確認事項)
| 項目 | 内容 | 確認方法 |
|---|---|---|
| IBM iの環境 | ILE RPGのコンパイラーが導入されていること。 | 管理者に、導入済みの製品を確認します。 |
| ユーザー | ソースを作成し、コンパイルできる権限を持つユーザープロファイル。 | 管理者に、使うライブラリーと権限を確認します。 |
| ライブラリー | ソース(ソース物理ファイル)と、完成したプログラムを置く場所。 | 管理者に、作成してよい場所を確認します。 |
| 開発用PC | Windows 11 + Visual Studio Code + Code for IBM i。 | Code for IBM iの導入方法へ |
コンパイラーの導入状況や権限は、環境ごとに異なります。このページでは、実機で確認していないため、具体的な製品番号や設定値は書きません。
開発環境の準備
- Visual Studio Codeを入れます(導入ガイド)。
- 拡張機能「Code for IBM i」を入れます(導入ガイド)。
- IBM iに接続します。Code for IBM iの公式ドキュメントでは、接続先に、SSHデーモンが起動していること、ログインするユーザーが有効でパスワードを持つことなどが求められています。
- ソース物理ファイル(
*SRCPF)を、オブジェクト・ブラウザーから開き、ソースメンバーを作ります。
最初のプログラム(独自の最小サンプル)
次は、メッセージを表示する、最小の例です。ソースの1行目に **FREE を書いた、完全フリーフォームです。
**FREE
dcl-s msg varchar(40) inz('Hello, IBM i');
dsply msg;
*inlr = *on;
return;dcl-sは、変数(単独の項目)の宣言です。varchar(40)は、長さが変わる文字列、inzは初期値です。dsplyは、画面にメッセージを表示します。*inlr = *on; return;は、プログラムを終了するときの、定番の書き方です。
未検証です。この例は、IBM公式ドキュメントの文法の説明に沿って書いた最小の例で、IBM i実機でコンパイル・実行していません。エラーが出たときは、コンパイラーの一覧と、お使いのIBM iのドキュメントを確認してください。
次に読むもの
よくある質問
RPGゲームを作るための解説ですか?
いいえ。IBM iの業務プログラムを書く言語(ILE RPG)の解説です。
固定形式は、もう使えませんか?
このページでは、固定形式の説明はしていません。お使いの環境の公式資料で確認してください。
Windowsだけで試せますか?
RPGのコンパイルと実行は、IBM i環境が必要です。Windowsでは、エディターの準備までです。