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
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.
Examples
Example 1:
%DEFINE handle = "" @DTW_RTVHANLDE(handle) %HTML(REPORT){ @DTW_ACCEPT(handle) ... %}