MRO CONNECTION 的属性

描述用于 MRO 连接的 CONNECTION 资源定义的语法和属性。

通过使用一个 CONNECTION 资源定义及其关联的并行会话通过使用一个 SESSIONS 资源定义来定义 MRO 链接。 以下属性很重要:

MRO CONNECTION 的语法

读取语法图跳过可视语法图CONNECTION( 名称)GROUP( groupName)DESCRIPTION( 文本)ACCESSMETHOD(IRC)CONNTYPE(SPECIFIC)CONNTYPE(GENERIC)ACCESSMETHOD(XM)PROTOCOL(blank)ATTACHSEC(LOCAL)ATTACHSEC(IDENTIFY)ATTACHSEC(MIXIDPE)ATTACHSEC(PERSISTENT)ATTACHSEC(VERIFY)AUTOCONNECT(NO)AUTOCONNECT(ALL)AUTOCONNECT(YES)DATASTREAM(USER)DATASTREAM(LMS)DATASTREAM(SCS)DATASTREAM(STRFIELD)DATASTREAM(3270)INSERVICE(YES)INSERVICE(NO)MAXQTIME(NO)MAXQTIME( 秒)NETNAME( 网络名)QUEUELIMIT(NO)QUEUELIMIT( 号)RECORDFORMAT(U)RECORDFORMAT(VB)USEDFLTUSER(NO)USEDFLTUSER(YES)XLNACTION(KEEP)XLNACTION(FORCE)

MRO CONNECTION 的属性

ACCESSMETHOD {IRC | XM } )
指定要用于此连接的访问方法。 对于 MRO 连接,请将其指定为 IRC (用于区域间通信) 或 XM (用于跨内存服务)。 IRC 用于打开和关闭链接。
IRC
本地 CICS® 区域与此 CONNECTION 资源定义所定义的区域之间的通信是通过区域间通信 (IRC) 程序 DFHIRP ,使用 SVC (而不是跨内存 (XM)) 方式 DFHIRP。 请注意,此处 IRC 的使用比其一般使用更具体。 您可以使用 IRC 进行多区域操作 (MRO),以处理处于同一系统池内 z/OS® 镜像中的区域。
XM
本地 CICS 区域与其 CONNECTION 定义的区域之间的 MRO 通信使用 MVS 跨内存服务。 初始连接通过区域间通信 (IRC) 程序 DFHIRP ,使用跨内存 (XM) (相对于 SVC) 方式 DFHIRP。 您可以使用 XM 对位于同一 z/OS 映像中的区域或位于一个 sysplex 中不同 MVS 映像中的区域进行多区域操作。
注: 由于在打开链接时使用 DFHIRP ,因此 XM 仍需要 CICS 类型 3 SVC。 有关 SVC 的更多信息,请参阅 安装 CICS SVC

MVS 只有当链路另一端的 ACCESSMETHOD 也定义为 XM 时,才能使用跨内存服务。

如果 MRO 合作伙伴位于综合系统中的不同 z/OS 映像中,并且 CONNECTION 资源定义指定 IRC 或 XM ,那么 CICS 会自动使用 XCF 作为访问方法,并忽略 IRC 或 XM 规范。

注: 不能显式定义 XCF; 如果要使用 XCF ,必须指定 IRC 或 XM。 有关 XCF 的更多信息,请参阅 跨系统多区域操作 (XCF/MRO)
ATTACHSEC { 本地 | 识别 | MIXIDPE || 持久验证 }
指定连接所需的连接时间用户安全性级别。
本地
CICS 不需要客户机提供用户标识或密码。 所有请求都以您在 SECURITYNAME 属性上指定的用户标识运行。
识别
入局连接请求必须指定用户标识。 当连接的系统具有安全管理器时,输入 IDENTIFY;例如,当连接的系统为另一个 CICS 系统时。
MIXIDPE
入局连接请求可以使用 IDENTIFY 或 PERSISTENT 安全性类型,也可以同时使用这两种类型。 所使用的安全性类型取决于入局连接请求。
持久性
入局连接请求必须在第一个连接请求上指定用户标识和用户密码。 后续连接请求仅需要用户标识。 这应仅在可编程工作站与 CICS之间使用。
验证
入局连接请求必须指定用户标识和用户密码。 当连接系统没有安全管理器并且因此无法信任时,请输入 VERIFY。 请勿为 CICS-to-CICS 通信指定 VERIFY ,因为 CICS 不会发送密码。
AUTOCONNECT { | 全部 |}
指定如何建立会话 (即,执行 BIND)。
ALL
在 CONNECTION 资源定义上, ALL 等同于 YES ,但您可以指定 ALL 以与会话资源定义一致。

