INQUIRE MQMONITOR

查询已安装的 MQ 监控器状态并返回 MQMONITOR 资源的当前属性。

语法

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

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

INQUIRE MQMONITOR

条件: NOTAUTH 和 NOTFND

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。命令语法图和选项说明中没有明确包含这些选项。有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。

此命令是线程安全的。

描述

INQUIRE MQMONITOR 命令查询已安装的 MQ 监视器的状态，并返回 MQMONITOR 资源的当前属性。

注: 在此命令完成之前， CICS® 会验证 TASKNUMBER 属性所标识的任务是否在区域中实际执行，以及该任务的 TRANID 是否与 MQMONITOR 的 TRANSACTION 值相匹配。如果任一验证失败，那么 CICS 会将 MQMONITOR 视为已停止。

在指定了 INITQNAME 属性的 CICS 区域中安装 MQCONN 资源定义时，还会安装保留名称为 DFHMQINI 的 MQMONITOR 资源。它表示缺省启动队列。

浏览

您可以在 INQUIRE MQMONITOR 命令上使用浏览选项 START ， AT ， NEXT 和 END 来浏览系统中的 MQMONITOR 定义。请参阅浏览资源定义，以获取有关浏览的常规信息，包括语法，异常条件和示例。

资源特征符

您可以使用此命令来检索资源签名字段。您可以使用这些字段来管理资源，方法是捕获资源的定义，安装和上次更改时间的详细信息。有关更多信息，请参阅标识对资源的更改 (资源特征符)。请参阅资源签名字段值摘要，以获取有关资源签名字段内容的详细信息。

选项

AUTOSTART (cvda)

返回一个 CVDA 值，该值指示在建立与 IBM® MQ 队列管理器的连接时是否自动启动 MQ 监视器。可能的值如下所示：

AUTOSTART: 建立与 IBM MQ 队列管理器的连接时，将自动启动 MQ 监视器。
自动启动: MQ 监视器不会自动启动。

CHANGEAGENT (cvda)

返回用于标识上次对资源定义进行更改的代理程序的 CVDA 值。可能的值如下所示：

自动安装: 由于在 CKQC START 命令上指定了启动队列名称，因此自动安装了资源，并且先前安装的 MQCONN 定义未指定 INITQNAME 的值。
DYNAMIC: 该资源是由于指定了 INITQNAME 的 MQCONN 资源定义而定义的。
OVERRIDE: 资源定义上次由资源覆盖文件中的覆盖规则的应用程序更改。

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 值，该值表示创建资源定义时的时间戳记。

ENABLESTATUS (cvda)

返回指示 MQMONITOR 资源状态的 CVDA 值。可能的值如下所示：

ENABLED: MQMONITOR 资源已启用以供使用。
ENABLING: MQMONITOR 资源正在启用。
DISABLED: MQMONITOR 资源已禁用。
DISABLING: MQMONITOR 资源正在禁用。
DISCARDING: 正在废弃 MQMONITOR 资源。

INSTALLAGENT (cvda)

返回用于标识安装资源的代理程序的 CVDA 值。可能的值如下所示：

自动安装: 由于在 CKQC START 命令上指定了启动队列名称，因此自动安装了资源，并且先前安装的 MQCONN 定义未指定 INITQNAME 的值。
DYNAMIC: 由于安装了指定了 INITQNAME 的 MQCONN ，因此安装了该资源。
CREATESPI: 资源是通过 EXEC CICS CREATE 命令安装的。
CSDAPI: 该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。
GRPLIST: 该资源已由 GRPLIST INSTALL安装。

INSTALLTIME (数据区)

返回表示安装资源时的时间戳记的 ABSTIME 值。

INSTALLUSRID (数据区)

返回安装资源的 8 字符用户标识。

MONDATA (data-area)

显示传递到事务监视 IBM MQ 队列的数据。

注：

当监视任务显示和检索 MONDATA 数据时，将在该数据前面附加以下 18 个字节：

字节 1：<（左尖括号）
字节 2 - 9：MQMONITOR 资源名称
字节 10 - 17：USERID
字节 18:> (右 V)

字节 19 - 218 包含用户输入的 MONDATA。

因此，用户编写的程序在检索 MONDATA 时必须支持最大长度 218 字节，并使用检索到的 MONDATA 中的字节 2 - 9 所指定的 MQMONITOR 名称来设置 MQ 监视器的 MONSTATUS 属性，从而指示其当前状态。另请注意，当安全性检查处于活动状态时， CICS 会对与尝试将 MQ 监视器状态设置为 "已启动" 的事务相关联的用户标识执行安全性检查。有关更多信息，请参阅 MQMONITOR 资源中描述的安全注意事项。

MONSTATUS (cvda)

返回用于指示 MQ 监视器状态的 CVDA 值。可能的值如下所示：

已启动: MQ 监视器已启动。
正在启动: MQ 监视器正在启动。
已停止: MQ 监视器已停止。
正在停止: MQ 监视器正在停止。

注: 在此命令完成之前， CICS 将验证 TASKNUMBER 属性所标识的任务是否在区域中实际执行，以及该任务的 TRANID 是否与 MQMONITOR 的 TRANSACTION 值匹配。如果任一验证失败，那么 CICS 会将 MQMONITOR 视为已停止。

联刚 SERID (data-area)

返回与事务监视 IBM MQ 队列相关联的用户标识。

仅当安全性检查处于活动状态 (即， SEC 系统初始化参数设置为 YES) 时，此属性才有效。 CICS 验证与尝试将 MQ 监视状态设置为 "已启动" 的事务关联的用户标识是否是 MONUSERID 中定义的用户标识的替代者，并有权启动与 MONUSERID关联的事务。在通过 CICSPlex ® SM API 接口 (例如 CICS Explorer®) 设置 MQ 监视器状态的情况下，要与 MQ 监视器事务关联的用户标识是区域用户标识或 PLTPIUSR 用户标识 (如果已指定)。

如果禁用安全性检查 (即， SEC 设置为 NO) ，那么要与 MQ 监视器事务关联的用户标识是将 MQMONITOR 资源的状态设置为已启动的事务的用户标识。

QNAME (data-area)

返回 MQ 监视器所监视的 IBM MQ 队列的名称。

TASKNUMBER (data-area)

返回当前正在监视 IBM MQ 队列的任务数。

TRANSACTION (数据区域)

返回监视 IBM MQ 队列的 CICS 事务的 4 字符标识。

USERID (data-area)

返回缺省情况下用于发出应用程序事务启动请求的 8 字符用户标识 (如果任何其他源都没有合适的用户标识)。

条件

NOTAUTH

RESP2 值：

100: 命令授权失败。

NOTFND

RESP2 值：

1: 找不到指定的 MQMONITOR 资源。