CONNECTION 属性

描述 CONNECTION 资源的语法和属性。

APPC 连接的属性

注: VTAM ® 现在是 z/OS® Communications Server。

MRO 连接的属性

LU 类型 6.1 连接的属性

间接连接的属性

ACCESSMETHOD({VTAM|间接|IRC|XM})

指定要用于此连接的访问方法。

VTAM: 本地 CICS® 区域与此连接定义所定义的系统之间的通信是通过 z/OS Communications Server进行的。可以将 z/OS Communications Server 系统间通信 (ISC) 用于不同 MVS™ 映像中的系统或同一 MVS 映像中的不同地址空间中的系统。
INDIRECT: 本地 CICS 系统与此连接定义所定义的系统之间的通信是通过 INDSYS 操作数中指定的系统进行的。
IRC: 本地 CICS 区域与此连接定义所定义的区域之间的通信是通过区域间通信 (IRC) 程序 DFHIRP 进行的，使用 SVC (而不是使用跨内存 (XM)) 方式 DFHIRP。
注: 术语 IRC 的此用法比其一般用法更具体。
对于同一 MVS 映像中的区域或综合系统中的不同 MVS 映像中的区域，可以将 IRC 用于多区域操作 (MRO)。
XM: 本地 CICS 区域与由其 CONNECTION 定义定义的区域之间的 MRO 通信使用 MVS 跨内存服务。初始连接是通过区域间通信 (IRC) 程序 DFHIRP ，使用跨内存 (XM) (相对于 SVC) 方式 DFHIRP。对于同一 MVS 映像中的区域或综合系统中的不同 MVS 映像中的区域，可以将 XM 用于多区域操作。
注: 由于在打开链接时使用 DFHIRP ，因此 XM 仍需要 CICS 类型 3 SVC。有关 SVC 的更多信息，请参阅安装 CICS SVC。

仅当链路另一端的 ACCESSMETHOD 也定义为 XM 时，才会使用 MVS 跨内存服务。

如果 MRO 伙伴驻留在综合系统中的不同 MVS 映像中，并且 CONNECTION 指定 IRC 或 XM ，那么 CICS 会自动使用 XCF 作为访问方法，并忽略 IRC 或 XM 规范。

注: 不能显式定义 XCF; 如果要使用 XCF ，必须指定 IRC 或 XM。有关 XCF 的更多信息，请参阅跨系统多区域操作 (XCF/MRO) 。

ATTACHSEC({LOCAL|IDENTIFY|VERIFY|PERSISTENT|MIXIDPE})

指定连接所需的连接时间用户安全性级别。

识别: 入局连接请求必须指定用户标识。当连接的系统具有安全管理器时，输入 IDENTIFY；例如，当连接的系统为另一个 CICS 系统时。
本地: CICS 不需要客户机提供以提供用户标识或密码。所有请求都将在 SECURITYNAME 属性中指定的用户标识下运行。如果 CONNECTION 定义中的 PROTOCOL 属性为 LU6.1，那么您必须指定 LOCAL。
MIXIDPE: 入局连接请求可以使用 IDENTIFY 或 PERSISTENT 安全性类型，也可以同时使用这两种类型。所使用的安全性类型取决于入局连接请求。
持久性: 入局连接请求必须在第一个连接请求上指定用户标识和用户密码。后续连接请求仅需要用户标识。这应仅在可编程工作站 (例如， IBM® 个人计算机) 与 CICS之间使用。
验证: 入局连接请求必须指定用户标识和用户密码。当连接系统没有安全管理器并且因此无法信任时，请输入 VERIFY。请勿为 CICS-to-CICS 通信指定 VERIFY ，因为 CICS 不会发送密码。

AUTOCONNECT({NO|YES|ALL})

对于使用 ACCESSMETHOD (VTAM) 的系统，使用 AUTOCONNECT (YES) 或 (ALL) 指定要建立的会话 (即，要执行 BIND)。此类会话是在 CICS 初始化期间设置的，或者当您使用 CEMT 或 EXEC CICS SET VTAM OPEN 命令来启动与 z/OS Communications Server的通信时设置的。如果由于远程系统不可用而无法在这些时间建立连接，那么您必须随后使用 CEMT 或 EXEC CICS SET CONNECTION (sysid) INSERVICE 既得命令来获取链接，除非远程系统在此期间变为可用并且自身启动通信。

对于指定了 SINGLESESS (NO) 的 APPC 连接， CICS 尝试在系统启动时绑定方式组 SNASVCMG 中的 LU 服务管理器会话。

对于指定了 SINGLESESS (YES) 的连接定义，将忽略 AUTOCONNECT 操作数。请改为使用会话定义的 AUTOCONNECT 操作数。

