在 CICS 中启用对 Liberty 优化本地适配器的支持
您必须启用客户信息控制系统 (CICS®) 环境以使用 WebSphere® 优化本地适配器 (WOLA) 来接收入站请求和出站请求。
过程
- 将优化本地适配器的 CICS 资源定义添加至主要 CICS 系统定义 (CSD) 文件 DFHCSD。 您可以手动添加定义(在 CICS 中)或者下载并运行 CSUPDAT 样本。
- 在 CICS 中,使用 CEDA 事务或者等价事务将定义添加至 DFHCSD。请参阅用于 CICS 的优化本地适配器定义以了解必需的定义。
- 使用 CICS 脱机 CSD 更新程序 DFHCSDUP 将定义添加到 DFHCSD。有关 DFHCSDUP 程序的更多信息,请参阅您的 CICS 版本的文档。请参阅用于 CICS 的优化本地适配器定义以了解必需的定义。
- 通过运行 CSDUPDAT.jclsamp 样本作业来更新定义。
- 下载优化本地适配器样本。有关下载和安装样本的更多信息,请参阅Liberty 的优化本地适配器样本。
- 将样本和 CSDUPDAT 成员复制到数据集。
- 针对您所在环境定制 CSDUPDAT.jclsamp 样本作业。例如,在样本作业中,输入 CSD 所在的数据集的名称。
- 运行 CSDUPDAT.jclsamp 样本作业。
- 将 CICS 所需的装入模块和 DLL 文件从 Liberty 服务器分层文件系统 (HFS) 或者 zSeries 文件系统 (zFS)
复制到分区数据集,以供在 CICS 下使用。 以下示例说明如何将装入模块复制到 $DSNAME 数据集:
cp -Xv wlp/clients/zos/* "//'$DSNAME'"
- 将该数据集放入 CICS DFHRPL 并置。
- 在 CICS 区域设置 Liberty 消息目录。 优化本地适配器程序从 Liberty 随附的消息目录中发出消息。要让程序发出消息,CICS 区域中的 NLSPATH 环境变量必须指向包含该消息目录的目录。此目录为
wlp/lib/native/zos/s390x/nls/%N.cat,其中 wlp 是 Liberty 服务器的安装目录。
要设置该环境变量,请使用语言环境 ENVAR 选项,您可以通过编辑 CICS 区域使用的 CEEROPT CSECT 来设置该选项。在您编辑 CSECT 之后,可以构建、编译和链接 CSECT 以及将 CSECT 复制到 DFHRPL 数据集。有关设置语言环境选项的其他方式的更多信息,请参阅您的 CICS 版本的文档。
注: 设置涉及到编辑应用程序源代码或者重新链接应用程序的语言环境选项的方式不受支持,这是因为无法重新编译或者重新链接优化本地适配器程序。以下示例显示了 CEEROPT CSECT,它定义安装在 /u/MSTONE1/wlp 中的 Liberty 服务器的 NLSPATH 环境变量。请注意,定义占用两行,在第 72 列中包含一个连续字符 X。CEEROPT CSECT CEEROPT AMODE ANY CEEROPT RMODE ANY ***************************************************************** * * Utility: CEEROPT * Purpose: Set default LE runtime options for CICS region. * ***************************************************************** CEEXOPT ENVAR=(('NLSPATH=/u/MSTONE1/wlp/lib/native/zos/s390x/nlX s/%N.cat'),OVR) END
- 通过执行下列操作来保护优化本地适配器连接:
- 为 z/OS 创建服务器概要文件。
- 如果您在系统授权工具 (SAF) 中启用了 CBIND,请对将使用优化本地适配器的客户机授予访问权。
有关更多信息,请参阅保护在 Liberty for z/OS 上提供入站支持的优化本地适配器。
- 启动优化本地适配器任务相关用户出口 (TRUE) 程序。
可以使用 BBOC(这是 CICS 的优化本地适配器事务)来启动 TRUE 程序。可以使用此事务对 TRUE 模块启动、停止、启用和禁用跟踪。TRUE 程序名为 BBOATRUE,使用带有 START_TRUE 参数的 BBOC 事务来激活该程序。
在启用了 CICS 安全性的情况下,用于运行带有 START_TRUE 和 STOP_TRUE 参数的 BBOC 的用户标识必须有权发出 EXEC CICS ENABLE PROGRAM(BBOATRUE) 和 DISABLE PROGRAM(BBOATRUE) EXITALL 命令。在 CICS 下由 Liberty 服务器发出的消息将传递到在 CICS 区域中的 DD BBOOUT 下分配的 BBOQ 附加分区瞬时数据队列 (TDQ)。
有关更多信息,请参阅CICS 的 Liberty 服务器事务:BBOC、BBO$ 和 BBO#。
- 可选: 如果您想要使用 CICS 链接服务器,请通过在 CICS 工作站上发出 BBOC_START_SRVR 命令来启动优化本地适配器 CICS 链接服务器任务。 有关更多信息,请参阅CICS 的 Liberty 服务器事务:BBOC、BBO$ 和 BBO#。
下一步做什么
如果要创建连接,那么首先向 Liberty 服务器注册外部地址空间。有关更多信息,请参阅使用优化本地适配器向本地 Liberty 服务器注册外部地址空间。
子主题
- 用于 CICS 的优化本地适配器定义
您必须在 CICS 中定义 WebSphere 优化本地适配器 (WOLA) 事务、程序、任务相关的用户出口 (TRUE) 和瞬时数据队列 (TDQ) 以启用 WOLA 支持。 - CICS 的 Liberty 服务器事务:BBOC、BBO$ 和 BBO#
在 CICS 产品中,BBOC、BBO$ 和 BBO# 事务支持 WebSphere 优化本地适配器 (WOLA)。

文件名:twlp_dat_enableconnectorcics.html