Net.Data: Guida alla gestione e alla programmazione per OS/400

Istruzioni della variabile di configurazione

Le istruzioni della variabile di configurazione di Net.Data impostano i valori delle variabili di configurazione. Le variabili di configurazione vengono utilizzate per diversi scopi. Alcune variabili vengono richieste da un ambiente di linguaggio per un corretto funzionamento o per operare in modo alternato. Altre variabili controllano la codifica del carattere del contenuto della pagina Web che è in fase di creazione. Inoltre, è possibile utilizzare le istruzioni della variabile di configurazione per definire le variabili specifiche per l'applicazione.

Le variabili di configurazione utilizzate dipendono dagli ambienti di linguaggio e dai utilizzati e da altri fattori specifici all'applicazione.

Per aggiornare le specifiche delle variabili di configurazione:

Personalizzare il file di inizializzazione con le variabili di configurazione necessarie per l'applicazione. Una variabile di configurazione presenta la seguente sintassi:

NAME[=]value-string

Il segno uguale è facoltativo, in base alle parentesi.

Le seguenti sottosezioni descrivono le istruzioni delle variabili di configurazione, utilizzate dagli ambienti di linguaggio forniti da Net.Data, che è possibile specificare nel file di inzializzazione:

• DTW_SQL_ISOLATION: variabile di isolamento di DB2

• DTW_SQL_NAMING_MODE: variabile di denominazione tabella SQL

• DTWR_CLOSE_REGISTRIES: variabile di apertura del registro Web

DTW_SQL_ISOLATION: variabile di isolamento di DB2

L'ambiente di linguaggio DTW_SQL utilizza l'istruzione di configurazione DTW_SQL_ISOLATION per stabilire il grado su cui le operazioni di database eseguite dall'ambiente di linguaggio DTW_SQL vengono isolate dai processi eseguiti contemporaneamente.

Sintassi:

DTW_SQL_ISOLATION locking_method

In cui locking_method è uno dei seguenti valori:

DTW_SQL_NO_COMMIT

Specifica di non utilizzare il controllo sincronizzazione. Per il sistema operativo OS/400, non specificare questo valore se viene specificato un database relazionale nella directory del database relazionale e quest'ultimo è in esecuzione su un sistema diverso da OS/400.

DTW_SQL_READ_UNCOMMITTED

Specifica il blocco per gli oggetti a cui si fa riferimento nelle istruzioni SQL ALTER, COMMENT ON, CREATE, DROP, GRANT, LABEL ON e REVOKE e alle righe aggiornate, cancellate e inserite. Gli oggetti vengono bloccati fino alla fine dell'unità di lavoro (transazione). E' possibile che vengano visualizzate modifiche non sincronizzate di altri processi.

DTW_SQL_READ_COMMITTED

Specifica il blocco per gli oggetti a cui si fa riferimento nelle istruzioni SQL ALTER, COMMENT ON, CREATE, DROP, GRANT, LABEL ON e REVOKE e alle righe aggiornate, cancellate e inserite. Gli oggetti vengono bloccati fino alla fine dell'unità di lavoro (transazione). Una riga selezionata, ma non aggiornata, viene bloccata fino a che non viene selezionata la riga successiva. Le modifiche non sincronizzate di altri processi non vengono visualizzate.

DTW_SQL_REPEATABLE_READ

Specifica il blocco per gli oggetti a cui si fa riferimento nelle istruzioni SQL ALTER, COMMENT ON, CREATE, DROP, GRANT, LABEL ON e REVOKE e alle righe selezionate, aggiornate, cancellate e inserite. Gli oggetti vengono bloccati fino alla fine dell'unità di lavoro (transazione). Le modifiche non sincronizzate di altri processi non vengono visualizzate.

DTW_SQL_SERIALIZABLE

Specifica il blocco per gli oggetti a cui si fa riferimento nelle istruzioni SQL ALTER, COMMENT ON, CREATE, DROP, GRANT, LABEL ON e REVOKE e alle righe selezionate, aggiornate, cancellate e inserite. Gli oggetti vengono bloccati fino alla fine dell'unità di lavoro (transazione). Le modifiche non sincronizzate di altri processi non vengono visualizzate. Tutte le tabelle a cui si fa riferimento nelle istruzioni SELECT, UPDATE, DELETE e INSERT vengono bloccate in esclusiva fino alla fine dell'unità di lavoro (transazione).

DTW_SQL_NAMING_MODE: variabile di denominazione tabella SQL

L'istruzione di configurazione DTW_SQL_NAMING_MODE specifica come un nome tabella può essere specificato in un'istruzione SQL.

Sintassi:

DTW_SQL_NAMING_MODE modo

In cui modo è uno dei seguenti valori:

SQL_NAMING

Specifica che le tabelle sono definite dal nome raccolta nel modulo:

raccolta.tabella

in cui raccolta è il nome della raccolta e tabella è il nome tabella. L'attributo predefinito è l'ID utente che esegue il processo che elabora l'istruzione SQL e viene utilizzato quando il nome tabella non viene esplicitamente definito e il nome raccolta predefinito non viene specificato. SQL_NAMING è il nome tabella predefinito.

SYS_NAMING

Specifica che i file vengono definiti in base al nome libreria contenuto nel modulo:

libreria/file

in cui libreria è il nome della libreria e file è il nome tabella. Il percorso di ricerca predefinito è *LIBL (l'elenco librerie) per il nome tabella non definito, nel caso in cui il nome tabella (file) non viene esplicitamente definito e non viene specificato un nome raccolta predefinito (libreria).

DTWR_CLOSE_REGISTRIES: variabile di apertura del registro Web

Specifica se chiudere o tenere aperto un registro Web. Questa variabile consente di mantenere aperto il registro Web in modo che i successivi richiami della macro di Net.Data che accedono allo stesso registro non devono riaprirlo.

Sintassi:

DTWR_CLOSE_REGISTRIES YES|NO

In cui:

YES

Specifica la chiusura di tutti i registri Web aperti dopo l'elaborazione di una macro di Net.Data.

NO

Specifica di lasciare aperti tutti i registri Web aperti dopo l'elaborazione di una macro di Net.Data. Il valore predefinito è NO.

Suggerimento per le prestazioni: E' possibile utilizzare l'istruzione di configurazione DTWR_CLOSE_REGISTRIES per migliorare le prestazioni dell'accesso a un registro Web (con le funzioni integrate del registro Web) riducendo al minimo le operazioni di apertura e di chiusura dei registri.