cciServiceDebugTrace

Questa funzione è molto simile a cciServiceTrace con l'unica differenza che la voce viene scritta nella traccia del servizio solo quando questa è attiva a livello di debug.

Sintassi

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

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output). Un input del puntatore NULL indica che il nodo definito dall'utente non intende gestire gli errori. Eventuali eccezioni generate durante l'esecuzione di questa chiamata, verranno generate nuovamente nel nodo successivo a monte del flusso. Se l'input è diverso da NULL, l'output indicherà lo stato positivo della chiamata. Se durante l'esecuzione si verifica un'eccezione, *returnCode verrà impostato su CCI_EXCEPTION nell'output. Una chiamata a CciGetLastExceptionData fornirà informazioni dettagliate sull'eccezione.
object (input)
L'indirizzo dell'oggetto che deve essere associato alla voce di traccia (input). Tale oggetto può essere CciNode* o CciParser*. Se è CciNode*, il nome di tale nodo viene scritto nella traccia. Se è CciParser*, nella traccia viene scritto il nome del nodo che ha creato il programma di analisi. Questo oggetto viene utilizzato inoltre per determinare se la voce deve essere scritta nella traccia. La voce viene scritta solo se la traccia è attiva per il nodo. Attualmente i nodi ereditano le relative impostazioni di traccia dal flusso di messaggi.
Se questo parametro è NULL, viene restituito il livello di traccia per il gruppo di esecuzione.
traceText (input)
Una stringa di caratteri che termina con NULL (input). Tale stringa verrà scritta nella traccia del servizio e fornisce un metodo semplice per correlare le voci di traccia con i percorsi mediante il codice di origine. Ad esempio, potrebbero esserci diversi percorsi nel codice che risultano nello stesso messaggio (messageSource e messageNumber) scritto nella traccia. E' possibile utilizzare traceText per distinguere questi diversi percorsi. Ovvero, la stringa traceText sarà una stringa letterale statica nell'origine e quindi la stessa stringa sarà sia nel file del codice di origine che nel file di traccia formattato.
Questa stringa deve essere nella codepage ISO-8859-1 (ibm-819) per le estensioni definite dall'utente in esecuzione sulle piattaforme distribuite e deve essere in EBCDIC (1047) per le estensioni definite dall'utente in esecuzione su Z/OS; fare riferimento alla sezione relativa a NLS.

Valori di restituzione

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

Esempio

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

    cciServiceTrace(&rc,(CciObject*)thisNode,">>_Switch_evaluate()");
    checkRC(rc);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as24530_