ccilsTraceActive

추적이 활성인지 여부와 추적이 활성 상태인 레벨을 보고합니다.

구문

CCI_TRACE_TYPE cciIsTraceActive(
  int*                   returnCode,
  CciObject*     object);

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력). 널(null) 포인터 입력은 사용자 정의 노드가 오류를 처리하지 않음을 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 실행 중 예외가 발생할 경우, *returnCode는 출력에 CCI_EXCEPTION으로 설정됩니다. CciGetLastExceptionData 호출은 예외에 대한 세부사항을 제공합니다.
object
추적 입력 항목과 연관될 오브젝트의 주소(입력). 오브젝트는 CciNode* 또는 CciParser*가 될 수 있습니다. CciNode*인 경우 해당 노드의 이름은 추적에 기록됩니다. CciParser*인 경우 구문 분석기를 작성한 노드의 이름은 추적에 기록됩니다. 이 오브젝트는 입력 항목이 추적에 기록되는지 여부를 판별하는 데에도 사용됩니다. 입력 항목은 해당 노드에서 추적이 활성 상태인 경우에만 기록됩니다. 현재 노드는 메시지 플로우로부터 추적 설정을 상속받습니다.
이 매개변수가 널(NULL)이면 실행 그룹의 추적 레벨이 리턴됩니다.

리턴 값

현재 활성인 추적 레벨을 표시하는 CCI_TRACE_TYPE 값. CCI_TRACE_TYPE 유형에는 다음과 같은 값이 있습니다.
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
이러한 리턴 값은 비트 단위의 값입니다. 이러한 값을 결합할 수도 있습니다. 예를 들면 다음과 같습니다.
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
CCI_TRACE_NONE은 0 값이고 다른 값은 모두 0이 아닌 값입니다.
추적의 활성 레벨을 조회할 때 두 개의 추가 값을 비트마스크로 사용할 수 있습니다. 해당 유틸리티는 다음과 같습니다.
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
예를 들어 표현식 (traceLevel & CCI_USER_TRACE)은 다음 리턴 값의 traceLevel에 대해 0이 아닌 값을 평가합니다.
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
예를 들어 표현식 (traceLevel & CCI_USER_TRACE)은 다음 리턴 값의 traceLevel에 대해 0 값을 평가합니다.
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

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

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
   checkRC(rc);
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as24540_