Verwaltung und Programmierung

Anpassen der Net.Data-Initialisierungsdatei

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]


  • Die Zeilen 1 - 8 definieren Konfigurationsvariablen.
  • Die Zeilen 9 - 13 definieren Pfade zu Dateien, die zur Verarbeitung des
    Makros erforderlich sind.
  • Die Zeilen 14 - 25 definieren die verfügbaren
    ENVIRONMENT-Anweisungen.



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:

Folgende Änderungen müssen berücksichtigt werden, weil sich einige Konfigurationsstandardwerte geändert haben:

Konfigurationsvariablenanweisungen

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:

Konfigurationsvariablen für den Cache-Manager

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.

DTW_CACHE_PORT: Variable für Cache-Manager-Anschluss
Gibt den TCP/IP-Anschluss an, über den der Cache-Manager empfängt. Diese Anschlussnummer muss mit der Anschlussnummer übereinstimmen, die in der Konfigurationsdatei für den Cache-Manager angegeben ist, damit Net.Data mit dem Cache-Manager kommunizieren kann. Wenn diese Variable nicht angegeben wird, verwendet der Cache-Manager den Standardanschluss 7175.

Syntax:

DTW_CACHE_PORT [=] port_number

Parameter:

port_number
Eine eindeutige Anschlussnummer, die dem Cache-Manager zugeordnet ist, um Cache-Anforderungen zu bedienen. Der Standardwert ist 7175.

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.

DTW_CACHE_HOST: Variable für Cache-Manager-Maschinen-ID
Gibt die Maschine an, auf der sich der Cache-Manager befindet. Wenn diese Variable nicht angegeben wird, geht Net.Data davon aus, dass die korrekte Maschine die lokale Maschine ist.

Syntax:

DTW_CACHE_HOST [=] host_name

Parameter:

host_name
Der qualifizierte TCP/IP-Host-Name der lokalen oder fernen Maschine, auf der der Cache-Manager ausgeführt wird. Der Standardwert ist der Host-Name der lokalen Maschine.

DB2INSTANCE: Variable für DB2-Exemplar

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

DTW_CM_PORT: Variable für Anschlussnummer bei Direktverbindung

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.

DTW_DEFAULT_ERROR_MESSAGE: Angeben generischer Fehlernachrichten

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."

DTW_DIRECT_REQUEST: Variable zum Aktivieren der Direktanforderung

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:

YES
Aktiviert die Net.Data-Direktanforderung.

NO
Inaktiviert die Net.Data-Direktanforderung. Der Standardwert ist NO.

DTW_INST_DIR: Variable für Net.Data-Installationsverzeichnis

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.

HTML_PATH

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 und DTW_LOG_LEVEL: Fehlerprotokollvariablen

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: Variable für Fehlerprotokollstufe

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

DTW_MBMODE: Variable für Unterstützung der Landessprache

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

DTW_REMOVE_WS: Variable für das Entfernen von Leerzeichen

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

DTW_SHOWSQL: Konfigurationsvariable zum Aktivieren bzw. Inaktivieren von SHOWSQL

Überschreibt die Wirksamkeit der Einstellung SHOWSQL in Ihren Net.Data-Makros.

Syntax:

DTW_SHOWSQL [=] YES|NO

Dabei gilt Folgendes:

YES
Aktiviert SHOWSQL in einem Makro, das den Wert von SHOWSQL auf YES setzt.

NO
Inaktiviert SHOWSQL in Ihren Makros, selbst wenn die Variable SHOWSQL auf YES gesetzt ist. Der Standardwert ist NO.

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.

Tabelle 5. Die Beziehung zwischen den Einstellungen in der Net.Data-Initialisierungsdatei und dem Makro für SHOWSQL
Einstellung von DTW_SHOWSQL Einstellung SHOWSQL SQL-Anweisung angezeigt
NO NO NO
NO YES NO
YES NO NO
YES YES YES

DTW_SMTP_SERVER: Variable für E-Mail-SMTP-Server

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

DTW_UNICODE: Variable für Unicode

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:

NO
Gibt die Verwendung des Werts für die Variable DTW_MBMODE an. Tabelle 4 beschreibt Net.Data-Unterstützung basierend auf dem Wert von DTW_MBMODE.

UTF8
Gibt die Unterstützung der UTF-8-Codepage und das Ignorieren des Werts für die Konfigurationsvariable DTW_MBMODE an. UTF-8 stellt Zeichen durch eine unterschiedliche Anzahl von Byte dar und kann auch für das ASCII-Format sicher verwendet werden.

DTW_UPLOAD_DIR

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

DTW_USE_DB2_PREPARE_CACHE

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:

YES
Gibt an, dass Net.Data alle SQL-Anweisungen so ändert, dass der Vorbereitungs-Cache genutzt wird. Diese Funktion können Sie für eine bestimmte SQL-Anweisung inaktivieren, indem Sie die Makrovariable mit Hilfe von %DEFINE oder @DTW_ASSIGN() auf NO setzen.

NO
Gibt an, dass Net.Data die SQL-Anweisung unverändert lässt. Dies ist der Standardwert.

DTW_VARIABLE_SCOPE: Variable für Variablenbereich

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:

LOCAL
Gibt an, dass lokale Variablen nur lokal gültig sind. Dieses Verhalten wurde bei Net.Data Version 2.0 eingeführt und ist die Standardeinstellung.

GLOBAL
Gibt an, dass lokale Variablen außerhalb des Funktionsblocks, in dem sie erstellt wurden, verwendet werden können. Diese Variable wird für Abwärtskompatibilität mit früheren Versionen von Net.Data zur Verfügung gestellt; LOCAL wird als Einstellung empfohlen.

Pfadkonfigurationsanweisungen

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.

DTW_ATTACHMENT_PATH

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

EXEC_PATH

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:

FFI_PATH

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.

INCLUDE_PATH

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:

MACRO_PATH

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:

Umgebungskonfigurationsanweisungen

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:

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.


[ Seitenanfang | Vorherige Seite | Nächste Seite ]