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

Istruzioni di configurazione percorso

Net.Data stabilisce l'ubicazione dei file e dei programmi eseguibili utilizzati dai file di macro di Net.Data dalle impostazioni delle istruzioni di configurazione del percorso. Le istruzioni del percorso sono:

MACRO_PATH
EXEC_PATH
INCLUDE_PATH
FFI_PATH

Queste istruzioni di percorso identificano una o più directory che Net.Data ricerca quando si tenta di assegnare i file di macro, i file eseguibili, i file di testo, , e i file di inclusione. Le istruzioni di percorso necessarie dipendono dalle capacità di Net.Data utilizzate dalle macro.

Indicazioni sull'aggiornamento:

Diverse indicazioni si applicano a tutte le istruzioni di percorso.

Ogni directory specificata è delimitata da un punto e virgola (;).
Barre (/) e barre retroverse (\) sono considerate allo stesso modo.
Ogni istruzione di percorso può specificare più percorsi . I percorsi vengono ricercati da sinistra a destra nell'ordine specificato. Questa capacità in più percorsi consente di organizzare i file all'interno di più directory. Ad esempio, è possibile posizionare ognuna delle applicazioni Web nella propria directory.
Si consiglia di utilizzare istruzioni di percorso assolute.

Suggerimento: Net.Data ricerca in tutte le directory specificate, ma non nelle sottodirectory. Ad esempio, nelle directory di seguito elencate ci sono macro Net.Data, nell'istruzione del percorso è necessario specificare ciascuna sottodirectory:

/usr/test/client
/usr/test/assoc
/usr/test/partner

L'istruzione MACRO_PATH potrebbe essere come segue:

MACRO_PATH [=] /usr/test/client;usr/test/assoc;usr/test/partner

Le seguenti sezioni descrivono lo scopo e la sintassi di ciascuna istruzione di percorso e contengono esempi di istruzioni di percorso corrette.

MACRO_PATH

L'istruzione di configurazione MACRO_PATH identifica le directory Net.Data cerca per i file di macro Net.Data. Ad esempio, specificando l'URL che segue, viene richiesta la macro di Net.Data con il percorso ed il nome filemacro/sqlm.d2w:

http://server/cgi-bin/db2www/macro/sqlm.d2w/report

Sintassi:

MACRO_PATH [=] path1;path2;...;pathn

Il segno di uguale (=) è facoltativo, come indicato dalle parentesi quadre.

Net.Data accoda il percorso macro/sqlm.d2w ai percorsi dell'istruzione di configurazione MACRO_PATH, da sinistra a destra finché Net.Data non trova il file di macro, oppure ricerca tutti i percorsi. Consultare Richiamo di Net.Data per informazioni su come richiamare le macro Net.Data.

Esempio: Il seguente esempio mostra l'istruzione MACRO PATH nel file di inizializzazione ed il relativo collegamento che richiama Net.Data.

File di inizializzazione di Net.Data:

MACRO_PATH = /u/user1/macros;/usr/lpp/netdata/macros;

Collegamento HTML:

<A HREF="http://server/cgi-bin/db2www/query.d2w/input">Submit another query.</A>

Se il file query.d2w si trova nella directory /u/user1/macros, il percorso completo è /u/user1/macros/query.d2w.

Se il file non si trova nelle directory specificate nell'istruzione MACRO_PATH, Net.Data ricerca il file nella directory radice (/). Ad esempio, se viene inoltrato l'URL:

http://myserver/cgi-bin/db2www/myfile.txt/report

e il file myfile.txt non si trova nelle directory specificate nell'istruzione MACRO_PATH, Net.Data ricerca il file nella directory radice (/):

/myfile.txt

EXEC_PATH

L'istruzione di configurazione EXEC_PATH identifica una o più directory che Net.Data ricerca per un programma esterno richiamato dall'istruzione EXEC o da una variabile eseguibile. Se il programma viene rilevato, il nome del programma esterno viene accodato all'istruzione del percorso e il risultato è un nome file completo che viene trasferito all'ambiente di linguaggio per l'esecuzione.

Sintassi:

EXEC_PATH [=] path1;path2;...;pathn

Esempio: Il seguente esempio mostra l'istruzione EXEC PATH nel file di inizializzazione e la relativa istruzione EXEC nel file di macro che richiama un programma esterno.

File di inizializzazione di Net.Data:

EXEC_PATH = /qsys.lib/programs.lib;/qsys.lib/rexx.lib/rexxpgms.file;

