使用工具和工具群組
了解 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 | 擷取資源（資料表、變數、include、畫面、資料集）的使用情況資訊。 |
get_project_inventory | 擷取專案中各類型構件數量的整體資訊（COBOL 程式、PL/I 程式、SQL 資料表、IMS 資料表）。 |
get_project_unused_paragraphs （3.0.20+） | 擷取一個或多個程式中所有未使用（無效或無法到達）的段落。例如，當你在 Bob 聊天中輸入提示 「告訴我 X 程式的未使用段落」 時，回應會顯示與指定程式相關的所有未使用段落。當你輸入 「告訴我名稱包含 'EDIX' 的程式的未使用段落」 時，回應會顯示所有名稱包含 "EDIX" 的程式的未使用段落。 |
get_project_unused_programs （3.0.20+） | 擷取專案中所有未使用（無效或無法到達）的程式。例如，當你在 Bob 聊天中輸入提示 「告訴我專案中的未使用程式」 時，回應會根據可用的資料庫記錄顯示所選專案的所有未使用程式。 |
execute_project_sql_query （3.1.0+） | 對完整的專案中繼資料資料庫（程式、段落、變數、檔案、游標、SQL 資料表、copybook、交易、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 | 解析建議報告，並將每項建議以 Bob Finding 的形式提交至相關的 COBOL 檔案。 |
工具群組將功能分類到邏輯領域，以提升可探索性、存取控制和整個平台的可用性。每個群組代表一組相關操作，例如程式碼分析和整合，讓使用者和系統能根據意圖有效率地組織和叫用功能。
| 類別 | 工具群組 | 說明 | ID |
|---|
| 核心 | Core | 主要操作所需的基本工具集。 | core |
| 核心 | Hint | 提供情境建議、指引或內嵌提示以協助使用者。 | toolHint |
| 資料與 API | Scan | 用於掃描程式碼庫、資源或環境。 | scan |
| 資料與 API | Data Dictionary | 支援與中繼資料、schema 定義和結構化資料說明的互動。 | dataDictionary |
| 資料與 API | GraphQL | 處理 GraphQL 查詢產生、執行和 schema 操作。 | graphQl |
| 程式碼智慧 | Analysis | 執行靜態/動態分析，以洞察程式碼品質、相依性和問題。 | analysis |
| 程式碼智慧 | Explain | 產生程式碼邏輯、功能和工作流程的說明。 | explain |
| 程式碼修改 | Refactor | 支援在不改變功能的情況下重構程式碼。 | refactor |
| 整合 | zOpenEditor Architect | zOpenEditor 工作流程的架構導向工具。 | zOpenEditor-architect |
| 整合 | zOpenEditor Code | zOpenEditor 中的程式碼層級工具。 | zOpenEditor-code |
| 整合 | zOpenDebug Code （3.1.0+） | zOpenDebug 中的程式碼層級工具。 | zOpenDebug-code |