Die Net.Data-Servlets können von einer URL-Adresse aus oder als SSI innerhalb einer HTML-Datei ausgeführt werden. Mit den Plug-Ins für NetObjects Fusion können Sie die Net.Data-Servlets in ihre NetObjects Fusion-Site aufnehmen. In den folgenden Abschnitten wird erläutert, wie Sie die Servlets durch Eingabe der entsprechenden Syntax für das Servlet ändern und ausführen können. Informationen zum Ändern und Ausführen der Servlets mit NetObjects Fusion finden Sie in Anhang C. Verwenden von Plug-Ins für NetObjects Fusion (NOF) mit Net.Data-Servlets.
Geben Sie unter Verwendung einer der folgenden Syntaxoptionen in einer HTML-Datei die Servlet-Parameter ein:
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet ?MACRO=makrowert&BLOCK=blockwert&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet?MACRO=my_macro &BLOCK=my_block&field1=custno
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="makrowert"> <param name="BLOCK" value="blockwert"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="my_macro.d2w"> <param name="BLOCK" value="report"> <param name="field1" value="custno"> </servlet>
Parameter:
<param name="field1" ...
... value="custno"
Parameter HTMLPATH: Wenn Sie eine Fehlernachricht erhalten, die auf einen fehlenden Parameter HTMLPATH hinweist, fügen Sie Ihrem Aufrufbefehl für das Servlet den Parameter HTMLPATH hinzu:
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet ?MACRO=makroname&BLOCK=blockwert&htmlpath=html_pfad&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet?MACRO=my_macro &BLOCK=my_blockhtmlpath=e:\html&field1=custno
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="makrowert"> <param name="BLOCK" value="blockwert"> <param name="htmlpath" value="html_pfad"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="my_makro"> <param name="BLOCK" value="my_block"> <param name="htmlpath" value="e:\html"> <param name="field1" value="custno"> </servlet>
Parameter INBUFLEN und OUTBUFLEN: Wenn Ihre Eingabe in die Makrodatei größer ist als 1 KB, müssen Sie den Parameter INBUFLEN angeben. Wenn die Ergebnisse Ihrer Makrodatei größer sind als 32 KB, müssen Sie den Parameter OUTBUFLEN angeben. Wenn diese Parameter erforderlich sind und nicht angegeben werden, kann dies unter Umständen zu unvorhersehbaren Ergebnissen führen.
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet ?MACRO=makroname&BLOCK=blockwert&INBUFLEN=eingabepuffergröße &OUTBUFLEN=ausgabepuffergröße&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet?MACRO=my_macro &BLOCK=my_blockINBUFLEN=3K&OUTBUFLEN=48K&field1=custno
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="makrowert"> <param name="BLOCK" value="blockwert"> <param name="INBUFLEN" value="eingabepuffergröße"> <param name="OUTBUFLEN" value="ausgabepuffergröße"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.MacroServlet"> <param name="MACRO" value="my_makro"> <param name="BLOCK" value="my_block"> <param name="INBUFLEN" value="3K"> <param name="OUTBUFLEN" value="48K"> <param name="field1" value="custno"> </servlet>
Das Funktions-Servlet kann Net.Data mit Hilfe einer Direktanforderung aufrufen, um eine Funktion (wie eine REXX-Funktion) oder eine SQL-Anweisung auszuführen. Die für das Servlet angegebenen Parameter hängen davon ab, ob Sie eine Funktion oder eine SQL-Anweisung ausführen. Geben Sie unter Verwendung einer der folgenden Syntaxoptionen in einer HTML-Datei die Servlet-Parameter ein:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=sprachumgebungsname&FUNC=programmname&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=DTW_REXX&FUNC=my_rexx&field1=custno
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=datenbanksprachumgebungsname&SQL=SQL_anweisung &DATABASE=datenbankname&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=DTW_SQL&SQL=select+*+from+myTable&DATABASE=CELDIAL
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="sprachumgebungsname"> <param name="FUNC" value="programmname"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="DTW_REXX"> <param name="FUNC" value="myREXX"> <param name="field1" value="custno"> </servlet>
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="sprachumgebungsname"> <param name="SQL" value="SQL_anweisungsname"> <param name="DATABASE" value="datenbankname"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="DTW_SQL"> <param name="SQL" value="select * from employee"> <param name="DATABASE" value="CELDIAL"> </servlet>
Parameter:
Parameter HTMLPATH: Wenn Sie eine Fehlernachricht erhalten, die auf einen fehlenden Parameter HTMLPATH hinweist, fügen Sie Ihrem Aufrufbefehl für das Servlet den Parameter HTMLPATH hinzu:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=sprachumgebungsname&FUNC=programmname&htmlpath=html_pfad &parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=DTW_REXX&FUNC=my_rexx&htmlpath=e:\html&field1=custno
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="sprachumgebungsname"> <param name="SQL" value="SQL_anweisungsname"> <param name="htmlpath" value="html_pfad"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="DTW_SQL"> <param name="SQL" value="select * from employee"> <param name="htmlpfad" value="e:\html"> <param name="field1" value="custno"> <param name="DATABASE" value="SAMPLE"> </servlet>
Dabei gibt html_pfad den Pfad zum HTML-Stammverzeichnis des Web-Servers an, zum Beispiel htmlpath=e:\html.
Parameter INBUFLEN und OUTBUFLEN: Wenn Ihre Eingabe in die Makrodatei größer ist als 1 KB, müssen Sie den Parameter INBUFLEN angeben. Wenn die Ergebnisse Ihrer Makrodatei größer sind als 32 KB, müssen Sie den Parameter OUTBUFLEN angeben. Wenn diese Parameter erforderlich sind und nicht angegeben werden, kann dies unter Umständen zu unvorhersehbaren Ergebnissen führen.
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet ?LANGENV=sprachumgebungsname&FUNC=programmname&INBUFLEN=eingabepuffergröße &OUTBUFLEN=ausgabepuffergröße&parmnn=wertnn
Beispiel:
http://myserver/servlet/com.ibm.netdata.servlets.FunctionServlet?LANGENV=DTW_REXX &FUNC=my_rexxINBUFLEN=3K&OUTBUFLEN=48K&field1=custno
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="sprachumgebungsname"> <param name="FUNC" value="programmname"> <param name="INBUFLEN" value="eingabepuffergröße"> <param name="OUTBUFLEN" value="ausgabepuffergröße"> <param name="parmnn" value="wertnn"> </servlet>
Beispiel:
<servlet code="com.ibm.netdata.servlets.FunctionServlet"> <param name="LANGENV" value="DTW_REXX"> <param name="FUNC" value="my_rexx"> <param name="INBUFLEN" value="3K"> <param name="OUTBUFLEN" value="48K"> <param name="field1" value="custno"> </servlet>