cciServiceDebugTrace

此函数与 cciServiceTrace 相差无几,唯一的区别是,只有当服务跟踪在调试级别处于活动状态时,项才会写入到服务跟踪。

语法

void cciServiceDebugTrace(
    int*                returnCode,
  CciObject*        object,
  const char*    traceText
);

参数

returnCode
接收来自函数(输出)的返回码。NULL 指针输入表示用户定义的节点不要处理错误。在执行此调用期间别的任何异常都重新抛出到流中的下一个上 行节点。如果输入不是 NULL,则输出表示调用的成功状态。如果在执行过程中出现异常,*returnCode 将在输出中被设置为 CCI_EXCEPTION。对 CciGetLastExceptionData 的调用将提供异常的详细信息。
object(输入)
要与跟踪条目关联的对象的地址(输入)。该对象可以是 CciNode* 或 a CciParser*。如果是 CciNode*,则该节点的名称会写到跟踪。如果是 CciParser*,则创建解析器的节点的名称会写到跟踪。该对象也用于确定该条目是否应该写到跟踪。仅当跟踪对该节点活动时才会写该条目。节点当前从消息流中继承它们的跟踪设置。
如果该参数为 NULL,则会返回执行组的跟踪级别。
traceText(输入)
以 NULL 结尾的字符串(输入)。该字符串将写到服务跟踪并且提供简单的方法通过源代码将跟踪项与路径关联起来。例如,可能有几个通过代码的路径,这些路径会导致产生相同的消息(messageSourcemessageNumber),这些消息会写到跟踪。traceText 可以用来区别这些不同的路径。即 traceText 字符串将为源代码中的静态文字串,因此相同的字符串将同时在源代码文件和格式化的跟踪文件中。
对于分布式平台上的用户定义的扩展,该字符串必须在 ISO-8859-1(ibm-819)代码页中,而对于 Z/OS 上的用户定义的扩展,它必须在 EBCDIC (1047) 代码页中。请参阅 NLS 一节。

返回值

无。 如果发生错误,则 returnCode 参数表明错误原因。

示例

    CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

    cciServiceTrace(&rc,(CciObject*)thisNode,">>_Switch_evaluate()");
       checkRC(rc);
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as24530_