Administration and Programming Guide for OS/400

Persistent Macro Syntax

Use the following syntax to invoke a persistent macro:

• HTML link:

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

• HTML form:

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

• URL:

  http://server/Net.Data_invocation_path/transaction_handle/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/.

transaction_handle

Specifies which URLs are part of a transaction initiated by a Net.Data macro. This identifier is obtained by calling the DTW_RTVHANDLE built-in function and must follow the Net.Data_invocation_path.

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.

method

Specifies the HTML method used with the form.

?name=val&...

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