CREATE ENQMODEL

定义一个 ENQMODEL 资源定义。

语法

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

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

CREATE ENQMODEL

读取语法图跳过可视语法图CREATE ENQMODEL( data-value) ATTRIBUTES( data-value)ATTRLEN( data-value)LOGNOLOGLOGMESSAGE( CVDA)
CREATE ENQMODEL 属性值
读取语法图跳过可视语法图DESCRIPTION( char58)ENQNAME( char1-255)ENQSCOPE( char4)STATUS(ENABLED)STATUS(DISABLED)

条件: INVREQ , LENGERR 和 NOTAUTH

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

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

描述

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

发出 CREATE 时, ENQMODEL 将进入 "正在等待" 状态,直到本地系统中没有与 ENQNAME 模式匹配的入队为止。 然后是 ENABLED 或 DISABLED ,如 CREATE 命令中所指定。

构成嵌套通用 enqname 的 ENQMODEL 必须以禁用状态安装,或者按顺序安装,从最具体到最不具体。 如果已安装另一个具有相同或较少特定嵌套 enqname 的 ENQMODEL ,那么会将 INVREQ 返回给调用者。

例如: 如果安装了包含 AB* 的 ENQMODEL ,那么在使用 ABCD* 创建 ENQMODEL 之前,必须将其废弃或禁用。

同步点在 CREATE ENQMODEL 处理中是隐式的,但在处理命令的早期检测到异常条件时除外。 如果 CREATE 成功执行,那么将落实对该任务中的可恢复资源所作的未落实的更改,如果未成功执行,那么将回滚。 请参阅 使用 EXEC CICS CREATE 命令来定义资源 ,以了解管理 CREATE 命令的其他一般规则

选项

ATTRIBUTES (data-value)
指定要添加的 ENQMODEL 的属性。 必须使用 ENQMODEL 属性中显示的语法将属性列表编码为单个字符串。 请参阅 ATTRIBUTES 选项 以获取有关指定属性的常规规则,并参阅 ENQMODEL 资源 以获取有关特定属性的详细信息。
ATTRLEN (data-value)
以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。 长度不能超过 32767 字节。
ENQMODEL (data-value)
指定要添加到 CICS 区域的 ENQMODEL 定义的 8 字符名称。
LOGMESSAGE( cvda )
指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下:
日志
资源属性将记录到 CSDL 瞬时数据队列中。
NOLOG
未记录资源属性。

条件

INVREQ
RESP2 值:
n
ATTRIBUTES 字符串中存在语法错误,或者在处理的废弃或资源定义阶段发生错误。 有关 RESP2 值的信息,请参阅 CREATE 和 CSD 命令的 RESP2 值
7
LOGMESSAGE cvda 值无效。
200
该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的,或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。
LENGERR
RESP2 值:
1
您在 ATTRLEN 中指定的长度为负数。
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
101
与发出任务关联的用户无权创建具有此名称的 ENQMODEL 定义。