cciLog

Registra un errore, un'avvertenza o un evento informativo. L'evento viene registrato dall'interfaccia del broker dei messaggi utilizzando gli argomenti specificati come dati di registrazione.

Sintassi

void cciLog(
  int*      returnCode,
  CCI_LOG_TYPE  type,
  char*         file,
  int           line,
  char*         function,
  CciChar*      messageSource,
  int           messageNumber,
  char*         traceText,
                ...);

Parametri

returnCode
Il codice di ritorno dalla funzione (output). I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_INV_DATA_POINTER
  • CCI_INV_LOG_TYPE
type
Il tipo di evento, come definito da CCI_LOG_TYPE (input). Valori validi sono:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
Il nome del file di origine dove è stata richiamata la funzione (input). Il valore è facoltativo, ma è utile ai fini dell'esecuzione del debug.
line
Il numero di riga del file di origine dove è stata richiamata la funzione (input). Il valore è facoltativo, ma è utile ai fini dell'esecuzione del debug.
function
Il nome della funzione che ha richiamato la funzione di registrazione (input). Il valore è facoltativo, ma è utile ai fini dell'esecuzione del debug.
messageSource
Una stringa che identifica l'origine di messaggi Windows o il catalogo di messaggi Linux e UNIX.
messageNumber
Il numero di messaggio che identifica l'evento (input). Se messageNumber è specificato come zero, è assunto che non è disponibile alcun messaggio. Se messageNumber è diverso da zero, il messaggio specificato è scritto nella registrazione eventi del broker con commenti forniti nell'elenco di argomenti della variabile (fare riferimento a quanto riportato di seguito).
traceText
Informazioni di traccia scritte nella registrazione di traccia del servizio del broker (input). Le informazioni sono facoltative, ma sono utili ai fini dell'esecuzione del debug.
...
Un elenco di argomenti di variabili in C contenente commenti di accompagnamento al messaggio (input). Tali commenti sono gestiti come stringhe di caratteri e gli argomenti di variabili si assume siano di tipo pointer to char.
Nota: I caratteri char* devono essere stringhe in ASCII (Latin) o EBCDIC (1047).
Nota: l'ultimo argomento di questo elenco deve essere (char*)0.

Valori di restituzione

Nessuno. Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08552_