z/OS JCL 变量

您可以在 BFGCUSTM 脚本中使用替换值、JCL 变量和配置属性。

下表列出了 MFT 命令 PDSE 库数据集中 BFGCUSTM JCL 脚本的替换值。在提交 BFGCUSTM 作业之前，必须将这些替换值替换为适当的值。

表 1. 针对 BFGCUSTM JCL 脚本的替换值
替换变量	值
++library++	包含 MFT 命令 PDSE 库的数据集名称。
++bfg_java_home++	Java 安装的位置。
+ + mq_path + +	IBM® MQ for z/OS® UNIX System Services Components 目录的路径。例如，/mqm/V9R2M0。这用于提供 MFT 安装的完整路径，例如 /mqm/V9R2M0/mqft。

下表描述了 MFT 命令 PDSE 库数据集 (在 [Variables] 部分中) 中 BFGCUSTM JCL 脚本的 BFGSTDIN DD 语句的环境变量。在提交 BFGCUSTM 作业之前，必须将使用替换值（即用两个加号 ++ 括起来的值）指定的所有变量替换为适当的值。

表 2. 环境变量
环境变量	值
LIBRARY	包含 MFT 命令 PDSE 库的数据集名称。
TMPDIR	临时文件的 z/OS UNIX System Services 目录。
BFG_PROD	IBM MQ for z/OS UNIX System Services Components 目录下 mqft 目录的完整路径; 例如: /mqm/V9R2M0/mqft。
BFG_DATA	Managed File Transfer for z/OS的数据目录的位置，这是 `DATA_DIR`的路径。
BFG_JAVA_HOME	Java 安装的位置。
BFG_JVM_PROPERTIES	设置 BFG_JVM_PROPERTIES 环境变量的值。这些属性将传递至 Java 虚拟机。从 IBM MQ 9.4.5中，将值设置为 `-Dfile.encoding=IBM-1047` 或 `-Dfile.encoding=COMPAT` ，如果你正在使用 IBM Semeru Runtime 21。此值是必需的，因为 IBM Semeru Runtime 21 使用默认文件编码 UTF-8 ，但 MFT 需要文件编码 IBM-1047。在早期 IBM MQ 版本中，此环境变量是可选的。
BFG_GROUP_NAME	mqm 文件组通常与 MFT 配置数据文件和命令相关联。因此，属于 mqm 组的所有用户都可以访问 MFT 配置并对其进行更改。有关更多信息，请参阅 IBM MQ中的 MFT 的文件系统许可权。对于 z/OS 系统，文件组是 z/OS UNIX System Services (z/OS UNIX) 文件系统实体，而不必定义 mqm 文件组。您可以使用 BFG_GROUP_NAME 环境变量来关联 MFT 配置数据文件的 z/OS UNIX 文件系统组。例如，在 z/OS UNIX shell 提示符处使用: `export BFG_GROUP_NAME=FTEGB` 定义要与当前 z/OS UNIX 会话的任何后续创建的配置文件相关联的组 `FTEGB` 。您可以将 BFG_GROUP_NAME 设置为空值或将其移除。注: 首次运行 BFGCUSTM 时，如果 MFT 配置要由多个用户标识使用，请务必将 BFG_GROUP_NAME 设置为可供所有必需用户标识访问的组。如果再次运行 BFGCUSTM ，那么不得更改 BFG_GROUP_NAME (否则，还必须更改 BFG_DATA 引用的目录中所有文件和目录的 z/OS UNIX 组文件许可权以反映新的 BFG_GROUP_NAME 设置)。
BFG_WTO	将 BFG_WTO 设置为 YES、ON 或 TRUE 时，将会启用 z/OS 记录。这将控制是否把写入代理事件日志的消息写入 z/OS 操作员日志工具，这在通过 JCL 运行代理时可以更轻松地访问自动化产品。路由代码是 Programmer Information (11)，描述符代码为 Informational (12)。
SERVICE_TYPE	指定 MFT 命令库是用于代理程序还是记录器。有效值为 AGENT 或 LOGGER。
名称	针对 SERVICE_TYPE 值的代理或记录器的名称。
QMGR	与针对 SERVICE_TYPE 值的代理或记录器关联的本地队列管理器的名称。
OUTPUT_CLASS	SYSOUT 数据集的输出类。缺省值为 *，这将请求与作业语句中 MSGCLASS 参数相同的输出类。
MQ_PATH	IBM MQ for z/OS UNIX Components 目录的路径。
MQ_HLQ	IBM MQ 数据集的高级限定符。
MQ_LANG	需要的语言。
DB2_HLQ	可选。 Db2®数据集的高级限定符。
JOBCARD1	JCL 命令作业的标题行 1。
JOBCARD2	JCL 命令作业的标题行 2。
JOBCARD3	JCL 命令作业的标题行 3。
ADMIN_JOB1	admin 作业的标题行 1。
ADMIN_JOB2	admin 作业的标题行 2。
ADMIN_JOB3	admin 作业的标题行 3。
FTE_CONFIG	用于迁移的现有 MFT 配置。如果无需迁移，请将其设置为空值。
CREDENTIAL_PATH	用于迁移的凭证文件的路径，例如 /u/user1/agent3。该凭证文件仅对迁移命令 BFGAGMG 和 BFGLGMG JCL 脚本是必需的。如果无需迁移，请将其设置为空值。另请注意
DB_PROPS_PATH	为迁移指定数据库记录器属性文件。仅当属性文件不使用以下缺省名称和路径时，才需要此选项：config_directory/coordination_qmgr/databaselogger.properties。如果无需迁移，请将其设置为空值。

下表描述了 MFT 命令 PDSE 库数据集中 BFGCUSTM JCL 脚本的 BFGSTDIN DD 语句的必需 MFT 配置属性。在提交 BFGCUSTM 作业之前，必须将使用替换值（即用两个加号 ++ 括起来的值）指定的属性替换为适当的非空值。这些属性定义 MFT 配置属性的覆盖。您可以添加代理和记录器属性，为您的环境定制代理或记录器。要查看所有属性的列表，请参阅配置属性文件。

表 3. 针对 BFGSTDIN DD 语句的必需配置属性
属性	值
coordinationQMgr	代理或记录器所关联配置的协调队列管理器的名称。
coordinationQMgrHost	可选。正在运行协调队列管理器的系统的主机名。如果将该属性的值留空，那么将采用绑定方式连接。
coordinationQMgrPort	可选。协调队列管理器正在侦听的端口号。只有当同时为 coordinationQMgrHost 属性指定了非空值时，才能使用该参数。
coordinationQMgrChannel	可选。用于连接到协调队列管理器的通道。只有当同时为 coordinationQMgrHost 属性指定了非空值时，才能使用该参数。
connectionQMgr	代理或记录器所关联配置的命令队列管理器的名称。
connectionQMgrHost	可选。正在运行命令队列管理器的系统的主机名。如果将该属性的值留空，那么将采用绑定方式连接。
connectionQMgrPort	可选。命令队列管理器正在侦听的端口号。只有当同时为 connectionQMgrHost 属性指定了非空值时，才能使用该参数。
connectionQMgrChannel	可选。用于连接到命令队列管理器的通道。只有当同时为 connectionQMgrHost 属性指定了非空值时，才能使用该参数。