endDebug()

RC=endDebug()

Include file

libreria: <debug.cmh>
file: <debug\dbgend.cmh>

Dipendenze

getSystemTimeStamp()
getDebugValue()
getDebugLevel()
getDebugLog()

Descrizione

Questa funzione effettua il cleanup dell`ambiente di DEBUG.

Input

Nessuno

Output

La funzione ritorna il codice numerico di errore, secondo il seguente schema:

0: l`esecuzione e` terminata correttamente.
-1: l`esecuzione e` terminata in errore.

Note

Le funzioni:

• getDebugValue()
• getDebugLevel()
• getDebugLog()

sono routine di DEBUG interne e non sono normalmente esposte.

[Home] [Index] [Usage] [Environment variable] [pre-processor] [funzioni] [debug]

YARPP debug Routine

Durante la scrittura di YARPP, mi sono imbattuto (2001/01/06) in un articolo della versione italiana della famosa rivista Dr. Dobb's Journal che aveva un'esempio di implementazione di una classe DEBUG in java.

Così ho scritto alcune funzioni che possono agevolare il debugging di programmi scritti in Rexx. Le funzioni esposte sono :

• initDebug() inizializza l`ambiente di debug
• getDebug() ritorna 1|0 a seconda che il debug sia attivo o meno
• showDebug() mostra il valore della variabile che si vuole "debuggare"
• endDebug() effettua il cleanup dell`ambiente di debug inizializzato in precedenza

Queste funzioni, ioltre utilizzano le seguenti variabili di ambiente:

• RX_DEBUG Attiva o disattiva il debug. Per attivare il debug bastera' impostare tale variabile di ambiente al valore "YES" oppure "Y" oppure "1". Qualsiasi altro valore disattivera` il debug.
• RX_DEBUGLEVEL Imposta il livello di debug con valori compresi da 0 a 9. Il default e' 0.
  
• RX_DEBUGLOG Imposta l'output per il debug. Se impostato scrive l'output del debug su un file il cui nome e' contenuto nella variabile RX_DEBUGLOG, altrimenti mostra l'output su standard output.

[Home] [Index] [Usage] [Environment variable] [pre-processor] [funzioni] [debug]