Net.Data ermittelt die Speicherposition der Dateien und ausführbaren Programme, die von Net.Data-Makros verwendet werden, anhand der Einstellungen der Pfadkonfigurationsanweisungen. Es gibt folgende Pfadanweisungen:
Diese Pfadanweisungen geben mindestens ein Verzeichnis an, das Net.Data durchsucht, wenn es versucht, Makros, ausführbare Dateien, Textdateien, und Kopfdateien zu lokalisieren. Die benötigten Pfadanweisungen hängen von dem Net.Data-Leistungsspektrum ab, das Ihre Makros verwenden.
Aktualisierungsrichtlinien:
Für die Pfadanweisungen gelten mehrere allgemeine Richtlinien. Ausnahmen werden in den Beschreibungen der einzelnen Pfadanweisungen angemerkt.
In den folgenden Abschnitten werden der Zweck und die Syntax jeder Pfadanweisung beschrieben und Beispiele gültiger Pfadanweisungen gegeben.
Die Konfigurationsanweisung MACRO_PATH gibt die Verzeichnisse an, die Net.Data nach Net.Data-Makros durchsucht. Zum Beispiel wird durch Angabe der folgenden URL-Adresse das Net.Data-Makro mit dem Pfad und Dateinamen /macro/sqlm.d2w angefordert:
http://server/cgi-bin/db2www/macro/sqlm.d2w/report
Syntax:
MACRO_PATH [=] path1;path2;...;pathn
Das Gleichheitszeichen (=) ist wahlfrei, wie durch eckige Klammern angegeben.
Net.Data fügt den Pfad /macro/sqlm.d2w an die Pfade in der Konfigurationsanweisung MACRO_PATH von links nach rechts an, bis das Net.Data-Makro gefunden wird bzw. alle Pfade durchsucht worden sind. Informationen zum Aufrufen von Net.Data-Makros finden Sie in Aufrufen von Net.Data.
Beispiel: Das folgende Beispiel zeigt die Anweisung MACRO_PATH in der Initialisierungsdatei und die zugehörige Programmverbindung (Link), die Net.Data aufruft.
Net.Data-Initialisierungsdatei:
MACRO_PATH /u/user1/macros;/usr/lpp/netdata/macros;
HTML-Programmverbindung (Link):
<A HREF="http://server/cgi-bin/db2www/query.d2w/input">Submit another query.</A>
Wenn die Datei query.d2w im Verzeichnis /u/user1/macros gefunden wird, ist der vollständig qualifizierte Pfad /u/user1/macros/query.d2w.
Wenn die Datei in den in der Anweisung MACRO_PATH angegebenen Verzeichnissen nicht gefunden wird, sucht Net.Data die Datei im Stammverzeichnis (/). Beispiel: Die folgende URL-Adresse wird übergeben:
http://myserver/cgi-bin/db2www/myfile.txt/report
Die Datei myfile.txt wurde in keinem der in MACRO_PATH angegebenen Verzeichnisse gefunden. Net.Data versucht dann, die Datei im Stammverzeichnis (/) zu finden:
/myfile.txt
Die Konfigurationsanweisung EXEC_PATH gibt ein oder mehrere Verzeichnisse an, die Net.Data nach einem externen Programm durchsucht, das über die EXEC-Anweisung oder eine ausführbare Variable aufgerufen wird. Wenn das Programm gefunden wird, wird der Name des externen Programms an die Pfadangabe angefügt. Der daraus resultierende, vollständig qualifizierte Dateiname wird zur Ausführung an die Sprachumgebung übergeben.
Syntax:
EXEC_PATH [=] path1;path2;...;pathn
Beispiel: Das folgende Beispiel zeigt die Anweisung EXEC_PATH in der Initialisierungsdatei und die Anweisung EXEC im Makro, das das externe Programm aufruft.
Net.Data-Initialisierungsdatei:
EXEC_PATH /qsys.lib/programs.lib;/qsys.lib/rexx.lib/rexxpgms.file;
Net.Data-Makro:
%FUNCTION(DTW_REXX) myFunction() {
%EXEC{ myFunction.mbr %}
%}
Wenn die Datei MyFunction.mbr im Verzeichnis /qsys.lib/rexx.lib/rexxpgms.file gefunden wird, ist der qualifizierte Name des Programms /qsys.lib/rexx.lib/rexxpgms.file/myFunction.mbr.
Wenn die Datei in den in der Anweisung EXEC_PATH angegebenen Verzeichnissen nicht gefunden wird, gilt folgendes:
%EXEC{/qsys.lib/programs.lib/rpg1.pgm %}
Net.Data sucht dann die Datei rpg1.pgm im Verzeichnis /qsys.lib/programs.lib.
%EXEC { rpg1.pgm %}
Net.Data versucht dann, die Datei rpg1.pgm im aktuellen Arbeitsverzeichnis zu finden.
Die Konfigurationsanweisung INCLUDE_PATH gibt ein oder mehrere Verzeichnisse an, die Net.Data durchsucht, um eine in einer INCLUDE-Anweisung in einem Net.Data-Makro angegebene Datei zu finden. Wenn Net.Data die Datei findet, hängt es den Namen der Kopfdatei an die Pfadangabe an, um den qualifizierten Kopfdateinamen zu erstellen.
Syntax:
INCLUDE_PATH [=] path1;path2;...;pathn
Beispiel 1: Das folgende Beispiel zeigt sowohl die Anweisung INCLUDE_PATH in der Initialisierungsdatei als auch die Anweisung INCLUDE, die die Kopfdatei angibt.
Net.Data-Initialisierungsdatei:
INCLUDE_PATH /u/user1/includes;/usr/lpp/netdata/includes;
Net.Data-Makro:
%INCLUDE "myInclude.txt"
Wenn die Datei myInclude.txt im Verzeichnis /u/user1/includes gefunden wird, ist der vollständig qualifizierte Name der Kopfdatei /u/user1/includes/myInclude.txt.
Beispiel 2: Das folgende Beispiel zeigt die Anweisung INCLUDE_PATH und eine Kopfdatei mit einem Unterverzeichnisnamen.
Net.Data-Initialisierungsdatei:
INCLUDE_PATH /u/user1/includes;/usr/lpp/netdata/includes;
Net.Data-Makro:
%INCLUDE "OE/oeheader.inc"
Die Kopfdatei wird in den Verzeichnissen /u/user1/includes/OE und /usr/lpp/netdata/includes/OE gesucht. Wenn die Datei im Verzeichnis /usr/lpp/netdata/includes/OE gefunden wird, ist der vollständig qualifizierte Name der Kopfdatei /usr/lpp/netdata/includes/OE/oeheader.inc.
Wenn die Datei in den in der Anweisung INCLUDE_PATH angegebenen Verzeichnissen nicht gefunden wird, gilt folgendes:
%INCLUDE "/u/user1/includes/oeheader.inc
Net.Data sucht dann die Datei oeheader.inc im Verzeichnis /u/user1/includes.
%INCLUDE "oeheader.inc"
Net.Data versucht dann, die Datei oeheader.inc im aktuellen Arbeitsverzeichnis zu finden.
Die Konfigurationsanweisung FFI_PATH gibt ein oder mehrere Verzeichnisse an, in denen Net.Data nach einer unstrukturierten Textdatei sucht, auf die durch die FFI-Funktion (FFI - Flat File Interface - Schnittstelle für unstrukturierte Dateien) verwiesen wird.
Syntax:
FFI_PATH [=] path1;path2;...;pathn
Beispiel: Das folgende Beispiel zeigt eine Anweisung FFI_PATH in der Initialisierungsdatei.
Net.Data-Initialisierungsdatei:
FFI_PATH /u/user1/ffi;/usr/lpp/netdata/ffi;
Wenn die FFI-Sprachumgebung aufgerufen wird, sucht Net.Data im in der Anweisung FFI_PATH angegebenen Pfad.
Da die Anweisung FFI_PATH verwendet wird, um die nicht in der Pfadanweisung aufgeführten Dateien zu sichern, gelten für nicht gefundene FFI-Dateien besondere Regeln. Weitere Informationen finden Sie im Abschnitt über in FFI integrierte Funktionen im Handbuch Net.Data Reference.
Die Konfigurationsanweisung HTML_PATH gibt an, in welches Verzeichnis Net.Data große Objekte (LOBs) schreibt. Für diese Pfadanweisung ist nur ein Verzeichnispfad zulässig.
Die Anweisung HTML_PATH muß ein IFS-Verzeichnis angeben, das sich nicht im Dateisystem QSYS.LIB befindet.
Syntax:
HTML_PATH [=] path
Beispiel: Das folgende Beispiel zeigt die Anweisung HTML_PATH in der Initialisierungsdatei.
Net.Data-Initialisierungsdatei:
HTML_PATH /db2/lobs
Wenn eine Abfrage ein LOB zurückgibt, sichert Net.Data es in dem in der in der Konfigurationsanweisung HTML_PATH angegebenen Verzeichnis.
Hinweis zur Leistung: Berücksichtigen Sie bei der Verwendung von LOBs die Systemeinschränkungen, denn LOBs können Ressourcen schnell aufbrauchen. Weitere Informationen finden Sie in Verwenden großer Objekte.
Die Konfigurationsanweisung DTW_JAVA_CLASSPATH gibt den Pfad zum Lokalisieren von Java-Klassen an. Verzeichnisse werden durch Doppelpunkte voneinander getrennt.
Syntax:
DTW_JAVA_CLASSPATH [=] path
Beispiel: Das folgende Beispiel zeigt die Anweisung DTW_JAVA_CLASSPATH in der Initialisierungsdatei.
Net.Data-Initialisierungsdatei:
DTW_JAVA_CLASSPATH /directory1/directory2:/QIBM/ProdData/Java400