INQUIRE ENQMODEL
检索本地系统中有关入队模型定义的信息。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: END , ILLOGIC , NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)。
此命令是线程安全的。
描述
INQUIRE ENQMODEL 命令返回有关本地系统上的入队模型定义的信息。
您可以对给定的 ENQMODEL 进行显式 INQUIRE 或使用命令的浏览形式。 浏览将返回本地系统上的所有入队模型定义。
浏览
要浏览本地系统中的所有 ENQ 模型,请使用 INQUIRE ENQMODEL 命令上的浏览选项 (START , NEXT 和 END)。
请参阅 浏览资源定义 ,以获取有关浏览的常规信息,包括语法,异常条件和示例。
资源特征符
您可以使用此命令来检索资源签名字段。 您可以使用这些字段来管理资源,方法是捕获资源的定义,安装和上次更改时间的详细信息。 有关更多信息,请参阅 标识对资源的更改 (资源特征符)。 请参阅 资源签名字段值摘要 ,以获取有关资源签名字段内容的详细信息。
选项
- CHANGEAGENT (cvda)
- 返回用于标识上次对资源定义进行更改的代理程序的 CVDA 值。 可能的值如下所示:
- CREATESPI
- 上次由 EXEC CICS CREATE 命令更改资源定义。
- CSDAPI
- 上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。
- CSDBATCH
- DFHCSDUP 作业上次更改资源定义。
- DREPAPI
- 资源定义上次由 CICSPlex ® SM BAS API 命令更改。
- OVERRIDE
- 资源定义上次由资源覆盖文件中的覆盖规则的应用程序更改。
- SYSTEM
- 上次由 CICS® 或 CICSPlex 系统更改资源定义。
- CHANGEAGREL (data-area)
- 返回上次更改资源定义时运行的 CICS 版本的 4 位数字:例如, 0 760 是 CICS TS for z/OS®, Version 6. 3 的标识符。
- CHANGETIME (data-area)
- 返回表示上次更改资源定义时的时间戳记的 ABSTIME 值。 有关 ABSTIME 值的格式的更多信息,请参阅 FORMATTIME。
- CHANGEUSRID (data-area)
- 返回运行更改代理程序的 8 字符用户标识。
- DEFINESOURCE (数据区域)
- 返回资源定义的 8 字符源。 DEFINESOURCE 值取决于 CHANGEAGENT 值。 有关更多信息,请参阅 资源签名字段值的摘要。
- DEFINETIME (数据区)
- 返回 ABSTIME 值,该值表示创建资源定义时的时间戳记。
- ENQMODEL (data-value)
- 指定入队模型的 8 字符标识。
- ENQSCOPE (data-area)
- 返回限定此 CICS 区域发出的综合系统范围 ENQUEUE 请求的 4 字符名称。 四个空格表示入队是 LOCAL。
- ENQNAME (数据区)
- 返回 1 到 255 个字符的资源名称或通用名称。
将根据此资源或通用名称检查此 CICS 区域发出的 ENQ 命令。 如果找到了匹配项,并且指定了 ENQSCOPE ,那么 ENQUEUE 是SYSPLEX作用域,由 $TAG1 字符 ENQSCOPE 限定。
- INSTALLAGENT (cvda)
- 返回用于标识安装资源的代理程序的 CVDA 值。 可能的值如下所示:
- CREATESPI
- 资源是通过 EXEC CICS CREATE 命令安装的。
- CSDAPI
- 该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。
- GRPLIST
- 该资源已由 GRPLIST INSTALL安装。
- INSTALLTIME (数据区)
- 返回表示安装资源时的时间戳记的 ABSTIME 值。
- INSTALLUSRID (数据区)
- 返回安装资源的 8 字符用户标识。
- 状态 (cvda)
- 返回描述 ENQMODEL 当前状态的 CVDA 值。 CVDA 值如下:
- ENABLED
- 正在以正常方式处理匹配的入队请求。
- DISABLED
- 正在拒绝匹配的入队请求,并且正在使用代码 ANQE 异常终止发出任务。 此时正在处理匹配的 INSTALL CREATE 或 DISCARD 请求。
- 正在等待
- 正在拒绝匹配的入队请求,并且正在使用代码 ANQE 异常终止发出任务。 INSTALL CREATE 或 DISCARD 请求正在等待处理。
条件
- END
- RESP2 值:
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值:
- 1
- 当浏览此资源类型时,您已发出 START 命令,或者当浏览此资源类型时,您已发出 NEXT 或 END 命令。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
- NOTFND
- RESP2 值:
- 1
- 找不到 ENQMODEL。
