cciServiceDebugTraceW

Esta función es muy parecida a cciServiceTraceW con la única diferencia de que la entrada solamente se graba en el rastreo de servicio cuando éste está activo a nivel de depuración.

Sintaxis

void cciServiceDebugTraceW(
  int*           returnCode,
  CciObject*     object,
  const CciChar* traceText
);

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 (entrada)
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.
traceText (entrada)
Serie de caracteres que finaliza con un NULL (entrada). Esta serie de caracteres se anotará en el rastreo de servicio y proporciona una forma fácil de correlacionar entradas de rastreo con rutas a través del código fuente. Por ejemplo, podría haber varias rutas a través del código que culminaran en que se escribiera el mismo mensaje (messageSource y messageNumber) en el rastreo. Se puede utilizar traceText para distinguir entre estas distintas rutas. Es decir, la serie de caracteres traceText será una serie de caracteres literal y estática en el origen y, por tanto, la misma serie de caracteres estará tanto en el archivo del código fuente como en el archivo de rastreo formateado.

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;
CciChar* traceText = CciString(">>_Switch_evaluate()",BIP_DEF_COMP_CCSID");
cciServiceTraceW(&rc,(CciObject*)thisNode,traceText);
checkRC(rc);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as24610_