管理与程序设计指南

Net.Data 小服务程序

Net.Data 为小服务程序和 NetObjects Fusion 插件提供了可以在 Java 环境中使用 的 Net.Data 函数。使用了这些小服务程序和插件,您可以:

本节将描述以下小服务程序的主题:

关于 Net.Data 小服务程序

Net.Data 提供了小服务程序来帮助您开发和管理使用 Java 环境的宏。小服务程序 是一些 Java 类,它们执行类似于 CGI 程序或 Web 服务器 API 插件的功能。支持 Java 小服务程序 的 Web 服务器使用小服务程序来构建 HTML 页面。小服务程序没有它们自己的图形用户界面, 但它们的类却可以动态地装入或通过访问网络来装入,并且可以使用一个 URL 地址(远程)或由 一个类名来调用。小服务程序在 Windows NT 和 AIX 操作系统中可用。

Net.Data 小服务程序是基于 Java 的包装,它们使用本机的 DLL 文件运行 Net.Data 版本 2 宏或 直接请求。这些小服务程序允许您运行现有的宏 (MacroServlet) 或单独的 函数 (FunctionServlet)。要使用这些小服务程序,Net.Data 版本 2 是必需的。Net.Data 小服务程序可以运行 数据库语言环境或非数据库语言环境,还可以与 Live Connection 一起运行。

API 所附带的小服务程序是与应用程序一起使用的。小服务程序 API 的文档与 Net.Data 在一起。参见 <inst_dir>/servlets/NetDataServlets.jar 文件以获取 API 文档。

Net.Data 提供了两个小服务程序:

宏小服务程序 (com.ibm.netdata.servlets.MacroServlet)
执行现有的 Net.Data 宏。

使用宏小服务程序类似于通过 CGI-BIN 接口 来运行 Net.Data 宏,除了您通过 Java 小服务程序运行宏以外。宏小服务程序要求 安装 Net.Data 版本 2 或更高版本。

使用宏小服务程序的好处包括:

宏小服务程序还允许对多机种数据库(例如 DB2 和 Oracle)以及各种 语言环境(例如 Perl、REXX 和 Java)的本机访问。

函数小服务程序 (com.ibm.netdata.servlets.FunctionServlet)
通过小服务程序接口执行 Net.Data 函数或 SQL 语句,例如 %FUNCTION DTW_SQL()。参见不使用宏对 Net.Data 进行调用(直接请求)以获取更多信息。

函数小服务程序要求安装 Net.Data 版本 2。

运行 Net.Data 小服务程序

Net.Data 小服务程序可以从 URL 运行,也可以作为 HTML 文件内的 SSI 运行。可以 使用 NetObjects Fusion 插件将 Net.Data 小服务程序结合到您的 NOF 站点中。以下章节将讨论 如何通过输入小服务程序的语法来修改和运行小服务程序。参见附录 E, 使用 NetObjects Fusion NOF 插件和 Net.Data 小服务程序以学习 如何使用 NetObjects Fusion 来修改和运行小服务程序。

运行宏小服务程序

在 HTML 文件内,使用以下某个语法选项输入小服务程序参数:

  1. URL:
    http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet
      ?MACRO=macro_value&BLOCK=block_value&parmnn=valuenn
    

    例如:

     http://myserver/servlet/com.ibm.netdata.servlets.MacroServlet
      ?MACRO=my_macro&BLOCK=my_block&field1=custno
    
  2. SSI:
    <servlet code="com.ibm.netdata.servlets.MacroServlet">
         <param name="MACRO" value="macro_value">
          <param name="BLOCK" value="block_value">
    <param name="parmnn" value="valuenn">
    </servlet>
    

    例如:

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

参数:

macro_value
现有 Net.Data 宏的全限定路径

block_value
在指定的 Net.Data 宏中要执行的 HTML 块的名称;缺省为 report(可选)。

parmnn
宏所需要的任何附加参数,例如
<param name="field1" ...

valuenn
宏所需要的任何附加值,例如
... value="custnum"

HTMLPATH 参数:如果您获取一个指示丢失了 HTMLPATH参数 的错误信息,则向小服务程序调用命令中添加 HTMLPATH 参数:

OUTBUFLEN 参数:如果宏的结果大于 32 KB, 则需指定 OUTBUFLEN 参数。如果在必需的 时侯不能指定这些参数,则有可能导致不可预测的结果。

运行函数小服务程序

函数小服务程序可以使用直接请求调用 Net.Data 来执行函数(例如 REXX 函数)或 SQL 语句。对小服务程序指定的参数取决于您是在执行函数还是在执行 SQL 语句。在 HTML 文件内,使用以下某个语法选项输入小服务程序参数:

  1. 对于 URL:
  2. SSI:

参数:

lang_env_name
要调用来处理函数、SQL 语句或存储过程的 Net.Data 语言环境(例如 DTW_SQL、DTW_REXX)。此参数 要求使用 FUNC 或 SQL。

program_name
包含要执行的函数的程序名。例如 my_rexx,其中 my_rexx 是 REXX 可执行程序的名称。使 用 parmnnvaluenn 参数来为函数指定输入参数。

database_name
与 DATABASE 参数相关联的数据库的名称。指定的

SQL_stmt_name
访问数据库的 SQL 语句或存储过程名。例如,"select * from employee"。使用 parmnnvaluenn 参数来为 SQL 语句或存储过程 指定输入参数。

parmnn
宏所需要的任何附加参数,例如 <param name="field1" ...

valuenn
宏所需要的任何附加值,例如 ... value="custnum"

HTMLPATH 参数:如果您获取一个指示丢失了 HTMLPATH 参数 的错误信息,则向小服务程序调用命令中添加 HTMLPATH 参数:

其中 html_path 指定了 Web 服务器根 HTML 目录的路径; 例如:htmlpath=e:\html

OUTBUFLEN 参数:如果宏的结果大于 32 KB, 则必须指定 OUTBUFLEN 参数。如果在必需的 时侯不能指定这些参数,则有可能导致不可预测的结果。


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]