Die in der Initialisierungsdatei enthaltenen Informationen werden mit drei Arten von Konfigurationsanweisungen angegeben, die in den folgenden Abschnitten beschrieben werden:
Die in Abbildung 5 gezeigte Beispielinitialisierungsdatei enthält Beispiele dieser Anweisungen und ist für OS/2 und Windows NT gültig.
Der Text jeder einzelnen Konfigurationsanweisung muss vollständig in einer Zeile stehen. Stellen Sie sicher, dass die Initialisierungsdatei eine Anweisung ENVIRONMENT für jede Sprachumgebung enthält, die Sie von Ihren Makros aus aufrufen. Sie müssen keine Pfadkonfigurationsanweisungen angeben, wenn Sie bei allen Verweisen auf Dateien innerhalb des Makros den vollständig qualifizierten Pfad angeben.
Abbildung 5. Die Net.Data-Initialisierungsdatei. Eine vollständige Beschreibung des DLL-Pfads und der Parameterliste finden Sie in der Datei db2www.ini selbst und in Umgebungskonfigurationsanweisungen.
1 DTW_CM_PORT 7128 2 DTW_INST_DIR c:\db2www 3 DTW_LOG_DIR c:\db2www\logs 4 DB2INSTANCE DB2 5 DTW_DIRECT_REQUEST NO 6 DTW_SHOWSQL NO 7 DTW_UNICODE NO 8 DTW_MBMODE NO 9 MACRO_PATH c:\DB2WWW\Macro 10 HTML_PATH c:\www\html 11 INCLUDE_PATH c:\db2www\Macro 12 EXEC_PATH c:\db2www\Macro 13 FFI_PATH c:\pub\ffi;pub\ffi\data 14 ENVIRONMENT (DTW_SQL) [DLL path] [Parameter list] 15 ENVIRONMENT (DTW_ORA) [DLL path] [Parameter list] 16 ENVIRONMENT (DTW_ODBC) [DLL path] [Parameter list] 17 ENVIRONMENT (DTW_DEFAULT) [DLL path] [Parameter list] 18 ENVIRONMENT (DTW_APPLET) [DLL path] [Parameter list] 19 ENVIRONMENT (DTW_REXX) [DLL path] [Parameter list] 20 ENVIRONMENT (DTW_PERL) [DLL path] [Parameter list] 21 ENVIRONMENT (DTW_SYSTEM) [DLL path] [Parameter list] 22 ENVIRONMENT (DTW_FILE) [DLL path] [Parameter list] 23 ENVIRONMENT (DTW_WEBREG) [DLL path] [Parameter list] 24 ENVIRONMENT (DTW_JAVAPPS) [DLL path] [Parameter list] 25 ENVIRONMENT (HWS_LE) [DLL path] [Parameter list] |
|
In den folgenden Abschnitten wird beschrieben, wie Sie die Konfigurationsanweisungen in der Initialisierungsdatei anpassen können.
Die folgenden Änderungen an den ENVIRONMENT-Anweisungen sind erforderlich:
Die Net.Data-Konfigurationsvariablenanweisungen legen die Werte der Konfigurationsvariablen fest. Konfigurationsvariablen werden für verschiedene Zwecke verwendet. Einige Variablen sind bei bestimmten Sprachumgebungen für die ordnungsgemäße Funktion oder den Betrieb in einem alternativen Modus erforderlich. Andere Variablen steuern die Zeichenverschlüsselung oder den Inhalt der momentan erstellten Webseite. Mit Konfigurationsvariablenanweisungen können Sie zudem anwendungsspezifische Variablen definieren.
Die verwendeten Konfigurationsvariablen hängen von den verwendeten Sprachumgebungen und Datenbanken sowie anderen, anwendungsspezifischen Faktoren ab.
Gehen Sie wie folgt vor, um die Konfigurationsvariablenanweisungen zu aktualisieren:
Passen Sie die Initialisierungsdatei mit den Konfigurationsvariablen an, die für Ihre Anwendung erforderlich sind. Eine Konfigurationsvariable hat die folgende Syntax:
NAME[=]value-string
Das Gleichheitszeichen ist optional, was durch die eckigen Klammern angegeben wird.
In den folgenden Unterabschnitten werden die Konfigurationsvariablenanweisungen beschrieben, die Sie in der Initialisierungsdatei angeben können:
Es werden zwei optionale Konfigurationsvariablen verwendet, wenn der Cache-Manager auf einer anderen Maschine ausgeführt wird als der, auf der das Net.Data-Makro ausgeführt wird:
Wenn der Cache-Manager auf der lokalen Maschine ausgeführt wird, werden UNIX-Domänen-Sockets oder benannte Pipes zur Übertragung verwendet. In diesem Fall ist keine Konfiguration erforderlich.
Der Cache-Manager kann nur auf Maschinen unter AIX oder Windows NT ausgeführt werden. Informationen zum Net.Data-Caching finden Sie in Net.Data-Caching.
Syntax:
DTW_CACHE_PORT [=] port_number
Parameter:
Tabelle 3 beschreibt die Optionen zum Angeben der Maschinen-IDs und
Anschlussnummern für diese Variablen.
Tabelle 3. Konfigurationsvariablen für den Cache-Manager: Konfigurationsoptionen
Standardwerte für Connection Manager | Bei Angabe der Cache-Maschine | Bei fehlender Angabe der Cache-Maschine |
Bei Angabe des Cache-Anschlusses | Net.Data stellt mit dem angegebenen Anschluss die Verbindung zum Cache-Manager auf der angegebenen Maschine her. | Net.Data stellt mit dem angegebenen Anschluss die Verbindung zum Cache-Manager auf der lokalen Maschine her. |
Bei fehlender Angabe des Cache-Anschlusses | Net.Data stellt mit dem Standardanschluss 7175 die Verbindung zum Cache-Manager auf der angegebenen Maschine her. | Net.Data stellt mit dem Standardanschluss 7175 die Verbindung zum Cache-Manager auf der lokalen Maschine her. |
Syntax:
DTW_CACHE_HOST [=] host_name
Parameter:
Gibt das DB2-Exemplar an, das von der SQL-Sprachumgebung verwendet wird. Dieser Variablenwert ist erforderlich, wenn Net.Data die Verbindung zu DB2 herstellt und dieses Produkt auf den Betriebssystemen Windows NT, OS/2 und UNIX ausgeführt wird.
Für DB2 unter OS/2, Windows NT und UNIX muss DB2INSTANCE als Umgebungsvariable definiert werden. Wenn Net.Data feststellt, dass DB2INSTANCE nicht als Umgebungsvariable definiert ist, setzt es die Umgebungsvariable DB2INSTANCE auf den in der INI-Datei vorhandenen Wert von DB2INSTANCE, bevor die Verbindungsherstellung zu DB2 versucht wird.
Syntax:
DB2INSTANCE [=] instance_name
Gibt eine eindeutige Anschlussnummer an, die Net.Data für Direktverbindungen verwendet.
Syntax:
DTW_CM_PORT [=] port_number
Dabei gilt Folgendes: port_number gibt die für Direktverbindungen verwendete eindeutige Anschlussnummer an.
Mit der Konfigurationsvariablen DTW_DEFAULT_ERROR_MESSAGE geben Sie eine generische Fehlernachricht für Anwendungen in der Produktion an. Diese Variable stellt eine generische Nachricht für Fehlerbedingungen zur Verfügung, die in keinem MESSAGE-Block erfasst sind.
Wenn Sie dennoch die ursprünglich von Net.Data generierten Fehlernachrichten sehen wollen, müssen Sie die Nachrichten mit Hilfe der Fehlernachrichtenprotokollierung erfassen. Informationen zur Verwendung des Fehlerprotokolls finden Sie in Net.Data-Protokollierung.
Wird die Konfigurationsvariable nicht angegeben, zeigt Net.Data eine eigene Nachricht für die Fehlerbedingung an.
Syntax:
DTW_DEFAULT_ERROR_MESSAGE [=] "message"
Beispiel: Gibt eine generische Nachricht an
DTW_DEFAULT_ERROR_MESSAGE "This site is temporarily unavailable."
Aktiviert bzw. inaktiviert den Net.Data-Direktanforderungsaufruf. Die Direktanforderung ist standardmäßig inaktiviert.
Bei der Direktanforderungsmethode zum Aufrufen von Net.Data kann ein Benutzer die Ausführung einer SQL-Anweisung bzw. eines Perl-, REXX- oder C-Programms direkt in einer URL-Adresse angeben. Ist die Direktanforderung inaktiviert, muss der Benutzer Net.Data mit der Makroanforderungsmethode aufrufen, d. h., Benutzer können nur jene SQL-Anweisungen und Funktionen ausführen, die in einem Makro definiert sind bzw. aufgerufen werden. Empfehlungen zur Sicherheit bei der Verwendung von DTW_DIRECT_REQUEST finden Sie in Verwenden von Net.Data-Mechanismen.
Syntax:
DTW_DIRECT_REQUEST [=] YES|NO
Dabei gilt Folgendes:
Lokalisiert bestimmte Dateien während der Net.Data-Ausführung. Sie setzen diese Variable während der Installation auf das Ausgangsverzeichnis (inst_dir), in dem Net.Data installiert wird. Ändern Sie diesen Wert nach der Installation nicht.
Gibt an, in welches Verzeichnis Net.Data große Objekte (LOBs) schreibt.
Während der Installation erstellt Net.Data das Verzeichnis tmplobs unter dem in der Pfadkonfigurationsvariablen HTML_PATH angegebenen Verzeichnis. Net.Data speichert alle LOB-Dateien in diesem Verzeichnis. Wenn Sie den Wert von HTML_PATH ändern, erstellen Sie ein neues Unterverzeichnis unter dem neuen Verzeichnis.
Syntax:
HTML_PATH [=] path
Beispiel: Das folgende Beispiel zeigt die Konfigurationsvariable HTML_PATH in der Initialisierungsdatei.
HTML_PATH /db2/lobs
Wenn eine Abfrage ein LOB zurückgibt, sichert Net.Data diese Datei in dem durch die Konfigurationsanweisung HTML_PATH angegebenen Verzeichnis.
Hinweis: 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.
DTW_LOG_DIR gibt das Verzeichnis an, in dem die Fehlerprotokolle gespeichert sind. Die Protokollierung findet nur dann statt, wenn diese und die Variable DTW_LOG_LEVEL definiert sind.
Weitere Informationen zu diesen Variablen und zum Protokollieren von Fehlernachrichten mit Net.Data finden Sie in Protokollieren von Net.Data-Fehlernachrichten.
Syntax:
DTW_LOG_DIR [=] \inst_dir\path
Beispiel: Konfiguration der Initialisierungsdatei
DTW_LOG_DIR \inst_dir\mylogfiles\
DTW_LOG_LEVEL gibt die Stufe der Fehler an, die in den Fehlerprotokollen aufgezeichnet werden soll. Die Protokollierung findet nur dann statt, wenn diese und die Variable DTW_LOG_DIR definiert sind.
Weitere Informationen zu diesen Variablen und zum Protokollieren von Fehlernachrichten mit Net.Data finden Sie in Protokollieren von Net.Data-Fehlernachrichten.
Syntax:
DTW_LOG_LEVEL [=] off|warning|error
Beispiel: Konfiguration der Initialisierungsdatei
DTW_LOG_LEVEL error
Aktiviert die Unterstützung in der Landessprache für Wort- und Zeichenfolgefunktionen. Wenn der Wert für die Variable YES ist, verarbeiten alle Zeichenfolge- und Wortfunktionen MBCS-Zeichen in Zeichenfolgen ordnungsgemäß, indem sie sie als gemischte Daten behandeln (d. h. als Zeichenfolgen, die möglicherweise Zeichen aus Einzelbytezeichensätzen und Doppelbytezeichensätzen enthalten). Der Standardwert ist NO. Sie können den in der Initialisierungsdatei festgelegten Wert überschreiben, indem Sie die Variable DTW_MBMODE in einem Net.Data-Makro entsprechend einstellen.
Diese Konfigurationsvariable steht mit der Konfigurationsvariablen
DTW_UNICODE in Verbindung. Wenn DTW_UNICODE den Standardwert NO
verwendet, wird der Wert von DTW_MBMODE verwendet. Wenn DTW_UNICODE auf
einen anderen Wert als NO gesetzt ist, wird dieser Wert verwendet. Tabelle 4 veranschaulicht, wie die Einstellungen dieser beiden
Variablen festlegen, wie integrierte Funktionen Zeichenfolgen
verarbeiten:
Tabelle 4. Beziehung zwischen den Einstellungen von DTW_UNICODE und DTW_MBMODE
DTW_UNICODE-Einstellung | DTW_MBMODE=YES | DTW_MBMODE=NO |
---|---|---|
NO | Unterstützt MBCS gemischt mit SBCS | Unterstützt nur SBCS |
UTF8 | Unterstützt UTF-8 | Unterstützt UTF-8 |
Syntax:
DTW_MBMODE [=] NO|YES
Wird für diese Variable YES definiert, entfernt Net.Data überflüssige Leerzeichen aus der HTML-Ausgabe. Diese Variable verringert durch Komprimierung von Leerzeichen die Menge der an den Web-Browser gesendeten Daten, was zu einer höheren Leistung führt. Der Standardwert ist NO.
Sie können diese Variable im Makro mit der Anweisung DEFINE überschreiben.
Syntax:
DTW_REMOVE_WS [=] YES|NO
Überschreibt die Wirksamkeit der Einstellung SHOWSQL in Ihren Net.Data-Makros.
Syntax:
DTW_SHOWSQL [=] YES|NO
Dabei gilt Folgendes:
Tabelle 5 beschreibt, wie die Einstellungen in der
Net.Data-Initialisierungsdatei und das Makro festlegen, ob die Variable
SHOWSQL für ein bestimmtes Makro aktiviert oder inaktiviert ist.
Einstellung von DTW_SHOWSQL | Einstellung SHOWSQL | SQL-Anweisung angezeigt |
---|---|---|
NO | NO | NO |
NO | YES | NO |
YES | NO | NO |
YES | YES | YES |
Gibt den SMTP-Server an, der zum Senden von E-Mail-Nachrichten über die integrierte Funktion DTW_SENDMAIL verwendet werden soll. Der Wert dieser Variablen kann ein Host-Name oder eine IP-Adresse sein. Wenn diese Variable nicht gesetzt wird, verwendet Net.Data den lokalen Host als SMTP-Server.
Syntax:
DTW_SMTP_SERVER [=] server_name
Dabei gilt Folgendes: server_name ist der Host-Name bzw. die IP-Adresse des SMTP-Servers, der zum Senden von E-Mail-Nachrichten verwendet werden soll.
Hinweis zur Leistung: Geben Sie eine IP-Adresse für diesen Wert an, um zu verhindern, dass Net.Data die Verbindung zu einem Domänennamensserver herstellt, wenn die IP-Adresse des angegebenen SMTP-Servers abgerufen wird.
Beispiel:
DTW_SMTP_SERVER us.ibm.com
Gibt an, ob Net.Data Unicode in folgenden Elementen unterstützt:
Net.Data unterstützt das UTF-8-Unicode-Format in Makros, Formulardaten und integrierten Funktionen, und die Ausgabe erfolgt immer in UTF-8. Net.Data kann auf eine Datenbank zugreifen, die UCS-2-Daten enthält, und diese in UTF-8 umsetzen.
Wird DTW_UNICODE auf UTF8 gesetzt, wird Net.Data zur Ausführung in einer Unicode-Umgebung angewiesen. Net.Data generiert dann Seiten in UTF-8 und erwartet alle Eingabedaten im UTF-8-Format (bei DB2-Datenbankdaten wird auch UCS-2 akzeptiert). Zu den Eingabedaten gehören der Inhalt der Makrodatei, die vom Browser gesendeten Formulardaten und alle anderen Daten aus externen Datenquellen.
Voraussetzung für DB2-Unicode-Datenbank: Neben der Definition der Variable DTW_UNICODE müssen Sie auch für die DB2-spezifische Umgebungsvariable, DB2CODEPAGE, 1208 in der Umgebung, in der Net.Data aktiv ist, definieren. Für den Apache-Webserver müssen Sie beispielsweise der Datei HTTPD.CONF folgende Zeile hinzufügen:
SetEnv DB2CODEPAGE 1208
Lesen Sie in Ihrer Webserverdokumentation nach, wie Umgebungsvariablen für CGI-Scripts, Webserver-APIs, FastCGI-Programme oder Servlets definiert werden.
Net.Data verwendet in einer Unicode-Umgebung den englischen Nachrichtenkatalog.
Die Konfigurationsvariable DTW_UNICODE steht mit der Konfigurationsvariablen DTW_MBMODE in Verbindung. Der Wert der Konfigurationsvariablen DTW_UNICODE überschreibt die Einstellung der Variablen DTW_MBMODE bei der Verarbeitung von integrierten Wort- und Zeichenfolgefunktionen. Wird für DTW_UNICODE jedoch NO definiert oder wird diese Variable nicht definiert, wird der Wert DTW_MBMODE verwendet. Tabelle 4 veranschaulicht, wie die Einstellungen dieser beiden Variablen festlegen, wie integrierte Funktionen Zeichenfolgen verarbeiten:
Syntax:
DTW_UNICODE [=] NO|UTF8
Dabei gilt Folgendes:
Gibt an, in welchem Verzeichnis Net.Data Dateien speichert, die vom Client hochgeladen werden. Wenn diese Variable nicht gesetzt wird, lehnt Net.Data die Dateien für das Hochladen ab.
Syntax:
DTW_UPLOAD_DIR [=] path
Beispiel:
DTW_UPLOAD_DIR /tmp/uploads
Gibt an, dass Net.Data den DB2-Vorbereitungs-Cache ohne explizite Verwendung von Parametermarken in der SQL-Anweisung der Makrodatei nutzen soll. Wenn alle Ihre Makros diese Funktion nutzen sollen, müssen Sie die Konfigurationsvariable DTW_USE_DB2_PREPAR_CACHE in der Net.Data-Initialisierungsdatei auf YES setzen. Soll diese Funktion nur für die Anweisungen in einem bestimmten Makro aktiviert werden, können Sie die Makrovariable DTW_USE_DB2_PREPARE_CACHE verwenden. Weitere Informationen finden Sie im Handbuch Net.Data Reference.
Syntax:
DTW_USE_DB2_PREPARE_CACHE [=] YES|NO
Dabei gilt Folgendes:
Gibt an, wie Net.Data den lokalen Variablenbereich behandelt, d. h. ob lokale Variablen nur lokal gültig sind oder ob lokale Variablen außerhalb des Funktionsblocks, in dem sie erstellt wurden, verwendet werden können. Diese Variable wird für Abwärtskompatibilität mit vorherigen Versionen von Net.Data zur Verfügung gestellt und ist bei den OS/390- oder OS/400-Versionen von Net.Data nicht verfügbar.
Syntax:
DTW_VARIABLE_SCOPE [=] LOCAL|GLOBAL
Dabei gilt Folgendes:
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, LOB-Dateien 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 einige 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 Beispiele können sich je nach Betriebssystem und Konfiguration von Ihrer Anwendung unterscheiden.
Diese Pfadkonfigurationsanweisung gibt den Pfad zum Lokalisieren von Anlagen an, die mit Hilfe von DTW_SENDMAIL gesendet werden sollen.
Syntax:
DTW_ATTACHMENT_PATH [=] path
Beispiel:
DTW_ATTACHMENT_PATH /usr/lpp/internet/server_root/pub/upload
Diese Pfadkonfigurationsanweisung gibt mindestens ein Verzeichnis an, das Net.Data nach einem externen Programm durchsucht, das über die EXEC-Anweisung oder eine ausführbare Variable aufgerufen wird. Die Reihenfolge der Verzeichnisse in der Pfadanweisung legt die Reihenfolge fest, in der Net.Data nach den Verzeichnissen sucht. 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 /u/user1/prgms;/usr/lpp/netdata/prgms;
Net.Data-Makro:
%FUNCTION(DTW_REXX) myFunction() { %EXEC{ myFunction.cmd %} %}
Wenn die Datei MyFunction.cmd im Verzeichnis /usr/lpp/netdata/prgms gefunden wird, ist der qualifizierte Name des Programms /usr/lpp/netdata/prgms/myFunction.cmd.
Wenn die Datei in den in der Anweisung EXEC_PATH angegebenen Verzeichnissen nicht gefunden wird, gilt Folgendes:
http://myserver/cgi-bin/db2www/usr/user1/prgms/myFunction.cmd
Net.Data sucht dann die Datei im Verzeichnispfad /u/user1/prgms/myFunction.cmd.
http://myserver/cgi-bin/db2www/myFunction.cmd/report
Die Datei myFunction.cmd wurde in keinem der in EXEC_PATH angegebenen Verzeichnisse gefunden. Net.Data versucht dann, die Datei im aktuellen Arbeitsverzeichnis zu finden.
Diese Pfadkonfigurationsanweisung gibt mindestens ein Verzeichnis an, in dem Net.Data in der angegebenen Reihenfolge 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.
Diese Pfadkonfigurationsanweisung gibt mindestens ein Verzeichnis an, das Net.Data durchsucht, und zwar in der angegebenen Reihenfolge, 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:
http://myserver/cgi-bin/db2www/u/user1/includes/oeheader.inc
Net.Data sucht dann die Datei im Verzeichnispfad /u/user1/includes/oeheader.inc.
http://myserver/cgi-bin/db2www/my.cmd/report
Die Datei myFunction.cmd wurde in keinem der in INCLUDE_PATH angegebenen Verzeichnisse gefunden. Net.Data versucht dann, die Datei im aktuellen Arbeitsverzeichnis zu finden.
Diese Pfadkonfigurationsanweisung 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.dtw angefordert:
http://server/cgi-bin/db2www/macro/sqlm.dtw/report
Syntax:
MACRO_PATH [=] path1;path2;...;pathn
Das Gleichheitszeichen (=) ist optional, wie durch eckige Klammern angegeben.
Net.Data fügt den Pfad /macro/sqlm.d2w/report an die Pfade in der Konfigurationsanweisung MACRO_PATH von links nach rechts an, bis das Net.Data-Makro gefunden wird. Wird das Makro nicht gefunden, führt Net.Data das Makro, das für die Konfigurationsvariable DTW_DEFAULT_MACRO definiert ist, aus oder gibt einen Fehler aus. 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 Verbindung (Link), die Net.Data aufruft.
Net.Data-Initialisierungsdatei:
MACRO_PATH /u/user1/macros;/usr/lpp/netdata/macros
HTML-Verbindung (Link):
<a href="http://server/cgi-bin/db2www/query.dtw/input">Submit another query.</a>
Wenn die Datei query.dtw im Verzeichnis /u/user1/macros gefunden wird, ist der vollständig qualifizierte Pfad /u/user1/macros/query.dtw.
Wenn die Datei in den in der Anweisung MACRO_PATH angegebenen Verzeichnissen nicht gefunden wird, gilt Folgendes:
http://server/cgi-bin/db2www/u/user1/macros/myfile.txt/report
Net.Data sucht dann die Datei im Verzeichnispfad /u/user1/macros/myfile.txt.
http://server/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
Eine Anweisung ENVIRONMENT konfiguriert eine Sprachumgebung. Eine Sprachumgebung ist eine Net.Data-Komponente, mit der Net.Data auf eine Datenquelle, wie zum Beispiel eine DB2-Datenbank, zugreift oder ein in einer Sprache wie REXX geschriebenes Programm ausführt. Net.Data stellt eine Reihe von Sprachumgebungen bereit sowie eine Schnittstelle, mit der Sie Ihre eigenen Sprachumgebungen erstellen können. Diese Sprachumgebungen werden in Verwenden der Sprachumgebungen beschrieben, und die Schnittstelle für Sprachumgebungen wird im Handbuch Net.Data Language Environment Interface Reference erörtert.
Net.Data erfordert, dass eine Anweisung ENVIRONMENT für eine bestimmte Sprachumgebung vorhanden ist, bevor Sie diese Sprachumgebung aufrufen können.
Sie können Variablen einer Sprachumgebung zuordnen, indem Sie die Variablen als Parameter in der Anweisung ENVIRONMENT angeben. Net.Data übergibt die in einer Anweisung ENVIRONMENT angegebenen Parameter implizit als Makrovariablen an die Sprachumgebung. Sie können im Makro den Wert eines Parameters ändern, der in einer Anweisung ENVIRONMENT angegeben ist, indem Sie entweder der Variablen mit der Funktion DTW_ASSIGN() einen Wert zuordnen oder die Variable in einem DEFINE-Abschnitt definieren.
Wichtig: Wird eine Variable in einem Makro definiert, aber nicht in der Anweisung ENVIRONMENT angegeben, wird die Makrovariable nicht an die Sprachumgebung übergeben.
Zum Beispiel kann ein Makro eine Variable DATABASE definieren, um den Namen einer Datenbank anzugeben, in der eine SQL-Anweisung innerhalb der Funktion DTW_SQL ausgeführt werden soll. Der Wert von DATABASE muss an die SQL-Sprachumgebung (DTW_SQL) übergeben werden, damit die SQL-Sprachumgebung die Verbindung zur angegebenen Datenbank herstellen kann. Zum Übergeben der Variablen an die Sprachumgebung müssen Sie die Variable DATABASE der Parameterliste in der Umgebungsanweisung für DTW_SQL hinzufügen.
Die Net.Data-Beispielinitialisierungsdatei geht beim Anpassen der Einstellungen der Anweisungen für die Net.Data-Umgebungskonfiguration von bestimmten Annahmen aus. Diese Annahmen sind für Ihre Umgebung eventuell nicht zutreffend. Ändern Sie die Anweisungen Ihrer Umgebung entsprechend.
Gehen Sie wie folgt vor, um eine Anweisung ENVIRONMENT hinzuzufügen oder zu aktualisieren:
Anweisungen ENVIRONMENT haben die folgende Syntax:
ENVIRONMENT(type) library_name (parameter_list, ...) [CLIETTE "cliette_name"]
Parameter:
Der Name, durch den Net.Data diese Sprachumgebung einem FUNCTION-Block zuordnet, der in einem Net.Data-Makro definiert ist. Sie müssen die Art der Sprachumgebung in einer FUNCTION-Blockdefinition angeben, um die Sprachumgebung zu definieren, in der Net.Data die Funktion ausführen soll.
Der Name der DLL-Datei oder gemeinsam benutzten Bibliothek mit den Schnittstellen für Sprachumgebungen, die Net.Data aufruft.
Die Liste der Parameter, die bei jedem Funktionsaufruf neben den Parametern, die in der FUNCTION-Blockdefinition angegeben sind, an die Sprachumgebung übergeben werden.
Definieren Sie die Variable im Makro, um die Variablen in der Parameterliste festzulegen und zu übergeben.
Sie müssen diese Parameter als Konfigurationsvariablen oder als Variablen in Ihrem Makro definieren, bevor Sie eine Funktion ausführen können, die von der Sprachumgebung verarbeitet wird. Das folgende Beispiel gibt die Variablen in der Anweisung ENVIRONMENT an:
ENVIRONMENT(DTW_SQL) C:\WINNT\System32\nddb2.dll(IN DATABASE,TRANSACTION_SCOPE,USERID,PASSWORD)
Wenn eine Funktion ihre Ausgabeparameter ändert, behalten die Parameter ihre geänderten Werte nach der Beendigung der Funktion bei.
Der Name der Cliette. cliette_name kann sich auf die Cliette für die Sprachumgebung der Java-Anwendung beziehen oder eine Datenbank-Cliette angeben. Der Parameter cliette_name wird zusammen mit dem Schlüsselwort CLIETTE verwendet, und beide sind nur bei Direktverbindungen gültig. CLIETTE und cliette_name sind optional und können nur für Sprachumgebungen von Datenbanken und Java-Anwendungen verwendet werden.
Syntax:
CLIETTE "DTW_JAVAPPS"
Syntax:
CLIETTE "type:db_name"
Parameter:
Wenn Net.Data die Initialisierungsdatei verarbeitet, werden die DLL-Dateien bzw. die gemeinsam benutzten Bibliotheken der Sprachumgebung nicht geladen. Net.Data lädt eine DLL-Datei bzw. eine gemeinsam benutzte Bibliothek, wenn es das erste Mal eine Funktion ausführt, die die betreffende Sprachumgebung angibt. Die DLL-Datei bzw. gemeinsam benutzte Bibliothek bleibt dann so lange geladen, wie Net.Data geladen ist.
Beispiel: Anweisungen ENVIRONMENT für von Net.Data bereitgestellte Sprachumgebungen
Beim Anpassen der Anweisungen ENVIRONMENT für Ihre Anwendung müssen Sie den Anweisungen ENVIRONMENT die Variablen hinzufügen, die von Ihrer Initialisierungsdatei an die Sprachumgebung übergeben werden müssen, oder die Net.Data-Makroprogrammierer zum Festlegen oder Überschreiben in ihren Makros benötigen.
ENVIRONMENT (DTW_SQL) /net.data/lib/dtwsql.so ( IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, ALIGN, START_ROW_NUM, DTW_SET_TOTAL_ROWS) CLIETTE "DTW_SQL:MYDBASE" ENVIRONMENT (DTW_ORA) /net.data/lib/dtwora.so ( IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, ALIGN, START_ROW_NUM, DTW_SET_TOTAL_ROWS) ENVIRONMENT (DTW_ODBC) /net.data/lib/dtwodbc.so ( IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, ALIGN, DTW_SET_TOTAL_ROWS) ENVIRONMENT (DTW_APPLET) /net.data/lib/dtwjava.so ( ) ENVIRONMENT (DTW_JAVAPPS) /net.data/lib/dtwjavapps.so ( OUT RETURN_CODE ) CLIETTE "DTW_JAVAPPS"ENVIRONMENT (DTW_PERL) /net.data/lib/dtwperl.so ( OUT RETURN_CODE ) ENVIRONMENT (DTW_REXX) /net.data/lib/dtwrexx.so ( OUT RETURN_CODE ) ENVIRONMENT (DTW_SYSTEM) dtwsys.so ( OUT RETURN_CODE ) ENVIRONMENT (HWS_LE) dtwhws.so ( OUT RETURN_CODE )
Wichtiger Hinweis: Jede Anweisung ENVIRONMENT muss in einer separaten Zeile stehen.