CREATE PROFILE

描述

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

同步点在 CREATE PROFILE 处理中是隐式的，但在处理命令的早期检测到异常条件时除外。 如果 CREATE 成功执行，那么将落实对该任务中的可恢复资源所作的未落实的更改，如果未成功执行，那么将回滚。 有关管理 CREATE 命令的其他常规规则，请参阅 创建资源定义 。

选项

ATTRIBUTES (data-value)

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

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

ATTRLEN (data-value)

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

LOGMESSAGE(cvda)

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

日志

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

NOLOG

未记录资源属性。

概要文件 (data-value)

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

条件

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

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