cciServiceTrace

Scrive un messaggio sulla traccia del servizio, se questa è attiva. Il messaggio scritto sulla traccia del servizio ha il seguente formato:

<data/ora> <threadNumber> +cciServiceTrace <nodeName> <nodeType> <traceText>, <nodeLabel>

Sintassi

void cciServiceTrace(
  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). Questo oggetto può essere l'indirizzo di un CciNode o un 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, si verifica quanto riportato di seguito:
  • <nodeName>, <nodeType>, <nodeLabel> e <messageFlowLabel> sono omessi dalla voce di traccia.
  • La voce viene scritta in base all'impostazione di traccia del 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
as24520_