showDebug()

RC=showDebug(showVariable,Level)

Include file

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

Dipendenze

initDebug()

Descrizione

Questa mostra la variabile showVariable se il livello di debug e' superiore o uguale a Level.

Input

showVariable: nome della variabile, interna al programma, che si vuole visualizzare
Level: livello minimo di debug (RX_DEBUGLEVEL) dal quale la variabile e' mostrata.

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.

[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]