cciServiceDebugTrace

이 함수는 서비스 추적이 디버그 레벨에서 활성일 때만 입력 항목이 서비스 추적에 기록된다는 점만 제외하고 cciServiceTrace와 매우 유사합니다.

구문

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

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력). 널(null) 포인터 입력은 사용자 정의 노드가 오류를 처리하지 않음을 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 실행 중에 예외가 발생하면 *returnCode가 출력 시 CCI_EXCEPTION으로 설정됩니다. CciGetLastExceptionData 호출은 예외에 대한 세부사항을 제공합니다.
object(입력)
추적 입력 항목과 연관될 오브젝트의 주소(입력). 오브젝트는 CciNode* 또는 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/21
as24530_