Utilice cciUserTraceW para escribir un mensaje de un catálogo de mensajes (con inserciones) en el rastreo de usuario. También se escribe un mensaje en el rastreo de servicio, si éste está activo.
El mensaje que se escribe en el rastreo de usuario tiene el formato siguiente:
<indicación hora-fecha> <NúmeroHebra> RastreoUsuario <Texto de mensaje con inserciones> <Explicación del mensaje>
void cciUserTraceW(
int* returnCode,
CciObject* object,
const CciChar* messageSource,
int messageNumber,
const CciChar* 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.
El último argumento en esta lista debe ser (CciChar*)0.
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);
const CciChar* text = CciString("propagando a terminal de adición",
BIP_DEF_COMP_CCSID);
const CciChar* insert = CciString("add", BIP_DEF_COMP_CCSID);
CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;
int rc = CCI_SUCCESS;
cciUserTrace(&rc,
(CciObject*)thisNode,
myMessageSource,
1,
text,
insert,
(CciChar*)0);
checkRC(rc);