CREATE ATOMSERVICE
在本地 CICS® 区域中定义 ATOMSERVICE 资源定义。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: INVREQ ， LENGERR 和 NOTAUTH
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
COBOL 程序员注意: 在上述语法中，必须使用 ATTRIBUTES(data-area) 而不是 ATTRIBUTES(data-value)。
描述
CREATE ATOMSERVICE 命令构建 ATOMSERVICE 定义。 它不使用存储在 CSD 中的资源定义。 如果已存在具有您在本地 CICS 区域中指定的名称的 ATOMSERVICE 定义，那么除非禁用现有 ATOMSERVICE 定义 (在这种情况下，新定义将替换旧定义) ，否则该命令将失败。 如果不存在具有指定名称的 ATOMSERVICE 定义，那么将添加新定义。
除非在处理命令的早期检测到异常情况，否则同步点在 CREATE ATOMSERVICE 处理中是隐式的。 如果 CREATE 命令成功，那么将落实到该任务中该点的可恢复资源的未落实更改，如果未成功，那么将回滚。 有关管理 CREATE 命令的其他一般规则，请参阅 使用 EXEC CICS CREATE 命令来定义资源 。
未审计 CREATE 命令，因为其他消息会记录这些命令的操作。
选项
- ATTRIBUTES (data-value)
- 指定要添加的 ATOMSERVICE 定义的属性。 必须使用 ATOMSERVICE 定义属性中显示的语法将属性列表编码为单个字符串。 请参阅 ATTRIBUTES 选项 以获取用于指定属性的常规规则。 请参阅 ATOMSERVICE 资源 以获取有关特定属性的详细信息。
- ATTRLEN (data-value)
- 以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。 长度不得超过 32767 字节。
- LOGMESSAGE( cvda )
- 指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下：
- 日志
- 资源属性将记录到 CSDL 瞬时数据队列中。
- NOLOG
- 未记录资源属性。
- ATOMSERVICE (data-value)
- 指定要添加到 CICS 区域的 ATOMSERVICE 定义的 8 字符名称。
条件
- INVREQ
- RESP2 值：
- n
- ATTRIBUTES 字符串包含语法错误，或者在处理的废弃或资源定义阶段发生错误。 RESP2 值与写入瞬时数据队列 CSMT 的消息相关联，该消息更精确地标识错误的性质。 有关 RESP2 值的信息，请参阅 RESP2 EXEC CICS CREATE 和 EXEC CICS CSD 命令的值。
- 7
- LOGMESSAGE cvda 值无效。
- 200
- 该命令在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中运行，或者在不使用 SYNCONRETURN 选项的情况下通过分布式程序链接从远程系统调用的程序中运行。
- LENGERR
- RESP2 值：
- 1
- 在 ATTRLEN 中指定的长度为负数。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。