ALL: 在此定义上， ALL 等同于 YES ，但您可以指定 ALL 以与会话定义一致。
不应为与其他 CICS 系统的连接指定 AUTOCONNECT (ALL) ，因为这可能导致绑定争用。
否: 建立连接时， CICS 不会尝试绑定会话。
YES: CICS 尝试在建立连接时仅绑定争用会话。

AUTOCONNECT 选项不适用于 LU6.1 连接定义。对于 LU6.1 连接，如果希望在初始化或 CEDA 安装时建立连接，请在 SESSIONS 定义上指定 AUTOCONNECT (YES)。如果您不希望在初始化或 CEDA 安装时建立连接，请在 SESSIONS 定义上指定 AUTOCONNECT (NO)。

BINDPASSWORD

该属性已过时，但仍受支持，用于提供与 CICS 较早发行版的兼容性。有关更多信息，请参阅过时属性。

BINDSECURITY({NO|YES}) (仅限 APPC)

指定是否将 ESM 用于绑定时间安全性。

否: 不需要外部绑定时间安全性。
YES: 如果安全性处于活动状态并且 XAPPC 系统初始化参数设置为 YES ，那么 CICS 会尝试从 RACF® 中抽取会话密钥以执行绑定时安全性。如果没有可用的 RACF 概要文件，那么绑定将失败。

CONNECTION(名称)

指定此连接定义的名称。该名称的最大长度为 4 个字符。

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

这是在文件，终端，事务和程序定义上指定为 REMOTESYSTEM 的名称。您不应具有具有相同名称的终端定义和连接定义。

CONNTYPE({SPECIFIC|GENERIC})

对于外部 CICS 接口 (EXCI) 连接，这指定连接的性质。

一般: 该连接用于从非CICS 客户机程序到 CICS 系统的通信，并且是通用的。通用连接是具有将由多个 EXCI 用户共享的大量会话的 MRO 链接。对于通用连接，您无法指定 NETNAME 属性。
特定于: 此连接用于从非CICS 客户机程序到 CICS 区域的通信，并且是特定连接。特定连接是具有专门针对客户机程序中单个用户的一个或多个会话的 MRO 链接。对于特定连接，NETNAME 是必需的。

DATASTREAM({USER|3270|SCS|STRFIELD|LMS})

指定数据流的类型。

LMS: 数据流是由 FMH4s 和 FMH8s 组成的逻辑消息服务 (LMS) 数据流，如 LUTYPE6.1 体系结构中所定义。
SCS: 数据流是 LUTYPE6.1 体系结构中定义的 SCS 数据流。
STRFIELD: 数据流是 LUTYPE6.1 体系结构中定义的结构化字段数据流。
用户: 如果数据流是用户定义的，那么让 DATASTREAM 缺省为 USER。如果要在多个 CICS 系统之间进行通信，请始终将 DATASTREAM 缺省设置为 USER。
3270: 数据流是类型为 6.1 逻辑单元 (LUTYPE6.1) 体系结构中定义的 3270 数据流。

DESCRIPTION(文本)

您可以提供在此字段中定义的资源的描述。描述文本的长度最多可以为 58 个字符。您可以使用的字符没有任何限制。但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。如果使用 CREATE 命令，那么对于文本中的每个单撇号，请对两个单撇号进行编码。

GROUP(groupname)

每个资源定义都必须具有 GROUP 名称。资源定义成为组的成员，并在安装组时安装在 CICS 系统中。

可接受的字符： `A-Z 0-9 $ @ #` 输入的任何小写字符都将转换为大写。

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

INDSYS(连接)

指定另一个 CONNECTION 的名称，该名称定义用于在此系统与远程系统之间中继通信的中间系统。该名称的最大长度为 4 个字符。

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

仅当指定 ACCESSMETHOD (间接) 时，才能指定中间系统。

INSERVICE({YES|NO})

指定正在定义的连接的状态。

否: 连接既不能接收消息，也不能传输输入。
是: 可以启动事务，并且可以通过连接自动发送消息。

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 出口，以获取有关编写 XZIQUE 全局用户出口程序的编程信息。

您还可以在 ALLOCATE 命令上指定 NOQUEUE | NOSUSPEND 选项，以防止显式请求排队。请参阅 CICS 命令摘要，以获取有关这些 API 选项的编程信息。

NETNAME(netname)

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

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

NETNAME 是远程系统或区域的 APPLID ，除非您定义到 z/OS Communications Server 通用资源组的 LUTYPE6.1 或 APPC 链接。

如果要定义指向通用资源的 LUTYPE6.1 链接，那么 NETNAME 必须指定通用资源名称，而不是其中一个组成员的 APPLID。
如果要定义指向通用资源的 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 连接。

