トラブルシューティング
Bob を使った IBM i 開発で発生する問題を、簡単に診断して解決します。
Bob 全般のトラブルシューティングについては、Troubleshooting IBM Bob を参照してください。
extension log
IBM Bob Premium Package for i は、VS Code の 2 つの output channel に構造化されたログエントリーを書き込みます。
IBM Bob Premium Package for i
IBM Bob Premium Package for i output channel は、Bob が行ったすべての tool call を記録するため、ツールが予期しない動作をしたりエラーが発生した場合に最初に確認すべき場所です。アクセスするには:
Bob で Output panel を開きます(View → Output、または Ctrl+Shift+U(Windows)/ Cmd+Shift+U(Mac))。
Output panel 右上の output channel ドロップダウンから IBM Bob Premium Package for i を選択します。
各 tool call では次のエントリーが生成されます:
- ツールが開始されるときに、ツール名と関連パラメーターを示す INFO エントリー。
- ツールが失敗した場合に、Bob が受け取る内容と同じ説明メッセージを含む ERROR エントリー。
- ツールが 30 秒経過しても完了していない場合に、潜在的なハングを示す WARN エントリー。
- 合計実行時間(ミリ秒)を示す完了エントリー。
IBM Bob
IBM Bob output channel は、extension レベルの全般的なログエントリーを記録します。アクセスするには:
Bob で Output panel を開きます(View → Output、または Ctrl+Shift+U(Windows)/ Cmd+Shift+U(Mac))。
Output panel 右上の output channel ドロップダウンから IBM Bob を選択します。
IBM Bob Premium Package for i 固有の log message に絞り込むには、output channel 内にカーソルを置き、Ctrl+f(Windows)または Cmd+f(Mac)を押して、[source:ibmi] を検索します。
その他の関連チャンネル
関連する診断情報は、前提となる他の IBM i extension が管理する次の output channel にもあります。
- Code for IBM i: すべての IBM i 通信に関する主要な output channel です。実行された CL、SQL、PASE コマンド、そのエラー、認証メッセージ、その他の各種 system message が含まれます。
- IBM i Testing: 検出された test、使用される test configuration、test command の標準出力とエラーなどを記録します。
リソース
IBM i 7.6 Documentation
IBM i 向け公式 IBM 7.6 ドキュメントです。
IBM Bob for IBM i Developers YouTube Playlist
IBM i 開発者が Bob を活用する方法を紹介する walkthrough、demo、tip をまとめた YouTube playlist です。
Code for IBM i Extension Documentation
Code for IBM i extension の公式ドキュメントです。接続設定、library list の構成、QSYS と IFS の参照、ソースコードのコンパイルを扱います。
Db2 for IBM i Extension Documentation
Db2 for IBM i extension の公式ドキュメントです。SQL の実行、database object の参照、Visual Explain の活用、SQL example へのアクセスを扱います。
RPGLE Extension Documentation
RPGLE extension の公式ドキュメントです。fixed-format と free-format の RPGLE language editor 機能を扱います。
CL Extension Documentation
CL extension の公式ドキュメントです。CL language editor 機能を扱います。
IBM i Testing Extension Documentation
IBM i Testing extension の公式ドキュメントです。RPGUnit test の書き方、設定方法、code coverage 付き実行方法を扱います。
RPGUnit Documentation
RPGUnit の公式ドキュメントです。test suite のセットアップ、assertion API、compile command、code coverage 設定を扱います。