IBM Books

Reference

DTW_TERMINATE


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





X


Purpose

Ends a persistent transaction. All changes to resources under commitment control since the last commitment boundary are made permanent.

Format

@DTW_TERMINATE()

Parameters

None

Return Codes

Table 216. DTW_TERMINATE Return Codes

Return Code Explanation
-1001 The server could not process a Net.Data request to allocate memory.
1003 The number of parameters passed on a function call either exceeded the maximum number allowed, or was less than the minimum number required by the function.
8200 Macro persistence is not enabled.
8201 A persistent built-in function was called out of sequence.

Usage Notes

  1. The DTW_TERMINATE function is called at the start of the logical last HTML block of the persistent transaction before any text is output to the browser. If any text output appears before the function, within the block, a Net.Data error will occur. Note that there could be more than one logical last HTML block depending on how the application is written.
  2. If this function is called when the macro is not in a persistent state, a Net.Data error will occur.

Examples

Example 1: Terminates the persistent transaction

%HTML(QUIT){
@DTW_TERMINATE()
 ...
%}


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