请勿指定与其他 CICS 系统的 AUTOCONNECT (ALL) 连接,因为这可能会导致绑定争用。

建立连接时, CICS 不会尝试绑定会话。
YES
CICS 尝试在建立连接时仅绑定争用会话。
CONNECTION(名称)
指定此 CONNECTION 资源定义的名称。 该名称的最大长度为 4 个字符。
可接受的字符:

A-Z 0-9 $ @ #

有效字符在代码页 IBM® -037 显示时列出。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。

这是在 FILE , TERMINAL , TRANSACTION 和 PROGRAM 资源定义上指定为 REMOTESYSTEM 的名称。 您不应具有同名的 TERMINAL 资源定义和 CONNECTION 资源定义。

CONNTYPE { 具体 | 通用 }
指定连接的性质。
特定于
此连接用于从非CICS 客户机程序到 CICS 区域的通信,并且是特定连接。 特定连接是具有专门针对客户机程序中单个用户的一个或多个会话的 MRO 链接。 对于特定连接,NETNAME 是必需的。
user 是已发出 Initialize_User 请求 (或已发出 Initialize_User 请求) 的程序,每个 TCB 具有唯一名称。 例如:
  • 在 z/OS 下运行的简单客户端程序可以成为外部 CICS 界面的单个用户。
  • 在 z/OS 下运行的客户机程序可以打开多个管道,并代表不同的供应商软件包对这些管道按顺序发出外部 CICS 接口调用。 在这种情况下,从客户机程序的角度来看,每个包都是一个用户,由唯一的用户名标识。 因此,单个客户机程序可以代表多个用户运行。
  • 在 z/OS 下运行的程序可以连接多个 TCB ,在每个 TCB 下,供应商包代表其自己发出外部 CICS 接口调用。 每个包都是自己的客户机程序,并在自己的 TCB 下运行。 每个用户也是一个用户,具有唯一的用户名。
通用
该连接用于从非CICS 客户机程序到 CICS 系统的通信,并且是通用的。 通用连接是具有多个要由多个用户共享的会话的 MRO 链接。
DATASTREAM { 用户 | 3270 | LMS | SCS | STRFIELD |}
指定数据流的类型。
3270
数据流是类型为 6.1 逻辑单元 (LUTYPE6.1) 体系结构中定义的 3270 数据流。
LMS
数据流是由 FMH4s 和 FMH8s 组成的逻辑消息服务 (LMS) 数据流,如 LUTYPE6.1 体系结构中所定义。
SCS
数据流是 LUTYPE6.1 体系结构中定义的 SCS 数据流。
STRFIELD
数据流是 LUTYPE6.1 体系结构中定义的结构化字段数据流。
用户
如果数据流是用户定义的,那么让 DATASTREAM 缺省为 USER。 如果要在多个 CICS 系统之间进行通信,请始终将 DATASTREAM 缺省设置为 USER。
DESCRIPTION(文本)
您可以提供在此字段中定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 您可以使用的字符没有任何限制。 但是,如果使用括号,请确保对于每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令,那么对于文本中的每个单撇号,请对两个单撇号进行编码。
GROUP 组名
每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员,并在安装组时安装在 CICS 系统中。
可接受的字符:

A-Z 0-9 $ @ #

当代码页为 IBM-037时,有效字符将按其呈现方式列出。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

输入的任何小写字符都将转换为大写。

GROUP 名称的长度最多可以为 8 个字符。 小写字符被视为大写字符。

