MQMONITOR 属性
描述 MQMONITOR 资源的语法和属性。
属性
- AUTOSTART({YES|NO})
- 指定是否自动启动 MQ 监视器。
- 是
- 在以下任一情况下，将自动启动 MQ 监视器:
- 建立与 IBM® MQ 队列的连接时。
- 如果 z/OS 工作负载管理器 (WLM) 运行状况服务处于活动状态 (请参阅 WLMHEALTH) ，那么 CICS 区域的 z/OS WLM HEALTH 值中的每个增量从 0 到 100%。 有关更多信息，请参阅 z/OS 工作负载管理器运行状况服务对 MQMONITOR 的影响 和 警报监视器 (CKAM)。
- 否
- MQ 监视器不会自动启动。
- DESCRIPTION (文本)
- 在此字段中，可以提供要定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 没有限制适用于您可以使用的字符。 但是，如果使用括号，请确保每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令，那么对于文本代码中的每个单撇号，请使用两个撇号。
- 组 (groupname)
- 每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员，并在安装组时安装在 CICS 系统中。
可接受的字符：
输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #GROUP 名称的长度最多可以为 8 个字符。
- MQMONITOR(名称)
- 指定此资源定义的 8 字符名称。
可接受的字符：
除非使用 CREATE 命令，否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ # - MONDATA(文本)
- 您可以指定要传递到监视 MQ 队列的事务的数据。 例如，可以使用此字段将参数传递到 MQ 网桥监视器事务 CKBR。 该属性最多可包含 200 个混合大小写字符。注：当监视任务显示和检索 MONDATA 数据时，将在该数据前面附加以下 18 个字节：
- 字节 1：<（左尖括号）
- 字节 2 - 9：MQMONITOR 资源名称
- 字节 10 - 17：USERID
- 字节 18:> (右 V)
因此，用户编写的程序在检索 MONDATA 时必须支持最大长度 218 字节，并使用检索到的 MONDATA 中的字节 2 - 9 所指定的 MQMONITOR 名称来设置 MQ 监视器的 MONSTATUS 属性，从而指示其当前状态。 另请注意，当安全性检查处于活动状态时， CICS® 会对与尝试将 MQ 监视器状态设置为 "已启动" 的事务相关联的用户标识执行安全性检查。 有关更多信息，请参阅 MQMONITOR 资源中描述的安全注意事项。
在安装 MQMONITOR 时，用户定义的任何字符串
&applid.或&APPLID.将替换为本地区域的 APPLID。 这可以使此资源更加通用。 - MONUSERID(userid)
- 指定要与用于监视 MQ 队列的事务相关联的用户标识。 仅当安全性检查处于活动状态 (即， SEC 系统初始化参数设置为 YES) 时，此属性才有效。 如果禁用安全性检查 (即， SEC 设置为 NO) ，那么要与 MQ 监视器事务关联的用户标识是将 MQMONITOR 资源的状态设置为已启动的事务的用户标识。注: 如果安全性检查处于活动状态，那么 CICS 会验证与尝试将 MQ 监视器状态设置为 "已启动" 的事务关联的用户标识是否是 MONUSERID 中定义的用户标识的代理，并且有权启动与 MONUSERID关联的事务。 在通过 CICSPlex ® SM API 接口 (例如 CICS Explorer®) 设置 MQ 监视器状态的情况下，要与 MQ 监视器事务关联的用户标识是区域用户标识或 PLTPIUSR 用户标识 (如果已指定)。
- QNAME(名称)
- 指定要监视的 MQ 队列的名称。
指定 QNAME 属性时，可以使用符号参数 &APPLID.， 作为值中的前缀，用于标识 CICS 区域的 APPLID; 例如，
&APPLID..EXAMPLE.QUEUE.NAME。 在 CICS 区域中安装资源时， &APPLID. 替换为本地区域的 APPLID。如果省略了 QNAME，那么缺省情况下，在安装资源时，会将该值设置为
&APPLID..INITIATION.QUEUE。 - STATUS({ENABLED|DISABLED})
- 指定 MQMONITOR 资源在安装时的初始状态。
- DISABLED
- MQMONITOR 资源不可用。
- 已启用
- MQMONITOR 资源可供使用。
- TRANSACTION(名称)
- 指定监视 MQ 队列的任务所使用的 CICS 事务的 4 字符标识。
如果省略了 TRANSACTION ，那么缺省情况下该值将设置为 CKTI。
- USERID(标识)
- 指定缺省情况下要用于启动与应用程序关联的事务的用户标识 (如果任何其他源都没有合适的用户标识)。
如果省略 USERID ，那么将使用 CICS 缺省用户标识 。