有关监测事件功能的命令和 API

可使用 CL 命令和 API 来处理监测。

以下命令用于处理监测事件功能。

“启动监测”命令

“启动监测”(STRWCH) 命令启动监测会话并在出现指定消息、许可内码记录项或产品活动记录项时通知您。被监测消息添加至指定消息队列或记录时，或添加被监测记录项时，会调用“监测程序”(WCHPGM) 参数中指定的出口程序。监测会话可通过“结束监测”(ENDWCH) 命令或“结束监测”(QSCEWCH) API 结束。

监测消息时，应指定期望将该消息发送至的消息队列或作业记录。可通过指定要针对消息数据、被监测消息的源程序或目标程序进行比较的文本字符串来缩小搜索范围。

监测许可内码记录项时，应指定许可内码记录主代码和次代码。可通过指定要针对以下项进行比较的文本字符串来缩小搜索范围：

任务分派元素 (TDE) 的编号
任务名称
服务器类型
作业名称
作业的用户名
用于进一步限定作业名和作业的用户名的作业号
线程标识
异常标识
LIC 模块名称
LIC 模块单元名称
入口点名称
LIC 模块文本的字节位移
编译 LIC 模块时的时间戳记

监测产品活动记录项时，应指定要监测的特定系统参考码 (SRC)。可通过指定要针对以下项进行比较的文本字符串来缩小搜索范围：

在记录中具有该项的物理设备的名称
用于标识产品的编号或单词
用于标识给定类型的产品的功能部件级别的编号或字母

可指定运行监测会话的作业的优先级。缺省情况下，使用作业优先级 25。

“处理监测”命令

可使用“处理监测”(WRKWCH) 命令来启动新监测或结束活动监测。通过此命令，还可显示系统上的活动监测列表。

“结束监测”命令

“结束监测”(ENDWCH) 命令结束通过“启动监测”(STRWCH) 命令或“启动监测”(QSCSWCH) API 启动的监测会话。通过跟踪命令（例如，STRTRC、TRCINT、TRCCNN、STRCMNTRC 或 TRCTCPAPP）启动的监测会话已结束，但关联跟踪仍处于活动状态。

“启动监测”API 和“结束监测”API

“启动监测”(QSCSWCH) API 和“结束监测”(QSCEWCH) API 的使用方式与 STRWCH 命令和 ENDWCH 命令类似。“结束监测”(QSCEWCH) API 结束通过 STRWCH（启动监测）命令或“启动监测”(QSCSWCH) API 启动的监测会话。

注：通过跟踪命令（例如，STRTRC、TRCINT、TRCCNN、STRCMNTRC 或 TRCTCPAPP）启动的监测会话已结束，但关联跟踪仍处于活动状态。监测会话可通过发出启动功能的同一作业或另一作业结束。

将监测事件功能与跟踪命令配合使用

监测支持通过在符合某些预定义条件时自动监视和结束跟踪来增强跟踪功能。这可避免丢失有价值的跟踪数据并缩短监视跟踪时所花的时间。