ENTER TRACENUM

撰写跟踪条目。

ENTER TRACENUM

条件: INVREQ 和 LENGERR

此命令是线程安全的。

描述

ENTER TRACENUM 命令在当前活动的跟踪目标中创建跟踪条目。仅当主跟踪标志和用户跟踪标志处于打开状态时， CICS® 才会写入跟踪条目，除非您指定 EXCEPTION 选项，在此情况下将始终写入用户跟踪条目，即使主跟踪标志和用户跟踪标志处于关闭状态也是如此。异常跟踪条目始终写入内部跟踪表 (即使设置了内部跟踪) ，但仅当它们处于活动状态时，才会将它们写入其他目标。

当应用程序检测到异常或异常情况时，可以在应用程序中使用异常跟踪选项来写入跟踪条目。要执行此操作，请在程序的异常或异常条件错误处理例程中包含 ENTER TRACENUM (DATA VALUE) EXCEPTION 命令。

要在应用程序放弃控制时在错误情况下写入异常跟踪条目，可以从用户编写的程序错误程序 (PEP) 发出 ENTER TRACENUM (DATA VALUE) EXCEPTION 命令。有关修改 DFHPEP 程序的编程信息，请参阅编写程序错误程序。

注: ENTER TRACENUM 将替换先前的 ENTER TRACEID 命令，该命令仍然支持与版本 3 之前的 CICS 发行版兼容。您应该对所有新程序使用 ENTER TRACENUM ，并且无论何时对旧程序应用维护。

有关跟踪条目格式的信息，请参阅使用 CICS 跟踪。

选项

EXCEPTION: 指定 CICS 将写入用户异常跟踪条目。 EXCEPTION 选项覆盖主用户跟踪标志，即使用户跟踪标志已关闭， CICS 也会写入跟踪条目。当跟踪项由跟踪实用程序格式化时，异常跟踪项由字符 *EXCU 标识。有关用户异常跟踪条目的更多信息，请参阅 CICS 异常跟踪。
FROM (数据区): 指定要将其内容输入到跟踪表项的数据字段中的数据区。如果省略了 FROM 选项，那么将传递两个二进制零的全字。
FROMLENGTH (data-area): 指定包含跟踪数据长度的半字二进制数据区，范围为 0-4000 字节。如果未指定 FROMLENGTH ，那么假定长度为 8 字节。
资源 (名称): 指定要输入到跟踪表条目的资源字段中的 8 字符名称。使用标识用户跟踪的名称，例如，调用程序的名称。
TRACENUM (data-value): 将用户跟踪表条目的跟踪标识指定为 0 到 199 范围内的半字二进制值。跟踪标识可用于过滤转储，因此您可能希望指定一个启用方便过滤的值。请参阅在问题确定中使用转储。
建议指定一个尚未使用的数字。例如，如果安装了 CICSPlex ® SM ，那么可能正在使用数字 1 到 20。如果安装了各种 CICS 样本程序，那么可能会使用以下数字: 4-8 个， 11-13 个， 15 -20 个， 27 个， 33 个， 35-37 个， 50-52 个， 77 个， 101-102 个， 190 个。另外，请检查您自己的系统是否存在已在使用的用户跟踪号。

条件

16 INVREQ

RESP2 值：

1: TRACENUM 超出范围 0 到 199。
2: 没有有效的跟踪目标。
3: 用户跟踪标志设置为 OFF ，但尚未指定 EXCEPTION。

缺省操作: 异常终止任务。

22 LENGERR

RESP2 值：

4: FROMLENGTH 超出范围 0 到 4000。

缺省操作: 异常终止任务。

示例

以下 COBOL 示例显示如何使用名为 USER-TRACE-ENTRY 的数据区中的跟踪数据编写跟踪标识为 123 的用户跟踪条目:

EXEC CICS ENTER TRACENUM(123)
     FROM(USER-TRACE-ENTRY)
END-EXEC.