INSERVICE { |}
指定正在定义的连接的状态。
连接无法接收消息或传输输入。
可以启动事务,并且可以通过连接自动发送消息。
MAXQTIME({NO|})
指定等待连接上似乎无响应的可用会话的排队分配请求的等待时间控制。 仅当为 QUEUELIMIT 指定了队列限制时,才会使用最大队列时间,并且仅当队列长度达到队列限制值时才会应用时间限制。
CICS 维护正在等待空闲会话的分配请求的队列。 没有为请求可以保持排队的时间长度设置时间限制 (尽管 DTIMOUT (死锁超时) 机制可以应用于个别请求)。 在这种情况下,会在 XZIQUE 参数列表 (在 UEPEMXQT 字段中) 上传递值 X'FFFF '
对于看似无响应的连接,分配请求排队等待的大致最大时间限制。 该数字范围为 0 到 9999(单位:秒)。

CICS 使用 "最大排队时间" 属性来控制正在等待的分配请求的队列。 当排队的分配请求数达到队列限制 (QUEUELIMIT) ,并且针对连接接收到新的分配请求时,如果队列的处理速率指示新分配平均占用的时间超过最大排队时间,那么将清除队列,并发出消息 DFHZC2300 。 清除队列时,排队的分配请求返回 SYSIDERR。

在连接成功释放会话之前,不会进行进一步的排队。 此时, CICS 发出 DFHZC2301 并恢复正常排队。

您还可以通过 XZIQUE 全局用户出口程序控制分配请求的排队。 这允许您使用 CICS提供的统计信息,这些统计信息报告链接的状态。 您可以将这些统计信息与指定的队列限制和最大队列时间值结合使用,以便对队列作出更专门的决策。

如果已启用出口,那么会将 MAXQTIME 值传递到 XZIQUE 参数列表上的 XZIQUE 全局用户出口程序。 请参阅 用于管理 MRO 和 APPC 系统间队列的 XZIQUE 出口

您还可以在 ALLOCATE 命令上指定 NOQUEUE | NOSUSPEND 选项,以防止显式请求排队。 请参阅 ALLOCATE (APPC)

NETNAME网名
指定标识远程系统的网络名。 该名称的最大长度为 8 个字符。 该名称遵循汇编语言规则。 它必须以字母字符开头。
可接受的字符:

A-Z 0-9 $ @ #

当代码页为 IBM-037时,有效字符将按其呈现方式列出。 如果使用不同的 EBCDIC 代码页,请注意 变体角色 中记录的变体字符。

除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。

NETNAME 是远程系统或区域的 APPLID ,除非您定义指向 z/OS Communications Server 通用资源组的 APPC 链接。 在这种情况下, NETNAME 可以指定组的通用资源名或其中一个组成员的 APPLID (成员名)。 但是,如果指定成员名,并且此 CICS 本身不是 CICS 通用资源的成员,那么此 CICS 必须始终获取连接 (此 CICS 是安装了连接定义的 CICS 区域)。

对于 z/OS Communications Server, APPLID 是远程 VTAM ® VBUILD TYPE=APPL 语句的标签。

如果未提供 NETNAME ,那么缺省情况下将使用 CONNECTION 名称。

有一些关于重复 NETNAMEs 的规则。 您 不能 具有:
  • 具有相同 NETNAME 的两个或多个 APPC 链接
  • APPC 链接和具有相同 NETNAME 的 LUTYPE6.1 链接
  • 具有相同 NETNAME 的两个或多个 IRC 连接
  • 具有相同 NETNAME 的两个或多个远程 APPC 连接。
  • 与任何其他连接或本地终端具有相同 NETNAME 的远程 APPC 连接。
对于使用 z/OS Communications Server LU 别名工具的连接:
APPC 同步级别 1
如果 CICS 区域支持 z/OS Communications Server 动态 LU 别名 (即,在 CICS 区域的 APPL 语句上指定 LUAPFX=xx ) ,那么假定此 NETNAME 与 CICS 区域位于同一网络中。 如果不是资源,那么必须具有定义了 LUALIAS=netname 的本地 z/OS Communications Server CDRSC 定义,其中 netname 必须与此 CONNECTION 定义上定义的 NETNAME 相匹配。 同步级别 1 APPC 连接通常是工作站。

