使用工具和工具组
了解 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 语言服务器检索已解析的控制流数据，用于分析程序结构和执行路径。 |
zopeneditor-cobol-get-data-flow | 追踪特定 COBOL 数据项的数据流，并返回该项在程序中被修改情况的图形表示。 |
zopeneditor-pli-get-program-control-flow | 从 PL/I 语言服务器检索已解析的控制流数据，用于分析程序结构和执行路径。 |
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 语言服务器和 Z Code 格式文件格式化 COBOL 文件。 |
zopeneditor-cobol-format-multiple-files | 使用 COBOL 语言服务器和 Z Code 格式文件格式化多个 COBOL 文件。 |
zopeneditor-cobol-renumber-file | 使用 COBOL 语言服务器对 COBOL 文件重新编号，为文件中的每一行添加序列号。 |
zopeneditor-cobol-renumber-multiple-files | 使用 COBOL 语言服务器对工作区中的多个 COBOL 文件重新编号。 |
zopeneditor-cobol-unnumber-file | 使用 COBOL 语言服务器从 COBOL 文件的每一行中删除序列号。 |
zopeneditor-cobol-unnumber-multiple-files | 使用 COBOL 语言服务器从工作区中多个 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 |