[z/OS]

使用优化本地适配器向本地守护程序组或单元注册外部地址空间

要让优化本地适配器对本地守护程序组进行出站调用或对 WebSphere® Application Server 单元进行入站调用,必须将当前地址空间与该 WebSphere Application Server 守护程序组绑定并设置连接属性。

开始之前

WebSphere Application Server 守护程序组必须在发出注册请求的 z/OS® 映像上生效。如果正在使用客户信息控制系统 (CICS®),那么必须先激活“任务相关用户出口”(TRUE) 程序,才能在 CICS 与 WebSphere Application Server 之间建立连接。

如果正在使用信息管理系统 (IMS™),那么在应用程序开始调用优化本地适配器 API 之前,必须先安装并激活优化本地适配器外部子系统接口。

过程

  1. 定义要在连接中使用的参数。 如果正在使用 CICS,那么 reg_flag_trans 标志设置为 1,这表明使用此注册名称创建的连接将连接到 RRS 并参与完成 WebSphere Application Server 全局事务中完成的工作。将此标志设置为 0(零)表明,使用此注册名称创建的连接将不会连接到 RRS 且不参与完成 WebSphere Application Server 全局事务中完成的工作。

    对于入站调用,始终将安全上下文传播到 WebSphere Application Server,并且,此上下文包含进行请求的地址空间的用户标识。对于 CICS 而言,reg_flag_C2Wprop 标志将传播 CICS 任务当前正在使用的用户标识,而不是传播来自地址空间的用户标识。

    对于出站调用,reg_flag_W2Cprop 标志指示 WebSphere Application Server 将用户标识传播到 CICS。然后,CICS 将尝试使用该用户标识来启动目标程序。

    要阅读更多有关使用安全性的资料,请参阅“保护用于入站支持的优化本地适配器”和“保护用于出站支持的优化本地适配器”主题。

  2. 验证注册名称是否尚未用于此地址空间所连接的另一个单元。 将执行地址空间验证,以确保注册名称尚未被另一单元使用。如果该注册名称已被另一单元使用,那么将传回错误返回码,并且注册请求将失败。
  3. 设置客户机地址空间本机语言应用程序,以便调用 BBOA1REG API。 将传递守护程序组和服务器名称,并且将传递表示该名称的输入字符串或者 WebSphere Application Server 守护程序所使用的注册名称。

    0(零)返回码和原因码表示客户机地址空间现在已与您选择的 WebSphere Application Server 守护程序组和服务器绑定。与此 WebSphere Application Server 进行交互的将来调用必须具有提供的注册名称或者具有使用这些调用所附带的注册名称创建的特定连接句柄。

结果

完成本任务之后,传递的注册名称字符串将保留在当前地址空间中。在接收到对此标记的注销调用之前,不能使用此标记进行其他注册调用。
要点: 如果执行此调用时指定了最少量的连接设置,那么结果将是一个连接池,这个池包含预先与目标服务器建立并且正在等待请求的连接。
并且,将创建注册条目上下文或控制块并使其与注册名称字符串相关联。每个唯一的注册名称都有注册上下文。多个具有相同地址空间和线程的注册名称可以与一个或多个 WebSphere Application Server 守护程序组绑定。

下一步做什么

要了解更多有关 BBOA1REG API 的信息,请参阅“用于 z/OS 的优化本地适配器的本机 API”主题。


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



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_register
文件名:tdat_register.html