请注意,某些同步级别 1 资源可能变为同步级别 2 ,这取决于它们连接到 CICS的方式。 例如,如果 CICS TX 使用 PPC 网关,那么连接为 synclevel 1。 如果它确实使用 PPC 网关,那么它是同步级别 2。

APPC 同步级别 2 和 LUTYPE6.1
假定此 NETNAME 是唯一的。 CICS 将其与 z/OS Communications Server APPL 语句中定义的网络名相匹配。 这些连接通常是 CICS到CICS 的连接,但例如,可以是通过 PPC 网关连接的 CICS TX。
有关 NETNAME 和 APPLID 的一些规则:
  • 如果已安装的 CONNECTION 资源定义与已安装的 IPCONN 资源定义同名,那么 IPCONN 资源定义的 APPLID 必须与 CONNECTION 资源定义的 NETNAME 匹配。 如果它们不存在,那么结果的消息取决于情境:
    • DFHIS3009 (如果在 IPCONN 自动安装期间检测到错误)。
    • DFHAM4913 (如果在 IPCONN 安装期间检测到错误)。
    • DFHZC6312 (如果在 CONNECTION 安装或自动安装期间检测到错误)。
  • IPCONN 资源定义优先于 CONNECTION 定义: 即,如果 IPCONN 和 CONNECTION 同名,那么 CICS 将使用 IPCONN 连接。
  • 具有相同 NETNAME 和 APPLID 的 CONNECTION 和 IPCONN 不必具有相同的名称。

    这允许使用不同的 sysid 进行基于 TCP/IP 的通信,而不是依赖于 CICS 缺省值通过 IPCONN 路由所有受支持的功能 (如果存在)。

PROTOCOL( 空白 )
指定要用于链路的协议的类型。
空白
此处的 PROTOCOL 留空,用于 MRO。 在 SESSIONS 定义中,指定 LU61 为 PROTOCOL。
QUEUELIMIT { | 数字 }
指定 CICS 在等待空闲会话时排队的最大分配请求数:
对于 CICS 在等待空闲会话时可以排队的分配请求数没有设置限制。 在这种情况下,会在 XZIQUE 参数列表 (在 UEPQUELM 字段中) 上传递值 X'FFFF '
CICS 在等待空闲会话时可以在此连接中排队的分配请求的最大数目,范围是 0 到 9999。 当排队的分配请求数达到此限制时,后续分配请求将返回 SYSIDERR ,直到队列低于此限制为止。

此队列限制将传递到 XZIQUE 参数列表上的 XZIQUE 全局用户出口程序 (如果已启用该出口)。

您还可以通过 MAXQTIME 属性和 XZIQUE 全局用户出口程序来控制分配请求的排队。

注: 不会触发 BIND 重新协商,即使存在未使用的辅助会话也是如此。 除非使用 CEMT SET MODE 命令来强制重新协商,否则在使用所有主会话时,队列限制将立即生效。
QUEUELIMIT { | 数字 }
指定 CICS 在等待空闲会话时排队的最大分配请求数:
对于 CICS 在等待空闲会话时可以排队的分配请求数没有设置限制。 在这种情况下,会在 XZIQUE 参数列表 (在 UEPQUELM 字段中) 上传递值 X'FFFF '
CICS 在等待空闲会话时可以在此连接中排队的分配请求的最大数目,范围是 0 到 9999。 当排队的分配请求数达到此限制时,后续分配请求将返回 SYSIDERR ,直到队列低于此限制为止。

此队列限制将传递到 XZIQUE 参数列表上的 XZIQUE 全局用户出口程序 (如果已启用该出口)。

您还可以通过 MAXQTIME 属性和 XZIQUE 全局用户出口程序来控制分配请求的排队。

