CREATE MQCONN

描述

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

仅当 CICS 未连接到 WebSphere® MQ时，才能安装 MQCONN 资源定义。

同步点在 CREATE MQCONN 处理中是隐式的，除非在处理命令的早期检测到异常情况。 如果 CREATE 命令成功，那么将落实到该任务中该点的可恢复资源的未落实更改，如果未成功，那么将回滚。

选项

ATTRIBUTES (data-value)

指定要添加的 MQCONN 资源定义的属性。 必须使用语法图中显示的语法将属性列表编码为单个字符串。

有关指定属性的一般规则，请参阅 ATTRIBUTES 选项 。

有关特定属性的详细信息，请参阅 MQCONN 属性 。 通过指定 ATTRLEN 值 0 ，可以为 MQCONN 定义的所有属性指定缺省值。 但是，您仍必须指定 ATTRIBUTES 选项，即使未使用其值也是如此。

ATTRLEN (data-value)

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

LOGMESSAGE(cvda)

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

日志

资源属性将记录到 CSDL 瞬时数据队列中。

NOLOG

未记录资源属性。

MQCONN (数据值)

指定要添加到 CICS 区域的 MQCONN 资源定义的 8 字符名称。

条件

INVREQ

RESP2 值：

n

ATTRIBUTES 字符串包含语法错误，或者在处理的废弃或资源定义阶段发生错误。

有关 RESP2 值的信息，请参阅 CREATE 和 CSD 命令的 RESP2 值 。

7

LOGMESSAGE CVDA 值无效。

200

该命令在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中运行，或在不使用 SYNCONRETURN 选项的情况下由分布式程序链接从远程系统调用的程序中运行。

LENGERR

RESP2 值：

1

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

NOTAUTH

RESP2 值：

100

未授权与发出任务关联的用户使用此命令。