定义和安装 MQMONITOR 资源

您可以选择安装 MQMONITOR 资源以处理 MQ 队列 (包括启动队列) 上的入局消息。 可以有多个 MQMONITOR 资源处理 MQ 队列上的入局消息。 建议使用 MQMONITOR 资源来控制 CICS®-MQ 触发器监视器 CKTI 的实例。

开始之前

仅当先前已安装 MQCONN 资源时，才能安装 MQMONITOR 资源。

关于此任务

您可以定义和安装 MQMONITOR 资源以控制 CICS-MQ 触发器监视器 CKTI。

您还可以为用户编写的触发器监视器或 MQ 消息使用者定义和安装 MQMONITOR 资源。 当要用于 MQMONITOR 资源的是用户编写的 MQ 监视程序而不是缺省的 CKTI 时，用户编写的程序负责直接从应用程序队列获取消息并执行所需的逻辑。 对程序进行编码时，请确保遵循 开发和使用用户编写的 MQ 触发器监视器和 MQ 消息使用者中描述的准则。

注: CICS提供的 MQ 触发器监视器程序 DFHMQTSK 保留用于 CICS-MQ 触发器监视器和任务发起方事务 CKTI。 尝试将 DFHMQTSK 作为用户事务调用都会导致此用户事务异常终止并显示异常终止代码 AMQO。

您可以随时安装新的 MQMONITOR ，即使 CICS-MQ 适配器已连接到 MQ也是如此。

仅当 MQMONITOR 已禁用并且没有事务正在使用时，才能重新安装 (通过替换) 现有 MQMONITOR。 使用 SET MQMONITOR DISABLED STOPPED 命令可停止关联的任务并禁用资源。

仅当 MQMONITOR 处于禁用状态并且没有关联的任务时，才能废弃该 MQMONITOR。 使用 SET MQMONITOR DISABLED STOPPED 命令可停止关联的任务并禁用资源。

安装在 INITQNAME 属性中指定值的 MQCONN 资源时， CICS 还会以保留名称 DFHMQINI (表示缺省启动队列) 动态创建并安装 MQMONITOR 资源。

有关 DFHMQINI 的详细信息，请参阅 MQMONITOR 资源。

过程

  1. 使用 定义 CICS 资源的方法中列出的其中一种方法来定义 MQMONITOR 资源。
    例如，可以使用 CREATE MQMONITOR 命令来定义 MQMONITOR 资源。

    表 1 列表显示了用于创建 MQMONITOR 资源的重要属性。

    表 1. 重要的 MQMONITOR 属性
    属性 必需/可选 缺省值 描述
    AUTOSTART 可选 YES 此属性控制 MQ 监视器的自动重新启动。
    AUTOSTART (YES)
    使 TRANSACTION 属性中指定的事务能够在与 MQ 队列管理器建立连接时自动重新启动。
    AUTOSTART (NO)
    MQ 监视器不会自动启动。 建立与 MQ 队列管理器的连接后，必须手动启动 MQ 监视器。
    MONUSERID 必需 - 指定要与用于监视 MQ 队列的事务相关联的用户标识。 仅当安全性检查处于活动状态 (即， SEC 系统初始化参数设置为 YES) 时，此属性才有效。 如果禁用安全性检查 (即， SEC 设置为 NO) ，那么要与 MQ 监视器事务关联的用户标识是将 MQMONITOR 资源的状态设置为已启动的事务的用户标识。
    QNAME 可选

    如果省略了 QNAME，那么缺省情况下，在安装资源时，会将该值设置为 &APPLID..INITIATION.QUEUE。

    		 指定要监视的 MQ 队列的名称。
    STATUS 可选 ENABLED 此属性使资源可在区域中使用。
    TRANSACTION 可选 CKTI 指定监视 MQ 队列的 CICS 事务的 4 字符标识。

    如果要定义 MQMONITOR 以监视 MQ 启动队列，请指定 CKTI 或留空。

    为了使 CICS 尝试自动启动与 MQMONITOR 关联的事务，请确保 MQMONITOR 资源具有属性 AUTOSTART (YES) 和 STATUS (ENABLED)。

  2. 安装 MQMONITOR 资源。