ECI V2 和 ESI V2 应用程序中的跟踪

应用程序应实施一个用于启用跟踪的选项。 您可以使用此处描述的函数和环境变量来控制 ECI V2 和 ESI V2 应用程序中的跟踪。

您可以通过使用函数调用或通过设置环境变量来设置跟踪级别、文件、数据长度和偏移量。 下面显示了所有这些项的示例。 为避免需要重新编译应用程序，请通过设置环境变量来启用跟踪。

跟踪级别

您可以设置 5 种跟踪级别：
CTG_TRACE_LEVEL0
禁用所有跟踪。 这是缺省设置。
CTG_TRACE_LEVEL1
启用异常跟踪点。 可以永久设置该跟踪级别以提供错误日志功能。 仅写入系统错误、套接字错误和其他 Gateway 连接错误所对应的消息。
CTG_TRACE_LEVEL2
启用事件跟踪点以及较低跟踪级别中的跟踪点。
CTG_TRACE_LEVEL3
启用函数入口和出口跟踪点以及较低跟踪级别中的跟踪点。
CTG_TRACE_LEVEL4
启用调试跟踪点以及较低跟踪级别中的跟踪点。
下面是跟踪级别函数调用的示例：
CTG_setAPITraceLevel(CTG_TRACE_LEVEL1);
下面是跟踪级别环境变量的示例：
CTG_CLIENT_TRACE_LEVEL=1

跟踪文件

缺省跟踪目标是标准错误流。
下面是跟踪文件函数调用的示例：
CTG_setAPITraceFile("filename.trc");
下面是跟踪文件环境变量的示例：
 CTG_CLIENT_TRACE_FILE=filename.trc
如果未设置跟踪文件，那么跟踪将写入到标准错误流 (stderr)。

跟踪数据长度

跟踪数据长度指定与 CICS® Transaction Gateway 通信时写入跟踪的最大数据量，并且跟踪级别设置为 CTG_TRACE_LEVEL4。 缺省设置是 128 字节。
下面是跟踪数据长度函数调用的示例：
CTG_setAPITraceDataLength(256);
下面是跟踪数据长度环境变量的示例：
CTG_CLIENT_DATA_LENGTH=256

跟踪数据偏移量

跟踪数据偏移量指定跟踪开始位置在数据中的偏移量。 与跟踪数据长度结合使用可允许跟踪特定数据段，例如 COMMAREA 中的一段数据。 缺省设置是零。
下面是跟踪数据偏移量函数调用的示例：
CTG_setAPITraceDataOffset(40);
下面是跟踪数据偏移量环境变量的示例：
CTG_CLIENT_DATA_OFFSET=40