使用样本作业 EQADCLSU 进行定制

eqadcol.env

Data Collector 可使用以下环境变量：

port= "port_number "

收集器监听 z/OS 调试器引擎连接的端口号。 该端口为强制端口，每个收集器实例都需要自己的端口。 如果要加密连接，可使用 AT-TLS 保护该端口。

localhostOnly=true

取消这一行可限制只收集来自 localhost 的请求。 该选项要求定义 localhost 和本地环回地址。

java_dir= "java_directory "

64 位 Java SDK 的主目录。 例如， java_dir="/usr/lpp/java/J17.0_64"。

umask= "permission "

创建新文件或目录时使用的文件权限。 默认值为 u+rwx,go=rx。

data_collector_output= /var/debug/data_collector_output

保存数据文件的目录。 该选项为强制选项。 若启动多个实例，可能指定相同的输出位置。 配置数据收集器服务时需要此目录。

data_savesource=true

如果可以通过调试数据保存源文件，则取消注释该选项以保存源文件。 该选项可通过数据收集提供更多信息，但会降低性能。 默认集合不保存源代码。

run_describe=true

取消注释可运行 DESCRIBE LOADMOD 和 DESCRIBE CU，作为数据收集会话的一部分。 该选项可通过数据收集提供更多信息，但会降低性能。 默认设置为 false，不运行附加调试命令。

data_props= "properties_path "

取消注释以提供属性文件的路径（例如 dataCollector.properties），用于配置数据收集器。 有关此属性文件的更多详细信息，请参阅使用示例作业 EQADCLSU 进行自定义的最后一节。

data_props_encoding="编码"

取消注释可覆盖属性文件的默认编码。 代码页 IBM-1047 是默认设置。

dps_base_URI= "url "

用于为数据收集器创建配置文件的调试配置文件服务实例的基础 URL （例如 https://localhost:8143/api/v1 ）。 如果调试配置文件服务 使用自签名证书或内部签名 CA，则应将这些证书放在数据收集器使用的密钥库中，以表明它们是可信的（请参阅 'keystoreFile' ）。

keystore_file="keystore_file_path "

存储调试配置文件服务 TLS 服务器证书的 PKCS12 或 JKS keystore 文件的路径名。 该密钥存储还可以包含自签名或内部签名 CA 证书。

密钥库密码文件="密钥库密码文件路径"

使用 z/OS 调试器密码文件生成器工具生成的加密密钥存储密码文件的完全限定路径。 有关生成安全密码的更多信息，请参阅生成与数据收集器一起使用的安全密码。

dps_user="用户"

用户ID，其加密密码存储在 dps_pwd_file. 中。 此用户ID必须具备必要的 RACF 权限，才能代表其他用户创建和删除集合配置文件。 要启用此功能，系统程序员必须授予您对 EQADTOOL.IMPERSONATE.*.*RACF 配置文件的访问 ALTER 权限。 有关定义此 RACF 配置文件的详细信息，请参阅允许用户模拟其他用户。

dps_pwd_file= "dps_password_file_path "

dps_user 中指定的用户 ID 的加密密码文件的完整路径。 该文件使用 z/OS 调试器密码文件生成器工具生成 ，如生成与数据收集器一起使用的安全密码中所述。

bzu_config= "data_set_name "

取消注释，为 BZUCFG 文件指定完全合格的数据集。 当数据收集期间没有调试数据时，强烈建议使用此方法。 仅支持第 3 版记录格式。

cics_config= "cics_config_file_path "

取消注释可指定 CICS 配置文件（例如 cicsCollectionProfiles.json）的路径，该文件包含 CICS 配置文件定义。 必须指定 cics_config 或 ims_config 中的至少一个。

cics_config_encoding="编码"

取消注释可指定 cics_config 中指定的配置文件的编码。 该选项覆盖 IBM-1047 的默认编码。

覆盖CICS=true

取消注释可覆盖任何现有的 CICS 调试配置文件。 默认设置为 false。

ims_config=" ims_config_file_path "

取消注释可指定 IMS 配置文件（例如 imsCollectionProfiles.json）的完整限定路径，该文件包含 IMS 或 IMS 隔离配置文件定义。 必须指定 cics_config 或 ims_config 中的至少一个。

ims_config_encoding="编码"

取消注释可指定 ims_config 中指定的配置文件的编码。 该选项覆盖 IBM-1047 的默认编码。

覆盖_IMS=true

取消注释可覆盖任何现有的 IMS 或 IMS 隔离调试配置文件。 默认设置为 false。

cicsCollectionProfiles.json

cicsCollectionProfiles.json 配置文件使数据收集器能够使用调试配置文件服务 自动创建 CICS 配置文件。 然后利用这些档案收集数据。 文件格式为 json，内容为包含类型（始终为 "cics"）、区域和 ownerID 的对象数组。 ownerID 将拥有调试配置文件，同时也是收集数据的用户。

[
  {
    "type": "cics",
    "region": "REGION1",
    "ownerID": "USER1"
  },
  {
    "type": "cics",
    "region": "REGION1",
    "ownerID": "USER2"
  },
  {
    "type": "cics",
    "region": "REGION2",
    "ownerID": "USER1"
  }
]

有关 CICS 调试配置文件的更多信息，请参阅 《添加对调试配置文件服务API的支持》。

imsCollectionProfiles.json

[
  {
    "type": "ims",
    "userID": "USER1",
    "subsystemID": "IMS1"
  },
  {
    "type": "ims",
    "userID": "USER2",
    "subsystemID": "IMS1"
  },
  {
    "type": "ims_iso",
    "userID": "USER3",
    "subsystemID": "IMS1",
    "transactionID": ["TRAN1", "TRAN2"]
  }
]

有关 DTSP 配置文件的更多信息，请参阅《 添加对调试配置文件服务 API 的支持 》中的“非 CICS 环境”部分。

有关 IMS 隔离配置文件的更多信息，请参阅《 为 IMS 事务隔离服务 API 添加支持 》。

dataCollector.属性

您可以使用 dataCollector.properties 文件为每个数据收集会话配置数据收集器。 例如，如果要从两个不同版本的应用程序中收集数据，就必须运行两个独立的数据收集器实例。 每个实例必须使用不同的 dataCollector.properties 文件，该文件指定了相应的应用程序版本。 这确保了所收集的数据可以根据嵌入式应用程序的版本进行区分。