ccilsTraceActive

Informa de si el rastreo está activo y el nivel al cual está activo.

Sintaxis

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

Parámetros

returnCode
Recibe el código de retorno de la función (salida). Una entrada de puntero NULL significa que el nodo definido por el usuario no desea tratar los errores. Las excepciones emitidas durante la ejecución de esta llamada se volverán a emitir en el nodo ascendente siguiente del flujo. Si la entrada no es NULL, la salida significará el estado de éxito de la llamada. Si se produce una excepción durante la ejecución, *returnCode se establecerá en CCI_EXCEPTION en la salida. Una llamada a CciGetLastExceptionData proporcionará los detalles de la excepción.
object
Dirección del objeto que se debe asociar a la entrada del rastreo (entrada). Este objeto puede ser un CciNode* o CciParser*. Si es un CciNode*, en el rastreo se anota el nombre de ese nodo. Si es un CciParser*, en el rastreo se anota el nombre del nodo que ha creado el analizador. Este objeto también se utiliza para determinar si la entrada debe anotarse en el rastreo. La entrada sólo se anota si el rastreo está activo para el nodo. Actualmente los nodos heredan el valor de rastreo del flujo de mensajes.
Si este parámetro es NULL, se devuelve el nivel de rastreo para el grupo de ejecución.

Valores de retorno

Un valor de CCI_TRACE_TYPE que indica el nivel de rastreo que está activo actualmente. El tipo de CCI_TRACE_TYPE tiene los siguientes valores posibles:
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
Estos valores de retorno son valores a nivel de bit. También son posibles las combinaciones de estos valores, por ejemplo:
  • 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 tiene el valor cero y todos los demás valores son distintos de cero.
Se pueden utilizar dos valores más como máscaras de bits al consultar el nivel al cual está activo el rastreo. Son:
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
Por ejemplo, la expresión (traceLevel & CCI_USER_TRACE) dará un valor distinto de cero para traceLevel, para los valores de retorno siguiente:
  • 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
La expresión (traceLevel & CCI_USER_TRACE) dará el valor cero para traceLevel, para los valores de retorno siguiente:
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

Ejemplo

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

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
checkRC(rc);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as24540_