Net.Data Verwaltung und Programmierung für OS/400

Pfadkonfigurationsanweisungen

Net.Data ermittelt die Speicherposition der Dateien und ausführbaren Programme, die von Net.Data-Makrodateien verwendet werden, anhand der Einstellungen der Pfadkonfigurationsanweisungen. Es gibt folgende Pfadanweisungen:

MACRO_PATH
EXEC_PATH
INCLUDE_PATH
FFI_PATH

Diese Pfadanweisungen geben mindestens ein Verzeichnis an, das Net.Data durchsucht, wenn es versucht, Makrodateien, 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:

Mehrere allgemeine Richtlinien gelten für alle Pfadanweisungen.

Jedes angegebene Verzeichnis wird durch ein Semikolon (;) begrenzt.
Schrägstriche (/) und umgekehrte Schrägstriche (\) werden auf gleiche Weise behandelt.
Jede Pfadanweisung kann mehrere Pfade angeben. Pfade werden von links nach rechts in der angegebenen Reihenfolge durchsucht. Durch die Möglichkeit zur Angabe mehrerer Pfade können Sie Ihre Dateien in mehreren Verzeichnissen verwalten. Sie können zum Beispiel jede Ihrer Web-Anwendungen in einem separaten Verzeichnis ablegen.
Es wird empfohlen, absolute Pfadanweisungen zu verwenden.

Hinweis: Net.Data durchsucht alle angegebenen Verzeichnisse, aber nicht die Unterverzeichnisse. Wenn sich zum Beispiel Net.Data-Makros in den folgenden Verzeichnissen befinden, müssen Sie jedes Unterverzeichnis in der Pfadanweisung angeben:

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

Ihre Anweisung MACRO_PATH könnte in etwa so aussehen:

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

In den folgenden Abschnitten werden der Zweck und die Syntax jeder Pfadanweisung beschrieben und Beispiele gültiger Pfadanweisungen gegeben.

MACRO_PATH

Die Konfigurationsanweisung MACRO_PATH gibt die Verzeichnisse an, die Net.Data nach Net.Data-Makrodateien 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 im Abschnitt 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

EXEC_PATH

Die Konfigurationsanweisung EXEC_PATH gibt mindestens ein Verzeichnis an, das von Net.Data nach einem externen Programm durchsucht wird, 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 in der Makrodatei, die 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/rexxprgms.file gefunden wird, ist der qualifizierte Name des Programms /qsys.lib/rexx.lib/rexxprgms.file/myFunction.mbr.

Wenn die Datei in den in der Anweisung EXEC_PATH angegebenen Verzeichnissen nicht gefunden wird, gilt folgendes:

Wenn der angegebene Pfad absolut ist, sucht Net.Data die Datei im angegebenen Pfad. Beispiel: Die folgende EXEC-Anweisung wurde angegeben:
```
%EXEC{/qsys.lib/programs.lib/rpg1.pgm %}
```
Net.Data sucht dann die Datei rpg1.pgm im Verzeichnis /qsys.lib/programs.lib.
Wenn der angegebene Pfad relativ ist, sucht Net.Data die Datei im aktuellen Arbeitsverzeichnis. Beispiel: Die folgende EXEC-Anweisung wurde angegeben:
```
%EXEC { rpg1.pgm %}
```
Net.Data versucht dann, die Datei rpg1.pgm im aktuellen Arbeitsverzeichnis zu finden.

INCLUDE_PATH

Die Konfigurationsanweisung INCLUDE_PATH gibt mindestens ein Verzeichnis an, das 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, die durch einen Unterverzeichnisnamen vollständig qualifiziert ist.

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:

Wenn der angegebene Pfad absolut ist, sucht Net.Data die Datei im angegebenen Pfad. Beispiel: Die folgende INCLUDE-Anweisung wurde angegeben:
```
%INCLUDE "/u/user1/includes/oeheader.inc
```
Net.Data sucht dann die Datei oeheader.inc im Verzeichnis /u/user1/includes.
Wenn der angegebene Pfad relativ ist, sucht Net.Data die Datei im aktuellen Arbeitsverzeichnis. Beispiel: Die folgende INCLUDE-Anweisung wurde angegeben:
```
%INCLUDE "oeheader.inc"
```
Net.Data versucht dann, die Datei oeheader.inc im aktuellen Arbeitsverzeichnis zu finden.

FFI_PATH

Die Konfigurationsanweisung FFI_PATH gibt mindestens ein Verzeichnis an, in dem 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. Weiere Informationen finden Sie im Abschnitt über in FFI integrierte Funktionen im Handbuch Net.Data Reference.

[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]