Passa al contenuto principale

DUMP

Desktop

Consente di effettuare il salvataggio di una serie di informazioni relative al proprio stato di esecuzione su un file XML.

Parametri​

ParametroDefinizioneI/OInformazioniVersione traduttoreSMP
FILEStringaINDesktop
DIRStringaINDesktop
OPZIONIEnumerazioneINDesktop
DESCRIZIONEStringaINDesktop
VISUALIZZAInteroINBinarioDesktop
INVIAInteroINBinarioDesktop
VARPGMLIVInteroINBinarioDesktop
ERROREInteroINDesktop

FILE​

StringaINInputValore non necessarioValore non necessarioDesktop

Imposta il nome del file generato.

Se non viene specificato assume come default il valore BCLIVE.SXLIV.

DIR​

StringaINInputValore non necessarioValore non necessarioDesktop

Imposta la direttiva in cui collocare il file generato.

Se non specificato assume come valore di default 'PHB$+OPZIONI+<WS>'.

OPZIONI​

EnumerazioneINInputValore non necessarioValore non necessarioDesktop

Specifica quale tra gli elementi supportati si intende esportare sul file.

Se non specificato si assume l'intenzione di esportare tutte le informazioni possibili.

Parametro enumerato, può assumere i seguenti valori:

ValoreDescrizione
STACKStack delle chiamate
DLLDLL caricate in memoria
VIDEATEElenco videate in esecuzione
STAMPE(in fase di sviluppo)
VARAMBVariabili di ambiente
VARPGMVariabili di programma
GRIGLIEGriglie in esecuzione
ALBERIAlberi in esecuzione
VARDIZvariabili del dizionario caricato
FILESElenco dei file aperti
STRUTTUREStrutture dinamiche

DESCRIZIONE​

StringaINInputValore non necessarioValore non necessarioDesktop

Imposta una descrizione al file generato.

VISUALIZZA​

InteroINInputBinarioBinarioValore non necessarioValore non necessarioDesktop

Permette di visualizzare automaticamente il contenuto del file XML al termine della creazione.

Il file BCLIVE.EXE deve trovarsi nella direttiva base.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
0No
1Si

INVIA​

InteroINInputBinarioBinarioValore non necessarioValore non necessarioDesktop

Permette di inviare per e-mail il file appena generato. Al momento non implementata.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
0No
1Si

VARPGMLIV​

InteroINInputBinarioBinarioValore non necessarioValore non necessarioDesktop

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
0No
1Si

ERRORE​

InteroINInputValore non necessarioValore non necessarioDesktop
SottoParametri

Consente al programma di intercettare e gestire l'errore restituito dalla funzione.

suggerimento

Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.

Esempi​

Salvataggio dello stato di un programma​

 'La specifica effettua il salvataggio di tutte le informazioni possibili sul file di default, che verrà creato nella direttiva di default. 
 '(<PHB>\OPZIONI\<WS>BCLIVE.SXLIV):
 '@DUMP 

 'La specifica effettua il salvataggio di tutte le informazioni possibili sul file "C:\MYDUMP.SXLIV" e gestisce le eventuali situazioni di errore:
 '@DUMP FILE["MYDUMP.SXLIV"] _
        DIR["C:\"] _
        ERRORE[Errore]
 'La specifica effettua il salvataggio delle sole informazioni relative alle strutture dinamiche sul file di default 
 '(<PHB>\OPZIONI\<WS>BCLIVE.SXLIV) e gestisce le situazioni di errore.       
 '@DUMP OPZIONI[STRUTTURE] _
        ERRORE[Errore]