WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciIsTraceActive

cciIsTraceActive 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 nodo CciNode*, el nombre de este nodo se anota en el rastreo. 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 de rastreo activo. 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 | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:29


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as24540_