您可以具有:

具有相同 NETNAME 的 IRC 连接和 LUTYPE6.1 连接
具有相同 NETNAME 的 IRC 连接和 APPC 连接
具有相同 NETNAME 的两个或多个 LUTYPE6.1 连接
与远程终端具有相同 NETNAME 的任何连接。

对于使用 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的方式。例如，如果 TXSeries ® 不使用 PPC 网关，那么连接为同步级别 1。如果它确实使用 PPC 网关，那么它是同步级别 2。
APPC 同步级别 2 和 LUTYPE6.1: 假定此 NETNAME 是唯一的。 CICS 将其与 z/OS Communications Server APPL 语句中定义的网络名相匹配。这些连接通常是 CICS到CICS 的连接，但例如，可以通过 PPC 网关进行 TXSeries 连接。

有关 NETNAME 和 APPLID 的一些规则:

- 如果已安装的 CONNECTION 定义与已安装的 IPCONN 定义同名，那么 IPCONN 定义的 APPLID 必须与 CONNECTION 定义的 NETNAME 匹配。如果它们不存在，那么结果的消息取决于情境:
- DFHIS3009 (如果在 IPCONN 自动安装期间检测到错误)
- DFHAM4913 (如果在 IPCONN 安装期间检测到错误)
- DFHZC6312 (如果在 CONNECTION 安装或自动安装期间检测到错误)
IPCONN 定义优先于 CONNECTION 定义: 即，如果 IPCONN 和 CONNECTION 同名，那么 CICS 将使用 IPCONN 连接。
a CONNECTION 和具有相同 NETNAME 和 APPLID 的 IPCONN 不必具有相同的名称。
这允许使用不同的 sysid 进行基于 TCP/IP 的通信，而不是依赖于 CICS 缺省值通过 IPCONN 路由所有受支持的功能 (如果存在)。

PROTOCOL({APPC|LU61|EXCI|空白})

指定要用于链路的协议类型。

APPC (LUTYPE6.2 协议): 高级程序间通信或 APPC 协议。这是 ACCESSMETHOD (VTAM) 的缺省值。为 CICS-CICS ISC 指定该值。
空白: CICS 区域之间的 MRO。对于 MRO ，必须将 PROTOCOL 留空，并且在 SESSIONS 定义上，必须将 $TAG1 LU6.1 $TAG2 指定为 PROTOCOL。
EXCI: 外部 CICS 接口。指定此项以指示此连接供使用外部 CICS 接口的非CICS 客户机程序使用。
LU61: LUTYPE6.1 协议。为 CICS-CICS ISC 或 CICS-IMS ISC 指定此项，但不为 MRO 指定此项。

PSRECOVERY({SYSDEFAULT|NONE})

在使用持久会话支持运行的 CICS 区域中，这指定是否以及如何在持久会话延迟时间间隔内系统重新启动时恢复 LU6.2 会话。

NONE

所有会话都未绑定为失服务，没有 CNOS 恢复。

SYSDEFAULT

如果在持久会话延迟时间间隔内重新启动失败的 CICS 系统，那么将执行以下操作:

将用户方式组恢复为 SESSIONS RECOVOPTION 值。
恢复 SNASVCMG 方式组。
将连接恢复到 ACQUIRED 状态，并且恢复上次协商的 CNOS 状态。

QUEUELIMIT({NO|number})

指定 CICS 在等待空闲会话时排队的最大分配请求数:

否: 对于 CICS 在等待空闲会话时可以排队的分配请求数没有设置限制。在这种情况下，会在 XZIQUE 参数列表 (在 UEPQUELM 字段中) 上传递值 X'FFFF ' 。
数目: CICS 在等待空闲会话时可以在此连接中排队的分配请求的最大数目，范围是 0 到 9999。当排队的分配请求数达到此限制时，后续分配请求将返回 SYSIDERR ，直到队列低于此限制为止。
此队列限制将传递到 XZIQUE 参数列表上的 XZIQUE 全局用户出口程序 (如果已启用该出口)。

您还可以通过 MAXQTIME 属性以及通过 XZIQUE 全局用户出口程序来控制分配请求的排队。有关控制队列的更多信息，请参阅 MAXQTIME 属性。

注: 不会触发 BIND 重新协商，即使存在未使用的辅助会话也是如此。除非使用 CEMT SET MODE 命令来强制重新协商，否则只要所有主会话都在使用中， queuelimit 就会立即生效。

RECORDFORMAT({U|VB})

指定 SNA 链的类型。

