[z/OS]

优化本地适配器的连接工厂注意事项

本主题讲述了使用优化本地适配器的连接工厂的注意事项。

连接工厂在 z/OS® 上必须配置为启用优化本地适配器以获取入站和出站支持,即使它仅直接用于出站。可以支持多个连接工厂。连接工厂可具有任何名称。

所配置的每个连接工厂可以具有不同的相关联设置。可配置的设置包括连接池大小和定制属性。

以下是可以对优化本地适配器受管连接工厂进行的设置。还可以使用优化本地适配器 setter 方法来设置这些设置中的每个设置:
  • 注册名称

    1 到 12 个字母数字字符。

    请将此值设置为目标注册名称

  • IMS™ OTMA 组标识

    1 到 8 个字母数字字符。

    请将此值设置为目标信息管理系统 (IMS) 开放式事务管理器访问 (OTMA) 名称。
    注意: 此设置必须与为有效 OTMA XCF 组名定义的条件相匹配,如 IMS 信息中心中所述。
  • IMS OTMA 服务器名称

    1 到 16 个字母数字字符。

    请将此值设置为目标 IMS OTMA 服务器名称。

    注意: 此设置必须与为有效 OTMA 服务器名称定义的条件相匹配,如 IMS 信息中心中所述。
  • IMS OTMA 同步级别

    1 个字符 - 0|1

    对于同步级别“无”,请将此值设置为 0(零);对于同步级别“确认”,请将此值设置为 1。如果您希望 IMS 在向应用程序服务器发送响应之后、但是未接收有关已接受响应的肯定确认的情况下就对已处理的事务落实工作,那么选择“无”作为同步级别。如果您希望 IMS 仅在接收到肯定确认之后才落实事务,请选择“确认”作为同步级别。如果为否定确认,那么会回滚未完成的工作。请注意,使用 OLA over OTMA 对 IMS 事务的所有调用都作为 SEND_THEN_COMMIT (CM1) 来运行。请参阅 IMS 信息中心以了解有关这些 OTMA 同步级别和 CM1 SEND_THEN_COMMIT 处理的更多信息。

  • IMS OTMA 最大段数

    整数 - 1

    请将此值设置为支持发送至 IMS 或者从 IMS 接收的最大 IMS 消息段数。

  • IMS OTMA 最大消息接收大小

    整数 - 32768

    请将此值设置为接收到的任何消息(包括所有消息段)的最大大小。

  • RemoteHostname

    String

    在非 z/OS 平台上运行时,指定指示对 OLA 代理 EJB 执行 JNDI 查询的主机名。

  • RemotePort

    Integer

    在非 z/OS 平台上运行时,指定指示对 OLA 代理 EJB 执行 JNDI 查询的远程主机的端口号。

  • RemoteJNDIName

    String

    在非 z/OS 平台上运行时,指定绑定了 OLA 代理 EJB 的远程主机的 JNDI 名称。由 RemoteHostname 和 RemotePort 属性来指定远程主机。

  • Username

    String

    指定用来向正在启用了安全性的情况下运行的注册发送请求的用户。将使用与用户名相关联的 MVS™ 用户标识。如果不存在与用户名相关联的 MVS 用户标识,那么在请求中未发送身份。如果未指定用户名,那么将使用执行调用的组件的用户标识来获取 MVS 用户标识。

  • Password

    String

    指定用户名的密码。

  • RemoteJNDIUsername

    String

    在非 z/OS 平台上运行时,指定用来获取远程系统上的 JNDI 初始上下文的用户名。JNDI 上下文用来查询 OLA 代理 EJB。

  • RemoteJNDIPassword

    String

    在非 z/OS 平台上运行时,指定用于 RemoteJNDIUsername 的密码。

  • RemoteJNDIRealm

    String

    在非 z/OS 平台上运行时,指定用于 RemoteJNDIUsername 的安全领域。

  • UseCICSContainer

    整数 - 0

    使用 CICS Link Server 时,指定请求和响应数据都将保存在容器中。

  • LinkTaskTranID

    String

    使用 CICS Link Server 时,指定链路任务事务标识。

  • LinkTaskReqContID

    String

    使用 CICS Link Server 时,指定请求或输入容器的名称。

  • LinkTaskReqContType

    整数 - 1

    使用 CICS Link Server 时,指定请求容器的类型 (CHAR=0|BIT=1)。

  • LinkTaskRspContID

    String

    使用 CICS Link Server 时,指定响应或输出容器的名称。

  • LinkTaskRspContType

    整数 - 1

    使用 CICS Link Server 时,指定响应容器的类型 (CHAR=0|BIT=1)。

  • ConnectionWaitTimeout

    整数 - 30

    指定等待为当前注册名称建立相匹配的客户机连接所需要的时间量(以秒计)。必须已注册外部地址空间。此超时适用于等待具有相匹配注册名称的可用服务变得可用的时间。

自动生成的 IMS OTMA 客户机名称为 16 个字符,无法使用优化本地适配器资源适配器来设置。有关通过 IMS OTMA 来使用优化本地适配器的更多信息,请参阅“通过 OTMA/IMS 支持来启用优化本地适配器”主题。

适配器的连接池设置将定义在 WebSphere® Application Server 连接池中定义的逻辑连接数。此数目与 WebSphere Application Server 与外部地址空间之间的物理连接数不相同。在这种情况下,逻辑连接实质上是物理连接的 Java™ EE 连接器体系结构 (JCA) 视图。WebSphere 应用程序使用逻辑连接来对外部地址空间进行出站调用。

适配器的连接池设置将定义在 WebSphere Application Server 连接池中定义的逻辑连接数。此数目与 WebSphere Application Server 与外部地址空间之间的物理连接数不相同。在这种情况下,逻辑连接实质上是物理连接的 JCA 视图。

物理和逻辑连接之间的差额取决于应该可以获取连接(逻辑)的并发 WebSphere 应用程序线程数以及在给定的时间应该可以发送到外部地址空间(物理)或从其接收的请求数。可以设置最大物理连接数以确保外部地址空间不会将过多的请求放入应用程序服务器,因为它们用于与外部地址空间的入站和出站通信。如果外部地址空间尝试向 WebSphere Application Server 注册并且指定的连接数达到支持此节点中服务器所拥有的最大物理连接数,那么注册请求将拒绝注册并带有表示失败的原因码。如果超出了守护程序组的最大连接数,那么注册也会失败。请记住,客户机请求的物理连接数与 JCA 适配器分发的逻辑连接数不同。发出外发请求后,在交互期间内,JCA 逻辑连接将与物理连接成对使用。

创建并保存连接工厂后,您可以修改在应用程序的各个模块中定义的资源引用并在合适时指定连接工厂的 Java 命名和目录接口 (JNDI) 名称。

避免故障 避免故障: 设置“最大消息接收大小”的值时,请注意不要将此值设置得太大。此大小值用来预获取用来接收 IMS 消息的内存区域。每个调用 IMS over OTMA 的线程都具有此大小的单独消息接收区域。应用程序还可以按照连接规范使用 setOTMAMaxRecvSize(nnn) 方法动态设置此值。gotcha

还可以按照连接规范使用 setOTMAMaxSegments(nnn) 方法来设置“最大段数”连接级别值。

如果要使用资源适配器高可用性功能,那么必须在每个连接工厂上配置其他连接池属性。有关如何设置并使用此功能的更多信息,请参阅“启用资源适配器高可用性支持”主题。


指示主题类型的图标 参考主题



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