DTW_RTVHANDLE

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)


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