Indicates which iteration level corresponds to the buffer handle during a recursive FILL of a ProDataSet.

Data type: INTEGER

Access: Read-only

Applies to: Buffer object handle

As a recursive ProDataSet FILL is proceeding, it creates clones of the relevant buffers, relations, queries and data-sources for each level of recursion. As a new record is added to the ProDataSet, it fires FILL events on the recursed, cloned buffer. From inside the event handler, you may want to see previous iterations of the buffer; its parent, grandparent, great-grandparent, and so on. CURRENT-ITERATION returns the level of iteration for the cloned buffer handle. To refer to the cloned buffer handle, use SELF:CURRENT-ITERATION from within the BEFORE-ROW-FILL and AFTER-ROW-FILL event handlers.

If the buffer object handle does not point to a ProDataSet temp-table or is not part of a recursive data-relation, CURRENT-ITERATION returns the Unknown value (?).

See also

DEFINE DATASET statement, FILL( ) method, GET-ITERATION( ) method (Data Objects), NUM-ITERATIONS attribute (data objects), RECURSIVE attribute