ツールとツールグループの使い方
IBM Bob Premium Package for Z で利用可能なツールとツールグループについて学びます。
ツールは、スキャン、分析、変換、検証、リファクタリング、ドキュメントワークフローを動かす低レベルの機能固有の構成要素です。これらのツールはプログラムソースコード、分析データベース、変換アーティファクトと直接やり取りして、正確で繰り返し可能な結果を提供します。
以下の表は IBM® Bob Premium Package for Z に含まれるツールを示しています。
| ツール | 説明 |
|---|
scan_program | COBOL または PL/I プログラムをスキャンして、変数使用状況、ステートメント参照、プログラム構造を含むメタデータデータベースを生成します。get_variables の前に呼び出す必要があります。後続の変数分析に必要なデータベースパスを返します。 |
get_control_flow | データベースのメタデータを使用して制御フローグラフを計算します。 |
get_paragraphs | メタデータデータベースからパラグラフ情報をクエリーします。 |
execute_sql_query | メタデータデータベース上で AI 生成の SQL クエリーを実行します。 |
| ツール | 説明 |
|---|
get_variables | scan_program でスキャンされたプログラムで使用されている変数のリストを返します。 |
edit_data_dictionary | データディクショナリーファイル（DD.json）をユーザーレビューと変更のためにエディターで開きます。説明を生成する前にユーザーが変数にビジネス上の説明を追加できるようにします。 |
sync_data_dictionary | ローカルデータディクショナリーを Z Understand サーバーに保存されている中央コピーのエントリーと同期します。 |
| ツール | 説明 |
|---|
persona_profile | プログラム説明に対するユーザーの好む説明タイプ（アーキテクト、開発者、またはビジネス）を記述します。 |
| ツール | 説明 |
|---|
refactor | Z Understand リファクタリング操作を実行し、サービス抽出をガイドするインタラクティブツールです。 |
submit_refactor_findings | プログラム内でサービスコード抽出の候補となる場所を見つけます。 |
| ツール | 説明 |
|---|
sign_in_to_z_understand | Z Understand にサインインし、接続された分析プロジェクトの情報を返します。 |
get_project_programs | プロジェクト内のすべてのプログラムを取得します（他のツールで必要な progId を返します）。 |
get_project_variables | 特定のプログラムで定義されたすべての変数を取得します（progId が必要です）。 |
get_project_tables | プロジェクトで定義されたすべてのテーブルを取得します。 |
get_project_statement_types | プロジェクトで利用可能なすべてのステートメントタイプを取得します。 |
get_project_paragraph | プログラム内の特定のステートメント行を含むパラグラフを見つけます。 |
get_project_variable_usage_paragraphs | 特定の変数が使用されているプログラム内のすべてのパラグラフを見つけます。 |
get_project_resource_usage | リソース（テーブル、変数、インクルード、スクリーン、データセット）の使用情報を取得します。 |
get_project_inventory | プロジェクト内の各タイプ（COBOL プログラム、PL/I プログラム、SQL テーブル、IMS テーブル）のアーティファクト数に関する全体情報を取得します。 |
get_project_unused_paragraphs (3.0.20+) | 1 つ以上のプログラムにわたるすべての未使用（デッドまたは到達不能）パラグラフを取得します。例えば、Bob チャットで 「X プログラムの未使用パラグラフを教えて」 と入力すると、指定されたプログラムに関連するすべての未使用パラグラフが表示されます。「'EDIX' を含む名前のプログラムの未使用パラグラフを教えて」 と入力すると、名前に「EDIX」を含むすべてのプログラムの未使用パラグラフが表示されます。 |
get_project_unused_programs (3.0.20+) | プロジェクト内のすべての未使用（デッドまたは到達不能）プログラムを取得します。例えば、Bob チャットで 「プロジェクト内の未使用プログラムを教えて」 と入力すると、利用可能なデータベースレコードに基づいて選択したプロジェクトのすべての未使用プログラムが表示されます。 |
execute_project_sql_query (3.1.0+) | プロジェクトメタデータデータベース全体（プログラム、パラグラフ、変数、ファイル、カーソル、SQL テーブル、コピーブック、トランザクション、JCL ジョブ、CA7 スケジューリングデータ）に対して生の SQL SELECT クエリーを実行します。 |
| ツール | 説明 |
|---|
| zOpenEditor-architect | |
zopeneditor-cobol-get-program-control-flow | COBOL Language Server からパース済みの制御フローデータを取得し、プログラム構造と実行パスを分析します。 |
zopeneditor-cobol-get-data-flow | 特定の COBOL データ項目のデータフローをトレースし、プログラム内でそのアイテムがどのように変更されるかのグラフ表現を返します。 |
zopeneditor-pli-get-program-control-flow | PL/I Language Server からパース済みの制御フローデータを取得し、プログラム構造と実行パスを分析します。 |
zopeneditor-get-embedded-languages | COBOL または PL/I ファイル内の埋め込み言語を検出します。 |
| zOpenEditor-code | |
zcodescan-check-current-program | エディターで現在開いている COBOL または PL/I プログラムファイルに対して IBM ZCodeScan を実行します。スキャンはプログラムをパースし、プログラムの品質に関する linter スタイルの問題を返します。 |
zcodescan-check-list-of-local-programs | ローカルワークスペース内の COBOL または PL/I ファイルに対して IBM ZCodeScan を実行します。ファイルは、エディターワークスペースでスキャンするすべてのプログラムを定義する glob 検索パターンのリストで識別されます。 |
zopeneditor-cobol-format-file | COBOL Language Server と Z Code Format ファイルを使用して COBOL ファイルをフォーマットします。 |
zopeneditor-cobol-format-multiple-files | COBOL Language Server と Z Code Format ファイルを使用して複数の COBOL ファイルをフォーマットします。 |
zopeneditor-cobol-renumber-file | COBOL Language Server を使用して COBOL ファイルの番号を振り直し、ファイル内のすべての行にシーケンス番号を追加します。 |
zopeneditor-cobol-renumber-multiple-files | COBOL Language Server を使用してワークスペース内の複数の COBOL ファイルの番号を振り直します。 |
zopeneditor-cobol-unnumber-file | COBOL Language Server を使用して COBOL ファイルのすべての行からシーケンス番号を削除します。 |
zopeneditor-cobol-unnumber-multiple-files | COBOL Language Server を使用してワークスペース内の複数の COBOL ファイルのすべての行からシーケンス番号を削除します。 |
| ツール | 説明 |
|---|
submit_optimize_findings | 推奨レポートをパースし、各推奨事項を関連する COBOL ファイルの Bob Finding として送信します。 |
ツールグループは、プラットフォーム全体での発見性、アクセス制御、使いやすさを向上させるために、機能を論理ドメインに分類します。各グループはコード分析や統合などの関連操作のセットを表し、ユーザーとシステムが意図に基づいて機能を効率的に整理して呼び出せるようにします。
| カテゴリー | ツールグループ | 説明 | ID |
|---|
| Core | Core | プライマリ操作に必要な基本ツールセット。 | core |
| Core | Hint | ユーザーを支援するための文脈的な提案、ガイダンス、またはインラインヒントを提供します。 | toolHint |
| Data & API | Scan | コードベース、リソース、または環境のスキャンに使用します。 | scan |
| Data & API | Data Dictionary | メタデータ、スキーマ定義、構造化データの説明との対話を可能にします。 | dataDictionary |
| Data & API | GraphQL | GraphQL クエリーの生成、実行、スキーマ操作を処理します。 | graphQl |
| Code Intelligence | Analysis | コード品質、依存関係、問題に関するインサイトのための静的/動的分析を実行します。 | analysis |
| Code Intelligence | Explain | コードロジック、関数、ワークフローの説明を生成します。 | explain |
| Code Modification | Refactor | 機能を変えずにコードの再構造化をサポートします。 | refactor |
| Integrations | zOpenEditor Architect | zOpenEditor ワークフロー向けのアーキテクチャー重視ツール。 | zOpenEditor-architect |
| Integrations | zOpenEditor Code | zOpenEditor 内のコードレベルツール。 | zOpenEditor-code |
| Integrations | zOpenDebug Code (3.1.0+) | zOpenDebug 内のコードレベルツール。 | zOpenDebug-code |