DTW_ACCEPT

AIX HP-UX Linux OS/2 OS/390 OS/400 PTX SUN Win NT





X


Purpose

Defines the transaction handle used to invoke a persistent macro.

Format

@DTW_ACCEPT(handle, timeout)

@DTW_ACCEPT(handle)

Parameters

Table 212. DTW_ACCEPT Parameters
Data Type Parameter Use Description
string handle IN A variable or literal string specifying a transaction handle to be used in URLs for subsequent macro invocations in this persistent transaction.
integer timeout IN A variable or literal string specifying an amount of time in seconds for the job servicing this port to wait for a response. This value overrides any timeout value specified on the DTW_STATIC() function.

Return Codes

Table 213. DTW_ACCEPT Return Codes
Return Code Explanation
-1001 The server could not process a Net.Data request to allocate memory.
1001 An input parameter contained a NULL value.
1003 An incorrect number of parameters were passed on a function call.
1005 A parameter passed on a function call, required to be a string variable, was of a different variable type.
1007 A parameter contains a value which is not valid.
8200 Macro persistence is not enabled.
8201 A persistent built-in function was called out of sequence.

Usage Notes

  1. Net.Data requires that the transaction handle be included in the URL that invokes the macro as a response from the Web browser. When a request comes in to the Web server, the server uses the transaction handle to route the request to the CGI process that is processing the transaction.

    The transaction handle must be called at the start of each HTML block in the macro until the last logical block, which contains a call to DTW_TERMINATE(). If either a call to DTW_ACCEPT() or DTW_TERMINATE() is not found before any text is output to the browser, a Net.Data error occurs.

  2. You can specify a timeout value for this page that overrides the timeout value specified on the @DTW_STATIC() function. The Web server waits for specified amount of time (in seconds) for the user to respond to this request.
  3. If this function is called when the macro is not in a persistent state, a Net.Data error occurs.
  4. The URLs containing the transaction handle can be coded as actions on form push buttons or as hypertext links on the page presented to the browser.

Examples

Example 1:

%DEFINE handle = ""
@DTW_RTVHANLDE(handle)
 
%HTML(REPORT){
@DTW_ACCEPT(handle)
 ...
%}


[ Top of Page | Previous Page | Next Page | Index ]