Esecuzione del debug di EmailPlus

Informazioni su questa attività

Attenersi alla procedura riportata di seguito per abilitare la funzionalità debug di EmailPlus.

Procedura

  1. Definire una variabile di ambiente del sistema denominata EMP_DEBUGOUT_LEVEL. Impostare il valore della variabile EMP_DEBUGOUT_LEVEL su uno dei seguenti valori:
    Opzione Descrizione
    1 Elenca tutte le chiamate della funzione EmailPlus e i parametri passati alle funzioni
    2 Elenca tutte le chiamate della funzione EmailPlus, i parametri passati alle funzioni e i valori restituiti
    3 Debug completo, che può generare un output
  2. Se si sta eseguendo il debug sui sistemi Linux o UNIX, è necessario impostare il valore della variabile EMP_DEBUGOUT_FILE sul nome di un file in cui IBM® Rational ClearQuest possa scrivere. Non includere spazi nel percorso completo del nome file di debug. Ad esempio, creare un nome file simile a questa riga: EMP_DEBUGOUT_FILE=/tmp/EmailPlusDebug.log.

Operazioni successive

Per visualizzare l'output del debug in Microsoft Windows, eseguire Debugger Windows (dbwin32.exe). L'output del debug generato da EmailPlus ha il seguente prefisso:

#EMP_DEBUGOUT# <DATE> : <FUNCTION NAME> : <DEBUG MESSAGE>

Ad esempio, quando il valore della variabile EMP_DEBUGOUT_LEVEL è 2, può essere generato il seguente output:
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: START
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: START - Cache EmailPlusConfig
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: END
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: EMP::ConfigCache::isEmailPlusActive = <YES>
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: END  - isEmailPlusActive=<1>
Per visualizzare l'output del debug sui sistemi Linux o UNIX, visualizzare il contenuto del file definito nella variabile EMP_DEBUGOUT_FILE. Quando abilita il debug EmailPlus, vengono influenzate le prestazioni di ClearQuest. Abilita il debug solo quando è necessario e, una volta completato, disabilitarlo. È necessario definire o modificare la variabile EMP_DEBUGOUT_FILE prima di avviare il client ClearQuest. Le modifiche apportate alla variabile EMP_DEBUGOUT_FILE mentre il client ClearQuest è in esecuzione non vengono riconosciute finché non viene riavviato il client ClearQuest.

Feedback