IBM iユーザーが、VSCodeでRPGⅣやFFRPGのコーディングをしていくうえで必要なVSCodeのインストール、初期設定、VSCode側のIBM iへの接続設定を紹介する記事となっています。
今までVSCodeを触った事がない方向けに説明していますので理解出来てるところは飛ばしてください。
IBM iへ接続する直前にIBM i側でSSHDサーバーを開始する必要があります。
SSHDサーバーの開始方法についてはIBM iのSSH接続をイチから設定してみたで説明しておりますので参考にしていただければと思います。
そもそもVSCodeって何？どうやって使うの？5250エミュレーターよりVSCodeを使うメリットあるの？については5250ユーザーが「VSCode」を使ってみた ～VSCodeの基本知識編～からご確認ください！
0.環境前提-2024年10月時点
| 環境項目 | 環境名 |
|---|---|
| PC | Windows11 |
| IBM iバージョン | V7.3 |
| エミュレーター | 5250(IBM i Access Client Solutions) |
| QCCSID | 65535(記事内で5035のユーザープロファイルを用意) |
| 導入済ライセンス | 5733SC1あり |
1.そもそもVSCodeとは…？
Microsoftが提供する無料の統合開発環境(正式名称:Visual Studio Code)でどんなシステムエンジニアでも一度は聞いた事があるサービスだと思います。
1.VSCodeのダウンロード手順
ダウンロードページにアクセスし、赤点線枠内の「Visual Studio Codeをダウンロードする」をクリックします。
以下の写真のようにWindows用のリンクをクリックして、インストーラーをダウンロードします。
ダウンロードしたインストーラーを実行し、VSCodeをインストールします。
セットアップ中に以下の画面でデスクトップ上にアイコンを作成する事が出来るのでチェック推奨です。
(筆者はタスクバーに追加してます。)
2.VSCode初回起動～拡張機能の導入まで
VSCodeをインストール出来たら起動します。
初回起動時の初期表示は以下の画面になります。
左端にメニューバーがあるので、その中のテトリスのようなアイコンをクリックすると拡張機能一覧ウィンドウが展開されます。
そのウィンドウの上部に拡張機能の検索窓があるので導入したい拡張機能を検索してインストールしていきましょう。
未導入の拡張機能が検索結果に表示された場合は、インストールボタンが表示されるのでクリックだけでインストールできます。
2.IBM i関連や必須レベル、オススメの拡張機能一覧
| No | 重要度 | 拡張機能名 | 説明 | 備考 |
|---|---|---|---|---|
| A | 必須 | Japanese Language Pack for Visual Studio Code | VSCodeの言語を日本語に変更できます | |
| B | 必須 | IBM i Development Pack | VSCodeでRPG/CL/COBOLのソースコードの保守、コンパイルといった開発が可能になります | |
| C | 必須 | Code for IBM i | IBM iのプログラム編集、コンパイル、デプロイ、デバッグ、ファイル(IFS)管理、SSH接続が可能になります | 2の拡張機能に内包 |
| D | 必須 | SFTP | IBM iへのファイルの自動アップロード、双方向同期が可能になります | 2の拡張機能に内包 |
| E | 必須 | RPGLE FREE | RPGLEコードの可読性の向上、コード補完機能、フリーフォーマットへのコンバージョン機能が追加されます | 2の拡張機能に内包 |
| F | オススメ | indent-rainbow | インデントに色が付きコードの可読性が向上します | |
| G | オススメ | vscode-icons | ファイルの拡張子やディレクトリの区別をアイコン表示する事で視認性が向上します | |
| H | オススメ | IntelliCode | AIを活用したコード補完機能で、コードの文脈に応じた適切な補完をしてくれます | |
| I | オススメ | Path Intellisense | ファイルパスの自動補完を行い、入力ミスが軽減します | |
| J | オススメ | Bracket Pair Colorizer | 対応する括弧を色分け表示し、コードの構造の視認性が向上します | |
| K | オススメ | Better Comments | コメントを色分け表示し、重要なコメントやTODOを強調表示出来る拡張機能 |
3.Code for IBM i(拡張機能)の初期設定方法
Code for IBM iのインストールが完了しましたら、IBM iに接続するためのConnection情報を入力をしていきます。
まずは左端のメニューバーにあるIBM i(サーバーマーク)アイコンをクリックし、メニューを展開します。
IBM iメニューの下にSERVERSというタブにカーソルを合わせて＋ボタンをクリックします。
IBM iログイン設定画面が表示されるので以下を参考に赤枠点線内を入力していきます。
| No | 入力項目 | 説明 |
|---|---|---|
| 1 | Connection Name | 接続名を入力 |
| 2 | Host or IP Address | 接続するIBM iのHost名かIPを入力 |
| 3 | Port(SSH) | SSHDサーバーのポート番号を入力 (IBM iは22ポート、PUB400は2222ポート) |
| 4 | Username | サインオン時のユーザー名を入力 |
| 5 | Password | サインオン時のパスワードを入力 |
入力後、お好みに合わせてSave Passwordにチェックを入れて、Connectをクリックします。
ConnectでIBM iに接続する際、事前にSSHDサーバーの開始をする必要があります。SSH接続設定、開始方法はIBM iのSSH接続をイチから設定してみたでご確認ください。
初回接続時には、以下のような確認メッセージが表示されます。
IBM i デバッグ拡張機能は、この接続のパスワードへのアクセスを要求しています。と聞かれており、問題が無ければAllowをクリックします。
4.記事作成にあたっての所感
3のIBM iへの接続設定でどんな値を入れるのかが少し自信がなく調べながら進めていきました。
その辺りは当記事で可能な限り、不明点を排除した書き方が出来たのではないかと思います。
筆者自身、過去にVSCodeを触った経験があったのでVSCode側でつまづいたところはありませんでしたので今回、初めてインストールされた方にとって分かり辛かった部分があったかと思います。当記事で詰まってしまったポイントがあれば、コメントで教えてくださればと思います。他にも記事を投稿しておりますので閲覧、そしてアカウントのフォローよろしくお願いいたします！