来自用户定义的 C 扩展中的跟踪日志

写到 C 编程语言 API 的消息处理节点和解析器可将项写到跟踪中。

跟踪有两种:
  • 服务跟踪:项通常描述代码中发生的事情,且只对诸如用户定义扩展的开发者之类的代码拥有者有用。
  • 用户跟踪:项通常描述代码外发生的事情,对代码的用户有用。代码的用户有消息流设计者和代理域的管理员。
每个跟踪类型都有三个级别:
  • 常规
  • 调试
对于用户定义的 C 扩展,下列实用程序函数可用于各种跟踪:
  • cciServiceTracecciUserTrace:只有当跟踪已激活时(也就是跟踪处于正常或调试级别时),这些函数才会将项写到相应的跟踪类型中。
  • cciServiceDebugTracecciUserDebugTrace:只有当跟踪在调试级别活动时,这些函数才会将项写到相应的跟踪类型中。
为了避免在无跟踪写入的情况下进行函数调用,您可以使用 cciIsTraceActive 实用程序函数。cciIsTraceActive 报告跟踪是否处于活动状态及其所在的活动级别。

用户定义的扩展可以不受跟踪设置的影响来使用 cci*Trace 函数。 这些函数函数判定跟踪是否处于活动状态,且只编写符合跟踪设置的项。调用 cci*Trace 函数时,可以要求进行一些额外处理。cciIsTraceActive 函数可用来让用户定义的扩展查询跟踪设置并避免在跟踪处于非活动状态的情况下进行这种额外的处理。

在很多情况下,将 cciIsTraceActive 函数返回的值作为布尔值使用即可。如果返回的是非零值,则表明跟踪在某个级别上处于活动状态,这时可以调用 cci*Trace 函数中的任意一个。 在需要了解跟踪设置的详细情况时,也可对返回值进行细致监查。

跟踪设置可随时进行更改,因此建议对它们经常进行查询。例如,当进入实施函数时,可用 cciIsTraceActive 来查询跟踪设置。

跟踪条目可与某些对象关联,这样就可以对跟踪的编写进行更好的控制。跟踪条目可与节点或解析器关联,然后跟踪将根据那对象的跟踪设置被编写。该对象的跟踪设置将从节点或解析器属于的消息流中继承。如果不指定对象,则跟踪将与执行组关联。

相关参考
cciUserDebugTrace
cciServiceTrace
cciServiceDebugTrace
ccilsTraceActive
用户跟踪
服务跟踪
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as24550_