For z/OS platforms

使用优化本地适配器向本地 Liberty 服务器注册外部地址空间

要让 WebSphere 优化本地适配器 (WOLA) 对本地优化本地适配器组进行出站调用,或者对 Liberty 服务器进行入站调用,您必须将当前地址空间绑定至 Liberty 服务器,并使用“注册”API 建立连接属性。

开始之前

允许 Liberty 服务器环境使用 WOLA。有关更多信息,请参阅使 Liberty 服务器环境能够使用优化本地适配器

在发出注册请求的同一 z/OS 映像上,Liberty 服务器必须处于活动状态。

如果您正在使用客户信息控制系统 (CICS®),请在 CICS 中启用优化本地适配器支持。有关更多信息,请参阅在 CICS 中启用对 Liberty 优化本地适配器的支持。在 CICS 与 Liberty 服务器之间建立连接之前,请激活任务相关的用户出口 (TRUE) 程序。

过程

  1. 确定当您使用“注册”API BBOA1REG 注册地址空间时使用哪些参数。
    该 API 接受下列各项的参数:
    • 您在将功能部件添加至 server.xml 文件时所指定的 WOLA 组名的三个组成部分
    • 注册名称
    • 初始连接的最小数目
    • 最大连接数
    • 用于指定跟踪行为的注册标志词语

    对于 Liberty 服务器的入站调用,始终会将包含发出请求的地址空间的用户标识的安全上下文传播至 Liberty 服务器。对于 CICS,reg_flag_C2Wprop 注册标志会传播 CICS 任务的用户标识,而不是传播来自地址空间的用户标识。

    对于来自 Liberty 服务器的出站调用,reg_flag_W2Cprop 注册标志指示 Liberty 服务器将用户标识传播至 CICS。然后,CICS 将尝试使用该用户标识来启动目标程序。

    有关 API 参数的更多信息,请参阅Liberty for z/OS 上的优化本地适配器 API保护 Liberty for z/OS 上的优化本地适配器

  2. 请验证此地址空间已连接至的另一个优化本地适配器组尚未使用所选择的注册名称。 如果另一个优化本地适配器组已使用该注册名称,那么会传递回错误返回码,并且注册请求将失败。
  3. 从客户机地址空间中的本地语言应用程序使用您所选择的参数来调用调用者的“注册”API。

    返回码和原因码 0 表明客户机地址空间现在已绑定至 Liberty 服务器。

结果

所传递的注册名称字符串保留在当前地址空间中。接收到对此标记的“注销”API 调用之前,不能使用此标记进行其他注册调用。
要点: 如果您执行此调用时使用最小连接数设置,那么结果将是一个连接池,这个池包含预先与目标服务器建立并且正在等待请求的连接。
还会创建注册条目上下文或控制块,并使其与注册名称字符串相关联。每个唯一的注册名称都有注册上下文。多个具有相同地址空间和线程的注册名称可以与一个或多个 Liberty 优化本地适配器组绑定。

下一步做什么

可以使用注册在 Liberty 环境与外部地址空间之间进行入站和出站调用。有关更多信息,请参阅开发将使用 Liberty 上的优化本地适配器的应用程序

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

文件名:twlp_dat_register.html