U: 如果 SNA 链是单个未阻塞的数据流，那么让 RECORDFORMAT 缺省为 U。您可以在 SNA 链中具有专用块算法。如果要在多个 CICS 系统之间进行通信，请将 RECORDFORMAT 缺省设置为 U。
VB: 根据 LUTYPE6.1 体系结构中定义的 VLVB 标准对 SNA 链进行格式化。

REMOTENAME(连接)

指定用于事务路由的 APPC 连接在拥有该连接的系统或区域中的已知名称。该名称的最大长度为 4 个字符。

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

远程系统或区域可以是 APPC 设备 (请参阅事务路由的 APPC 设备)。

REMOTESYSNET(netname)

指定拥有连接的系统的网络名 (APPLID)。该名称的最大长度为 8 个字符。它遵循汇编语言规则，并且必须以字母字符开头。

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

当事务路由至远程 APPC 系统或设备时使用 REMOTESYSNET ，并且在安装了此定义的区域与拥有与远程设备的连接的系统之间没有直接链路。在下列情况下，不需要指定 REMOTESYSNET:

您正在定义本地连接 (即，未指定 REMOTESYSTEM ，或指定本地系统的 sysid)。
REMOTESYSTEM 指定与拥有该连接的系统的直接链接。但是，存在一种特殊情况: 如果拥有连接的区域是 z/OS Communications Server 类属资源组的成员，并且与该区域的直接链接是 APPC 连接，那么可能需要指定 REMOTESYSNET。在这种情况下，如果在直接链路的 CONNECTION 定义上指定的 NETNAME 是拥有连接的区域的通用资源名 (而不是 applid) ，那么需要 REMOTESYSNET。

REMOTESYSTEM(连接)

指定用于标识与拥有该连接的系统的相互通信链路的名称。该名称的最大长度为 4 个字符。

可接受的字符： `A-Z 0-9 $ @ #` 除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。

这是用于相互通信链路的连接定义上的 CONNECTION 名称。

REMOTESYSTEM 用于到远程 APPC 系统或设备的事务路由。如果未指定，或者如果将其指定为本地系统的 sysid ，那么此连接是此系统的本地连接。如果名称是另一个系统的名称，那么连接是远程的。因此，可以对本地系统和远程系统中的连接使用相同的定义。

如果此 CICS 与拥有 (连接到) 设备的区域之间存在中间系统，那么 REMOTESYSTEM 应指定设备拥有区域的路径中的第一个链接。如果有多个可能的路径，那么应指定首选路径中的第一个链接。

SECURITYNAME(用户标识)

远程系统的安全性名称，仅限 APPC 和 LU6.1 链接。

在已初始化安全性 (SEC=YES) 的 CICS 系统中，安全性名称用来确定远程系统的权限。

注: 如果在与连接定义关联的 SESSIONS 定义中指定了 USERID ，那么它将覆盖 SECURITYNAME 属性中指定的用户标识，并用于链接安全性。

安全性名称 (或会话定义上的 USERID) 必须是系统上的有效 RACF 用户标识。对系统上受保护资源的访问是基于 RACF 用户概要文件及其组成员资格的。

SINGLESESS({NO|YES})

指定定义是否用于指向 CICS的单个会话 APPC 链接上的 APPC 终端。

否: 该定义不适用于指向 CICS的单个会话 APPC 链接。
YES: 该定义适用于指向 CICS的单个会话 APPC 链接上的 APPC 终端。

SESSIONS 定义的 MODENAME 属性可用于为单会话方式集提供 modename。

APPC 单会话终端也可以定义为 TERMINAL-TYPETERM 定义。可以自动安装 TERMINAL-TYPETERM 定义和 CONNECTION 定义。如果考虑使用自动安装，请参阅自动安装 VTAM 终端。

USEDFLTUSER({NO|YES}) (仅限 APPC 和 MRO)

指定入站 FMH5 不包含 ATTACHSEC 属性所隐含的安全性信息时执行的操作。

否: 连接请求被拒绝，并发出协议违例消息。
YES: 已接受连接，并且缺省用户标识与事务相关联。

有关更多信息，请参阅实现 LU6.2 安全性和实现 MRO 安全性。

XLNACTION({KEEP|FORCE}) (仅限 APPC 和 MRO)

XLNACTION 指定从伙伴系统接收到新的 logname 时要执行的操作。收到新的 logname 指示合作伙伴已删除其恢复信息。

注: 此处的 MRO 涵盖 ACCESSMETHOD 设置为 IRC 或 XM 的连接。

FORCE

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

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

KEEP

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

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

对于 APPC，连接无法执行需要同步级别 2 协议的新工作，直到使用 CEMT 或 SPI 接口完成与合作伙伴 (即，不确定的 UOW 或与旧登录名称下的合作伙伴系统上不确定的 UOW 相关的信息) 的所有未完成的可恢复工作。