Net.Data Administration and Programming Guide for OS/400

Invoking Net.Data with a Macro File (Macro Request)

This section shows you how to invoke Net.Data by specifying a macro file. For the macro request style of invocation, you can call Net.Data using an HTML link, an HTML form, or a URL.

The following syntax statements show the different ways you can invoke Net.Data.

• HTML link:

  <A HREF="http://server/Net.Data_invocation_path/filename/block/
  [?name=val&...]">any text</A>
  

• HTML form:

  <FORM METHOD=method ACTION="http://server/Net.Data_invocation_path/
  filename/block/[?name=val&...]">any text</FORM>
  

• URL:

  http://server/Net.Data_invocation_path/filename/block/[?name=val&...]
  

Parameters:

server

Specifies the name of the Web server. If the server is the local server, you can omit the server name and use a relative URL.

Net.Data_invocation_path

The path and filename of the Net.Data executable file. For example, /cgi-bin/db2www/.

filename

Specifies the name of the Net.Data macro file. Net.Data searches for and tries to match this file name with the path statements defined in the MACRO_PATH initialization path variable. See MACRO_PATH for more information.

block

Specifies the name of the HTML block in the referenced Net.Data macro file.

method

Specifies the HTML method used with the form. METHOD=POST is recommended.

?name=val&...

Specifies one or more optional parameters passed to Net.Data.

Examples

The following examples demonstrate the different methods of invoking Net.Data.

Example 1: Invoking Net.Data using an HTML link:

<A HREF="http://MyServer/cgi-bin/db2www/myMacro.d2w/report">
.
.
.
</A>
 

Example 2: Invoking Net.Data using a form

<FORM METHOD=POST
 ACTION="http://MyServer/cgi-bin/db2www/myMacro.d2w/report">
.
.
.
</FORM>
 

Example 3: Invoking Net.Data macros in the qsys.lib file system, using an HTML link:

<A HREF="http://MyServer/cgi-bin/db2www/myMacro.mbr/report">
.
.
.
</A>
 

Example 4: Invoking Net.Data macros in the qsys.lib file system, using a form:

<FORM METHOD=POST
  ACTION="http://MyServer/cgi-bin/db2www/
  qsys.lib/mylib.lib/myfile.file/myMacro.mbr/report">
.
.
.
</FORM>
 

The following sections describe HTML links and forms and more about how to invoke Net.Data with them:

• HTML Links
• HTML Forms