CREATE IPCONN

在本地 CICS® 区域中定义并安装 IPCONN。

语法

警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。

CREATE IPCONN

CREATE IPCONN 属性值

条件: ILLOGIC ， INVREQ ， ENGERR 和 NOTAUTH

NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.

COBOL 程序员请注意：在上述语法中，必须使用 ATTRIBUTES（数据区）而不是 ATTRIBUTES（数据值）。

描述

CREATE IPCONN 命令安装具有命令上指定的属性的 IPCONN 定义。它不使用存储在 CSD 中的资源定义。如果已存在具有您在本地 CICS 区域中指定的名称的 IPCONN ，那么新定义将替换旧定义; 否则，将添加新定义。

注: CREATE IPCONN 创建到远程系统的 TCP/IP 通信链路。另请参阅 " 创建连接 "。与 IPCONN 一样， CONNECTION 定义到远程系统的通信链路，但在这种情况下，连接使用 APPC 或 LUTYPE6.1 通信协议 (系统间通信) ， IRC ， XM 或 XCF/MRO 访问方法 (多区域操作)。

请注意，要在安装 IPCONN 定义时实现连接:

在此 IPCONN 定义的 TCPIPSERVICE 选项上指定的 TCPIPSERVICE 定义也必须安装在此区域中，并且必须指定 PROTOCOL (IPIC)。
必须在远程区域中安装相应的 IPCONN 和 TCPIPSERVICE 定义。相应的 IPCONN 和 TCPIPSERVICE 定义的特征如下:
- 远程区域上的 IPCONN 定义的 HOST 选项必须指定此区域。
- 远程区域上 IPCONN 定义的 PORT 选项必须指定与此 IPCONN 指定的本地 TCPIPSERVICE 定义的 PORTNUMBER 选项上指定的端口号相同的端口号。
- 远程区域上的 TCPIPSERVICE 定义 (由远程区域上的 IPCONN 定义指定) 必须指定 PROTOCOL (IPIC) ，并且在其 PORTNUMBER 选项上必须指定与此 IPCONN 的 PORT 选项指定的端口号相同的端口号。

如果此 IPCONN 用于通过 IPIC 连接在 CICS 区域之间的分布式程序链接 (DPL) ，事务路由，函数输送文件控制，瞬时数据或临时存储器请求，那么其名称必须与 CICS 用于识别远程系统的 4 字符局部名 (SYSID) 匹配，并填充四个尾部空格。

注: 可以使用下列任何方法指定 DPL 请求的远程目标区域的名称 (SYSID):

已安装的 PROGRAM 定义的 REMOTESYSTEM 选项
EXEC CICS LINK PROGRAM 命令的 SYSID 选项
动态路由程序

有关 IPCONN 和 TCPIPSERVICE 定义的属性的详细信息，请参阅 IPCONN 资源和 TCPIPSERVICE 资源。有关定义 IPIC 连接的指导信息，请参阅定义 IPIC 连接。

同步点隐含在 CREATE IPCONN 处理过程中，除非在处理命令的早期检测到异常情况。如果 CREATE 成功执行，那么将落实对该任务中的可恢复资源所作的未落实的更改，如果未成功执行，那么将回滚。

请参阅使用 EXEC CICS CREATE 命令来定义资源，以了解管理 CREATE 命令的其他一般规则。

未审计 CREATE 命令，因为其他消息会记录这些命令的操作。

选项

ATTRIBUTES (data-value)

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

ATTRLEN (data-value)

以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。长度不得超过 32767 字节。

IPCONN (data-value)

指定与远程系统的连接的 8 字符名称 (即，要创建的 IPCONN 定义的名称)。

LOGMESSAGE( cvda )

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

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

条件

ILLOGIC

RESP2 值：

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

INVREQ

RESP2 值：

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

LENGERR

RESP2 值：

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

NOTAUTH

RESP2 值：

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