CREATE CONNECTION

在本地 CICS® 区域中定义 CONNECTION。

CREATE CONNECTION

CREATE CONNECTION 属性值

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

条件: ILLOGIC ， INVREQ ， ENGERR 和 NOTAUTH

COBOL 程序员注意事项: 在上述语法中，必须使用 ATTRIBUTES(data-area) 而不是 ATTRIBUTES(data-value)。

描述

CREATE CONNECTION 命令与 CREATE SESSIONS 命令结合使用命令中指定的属性将 CONNECTION 和 SESSIONS 定义安装到本地 CICS 区域。它们不使用存储在 CSD 中的资源定义。有关 CREATE 命令的其他一般规则，请参阅创建资源定义。

注: CREATE CONNECTION 创建与远程系统的 MRO ， APPC 或 LUTYPE6.1 通信链路。另请参阅 CREATE IPCONN。与 CONNECTION 一样， IPCONN 定义到远程系统的通信链路，但在这种情况下，连接使用 TCP/IP 协议。

要创建新的 CONNECTION ，请按以下顺序发出一系列命令:

具有 ATTRIBUTES 和 ATTRLEN 选项的 CREATE CONNECTION
CREATE SESSIONS
其他 CREATE SESSIONS。 (仅需要一组会话，但您可以定义其他组)
带有 COMPLETE 选项的 CREATE CONNECTION。

在执行所有这些步骤之前，不会添加 CONNECTION。在构建定义期间 (即，在初始 CREATE CONNECTIONs 与最终 CREATE CONNECTIONs 之间) ，您可能无法:

定义任何类型的其他资源，包括其他连接
发出 SYNCPOINT (或任何暗示一个 SYNCPOINT 的命令)
终止任务 (通常)

但是，如果在构建 CONNECTION 定义过程中迂到错误或问题，那么可以通过发出 CREATE CONNECTION DISCARD 命令在任何时候终止该进程。如果执行此操作，那么 CICS 将废弃部分 CONNECTION 定义以及为其创建的任何 SESSIONS。

否则，当发出最终 CREATE CONNECTION COMPLETE 命令时， $TAG1 CICS $TAG2 会将 CONNECTION 及其会话添加到其资源定义中，替换同名的 CONNECTION 定义 (如果存在)。

在处理连接的最终 CREATE 期间， CICS 还会执行隐式 SYNCPOINT 命令，除非它包含可在处理过程中早期检测到的错误。如果定义成功，那么同步点会将未落实的更改落实到任务中该点之前的可恢复资源，并回滚更改，就像发出了 SYNCPOINT ROLLBACK 一样，如果定义失败或在 DISCARD 中结束一样。有关管理 CREATE 命令的其他常规规则，请参阅创建资源定义。

选项

ATTRIBUTES (data-value)

指定要添加的 CONNECTION 的属性。必须使用 CONNECTION attributes中显示的语法将属性列表编码为单个字符串。请参阅 ATTRIBUTES 选项以获取有关指定属性的常规规则，并参阅 CONNECTION 定义属性以获取有关特定属性的详细信息。

注: 可以通过指定 ATTRLEN 值 0 为 CONNECTION 定义的所有属性指定缺省值。但是，您仍需要指定 ATTRIBUTES 选项，即使未使用其值也是如此。

ATTRLEN (data-value)

指定 ATTRIBUTES 选项中提供的字符串长度 (以字节为单位) 作为半字二进制值。长度可以从 0 到 32767。

完成

指定此 CONNECTION 的定义集已完成，应该将其添加到 CICS 系统。

连接 (data-value)

指定要添加的 CONNECTION 定义的 4 字符名称。

DISCARD

指定将不完成构造中的 CONNECTION 定义，并且将废弃该定义以及为其创建的任何 SESSIONS ，并且不添加该定义。

LOGMESSAGE(cvda)

指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下：

日志: 资源属性将记录到 CSDL 瞬时数据队列中。
NOLOG: 未记录资源属性。

条件

ILLOGIC

RESP2 值：

2: 无法执行该命令，因为尚未完成先前的 CONNECTION 或 TERMINAL 池定义。

INVREQ

RESP2 值：

n: ATTRIBUTES 字符串中存在语法错误，或者在处理的废弃或资源定义阶段发生错误。请参阅 EXEC CICS CREATE 和 EXEC CICS CSD 命令的 RESP2 值以获取有关 RESP2 值的信息。
7: LOGMESSAGE cvda 值无效。
200: 该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的，或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。

LENGERR

RESP2 值：

1: ATTRLEN 中指定的长度为负数。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。
102: 与发出 CREATE CONNECTION 命令的任务关联的用户不是 SECURITYNAME 中指定的用户的授权代理。