RSED 整合

Eclipse 客户使用 Explorer的RSED启动任务FMID HALGxxx与主机通信。 z/OS z/OS®调试器必须让 RSED 知道它的存在，其服务才能可用。

注：

对于 z/OS 调试器 16.0 及更早版本，本文档所述的 z/OS 调试器功能由 IBM z/OS Explorer Extensions 16.0 及更早版本（FMID HHOPxxx）与 IBM Explorer for z/OS 3.3 及更早版本（FMID HALGxxx）共同提供。

rse.env，z/OS资源管理器配置文件

z/OSExplorer RSE 服务器进程（RSE 守护进程、RSE 线程池和 RSE 服务器）必须知道它们已被z/OS调试器扩展。根据 z/OS Debugger的安装位置，检测是自动的，或者通过 rse.env 中的环境变量进行。

如果z/OSDebugger安装在z/OSExplorer 的plugin/目录（默认/usr/lpp/IBM/zexpl/plugin/）中，则在下一次重新启动 RSED 已启动任务时，z/OSExplorer 会自动检测到z/OSDebugger的存在，无需进一步操作。

如果z/OS调试器安装在其他目录下（默认为/usr/lpp/IBM/debug/），则必须在rse.env中更新变量RSE_PLUGIN_PATH，以指定z/OS调试器的安装位置。

注意：z/OS 调试器将RSE相关文件存储在其安装目录下的子目录中 rse 。 /usr/lpp/IBM/debug/rse/usr/lpp/IBM/debug/如果您已将 z/OS 调试器安装在默认位置，请将 RSE_PLUGIN_PATH 变量设置为。

rse.env 位于 /etc/zexpl/，除非您在自定义并提交 z/OS Explorer 作业 FEK.SFEKSAMP(FEKSETUP) 时指定了其他位置。您可以使用 TSO/EOEDIT命令编辑该文件。文件的语法遵循标准 z/OS UNIX shell 语法规则。例如，在使用美国代码页时，注释以数字符号 (#) 开始，不支持等号 (=) 两端具有空格。

注意：要使更改生效，必须重新启动z/OSExplorer RSED 已启动任务。

#RSE_PLUGIN_PATH=

RSE_PLUGIN_PATH

引用未安装在plugin/目录中的插件产品。缺省值为空字符串。取消注释并进行更改以匹配扩展 z/OS Explorer 的产品的安装路径。多个路径之间用冒号（:）分隔。

安装在z/OSExplorerplugin/子目录中的产品会被自动检测到，无需添加到RSE_PLUGIN_PATH 中。

例如： RSE_PLUGIN_PATH=/usr/lpp/IBM/debug/rse

eqa.env，环境配置文件

z/OSExplorer RSE 服务器进程（RSE 守护进程、RSE 线程池和 RSE 服务器）使用eqa.env中的定义来了解z/OS调试器环境变量。

eqa.env 必须与 z/OS 资源管理器配置文件位于同一目录 rse.env下，才能被找到。 rse.env 位于 /etc/zexpl/，除非您在自定义并提交 z/OS Explorer 作业 FEK.SFEKSAMP(FEKSETUP) 时指定了其他位置。

将eqa.env从rse/samples/目录（默认/usr/lpp/IBM/debug/rse/samples/）复制到/etc/zexpl/，并根据需要进行自定义。您可以使用 TSO/EOEDIT命令编辑该文件。

系统为未明确指定的所有变量提供缺省值。文件的语法遵循标准 z/OS UNIX shell 语法规则。例如，在使用美国代码页时，注释以数字符号 (#) 开始，不支持等号 (=) 两端具有空格。

注意：要使更改生效，必须重新启动z/OSExplorer RSED 已启动任务。

#EQA_HLQ=${ELAXF_EQA:-EQAW}

#AZU_JES_PROCLIB=SYS1.PROCLIB

#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DBM_INTEGRATION=false"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.autoreconnect=0"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.localhost=localhost"

EQA_HLQ

用于安装z/OS调试器的高级限定符。缺省值为 EQAW。取消注释并更改，以匹配z/OS调试器数据集的位置。

请注意： If z/OS Explorer Extensions, FMID HHOPxxx, is also extending the same RSED started task as z/OS Debugger, then z/OS Debugger will use environment variable ELAXF_EQA, if defined, as default value for EQA_HLQ. z/OSExplorer Extensions 在处理ELAXFJCL INCLUDE 成员时创建此变量。

AZU_JES_PROCLIB

定义编目存储过程的存储位置，以便早期开发测试 (EDT) 在使用编目存储过程为 JCL 添加记录参数时对其进行分析。缺省值为 SYS1.PROCLIB。取消注释并指定数据集的冒号 (:) 分隔列表。

_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DBM_INTEGRATION=false"

禁用与调试管理器的集成，这是z/OS调试器的一项可选启动任务。默认值为false，这意味着 Debug Miner 将尝试至少连接一次调试管理器。取消注释并指定为 "true"，以防止任何连接到调试管理器的尝试。

_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.autoreconnect=0"

自动重新连接调试管理器，这是z/OS调试器的一项可选启动任务。缺省值为 0，这意味着当未建立或断开了与调试管理器服务器的连接时，Debug Miner 将每隔一分钟尝试重新连接至调试管理器。取消注释并指定另一个值，以限制 Debug Miner 尝试连接至调试管理器的频率。

表 1. 自动重新连接至调试管理器
debug.miner.autoreconnect	重新连接行为
-1	不重新连接
0（缺省值）	每隔一分钟尝试重新连接，直到成功
1-86400	尝试重新连接，直到达到指定的时间量为止。最大值 86400 等于 24 个小时。

_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.localhost=localhost"

localhost TCP/IP 定义的替代项。 Debug Miner 将尝试使用 localhost 规范连接到 Debug Manager——这是 z/OS Debugger 中的一个可选启动任务。如果 localhost 无法解析为本地回环地址（例如 IVPv4 对应 127.0.0.1 ， IPv6 对应 ::1），此操作将失败。如有必要，请取消注释并指定本地回环地址。