getDebugValue()

RC=getDebugValue()

Include file

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

Dipendenze

getEnvironmentName()
getInterpreterName()

Descrizione

Questa funzione imposta l'ambiente di debug in base al valore della variabile di ambiente RX_DEBUG.

Input

Nessuno

Output

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

1: se RX_DEBUG = "YES" | "Y" | "1"
0: per ogni altro valore di RX_DEBUG.

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

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]

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]

getDebug()

RC=getDebug()

Include file

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

Dipendenze

getDebugValue()

Descrizione

Questa funzione verifica se l'ambiente di debug e' attivo o meno.

Input

Nessuno

Output

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

0: il debug non e` attivo.
1: il debug e` attivo.

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

initDebug()

RC=initDebug()

Include file

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

Dipendenze

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

Descrizione

Questa funzione inizializza l`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]