Macro di Net.Data:

%FUNCTION(DTW_REXX) myFunction() {
  %EXEC{ myFunction.mbr %}
%}

Se il file myFunction.mbr si trova nella directory /qsys.lib/rexx.lib/rexxprgms.file, il nome completo del programma è /qsys.lib/rexx.lib/rexxpgms.file/myFunction.mbr.

Se il file non si trova nelle directory specificate nell'istruzione EXEC_PATH:

Se il percorso specificato è assoluto, Net.Data ricerca il file nel percorso specificato. Ad esempio, se sono state specificate le seguenti istruzioni EXEC:
```
%EXEC{/qsys.lib/programs.lib/rpg1.pgm %}
 
```
Net.Data ricerca il file rpg1.pgm nella directory /qsys.lib/programs.lib.
Se il percorso specificato è relativo, Net.Data ricerca la directory di lavoro corrente. Ad esempio, se sono state specificate le seguenti istruzioni EXEC:
```
%EXEC { rpg1.pgm %}
```
Net.Data tenterà di trovare il file rpg1.pgm nella directory di lavoro corrente.

INCLUDE_PATH

L'istruzione di configurazione INCLUDE_PATH identifica una o più directory che Net.Data ricerca per rilevare un file specificato su un'istruzione INCLUDE nella macro di Net.Data. Quando il file viene rilevato, Net.Data accoda il nome file include all'istruzione del percorso per produrre il nome file include completo.

Sintassi:

INCLUDE_PATH [=] path1;path2;...;pathn

Esempio 1: L'esempio che segue riporta l'istruzione INCLUDE PATH del file di inizializzazione e l'istruzione INCLUDE che specifica il file di inclusione.

File di inizializzazione di Net.Data:

INCLUDE_PATH = /u/user1/includes;/usr/lpp/netdata/includes;

Macro di Net.Data:

%INCLUDE "myInclude.txt"

Se il file myInclude.txt si trova nella directory /u/user1/includes, il nome completo del file include è /u/user1/includes/myInclude.txt.

Esempio 2: L'esempio che segue mostra l'istruzione INCLUDE PATH ed un file INCLUDE completo utilizzando un nome di sottodirectory.

File di inizializzazione di Net.Data:

INCLUDE_PATH = /u/user1/includes;/usr/lpp/netdata/includes;

Macro di Net.Data:

%INCLUDE "/OE/oeheader.inc"

Il file include viene ricercato nelle directory /u/user1/includes/OE e /usr/lpp/netdata/includes/OE. Se il file viene rilevato in /usr/lpp/netdata/includes/OE, il nome completo del file include è /usr/lpp/netdata/includes/OE/oeheader.inc.

Se il file non si trova nelle directory specificate nell'istruzione INCLUDE_PATH:

Se il percorso specificato è assoluto, Net.Data ricerca il file nel percorso specificato. Ad esempio, se è stata specificata la seguente istruzione INCLUDE:
```
%INCLUDE "/u/user1/includes/oeheader.inc
 
```
Net.Data ricerca il file oeheader.inc nella directory u/uyer1/includes.
Se il percorso specificato è relativo, Net.Data ricerca la directory di lavoro corrente. Ad esempio, se è stata specificata la seguente istruzione INCLUDE:
```
%INCLUDE "oeheader.inc"
 
```
Net.Data tenterà di trovare il file oeheader.inc nella directory di lavoro corrente.

FFI_PATH

L'istruzione di configurazione FFI_PATH identifica una o più directory che Net.Data ricerca per un file non codificato a cui fa riferimento una funzione FFI (flat file interface).

Sintassi:

FFI_PATH [=] path1;path2;...;pathn

Esempio: L'esempio che segue riporta un'istruzione FFI_PATH nel file di inizializzazione.

File di inizializzazione di Net.Data:

FFI_PATH = /u/user1/ffi;/usr/lpp/netdata/ffi;

Quando viene chiamato un ambiente di linguaggio FFI, Net.Data esegue una ricerca nel percorso specificato nell'istruzione FFI_PATH.

Poichè l'istruzione FFI_PATH viene utilizzata per fornire la protezione a quei file non presenti nelle directory nell'istruzione di percorso, esistono regole speciali per quei file FFI che non vengono rilevati. Consultare la sezione relativa alle funzioni integrate FFI presenti in Riferimenti di Net.Data.

[ Inizio pagina | Pagina precedente | Pagina successiva | Indice | Indice analitico ]