Utilice cciUserDebugTrace para grabar un mensaje de un catálogo de mensajes (con inserciones) en un rastreo de usuario si el rastreo de usuario está activo a nivel de depuración.
Si el rastreo de usuario no está activo a nivel de depuración, se graba una entrada en el rastreo de servicio cuando éste está activo.
void cciUserDebugTrace(
int* returnCode,
CciObject* object,
const CciChar* messageSource,
int messageNumber,
const char* traceText,
...
);
Para utilizar el catálogo de mensajes del intermediario actual, especifique BIPmsgs en todos los sistemas operativos. De forma alternativa, puede crear su propio catálogo de mensajes.
Cuando se da formato a un rastreo, se escribe un mensaje de la versión NLS de este catálogo.
El entorno local utilizado es el del entorno en el que se da formato al rastreo. Puede ejecutar el intermediario en un sistema operativo, leer las anotaciones en ese sistema operativo y luego dar formato a las anotaciones en un sistema operativo distinto. Por ejemplo, si el intermediario se está ejecutando en Linux, UNIX o z/OS pero no hay ningún archivo .cat disponible, el usuario podría leer las anotaciones y luego transferirlas a Windows, donde se pueden formatear utilizando el archivo .properties.
Si este parámetro es NULL, el efecto es el mismo que especificar una serie de caracteres vacía. Es decir, se anota toda la información restante y el campo de catálogo tiene un valor de serie de caracteres vacía. Por consiguiente, el formateador de anotaciones no puede encontrar el origen de mensajes y no puede formatear esta entrada.
Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.
const CciChar* myMessageSource=CciString("SwitchMSG",BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
const char* mbElementName = mbString((CciChar*)&elementName,BIP_DEF_COMP_CCSID);
const char* mbElementValue = mbString((CciChar*)&elementValue,BIP_DEF_COMP_CCSID);
const char* traceTextFormat = "Switch Element: name=%s, value=%s";
char* traceText = (char*)malloc(strlen(traceTextFormat) +
strlen(mbElementName) +
strlen(mbElementValue));
sprintf(traceText,traceTextFormat,mbElementName,mbElementValue);
cciUserDebugTrace(&rc,
(CciObject*)thisNode,
myMessageSource,
2,
traceText,
mbElementName,
mbElementValue,
(char*)0);
free((void*)mbElementName);
free((void*)mbElementValue);
free((void*)traceText);