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

cciServiceTrace

Escribe un mensaje en un rastreo de servicio, si éste está activo.

El mensaje que se escribe en el rastreo de servicio tiene el formato siguiente:
<indicación fecha-hora> <NúmeroHebra> RastreoServicio+cci <Nombrenodo> <Tiponodo> <Textorastreo>, <Etiquetanodo>

Sintaxis

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

Parámetros

returnCode
Recibe el código de retorno de la función (salida). Un parámetro de entrada de puntero NULL significa que el nodo definido por el usuario no maneja errores. Las excepciones emitidas durante la ejecución de esta llamada se vuelven a emitir en el nodo ascendente siguiente del flujo. Si el parámetro de entrada no es NULL, la salida indica el estado de éxito de la llamada. Si se produce una excepción durante la ejecución, *returnCode se establece en CCI_EXCEPTION en la salida. Utilice CciGetLastExceptionData para obtener información detallada de la excepción.
object (entrada)
Dirección del objeto que se debe asociar a la entrada del rastreo (entrada). Este objeto puede ser la dirección de un CciNode o un CciParser. Si especifica un CciNode, el nombre de este nodo se anota en el rastreo. Si especifica 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 se anota 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 emprenden las acciones siguientes:
  • Los elementos <Nombrenodo>, <Tiponodo>, <Etiquetanodo> y <Etiquetaflujomensajes> se omiten de la entrada de rastreo.
  • La entrada se anota basándose en el valor de rastreo del grupo de ejecución.
traceText (entrada)
Serie de caracteres que finaliza con un NULL (entrada). Esta serie de caracteres se anota en el rastreo de servicio y puede utilizarlo para correlacionar entradas de rastreo con rutas a través del código fuente. Por ejemplo, puede que haya diversas vías de acceso a través del código que culminen en el mismo mensaje (messageSource y messageNumber) que se registra en el rastreo. Se puede utilizar traceText para distinguir entre estas distintas rutas. Es decir, la serie de caracteres traceText es una serie de caracteres literal y estática en el origen y, por tanto, la misma serie de caracteres está tanto en el archivo del código fuente como en el archivo de rastreo formateado.
Esta serie de caracteres debe estar en la página de códigos ISO-8859-1 (ibm-819) para las extensiones definidas por el usuario que se ejecutan en plataformas distribuidas y debe estar en formato EBCDIC (1047) para las extensiones definidas por el usuario que se ejecutan en z/OS.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

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

    cciServiceTrace(&rc,(CciObject*)thisNode,">>_Switch_evaluate()");
    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 | as24520_