For z/OS platforms

使 Liberty 服务器环境能够使用优化本地适配器

必须使用优化本地适配器支持以允许 Liberty 服务器接收入站和出站请求。针对 z/OS® 的 WebSphere® 优化本地适配器 (WOLA) 是一组可调用服务 (API),它允许本机 z/OS 应用程序对应用程序服务器企业 bean 进行入站调用,支持本机程序充当服务器并接受来自在 Liberty 服务器中运行的应用程序的请求。

开始之前

Liberty 环境中安装 zosLocalAdapters-1.0 功能部件。有关更多信息,请参阅安装 Liberty 存储库 资产

过程

  1. 分配或选择装入模块库,用于包含已优化本地适配器装入模块。 此库由正在 Liberty 服务器外部运行的应用程序使用。此库必须是 PDS-E,并且大约需要 40 个磁道 (3390) 来存放已优化本地适配器模块。
  2. 将已优化本地适配器装入模块从 wlp/clients/zos/* 复制到装入模块库。 以下示例说明如何将装入模块复制到 $DSNAME 数据集:
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. 要启用 Liberty 服务器上的优化本地适配器支持,请在 server.xml 文件中配置 zosLocalAdapters-1.0 功能部件。
    1. 要启用该功能部件,请将 zosLocalAdapters-1.0 功能部件添加到 server.xml 文件,如以下示例中所示。
      <featureManager>
        <feature>zosLocalAdapters-1.0</feature>
      </featureManager>
    2. 要创建 WOLA 组,请在 server.xml 文件中使用包含三部分的 WOLA 组名配置 zosLocalAdapters 元素。 客户机使用此包含三部分的 WOLA 组名连接到 Liberty 服务器。组名的每个部分必须为 1 到 8 位字母数字字符。
      注: 不要在 WOLA 组名中使用小写字符。z/OS 安全子系统将小写字符转换为大写,这会导致与您的配置不匹配。
      <zosLocalAdapters wolaGroup="LIB1" wolaName2="LIB2" wolaName3="LIB3"/>
  4. 要配置连接工厂,请将 connectionFactory 元素添加到 server.xml 文件并在 properties.ola 元素中指定其属性。
    <connectionFactory jndiName="eis/ola">
     <properties.ola RegisterName="OLASERVER"/>
    </connectionFactory> 
    有关 WOLA 连接工厂属性的信息,请参阅Liberty 中的优化本地适配器的连接工厂属性
  5. 为 z/OS 创建服务器概要文件。
    1. 为优化本地适配器授权服务创建服务器概要文件。 使用下列“时间共享选项”(TSO) 命令:
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.LOCALCOM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.LOCALCOM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.WOLA CLASS(SERVER)ACCESS(READ) ID(wlpuser1)
    2. 为授权客户机模块 BBGZSCFM 创建 SERVER 概要文件,并允许该概要文件使用 Liberty 服务器的启动任务用户标识。此操作使 Liberty 服务器能够装入 z/OS 授权客户机服务。 要允许以 WLPUSER1 身份运行的服务器访问授权客户机模块,请输入以下命令:
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    3. 为优化本地适配器授权客户机服务创建服务器概要文件。 使用下列 TSO 命令:
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM.WOLA CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    有关更多信息,请参阅在 Liberty for z/OS 上启用 z/OS 授权服务
  6. 如果您在系统授权工具 (SAF) 中启用了 CBIND,请对将使用优化本地适配器的客户机授予访问权。
    1. 在 CBIND 类中,为 Liberty 服务器定义概要文件。 概要文件名称为 BBG.WOLA.<WOLA1>.<WOLA2>.<WOLA3>,其中 WOLA1WOLA2WOLA3 是在 server.xml 文件的 <zosLocalAdapters> 元素中指定的优化适配器组名的三个部分。可以使用 SAF RDEFINE TSO 命令来定义概要文件。 例如,以下命令将在 CBIND 类中为 WOLA 组创建一个名为 LIB1.LIB2.LIB3 的概要文件:
      RDEF CBIND BBG.WOLA.LIB1.LIB2.LIB3 UACC(NONE)
    2. 允许对该概要文件进行读访问。 例如,以下命令将允许对 bbg.wola.lib1.lib2.lib3 概要文件上的 username 用户名进行读访问:
      PERMIT BBG.WOLA.LIB1.LIB2.LIB3 CLASS(CBIND) ACCESS(READ) ID(username)
      可以使用星号以允许用户访问多个概要文件。 以下示例允许 username 用户对 CBIND 类中以 bbg.wola 开头的所有概要文件进行读访问:
      RDEF CBIND BBG.WOLA.* UACC(NONE)
      PERMIT BBG.WOLA.* CLASS(CBIND) ACCESS(READ) ID(username)
    有关 SAF 命令和语法的更多信息,请参阅您的 z/OS 版本的文档。

结果

现在,您可以部署和启动那些使用 Liberty 服务器上的优化本地适配器的应用程序。

下一步做什么

确保使用优化本地适配器的所有外部连接所运行的优化本地适配器装入模块库为最新版本。诸如 WOLA 链接服务器的客户机应该使用可能与其连接的最新 Liberty 安装中的程序库。 此外,诸如 WOLA 链接服务器的客户机与 WOLA 客户机库的先前发行版兼容,除非 IBM® 另有声明。
  1. 确保装入模块库为最新级别。
  2. 确保此库对使用已优化本地适配器的所有外部地址空间可用。例如,确保库在 STEPLIB(对于批处理作业)或 DFHRPL 并置(对于客户信息控制系统,即,CICS®)中可用。

如果要将优化本地适配器与 CICS 配合使用,那么必须在 CICS 中启用对这些适配器的支持。有关更多信息,请参阅在 CICS 中启用对 Liberty 优化本地适配器的支持

如果要将优化本地适配器与 IMS™ 配合使用,那么必须在 IMS 中启用对这些适配器的支持。有关更多信息,请参阅在 IMS 中启用对 Liberty 优化本地适配器的支持

如果要创建连接,那么首先向 Liberty 服务器注册外部地址空间。有关更多信息,请参阅使用优化本地适配器向本地 Liberty 服务器注册外部地址空间


用于指示主题类型的图标 任务主题

文件名:twlp_dat_enableconnector.html