SAVEOPTION
La specifica '@SAVEOPTION viene utilizzata per salvare e quindi poter ripristinare successivamente la variabile o l'insieme di variabili indicate nel parametro VARS[] in un file XML.
Se non viene specificato il parametro DIR, il file utilizzato per il salvataggio delle variabili viene inserito nella direttiva con nome OPZIONI contenuta nella direttiva puntata dalla variabile di ambiente PHB e da una sottodirettiva con lo stesso nome della stazione di lavoro: <PHB>\OPZIONI\<WS>.
Il nome del file viene indicato nel parametro FILE[]. Se il nome è indicato come una costante (es.: 'EI403') può essere parametrizzato mediante l'utilizzo della variabile d'ambiente OPZ.
In particolare è possibile definire il nome del file secondo i seguenti criteri:
| Opzione | Nome file opzioni |
|---|---|
| 0 (valore predefinito) | <NomeFile> + '.SXO' |
| 1 | <NomeFile> + <NomeFile> + <Gruppo> + '.SXO' |
| 2 | <NomeFile> + <Gruppo> + <Ditta> + '.SXO' |
Se il parametro, invece, è una variabile (di tipo alfanumerico) non verrà fatta nessuna modifica al valore che la variabile assume, ed il programmatore potrà decidere di differenziare i file salvati secondo altri criteri che non quelli di gruppo o ditta.
Ci deve essere coerenza nel numero, tipo e ordine delle variabili indicate su '@SAVEOPTION ed una successiva '@READOPTION.
Al momento del ripristino del file contenente le variabili salvate, viene eseguito un controllo per verificare che si stia effettivamente ripristinando il gruppo contenente le variabili indicate nella specifica '@SAVEOPTION. Se da tale controllo risulta che il file non contiene informazioni coerenti con la specifica '@READOPTION o se il gruppo dal quale si intende eseguire il ripristino non esiste, viene settata la variabile ERRSOP% ad 1.
Tale variabile sarà poi visibile al programma che in presenza di errore (ERRSOP%=1) si potrà comportare di conseguenza.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| FILE | Stringa | ||||
| VARS | |||||
| DIR | Stringa |
FILE
Nome del file in formato XML che conterrà le variabili definite nella specifica '@SAVEOPTION.
Può essere indicata sia una variabile che una costante. Il nome non deve avere né Path, né appendice, in quanto verranno automaticamente aggiunte in esecuzione.
VARS
Variabile o variabili il cui contenuto deve essere salvato.
Possono essere indicate sia variabili numeriche che alfanumeriche, precedentemente dimensionate.
Nel caso si indichino schiere, deve essere indicato il nome della schiera seguito dalla sequenza di caratteri '()', oppure un solo elemento della schiera per volta ma con indice costante (es.: VETT$(1) e non VETT$(IND%)).
Dalla versione 26.1 del traduttore le variabili vanno separate tramite il carattere virgola.
DIR
[NomeDirettiva]: può essere una variabile o una costante alfanumerica.
Direttiva di collocazione del file di salvataggio opzioni.
Se non indicata la direttiva di salvataggio verrà costruita secondo il criterio specificato <PHB>\OPZIONI\<WS>.