SET MQMONITOR

启用或禁用 MQMONITOR 资源定义。启动或停止 MQ 监控器。设置 MQ 监控器的自动重新启动。

SET MQMONITOR

条件: IOERR ， INVREQ ， NOTAUTH ， NOTFND ， TRANSIDERR 和 USERIDERR

此命令是线程安全的。

有关使用 CVDA 的更多信息，请参阅 CICS-value 数据区 (CVDA)。

描述

使用 SET MQMONITOR 命令可启用或禁用 MQMONITOR 资源定义 (ENABLESTATUS 属性) ，启动或停止 MQ 监视器 (MONSTATUS 属性) 或设置自动重新启动 MQ 监视器 (AUTOSTART 属性)。

此命令不会设置任何其他 MQMONITOR 属性。要更改这些属性，必须更改资源定义，然后重新安装资源。

如果要更改保留的 MQMONITOR 资源定义 DFHMQINI 的 QNAME 属性，那么必须更改安装了 DFHMQINI 的 MQCONN 资源定义的 INITQNAME 属性，然后重新安装 MQCONN 资源定义。

要将 MQMONITOR 的状态设置为 "已启动" 的请求会导致 CICS® 发出 EXEC CICS START 请求，该请求将 TRANSACTION 中的值指定为 TRANID ，将 USERID 中的值指定为 USERID ，并且对于非 CKTI 事务，将 MONDATA 中包含的数据以 18 个字节作为 FROM 数据的前缀 (请参阅图 1)。如果 EXEC CICS START 命令失败，请参阅消息 DFHMQ0390E 以获取诊断详细信息。

图 1。在请求将未与 CKTI 关联的 MQMONITOR 的状态设置为 "已启动" 时，发出了 EXEC CICS START CICS 的 FROM 数据。 FROM 数据包含 MONDATA 中以 18 字节开头的数据。


Byte 1: < (left chevron)
Bytes 2 - 9: MQMONITOR resource name
Bytes 10 - 17: USERID
Byte 18: > (right chevron)
Bytes 19 - 218: MONDATA as entered by the user

对于用户编写的事务，启动的事务必须检索 FROM 数据中包含的 MONDATA ，并使用以字节 2-9 为单位指定的 MQMONITOR 资源名称来发出 EXEC CICS SET MQMONITOR 命令以设置监视事务的状态 (MONSTATUS 属性)。另请注意，当安全性检查处于活动状态时， CICS 会对与尝试将 MQ 监视器状态设置为 "已启动" 的事务相关联的用户标识执行安全性检查。因此，请确保与尝试将 MQ 监视器状态设置为 "已启动" 的事务关联的用户标识是 MONUSERID 中定义的用户标识的代理，并且有权启动与 MONUSERID关联的事务。在通过 CICSPlex ® SM API 接口 (例如 CICS Explorer®) 设置 MQ 监视器状态的情况下，要与 MQ 监视器事务关联的用户标识是区域用户标识或 PLTPIUSR 用户标识 (如果已指定)。有关更多信息，请参阅 MQMONITOR 资源中描述的安全注意事项。

选项

AUTOSTART (cvda)

指定 MQ 监视器是否自动启动。 CVDA 值如下所示：

AUTOSTART

在以下任一情况下， MQ 监视器会自动启动:

建立与 IBM® MQ 队列的连接时。
如果 z/OS® 工作负载管理器 (WLM) 运行状况服务处于活动状态 (请参阅 WLMHEALTH) ，那么 CICS 区域的 z/OS WLM HEALTH 值中的每个增量从 0 到 100%。有关更多信息，请参阅 z/OS 工作负载管理器运行状况服务对 MQMONITOR 的影响和警报监视器 (CKAM)。

NOAUTOSTART

MQ 监视器不会自动启动。

ENABLESTATUS (cvda)

指定 MQMONITOR 资源定义是否可供使用。 CVDA 值如下所示：

ENABLED: 将启用 MQMONITOR 资源定义并使其可供使用。
DISABLED: 将禁用 MQMONITOR 资源定义。

MONSTATUS (cvda)

启动或停止 MQ 监视器。 CVDA 值如下所示：

已启动: 将启动 MQ 监视器。
已停止: 将停止 MQ 监视器。

MQMONITOR (data-value)

指定要设置的 MQMONITOR 资源的 8 字符名称。

条件

IOERR

RESP2 值：

10: 发生输入/输出错误。此错误通常发生在 EXEC CICS START 命令上，因为文件 DFHINTRA 已满或损坏。

缺省操作: 异常结束任务。

INVREQ

RESP2 值：

2: 无法启动 MQMONITOR ，因为资源已启动。
3: 无法停止 MQMONITOR ，因为资源已停止。
5: 无法启动 MQMONITOR ，因为资源已禁用。
6: 尝试启动 MQ 监视器失败。验证 TRANID 和 USERID 属性以及安全性定义。验证是否已升级组 DFHMQ 的 IBM提供的 CSD 定义。

缺省操作: 异常结束任务。

NOTAUTH

RESP2 值：

7: 用户无权启动与 MQMONITOR 关联的事务。
100: 命令授权失败。

缺省操作: 异常结束任务。

NOTFND

RESP2 值：

1: 找不到指定的 MQMONITOR 定义。

缺省操作: 异常结束任务。

TRANSIDERR

当尝试启动 MQMONITOR 失败时发生，因为未向 CICS定义 START 命令中指定的事务标识。

缺省操作: 异常结束任务。

USERIDERR

当尝试启动 MQMONITOR 失败时发生，因为外部安全管理器不知道联刚 SERID。

缺省操作: 异常结束任务。