注: 不会触发 BIND 重新协商,即使存在未使用的辅助会话也是如此。 除非使用 CEMT SET MODE 命令来强制重新协商,否则在使用所有主会话时,队列限制将立即生效。
RECORDFORMAT { U | VB }
指定 SNA 链的类型。
U
如果 SNA 链是单个未阻塞的数据流,那么让 RECORDFORMAT 缺省为 U。 您可以在 SNA 链中具有专用块算法。 如果要在多个 CICS 系统之间进行通信,请将 RECORDFORMAT 缺省设置为 U。
VB
根据 LUTYPE6.1 体系结构中定义的 VLVB 标准对 SNA 链进行格式化。
USEDFLTUSER { |}
指定当入站 FMH5 不包含 ATTACHSEC 属性所隐含的安全性信息时执行的操作。
连接请求被拒绝,并发出协议违例消息。
YES
已接受连接,并且 缺省用户标识 与事务相关联。
XLNACTION { 保持 | 强制 }
XLNACTION 指定新名称时要执行的操作
有一些关于重复 NETNAMEs 的规则。 您 不能 具有:
  • 具有相同 NETNAME 的两个或多个 APPC 链接
  • APPC 链接和具有相同 NETNAME 的 LUTYPE6.1 链接
  • 具有相同 NETNAME 的两个或多个 IRC 连接
  • 具有相同 NETNAME 的两个或多个远程 APPC 连接。
  • 与任何其他连接或本地终端具有相同 NETNAME 的远程 APPC 连接。
对于使用 z/OS Communications Server LU 别名工具的连接:
APPC 同步级别 1
如果 CICS 区域支持 z/OS Communications Server 动态 LU 别名 (即,在 CICS 区域的 APPL 语句上指定 LUAPFX=xx ) ,那么假定此 NETNAME 与 CICS 区域位于同一网络中。 如果不是资源,那么必须具有定义了 LUALIAS=netname 的本地 z/OS Communications Server CDRSC 定义,其中 netname 必须与此 CONNECTION 定义上定义的 NETNAME 相匹配。 同步级别 1 APPC 连接通常是工作站。

请注意,某些同步级别 1 资源可能变为同步级别 2 ,这取决于它们连接到 CICS的方式。 例如,如果 CICS TX 使用 PPC 网关,那么连接为 synclevel 1。 如果它确实使用 PPC 网关,那么它是同步级别 2。

APPC 同步级别 2 和 LUTYPE6.1
假定此 NETNAME 是唯一的。 CICS 将其与 z/OS Communications Server APPL 语句中定义的网络名相匹配。 这些连接通常是 CICS到CICS 的连接,但例如,可以是通过 PPC 网关连接的 CICS TX。
有关 NETNAME 和 APPLID 的一些规则:
  • 如果已安装的 CONNECTION 资源定义与已安装的 IPCONN 资源定义同名,那么 IPCONN 资源定义的 APPLID 必须与 CONNECTION 资源定义的 NETNAME 匹配。 如果它们不存在,那么结果的消息取决于情境:
    • DFHIS3009 (如果在 IPCONN 自动安装期间检测到错误)。
    • DFHAM4913 (如果在 IPCONN 安装期间检测到错误)。
    • DFHZC6312 (如果在 CONNECTION 安装或自动安装期间检测到错误)。
  • IPCONN 资源定义优先于 CONNECTION 定义: 即,如果 IPCONN 和 CONNECTION 同名,那么 CICS 将使用 IPCONN 连接。
  • 具有相同 NETNAME 和 APPLID 的 CONNECTION 和 IPCONN 不必具有相同的名称。

    这允许使用不同的 sysid 进行基于 TCP/IP 的通信,而不是依赖于 CICS 缺省值通过 IPCONN 路由所有受支持的功能 (如果存在)。

从伙伴系统接收。 收到新的 logname 指示合作伙伴已删除其恢复信息。
FORCE
针对不确定 UOW (由事务定义的不确定属性定义) 的预定义决策将在开始使用新 Logname 的任何新工作之前实现。 CICS 还会删除为可能解决在伙伴系统上处于不确定状态的 UOW 而保留的任何信息。

注意: 如果使用此选项,那么可能会损害数据完整性。

保持
将保留恢复信息,并且不会对不确定的工作单元执行任何操作。

对于 IRC ,连接将继续执行新工作。 使用 CEMT 或 SPI 接口解析不确定的 UOW。