必须使用优化本地适配器支持以允许应用程序服务器接收入站和出站请求。Optimized Local Adapters for z/OS®
是一组可调用服务 (API),它允许本机 z/OS 应用程序对应用程序服务器企业 Bean 进行入站调用,并允许本机程序充当服务器并接受来自在
WebSphere® Applications Server 中运行的应用程序的请求。
开始之前
使用优化本地适配器的 WebSphere Application
Server 区域必须以 64 位方式运行。创建应用程序服务器时,它自动配置为以 64 位方式运行。
过程
- 分配或选择装入模块库,用于包含优化本地适配器装入模块。 在 WebSphere Application Server 外部运行的应用程序将使用这个库。这可以是分区数据集或
PDS-E,并且大约需要 40 个磁道 (3390) 来存放优化本地适配器模块。在后续示例中,此数据集称为 WAS.OLA.LOADLIB。
- 切换至节点的 profile_root/bin 目录,并带 OLAMODS 选项运行
copyZOS.sh 脚本:
cd /wasconfig/azcell/aznodea/AppServer/profiles/default/bin
copyZOS.sh OLAMODS WAS.OLA.LOADLIB
copyZOS.sh
脚本将优化本地适配器装入模块写出至您在 OLAMODS 关键字后指定的数据集。
- 设置 WebSphere
环境变量以允许应用程序服务器使用优化本地适配器。 “优化本地适配器环境变量”主题对这些变量作了描述。
您需要为每个独立应用程序服务器或 Network Deployment 单元设置这些变量。
- 将单元范围的变量 WAS_DAEMON_ONLY_enable_adapter 设置为 True,以便允许单元守护程序处理入站和出站优化本地适配器调用。要使用优化本地适配器,必须设置此变量。
- 使用单元范围的变量 WAS_DAEMON_ONLY_adapter_max_conn、WAS_DAEMON_ONLY_adapter_max_serv 和 WAS_DAEMON_ONLY_adapter_max_shrmem 设置最大连接数、最大出站服务数,以及守护程序分配给已优化的本地适配器会话的最大共享内存量。
- 使用 ola_cicsuser_identity_propagate
变量来控制注册期间安全身份的传播。此变量必须设置为 1,以便允许运行优化本地适配器样本(您可以在单元级别或节点级别设置此变量)。
要点: 请阅读“优化本地适配器环境变量”主题中有关 ola_cicsuser_identity_propagate 变量的信息,以便了解在服务器上设置此变量对安全性的影响。
- 如果您使用 CICS Link Server,并且要使用 MappedRecord 指定多个容器,请将 LinkTaskChanID 变量设置为将存放容器的通道的名称。
- 如果您使用 CICS Link Server,并且要使用 MappedRecord 指定多个容器,请将 LinkTaskChanType 设置为将存放容器的通道的类型 (CHAR=0|BIT=1)。此变量的缺省值为 1。
您可以使用管理控制台或者通过进行脚本编制来设置这些变量。下一步骤中描述的 olaRar.py 脚本将 WAS_DAEMON_ONLY_enable_adapter 变量设置为 true,但不会更改任何其他 WebSphere Application Server 环境变量。
- 安装资源适配器归档(ola.rar 文件)并创建连接工厂。 对于使用优化本地适配器的每个应用程序服务器节点,还必须安装该资源适配器归档并创建连接工厂。copyZOS.sh
脚本会创建从每个应用程序服务器节点 install_root/installableApps 目录至此归档文件的符号链接。
可使用管理控制台或 olaRar.py
脚本来安装资源适配器并创建连接工厂:
如果要使用资源适配器高可用性功能,那么必须在每个连接工厂上配置其他连接池属性。有关如何设置并使用此功能的更多信息,请参阅“启用资源适配器高可用性支持”主题。
有关连接工厂的更多信息,请参阅“优化本地适配器的连接工厂注意事项”主题。
- 重新启动 WebSphere Application Server 守护程序以使这些更改生效。 重新启动该守护程序会使同一
z/OS 系统上的所有单元服务器停止。
守护程序启动时,确认适配器处于活动状态。守护程序日志中的一条消息将指示优化本地适配器是否已激活,如下所示:
- 已激活支持:BBOMOOO1I enable_adapter:1
- 未激活支持:BBOMOOO1I enable_adapter:0
下一步做什么
现在,可以在已启用的应用程序服务器节点上部署并启动那些使用 WebSphere Application Server
for z/OS 优化本地适配器的应用程序。
对于使用优化本地适配器的所有外部连接,请确保它们正在运行对应您的
WebSphere Application Server 级别的 OLAMODS 数据集的最新版本:
- 对该数据集带 OLAMODS 选项运行 copyZOS.sh 脚本,以确保这些模块位于最新级别。例如:
copyZOS.sh OLAMODS WAS.OLA.LOADLIB
- 请确保此数据集对使用优化本地适配器的所有外部地址空间可用。例如,请确保它在 STEPLIB(对于批处理作业)、DFHRPL 库(对于客户信息控制系统 (CICS))和 DFSESL(对于 IMS 数据定义)中可用。
可在不同集群间共享同一所生成数据集;每个集群不必有单独副本。