AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
|
|
|
|
| X |
|
|
|
Purpose
Generates and returns a transaction handle that is unique to this macro across separate invocations and is calculated based on a combination of thread information, timestamp, and current user.
Format
@DTW_RTVHANDLE(handle)
Parameters
Table 216. DTW_RTVHANDLE Parameters
Data Type | Parameter | Use | Description |
---|---|---|---|
string | handle | OUT | A variable that contains a unique transaction handle for the current persistent macro. |
Return Codes
Table 217. DTW_RTVHANDLE Return Codes
Return Code | Explanation |
---|---|
-1001 | The server could not process a Net.Data request to allocate memory. |
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. |
1006 | A literal string was passed on a function call for a parameter which was required to be an output parameter. |
Usage Notes
The transaction handle can be used to ensure that URLs specified as part of a persistent transaction are unique to the HTTP server and can be securely identified as valid requests.
Examples
Example 1: Defines the handle variable used to retrieve the transaction handle
%DEFINE handle = "" @DTW_RTVHANLDE(handle)