BlockManager (P2J - Progress 4GL to Java Conversion and Runtime)

java.lang.Object
- com.goldencode.p2j.util.BlockManager

```
public class BlockManager
extends java.lang.Object
```
Provides an external API that allows the Progress-compatible code block semantics to be provided with a minimum of code in the caller. This class encodes the "scaffolding" necessary to properly process code blocks with the right behavior. The external interface is designed to be statically imported to make access simple, short and easy to read. The API has been designed to minimize name conflicts. The scaffolding code uses the TransactionManager extensively to implement the proper behavior.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`BlockManager.Action` Encodes the possible actions in response to given conditions.
`(package private) static class`	`BlockManager.BlockManagerHelper` Helper to expose state in a way that avoids context local lookups.
`static class`	`BlockManager.Condition` Encodes the possible condition types.
`private static class`	`BlockManager.ContextContainer` Simple container that stores and returns a context-local instance of the global work area.
`private static class`	`BlockManager.Disposition` Encodes the possible responses to a flow control event.
`(package private) static class`	`BlockManager.ReturnType` Encodes the possible types of return statement.
`private static class`	`BlockManager.StatsHelper` Server-wide hook that gets called at initialization and termination.
`static class`	`BlockManager.TransactionType` Encodes the possible levels of transaction support for each block.
`private static class`	`BlockManager.WorkArea` Stores global data relating to the state of the current context's blocks.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CATCH_BLOCK_LABEL` The fixed label of all CATCH: blocks.
`static java.lang.String`	`FINALLY_BLOCK_LABEL` The fixed label of all FINALLY: blocks.
`private static CentralLogger`	`LOG` Logger
`private static java.lang.Object`	`NULL` Synthetic null value to use in a deque which doesn't accept null values.
`private static java.util.Map<java.lang.String,java.util.concurrent.atomic.AtomicInteger>`	`stats` Stores calls execution statistics.
`private static java.lang.String`	`STATS_FILE` Directory entry to define an execution statistics output file.
`private static java.lang.String`	`statsFile` Output filename in which to write execution statistics.
`private static java.util.Map<java.lang.String,java.util.concurrent.atomic.AtomicLong>`	`times` Stores timing execution statistics.
`private static BlockManager.ContextContainer`	`work` Stores context-local state variables.

Constructor Summary

Constructors
Constructor and Description

BlockManager()

Constructors
Constructor and Description
`BlockManager()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`catchBlock(Block block)` Execute the default block associated with a `CATCH` statement.
`static <T extends LegacyError> void`	`catchError(java.lang.Class<T> type, java.util.function.Consumer<object<T>> catchBlock)` The CATCH statement.
`(package private) static boolean`	`checkFunctionReturn(java.util.function.Function<java.lang.Object,java.lang.Boolean> func)` Check the `BlockManager.WorkArea.funcRet` stack for the supplied condition.
`private static java.lang.Boolean`	`checkJavaCall(BlockManager.WorkArea wa, java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, Block block, boolean function, boolean externalProgram, boolean persistentProc)` Check if we this call is a java-style call or is from `ControlFlowOps` APIs.
`private static int`	`conditionMask(BlockManager.Condition cond)` Matches a `Condition` with its corresponding `TransactionManager` constant.
`private static int`	`convertTransType(BlockManager.TransactionType ttype, BlockType btype)` Helper to convert between this class' enum and the corresponding `TransactionManager` constants.
`private static void`	`coreLoop(BlockType btype, boolean next, BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, OnPhrase[] defOn, Block block)` Execute a DO or REPEAT loop with all possible loop constructs, the given configuration and with default properties.
`private static int`	`decodeConditions(OnPhrase[] user, OnPhrase[] def)` Encode the conditions supported by this block as a bitfield.
`static boolean`	`deferredLeave(java.lang.String label)` Detect if there is a pending leave for the block named by the given label.
`private static boolean`	`deferredLeaveWorker(BlockManager.WorkArea wa, java.lang.String label)` Detect if there is a pending leave for the block named by the given label.
`static boolean`	`deferredNext(java.lang.String label)` Detect if there is a pending next for the block named by the given label.
`private static boolean`	`deferredNextWorker(BlockManager.WorkArea wa, java.lang.String label)` Detect if there is a pending next for the block named by the given label.
`static void`	`doBlock(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a simple DO block (not a loop) with the given configuration and no user-defined or default properties.
`static void`	`doBlock(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`static void`	`doBlock(BlockManager.TransactionType lvl, java.lang.String label, Block block)` Execute a simple DO block (not a loop) with the given configuration and no user-defined or default properties.
`static void`	`doBlock(BlockManager.TransactionType lvl, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`static void`	`doBlock(java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`static void`	`doBlock(java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`static void`	`doBlock(java.lang.String label, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`static void`	`doBlock(java.lang.String label, OnPhrase[] on, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`private static void`	`doBlockWorker(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple DO block (not a loop) with the given configuration and no default properties.
`private static void`	`doLoopWorker(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`private static void`	`doTerminationBlockWorker(BlockManager.WorkArea wa, BlockManager.TransactionType lvl, java.lang.String label, boolean finBlock, Block block)` Execute a a termination block like CATCH and FINALLY, emulating `doBlockWorker(com.goldencode.p2j.util.BlockManager.TransactionType, java.lang.String[], java.lang.String, com.goldencode.p2j.util.OnPhrase[], com.goldencode.p2j.util.Block)`.
`static void`	`doTo(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a DO TO expression loop with the given configuration and no user-defined or default properties.
`static void`	`doTo(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doTo(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, Block block)` Execute a DO TO expression loop with the given configuration and no user-defined or default properties.
`static void`	`doTo(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doTo(java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doTo(java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doTo(java.lang.String label, ToClause to, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doTo(java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a DO TO expression loop with the given configuration and no default properties.
`static void`	`doToWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doToWhile(java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a DO WHILE expression loop with the given configuration and no user-defined or default properties.
`static void`	`doWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(BlockManager.TransactionType lvl, java.lang.String label, LogicalOp expr, Block block)` Execute a DO WHILE expression loop with the given configuration and no user-defined or default properties.
`static void`	`doWhile(BlockManager.TransactionType lvl, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(java.lang.String label, LogicalOp expr, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`static void`	`doWhile(java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a DO WHILE expression loop with the given configuration and no default properties.
`private static void`	`dumpExecutionStats()` Generates a CSV file with the recorded execution statistics.
`private static void`	`editingBlock(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block, int etype)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`(package private) static BlockManager.Condition`	`exceptionToCondition(ConditionException ce)` Translate exception into `BlockManager.Condition` code.
`private static void`	`executeStateManaged(BlockManager.WorkArea wa, java.lang.Runnable code)` Preserve certain work area state before running the given code and then restore that state afterward.
`private static void`	`exitTopLevel(BlockManager.WorkArea wa)` Common worker to cleanup top-level block state just before exiting.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, int extent, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, int extent, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<T> cls, int extent, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Class<T> cls, int extent, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, int extent, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns a dynamic extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.String legacyName, java.lang.Class<T> cls, int extent, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`, which returns an extent value.
`static <T extends BaseDataType> T[]`	`extentFunction(java.lang.String legacyName, java.lang.Class<T> cls, int extent, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level, which returns an extent value.
`static void`	`externalProcedure(Block block)` Execute the given external procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`externalProcedure(BlockManager.TransactionType lvl, Block block)` Execute the given external procedure block with the given transaction level.
`static void`	`externalProcedure(java.lang.Class<?> def, java.lang.Object referent, Block block)` Execute the given external procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`externalProcedure(java.lang.Class<?> def, java.lang.Object referent, BlockManager.TransactionType lvl, Block block)` Execute the given external procedure block with the given transaction level.
`static void`	`externalProcedure(java.lang.Object referent, Block block)` Execute the given external procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`externalProcedure(java.lang.Object referent, BlockManager.TransactionType lvl, Block block)` Execute the given external procedure block with the given transaction level.
`static void`	`forBlock(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(P2JQuery query, int direction, java.lang.String label, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlock(P2JQuery query, int direction, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
`static void`	`forBlockTo(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and no user-defined or default properties.
`static void`	`forBlockTo(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockTo(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, ToClause to, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and no user-defined or default properties.
`static void`	`forBlockTo(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockTo(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockTo(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockTo(P2JQuery query, int direction, java.lang.String label, ToClause to, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockTo(P2JQuery query, int direction, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
`static void`	`forBlockToWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(P2JQuery query, int direction, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockToWhile(P2JQuery query, int direction, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and no user-defined or default properties.
`static void`	`forBlockWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and no user-defined or default properties.
`static void`	`forBlockWhile(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(P2JQuery query, int direction, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`static void`	`forBlockWhile(P2JQuery query, int direction, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
`private static void`	`forBlockWorker(BlockManager.TransactionType lvl, P2JQuery query, int direction, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and with default properties.
`static void`	`forEach(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(P2JQuery query, java.lang.String label, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEach(P2JQuery query, java.lang.String label, OnPhrase[] on, Block block)` Execute a FOR EACH loop with the given configuration and default properties.
`static void`	`forEachTo(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a FOR EACH TO block with the given configuration and no user-defined or default properties.
`static void`	`forEachTo(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachTo(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, ToClause to, Block block)` Execute a FOR EACH TO block with the given configuration and no user-defined or default properties.
`static void`	`forEachTo(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachTo(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachTo(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachTo(P2JQuery query, java.lang.String label, ToClause to, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachTo(P2JQuery query, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a FOR EACH TO block with the given configuration and default properties.
`static void`	`forEachToWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(P2JQuery query, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachToWhile(P2JQuery query, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block with the given configuration and no user-defined or default properties.
`static void`	`forEachWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block with the given configuration and no user-defined or default properties.
`static void`	`forEachWhile(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(P2JQuery query, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(P2JQuery query, java.lang.String label, LogicalOp expr, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`static void`	`forEachWhile(P2JQuery query, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH WHILE block with the given configuration and default properties.
`private static void`	`forEachWorker(BlockManager.TransactionType lvl, P2JQuery query, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a FOR EACH, FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and with default properties.
`static <T extends BaseDataType> T`	`function(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`.
`static <T extends BaseDataType> T`	`function(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level.
`static <T extends BaseDataType> T`	`function(java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`.
`static <T extends BaseDataType> T`	`function(java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level.
`static <T extends BaseDataType> T`	`function(java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`.
`static <T extends BaseDataType> T`	`function(java.lang.Object referent, java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level.
`static <T extends BaseDataType> T`	`function(java.lang.String legacyName, java.lang.Class<T> cls, Block block)` Execute the given function block with a default transaction level of `TransactionType.SUB`.
`static <T extends BaseDataType> T`	`function(java.lang.String legacyName, java.lang.Class<T> cls, BlockManager.TransactionType lvl, Block block)` Execute the given function block with the given transaction level.
`private static <T extends BaseDataType> java.lang.Object`	`functionBlock(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, BlockManager.TransactionType level, Block block, java.lang.Class<T> retType, int extent)` Execute the given function block with the given transaction level.
`(package private) static java.lang.Object`	`getFunctionReturn()` Get the function's return value.
`(package private) static BlockManager.BlockManagerHelper`	`getHelper()` Get an instance of `ProcedureManager.ProcedureHelper`, which has the context-local instance saved, so API access can be done without a context-local query.
`(package private) static BlockManager.ReturnType`	`getReturnType()` Returns the type of return processing from the nearest top-level block.
`private static boolean`	`hasLegacyError(BlockManager.WorkArea wa, java.lang.Class<? extends LegacyError> type, int levels)` Check if any CATCH blocks defined at the specified enclosing block can manage this exception.
`(package private) static boolean`	`hasLegacyError(java.lang.Class<? extends LegacyError> type, int levels)` Check if any CATCH blocks defined at the specified enclosing block can manage this exception.
`(package private) static void`	`ignoreNextCall(java.lang.Runnable abend)` Register the abend code to be executed when the next top-level block needs to be invoked, as the argument assignment failed.
`static void`	`internalProcedure(Block block)` Execute the given internal procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`internalProcedure(BlockManager.TransactionType lvl, Block block)` Execute the given internal procedure block with the given transaction level.
`static void`	`internalProcedure(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, Block block)` Execute the given internal procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`internalProcedure(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, BlockManager.TransactionType lvl, Block block)` Execute the given internal procedure block with the given transaction level.
`static void`	`internalProcedure(java.lang.Object referent, java.lang.String legacyName, Block block)` Execute the given internal procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`internalProcedure(java.lang.Object referent, java.lang.String legacyName, BlockManager.TransactionType lvl, Block block)` Execute the given internal procedure block with the given transaction level.
`static void`	`internalProcedure(java.lang.String legacyName, Block block)` Execute the given internal procedure block with a default transaction level of `TransactionType.SUB`.
`static void`	`internalProcedure(java.lang.String legacyName, BlockManager.TransactionType lvl, Block block)` Execute the given internal procedure block with the given transaction level.
`private static boolean`	`isNormal(BlockManager.WorkArea wa, java.lang.Throwable thr, OnPhrase[] on)` Detect if an exception represents a normal or abnormal condition.
`private static boolean`	`isPersistentTriggerTopLevel(BlockManager.WorkArea wa)` Check if we are on the top level of a persistent trigger.
`static void`	`leave()` Break out of the nearest enclosing block.
`private static void`	`leave(BlockManager.WorkArea wa, java.lang.String label)` Break out of the block associated with the given label.
`static void`	`leave(java.lang.String label)` Break out of the block associated with the given label.
`private static void`	`markReturnError(BlockManager.WorkArea wa)` Mark all blocks on the stack enclosed in this this top-level block (including it), as `BlockDefinition.wasReturnError`.
`private static OnPhrase`	`matchCondition(OnPhrase[] user, OnPhrase[] def, BlockManager.Condition cond)` Find a matching condition in the user-defined on phrases or the default on phrases for the block and return the on phrase that is matched.
`private static boolean`	`matches(java.lang.String[] list, java.lang.String entry)` Given a list of strings, detect if the given entry matches (case sensitively) any of the elements in the list.
`(package private) static boolean`	`mustManageLegacyError()` Check if the top-level block is ROUTINE-LEVEL UNDO, THROW or the current program is BLOCK-LEVEL UNDO, THROW.
`(package private) static boolean`	`mustManageLegacyError(BlockManager.WorkArea wa)` Check if the top-level block is ROUTINE-LEVEL UNDO, THROW or the current program is BLOCK-LEVEL UNDO, THROW.
`(package private) static boolean`	`mustThrowLegacyError(BlockManager.WorkArea wa, java.lang.Class<? extends LegacyError> errorClass)` Check if we must throw a legacy compatible OO error.
`(package private) static boolean`	`mustThrowLegacyError(java.lang.Class<? extends LegacyError> errorClass)` Check if we must throw a legacy compatible OO error.
`private static boolean`	`needsIterate(ToClause to, LogicalOp expr)` Test the given expressions to determine if the calling loop should iterate or if the loop should exit.
`static void`	`next()` Continue (iterate) the nearest enclosing block.
`private static void`	`next(BlockManager.WorkArea wa, java.lang.String label)` Continue (iterate) the block associated with the given label.
`static void`	`next(java.lang.String label)` Continue (iterate) the block associated with the given label.
`static void`	`onBlockLevel(BlockManager.Condition condition, BlockManager.Action action)` API for BLOCK-LEVEL ON ERROR UNDO,THROW statement.
`static void`	`onRoutineLevel(BlockManager.Condition condition, BlockManager.Action action)` API for ROUTINE-LEVEL ON ERROR UNDO,THROW statement.
`private static void`	`processBody(BlockManager.WorkArea wa, Block block, OnPhrase[] on, OnPhrase[] defOn)` Implements the body of all blocks or loops that are not related to the `FOR` language statement.
`static void`	`processCatch(Body body)` Execute the given catch block as if it was a simple DO block.
`private static BlockManager.Disposition`	`processCondition(BlockManager.WorkArea wa, OnPhrase[] user, OnPhrase[] def, ConditionException ce, java.lang.String[] enclosing, java.lang.String label)` Core worker to handle all the possible behavior in response to a condition being raised in an inner block (DO, REPEAT or FOR).
`private static boolean`	`processForBody(BlockManager.WorkArea wa, Block block, ToClause to, LogicalOp expr, OnPhrase[] on, OnPhrase[] defOn)` Implements the body of all `FOR` language statement blocks or loops.
`private static void`	`processLegacyError(BlockManager.WorkArea wa, LegacyErrorException lex, OnPhrase[] on, OnPhrase[] defOn)` Check if any CATCH blocks defined at the current enclosing block can manage this exception.
`private static void`	`processLegacyException(BlockManager.WorkArea wa, LegacyErrorException e)` Make sure that the legacy exception is honoring the roll-back of transactions in the current block.
`static void`	`promptForEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`promptForEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `PROMPT-FOR` semanics.
`static void`	`quit()` Raise the QUIT condition and cause control to be transferred to the nearest enclosing block that handles the associated condition.
`private static void`	`recordExecutionStats(BlockType type, Block block, long start)` Update block execution statistics for the given block instance.
`static void`	`repeat(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(BlockManager.TransactionType lvl, java.lang.String label, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(BlockManager.TransactionType lvl, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(java.lang.String[] enclosing, java.lang.String label, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(java.lang.String[] enclosing, java.lang.String label, OnPhrase[] on, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(java.lang.String label, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeat(java.lang.String label, OnPhrase[] on, Block block)` Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
`static void`	`repeatTo(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a REPEAT TO expression loop with the given configuration and no user-defined or default properties.
`static void`	`repeatTo(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatTo(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, Block block)` Execute a REPEAT TO expression loop with the given configuration and no user-defined or default properties.
`static void`	`repeatTo(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatTo(java.lang.String[] enclosing, java.lang.String label, ToClause to, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatTo(java.lang.String[] enclosing, java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatTo(java.lang.String label, ToClause to, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatTo(java.lang.String label, ToClause to, OnPhrase[] on, Block block)` Execute a REPEAT TO expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(BlockManager.TransactionType lvl, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(java.lang.String label, ToClause to, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatToWhile(java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and no user-defined or default properties.
`static void`	`repeatWhile(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(BlockManager.TransactionType lvl, java.lang.String label, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and no user-defined or default properties.
`static void`	`repeatWhile(BlockManager.TransactionType lvl, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(java.lang.String[] enclosing, java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(java.lang.String label, LogicalOp expr, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`static void`	`repeatWhile(java.lang.String label, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT WHILE expression loop with the given configuration and default properties.
`private static void`	`repeatWorker(BlockManager.TransactionType lvl, java.lang.String[] enclosing, java.lang.String label, ToClause to, LogicalOp expr, OnPhrase[] on, Block block)` Execute a REPEAT, REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and with default properties.
`static void`	`returnConsume()` Return from the nearest enclosing top-level block.
`static void`	`returnConsume(character val)` Return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`returnConsume(java.lang.String val)` Return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`returnError()` Return from the nearest enclosing top-level block.
`static void`	`returnError(character val)` Return from the nearest enclosing top-level block.
`static void`	`returnError(object<? extends LegacyError> error)` Return from the nearest enclosing top-level block by throwing the specified legacy error.
`static void`	`returnError(java.lang.String val)` Return from the nearest enclosing top-level block.
`static void`	`returnExtentNormal(BaseDataType[] val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal()` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(BaseDataType val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(boolean val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(double val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(int val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(long val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(java.lang.String val)` Return from the nearest enclosing top-level block.
`static void`	`returnNormal(WrappedResource val)` Return from the nearest enclosing top-level block.
`private static void`	`returnWorker(BaseDataType val, BlockManager.ReturnType rtype)` Return from the nearest enclosing top-level block.
`private static void`	`returnWorker(BlockManager.WorkArea wa, java.lang.Object val, BlockManager.ReturnType rtype)` Return from the nearest enclosing top-level block.
`static void`	`setEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`static void`	`setEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `SET` semanics.
`private static void`	`setFuncReturn(java.lang.Object bdt, BlockManager.WorkArea wa, BlockType nearest)` Set the return value for the nearest enclosing function.
`private static boolean`	`setReturnValue(BlockManager.WorkArea wa, LegacyError err)` If the error referenced is an `AppError`, then also set the `RETURN-VALUE`.
`static void`	`stop()` Raise the STOP condition and cause control to be transferred to the nearest enclosing block that handles the associated condition.
`static void`	`stopAfter(long val)` Offers runtime support for stop-after statement for Progress blocks.
`static void`	`stopAfter(NumberType val)` Offers runtime support for stop-after statement for Progress blocks.
`static void`	`storeExtentReturnValue(BaseDataType[] val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue()` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(BaseDataType val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(boolean val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(double val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(int val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(long val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(java.lang.String val)` Return from the nearest enclosing top-level block.
`static void`	`storeReturnValue(WrappedResource val)` Return from the nearest enclosing top-level block.
`private static BlockManager.Disposition`	`testLeave(BlockManager.WorkArea wa, java.lang.String[] enclosing, java.lang.String label)` Detect if the leave event is referencing this block OR if it is referencing a directly enclosing block which is not managed by this class.
`private static BlockManager.Disposition`	`testNext(BlockManager.WorkArea wa, java.lang.String[] enclosing, java.lang.String label)` Detect if the next event is referencing this block OR if it is referencing a directly enclosing block which is not managed by this class.
`(package private) static void`	`topLevelBlock(java.lang.Class<?> def, java.lang.Object referent, java.lang.String legacyName, BlockManager.TransactionType lvl, BlockType btype, Block block)` Execute the given top-level block with the given transaction level.
`private static BlockType`	`topLevelType(BlockManager.WorkArea wa)` Accesses the type of the nearest enclosing top level block.
`static void`	`trigger(Block block)` Execute the given trigger block as a SUB-transaction.
`static void`	`undoLeave()` Trigger a rollback of the current block and then leave that block.
`static void`	`undoLeave(java.lang.String label)` Trigger a rollback of the given block and then leave that block.
`static void`	`undoLeave(java.lang.String undo, java.lang.String leave)` Trigger a rollback of the given block and then leave that block or a more enclosing block.
`static void`	`undoNext()` Trigger a rollback of the current block and then iterate that block.
`static void`	`undoNext(java.lang.String label)` Trigger a rollback of the given block and then iterate that block.
`static void`	`undoNext(java.lang.String undo, java.lang.String next)` Trigger a rollback of the given block and then iterate that block or a more enclosing block.
`static void`	`undoRetry()` Trigger a rollback of the current block and then retry that block.
`static void`	`undoRetry(java.lang.String label)` Trigger a rollback of the given block and then retry that block.
`static void`	`undoRetryTopLevel()` Trigger a rollback of the nearest enclosing top-level block and then retry that block.
`static void`	`undoReturnConsume()` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnConsume(character val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`undoReturnConsume(java.lang.String label)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnConsume(java.lang.String label, character val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`undoReturnConsume(java.lang.String label, java.lang.String val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`undoReturnConsumeTopLevel()` Trigger a rollback of and then return from the nearest enclosing top-level block.
`static void`	`undoReturnConsumeTopLevel(character val)` Trigger a rollback of and then return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`undoReturnConsumeTopLevel(java.lang.String val)` Trigger a rollback of and then return from the nearest enclosing top-level block, consuming any pending event processing.
`static void`	`undoReturnError()` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnError(character val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnError(java.lang.String label)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnError(java.lang.String label, character val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnError(java.lang.String label, java.lang.String val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnErrorTopLevel()` Trigger a rollback of and then return from the nearest enclosing top-level block.
`static void`	`undoReturnErrorTopLevel(character val)` Trigger a rollback of and then return from the nearest enclosing top-level block.
`static void`	`undoReturnErrorTopLevel(java.lang.String val)` Trigger a rollback of and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal()` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(BaseDataType val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(boolean val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(double val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(int val)` Trigger a rollback of the current block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label, BaseDataType val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label, boolean val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label, double val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label, int val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormal(java.lang.String label, java.lang.String val)` Trigger a rollback of the given block and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormalTopLevel()` Trigger a rollback and then return from the nearest enclosing top-level block.
`static void`	`undoReturnNormalTopLevel(BaseDataType val)` Trigger a rollback of the nearest enclosing top-level block and then return from that block.
`static void`	`undoReturnNormalTopLevel(boolean val)` Trigger a rollback of the nearest enclosing top-level block and then return from that block.
`static void`	`undoReturnNormalTopLevel(double val)` Trigger a rollback of the nearest enclosing top-level block and then return from that block.
`static void`	`undoReturnNormalTopLevel(int val)` Trigger a rollback of the nearest enclosing top-level block and then return from that block.
`static void`	`undoReturnNormalTopLevel(java.lang.String val)` Trigger a rollback of the nearest enclosing top-level block and then return from that block.
`static void`	`undoThrow(object<? extends LegacyError> error)` Trigger a rollback of the current block and then throw a legacy condition.
`static void`	`undoThrowTopLevel(object<? extends LegacyError> error)` Trigger a rollback of the current block and then throw a legacy condition.
`static void`	`updateEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditing(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditing(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, EventList goOn, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String[] enclosing, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.
`static void`	`updateEditingUnlessHidden(CommonFrame frame, FrameElement[] widgets, java.lang.String label, Block block)` Execute the given editing block for the given frame and widget list with `UPDATE` semanics.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LOG
```
private static final CentralLogger LOG
```
    Logger
  - work
```
private static final BlockManager.ContextContainer work
```
    Stores context-local state variables.
  - FINALLY_BLOCK_LABEL
```
public static final java.lang.String FINALLY_BLOCK_LABEL
```
    The fixed label of all FINALLY: blocks.
    
    See Also:
    
    Constant Field Values
  - CATCH_BLOCK_LABEL
```
public static final java.lang.String CATCH_BLOCK_LABEL
```
    The fixed label of all CATCH: blocks.
    
    See Also:
    
    Constant Field Values
  - STATS_FILE
```
private static final java.lang.String STATS_FILE
```
    Directory entry to define an execution statistics output file.
    
    See Also:
    
    Constant Field Values
  - NULL
```
private static final java.lang.Object NULL
```
    Synthetic null value to use in a deque which doesn't accept null values.
  - statsFile
```
private static java.lang.String statsFile
```
    Output filename in which to write execution statistics.
  - stats
```
private static java.util.Map<java.lang.String,java.util.concurrent.atomic.AtomicInteger> stats
```
    Stores calls execution statistics.
  - times
```
private static java.util.Map<java.lang.String,java.util.concurrent.atomic.AtomicLong> times
```
    Stores timing execution statistics.
- Constructor Detail
  - BlockManager
```
public BlockManager()
```
- Method Detail
  - onRoutineLevel
```
public static void onRoutineLevel(BlockManager.Condition condition,
                                  BlockManager.Action action)
```
    API for ROUTINE-LEVEL ON ERROR UNDO,THROW statement.
    This will change the default ON ERROR from UNDO, RETRY to UNDO, THROW for all routines in this procedure or class (including its 'execute' method).
    This includes:
    - external program
    - internal procedures
    - functions
    - user-defined functions
    - class methods
    - class constructors (but not destructors) - including static
    - class property getter/setter - including static
    - schema trigger programs - including static
    TODO: does this affect super-classes, in case of OO instances?
    Parameters:
    
    condition - ERROR.
    
    action - THROW.
  - onBlockLevel
```
public static void onBlockLevel(BlockManager.Condition condition,
                                BlockManager.Action action)
```
    API for BLOCK-LEVEL ON ERROR UNDO,THROW statement.
    This will change the default ON ERROR from UNDO, RETRY to UNDO, THROW for all routines in this procedure or class (including its 'execute' method).
    This includes:
    - external program
    - internal procedures
    - functions
    - user-defined functions
    - class methods
    - class constructors (but not destructors) - including static
    - class property getter/setter - including static
    - schema trigger programs - including static
    - REPEAT, FOR, DO TRANSACTION blocks
    TODO: does this affect super-classes, in case of OO instances?
    Parameters:
    
    condition - ERROR.
    
    action - THROW.
  - stopAfter
```
public static void stopAfter(NumberType val)
```
    Offers runtime support for stop-after statement for Progress blocks.
    
    Parameters:
    
    val - The number of seconds to wait before raising a QUIT.
  - stopAfter
```
public static void stopAfter(long val)
```
    Offers runtime support for stop-after statement for Progress blocks.
    
    Parameters:
    
    val - The number of seconds to wait before raising a QUIT.
  - externalProcedure
```
public static void externalProcedure(Block block)
```
    Execute the given external procedure block with a default transaction level of TransactionType.SUB.
    This form may only be used with block instances that are anonymous inner classes since the containing business logic class can be calculated using reflection. Any usage with lambdas will fail!
    
    Parameters:
    
    block - The code to execute.
  - externalProcedure
```
public static void externalProcedure(BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given external procedure block with the given transaction level.
    This form may only be used with block instances that are anonymous inner classes since the containing business logic class can be calculated using reflection. Any usage with lambdas will fail!
    
    Parameters:
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - externalProcedure
```
public static void externalProcedure(java.lang.Object referent,
                                     Block block)
```
    Execute the given external procedure block with a default transaction level of TransactionType.SUB.
    This form is suitable for use with lambdas but in such a case the referent must be non-null.
    
    Parameters:
    
    referent - The instance of the containing business logic class from which this is being called. If this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection.
    
    block - The code to execute.
  - externalProcedure
```
public static void externalProcedure(java.lang.Object referent,
                                     BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given external procedure block with the given transaction level.
    This form is suitable for use with lambdas but in such a case the referent must be non-null.
    
    Parameters:
    
    referent - The instance of the containing business logic class from which this is being called. If this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - externalProcedure
```
public static void externalProcedure(java.lang.Class<?> def,
                                     java.lang.Object referent,
                                     Block block)
```
    Execute the given external procedure block with a default transaction level of TransactionType.SUB.
    This form is suitable for use with lambdas but in such a case the referent must be non-null.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The instance of the containing business logic class from which this is being called. If this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection.
    
    block - The code to execute.
  - externalProcedure
```
public static void externalProcedure(java.lang.Class<?> def,
                                     java.lang.Object referent,
                                     BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given external procedure block with the given transaction level.
    This form is suitable for use with lambdas but in such a case the referent must be non-null.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The instance of the containing business logic class from which this is being called. If this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(Block block)
```
    Execute the given internal procedure block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given internal procedure block with the given transaction level.
    
    Parameters:
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.String legacyName,
                                     Block block)
```
    Execute the given internal procedure block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.String legacyName,
                                     BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given internal procedure block with the given transaction level.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.Object referent,
                                     java.lang.String legacyName,
                                     Block block)
```
    Execute the given internal procedure block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.Object referent,
                                     java.lang.String legacyName,
                                     BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given internal procedure block with the given transaction level.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.Class<?> def,
                                     java.lang.Object referent,
                                     java.lang.String legacyName,
                                     Block block)
```
    Execute the given internal procedure block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    block - The code to execute.
  - internalProcedure
```
public static void internalProcedure(java.lang.Class<?> def,
                                     java.lang.Object referent,
                                     java.lang.String legacyName,
                                     BlockManager.TransactionType lvl,
                                     Block block)
```
    Execute the given internal procedure block with the given transaction level.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
  - trigger
```
public static void trigger(Block block)
```
    Execute the given trigger block as a SUB-transaction.
    
    Parameters:
    
    block - The code to execute.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Class<T> cls,
                                                  Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Class<T> cls,
                                                  BlockManager.TransactionType lvl,
                                                  Block block)
```
    Execute the given function block with the given transaction level.
    
    Parameters:
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<T> cls,
                                                          int extent,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns an extent value.
    
    Parameters:
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<T> cls,
                                                          int extent,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns an extent value.
    
    Parameters:
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<T> cls,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns a dynamic extent value.
    
    Parameters:
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<T> cls,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns a dynamic extent value.
    
    Parameters:
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - function
```
public static <T extends BaseDataType> T function(java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  BlockManager.TransactionType lvl,
                                                  Block block)
```
    Execute the given function block with the given transaction level.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Object referent,
                                                  java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Object referent,
                                                  java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  BlockManager.TransactionType lvl,
                                                  Block block)
```
    Execute the given function block with the given transaction level.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Class<?> def,
                                                  java.lang.Object referent,
                                                  java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - function
```
public static <T extends BaseDataType> T function(java.lang.Class<?> def,
                                                  java.lang.Object referent,
                                                  java.lang.String legacyName,
                                                  java.lang.Class<T> cls,
                                                  BlockManager.TransactionType lvl,
                                                  Block block)
```
    Execute the given function block with the given transaction level.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          int extent,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns an extent value.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          int extent,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns an extent value.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns a dynamic extent value.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns a dynamic extent value.
    
    Parameters:
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          int extent,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns an extent value.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<?> def,
                                                          java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          int extent,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns an extent value.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<?> def,
                                                          java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          int extent,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns an extent value.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    extent - The function's return extent value.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns a dynamic extent value.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<?> def,
                                                          java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          Block block)
```
    Execute the given function block with a default transaction level of TransactionType.SUB, which returns a dynamic extent value.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns a dynamic extent value.
    
    Parameters:
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - extentFunction
```
public static <T extends BaseDataType> T[] extentFunction(java.lang.Class<?> def,
                                                          java.lang.Object referent,
                                                          java.lang.String legacyName,
                                                          java.lang.Class<T> cls,
                                                          BlockManager.TransactionType lvl,
                                                          Block block)
```
    Execute the given function block with the given transaction level, which returns a dynamic extent value.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    cls - The function's return type.
    
    lvl - The transaction level for the given block.
    
    block - The code to execute.
    
    Returns:
    
    The return value from the block (or its nested blocks).
  - doBlock
```
public static void doBlock(java.lang.String label,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(java.lang.String[] enclosing,
                           java.lang.String label,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties. TransactionType.NONE will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(BlockManager.TransactionType lvl,
                           java.lang.String label,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(BlockManager.TransactionType lvl,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(java.lang.String[] enclosing,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties. TransactionType.NONE will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(BlockManager.TransactionType lvl,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doBlock
```
public static void doBlock(BlockManager.TransactionType lvl,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(java.lang.String label,
                           LogicalOp expr,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(java.lang.String[] enclosing,
                           java.lang.String label,
                           LogicalOp expr,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(BlockManager.TransactionType lvl,
                           java.lang.String label,
                           LogicalOp expr,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(BlockManager.TransactionType lvl,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           LogicalOp expr,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(java.lang.String label,
                           LogicalOp expr,
                           OnPhrase[] on,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(java.lang.String[] enclosing,
                           java.lang.String label,
                           LogicalOp expr,
                           OnPhrase[] on,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties. TransactionType.NONE will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(BlockManager.TransactionType lvl,
                           java.lang.String label,
                           LogicalOp expr,
                           OnPhrase[] on,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doWhile
```
public static void doWhile(BlockManager.TransactionType lvl,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           LogicalOp expr,
                           OnPhrase[] on,
                           Block block)
```
    Execute a DO WHILE expression loop with the given configuration and no default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doTo
```
public static void doTo(java.lang.String label,
                        ToClause to,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - doTo
```
public static void doTo(java.lang.String[] enclosing,
                        java.lang.String label,
                        ToClause to,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - doTo
```
public static void doTo(BlockManager.TransactionType lvl,
                        java.lang.String label,
                        ToClause to,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - doTo
```
public static void doTo(BlockManager.TransactionType lvl,
                        java.lang.String[] enclosing,
                        java.lang.String label,
                        ToClause to,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - doTo
```
public static void doTo(java.lang.String label,
                        ToClause to,
                        OnPhrase[] on,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties. TransactionType.NONE will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doTo
```
public static void doTo(java.lang.String[] enclosing,
                        java.lang.String label,
                        ToClause to,
                        OnPhrase[] on,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties. TransactionType.NONE will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doTo
```
public static void doTo(BlockManager.TransactionType lvl,
                        java.lang.String label,
                        ToClause to,
                        OnPhrase[] on,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doTo
```
public static void doTo(BlockManager.TransactionType lvl,
                        java.lang.String[] enclosing,
                        java.lang.String label,
                        ToClause to,
                        OnPhrase[] on,
                        Block block)
```
    Execute a DO TO expression loop with the given configuration and no default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.NONE will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.NONE will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(BlockManager.TransactionType lvl,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties and no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(BlockManager.TransactionType lvl,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             OnPhrase[] on,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.NONE will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             OnPhrase[] on,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.NONE will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(BlockManager.TransactionType lvl,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             OnPhrase[] on,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doToWhile
```
public static void doToWhile(BlockManager.TransactionType lvl,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             OnPhrase[] on,
                             Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeat
```
public static void repeat(java.lang.String label,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    block - The code to execute.
  - repeat
```
public static void repeat(java.lang.String[] enclosing,
                          java.lang.String label,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - repeat
```
public static void repeat(BlockManager.TransactionType lvl,
                          java.lang.String label,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. There are no user-defined properties and there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - repeat
```
public static void repeat(BlockManager.TransactionType lvl,
                          java.lang.String[] enclosing,
                          java.lang.String label,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. There are no user-defined properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - repeat
```
public static void repeat(java.lang.String label,
                          OnPhrase[] on,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeat
```
public static void repeat(java.lang.String[] enclosing,
                          java.lang.String label,
                          OnPhrase[] on,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. TransactionType.SUB will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeat
```
public static void repeat(BlockManager.TransactionType lvl,
                          java.lang.String label,
                          OnPhrase[] on,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeat
```
public static void repeat(BlockManager.TransactionType lvl,
                          java.lang.String[] enclosing,
                          java.lang.String label,
                          OnPhrase[] on,
                          Block block)
```
    Execute a simple REPEAT (infinite loop) with the given configuration and default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(java.lang.String label,
                               LogicalOp expr,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(java.lang.String[] enclosing,
                               java.lang.String label,
                               LogicalOp expr,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(BlockManager.TransactionType lvl,
                               java.lang.String label,
                               LogicalOp expr,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(BlockManager.TransactionType lvl,
                               java.lang.String[] enclosing,
                               java.lang.String label,
                               LogicalOp expr,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(java.lang.String label,
                               LogicalOp expr,
                               OnPhrase[] on,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(java.lang.String[] enclosing,
                               java.lang.String label,
                               LogicalOp expr,
                               OnPhrase[] on,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties. TransactionType.SUB will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(BlockManager.TransactionType lvl,
                               java.lang.String label,
                               LogicalOp expr,
                               OnPhrase[] on,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatWhile
```
public static void repeatWhile(BlockManager.TransactionType lvl,
                               java.lang.String[] enclosing,
                               java.lang.String label,
                               LogicalOp expr,
                               OnPhrase[] on,
                               Block block)
```
    Execute a REPEAT WHILE expression loop with the given configuration and default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(java.lang.String label,
                            ToClause to,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(java.lang.String[] enclosing,
                            java.lang.String label,
                            ToClause to,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(BlockManager.TransactionType lvl,
                            java.lang.String label,
                            ToClause to,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(BlockManager.TransactionType lvl,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            ToClause to,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(java.lang.String label,
                            ToClause to,
                            OnPhrase[] on,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(java.lang.String[] enclosing,
                            java.lang.String label,
                            ToClause to,
                            OnPhrase[] on,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties. TransactionType.SUB will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(BlockManager.TransactionType lvl,
                            java.lang.String label,
                            ToClause to,
                            OnPhrase[] on,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatTo
```
public static void repeatTo(BlockManager.TransactionType lvl,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            ToClause to,
                            OnPhrase[] on,
                            Block block)
```
    Execute a REPEAT TO expression loop with the given configuration and default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no user-defined properties.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(BlockManager.TransactionType lvl,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties and no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(BlockManager.TransactionType lvl,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(BlockManager.TransactionType lvl,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no enclosing non-managed blocks.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatToWhile
```
public static void repeatToWhile(BlockManager.TransactionType lvl,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(P2JQuery query,
                            int direction,
                            java.lang.String label,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(P2JQuery query,
                            int direction,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(BlockManager.TransactionType lvl,
                            P2JQuery query,
                            int direction,
                            java.lang.String label,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. There are no user-defined properties and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(BlockManager.TransactionType lvl,
                            P2JQuery query,
                            int direction,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. There are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(P2JQuery query,
                            int direction,
                            java.lang.String label,
                            OnPhrase[] on,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(P2JQuery query,
                            int direction,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            OnPhrase[] on,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(BlockManager.TransactionType lvl,
                            P2JQuery query,
                            int direction,
                            java.lang.String label,
                            OnPhrase[] on,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlock
```
public static void forBlock(BlockManager.TransactionType lvl,
                            P2JQuery query,
                            int direction,
                            java.lang.String[] enclosing,
                            java.lang.String label,
                            OnPhrase[] on,
                            Block block)
```
    Execute a FOR FIRST or FOR LAST block with the given configuration and default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(P2JQuery query,
                                 int direction,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(P2JQuery query,
                                 int direction,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(BlockManager.TransactionType lvl,
                                 P2JQuery query,
                                 int direction,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(BlockManager.TransactionType lvl,
                                 P2JQuery query,
                                 int direction,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and no user-defined or default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(P2JQuery query,
                                 int direction,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(P2JQuery query,
                                 int direction,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(BlockManager.TransactionType lvl,
                                 P2JQuery query,
                                 int direction,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockWhile
```
public static void forBlockWhile(BlockManager.TransactionType lvl,
                                 P2JQuery query,
                                 int direction,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a FOR FIRST/LAST WHILE block with the given configuration and default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(P2JQuery query,
                              int direction,
                              java.lang.String label,
                              ToClause to,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(P2JQuery query,
                              int direction,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              ToClause to,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(BlockManager.TransactionType lvl,
                              P2JQuery query,
                              int direction,
                              java.lang.String label,
                              ToClause to,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(BlockManager.TransactionType lvl,
                              P2JQuery query,
                              int direction,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              ToClause to,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and no user-defined or default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(P2JQuery query,
                              int direction,
                              java.lang.String label,
                              ToClause to,
                              OnPhrase[] on,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(P2JQuery query,
                              int direction,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              ToClause to,
                              OnPhrase[] on,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(BlockManager.TransactionType lvl,
                              P2JQuery query,
                              int direction,
                              java.lang.String label,
                              ToClause to,
                              OnPhrase[] on,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockTo
```
public static void forBlockTo(BlockManager.TransactionType lvl,
                              P2JQuery query,
                              int direction,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              ToClause to,
                              OnPhrase[] on,
                              Block block)
```
    Execute a FOR FIRST/LAST TO block with the given configuration and default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(P2JQuery query,
                                   int direction,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(P2JQuery query,
                                   int direction,
                                   java.lang.String[] enclosing,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(BlockManager.TransactionType lvl,
                                   P2JQuery query,
                                   int direction,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties and no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(BlockManager.TransactionType lvl,
                                   P2JQuery query,
                                   int direction,
                                   java.lang.String[] enclosing,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(P2JQuery query,
                                   int direction,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   OnPhrase[] on,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(P2JQuery query,
                                   int direction,
                                   java.lang.String[] enclosing,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   OnPhrase[] on,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(BlockManager.TransactionType lvl,
                                   P2JQuery query,
                                   int direction,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   OnPhrase[] on,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forBlockToWhile
```
public static void forBlockToWhile(BlockManager.TransactionType lvl,
                                   P2JQuery query,
                                   int direction,
                                   java.lang.String[] enclosing,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   OnPhrase[] on,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEach
```
public static void forEach(P2JQuery query,
                           java.lang.String label,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forBlock.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forEach
```
public static void forEach(P2JQuery query,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forEach
```
public static void forEach(BlockManager.TransactionType lvl,
                           P2JQuery query,
                           java.lang.String label,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. There are no user-defined properties and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forEach
```
public static void forEach(BlockManager.TransactionType lvl,
                           P2JQuery query,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. There are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    block - The code to execute.
  - forEach
```
public static void forEach(P2JQuery query,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEach
```
public static void forEach(P2JQuery query,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEach
```
public static void forEach(BlockManager.TransactionType lvl,
                           P2JQuery query,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEach
```
public static void forEach(BlockManager.TransactionType lvl,
                           P2JQuery query,
                           java.lang.String[] enclosing,
                           java.lang.String label,
                           OnPhrase[] on,
                           Block block)
```
    Execute a FOR EACH loop with the given configuration and default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(P2JQuery query,
                                java.lang.String label,
                                LogicalOp expr,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(P2JQuery query,
                                java.lang.String[] enclosing,
                                java.lang.String label,
                                LogicalOp expr,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(BlockManager.TransactionType lvl,
                                P2JQuery query,
                                java.lang.String label,
                                LogicalOp expr,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(BlockManager.TransactionType lvl,
                                P2JQuery query,
                                java.lang.String[] enclosing,
                                java.lang.String label,
                                LogicalOp expr,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and no user-defined or default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(P2JQuery query,
                                java.lang.String label,
                                LogicalOp expr,
                                OnPhrase[] on,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(P2JQuery query,
                                java.lang.String[] enclosing,
                                java.lang.String label,
                                LogicalOp expr,
                                OnPhrase[] on,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(BlockManager.TransactionType lvl,
                                P2JQuery query,
                                java.lang.String label,
                                LogicalOp expr,
                                OnPhrase[] on,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachWhile
```
public static void forEachWhile(BlockManager.TransactionType lvl,
                                P2JQuery query,
                                java.lang.String[] enclosing,
                                java.lang.String label,
                                LogicalOp expr,
                                OnPhrase[] on,
                                Block block)
```
    Execute a FOR EACH WHILE block with the given configuration and default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    expr - The WHILE clause that defines the loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(P2JQuery query,
                             java.lang.String label,
                             ToClause to,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(P2JQuery query,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(BlockManager.TransactionType lvl,
                             P2JQuery query,
                             java.lang.String label,
                             ToClause to,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and no user-defined or default properties. In addition, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(BlockManager.TransactionType lvl,
                             P2JQuery query,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and no user-defined or default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(P2JQuery query,
                             java.lang.String label,
                             ToClause to,
                             OnPhrase[] on,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties. TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(P2JQuery query,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             OnPhrase[] on,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties. TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(BlockManager.TransactionType lvl,
                             P2JQuery query,
                             java.lang.String label,
                             ToClause to,
                             OnPhrase[] on,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties. In this case, there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachTo
```
public static void forEachTo(BlockManager.TransactionType lvl,
                             P2JQuery query,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             OnPhrase[] on,
                             Block block)
```
    Execute a FOR EACH TO block with the given configuration and default properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(P2JQuery query,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks. In addition, there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(P2JQuery query,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(BlockManager.TransactionType lvl,
                                  P2JQuery query,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties and no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(BlockManager.TransactionType lvl,
                                  P2JQuery query,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no user-defined properties.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(P2JQuery query,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used and there are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(P2JQuery query,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    TransactionType.SUB will be used.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(BlockManager.TransactionType lvl,
                                  P2JQuery query,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    There are no enclosing non-managed blocks.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachToWhile
```
public static void forEachToWhile(BlockManager.TransactionType lvl,
                                  P2JQuery query,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - promptForEditingUnlessHidden
```
public static void promptForEditingUnlessHidden(CommonFrame frame,
                                                FrameElement[] widgets,
                                                java.lang.String label,
                                                Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditingUnlessHidden
```
public static void promptForEditingUnlessHidden(CommonFrame frame,
                                                FrameElement[] widgets,
                                                java.lang.String[] enclosing,
                                                java.lang.String label,
                                                Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditingUnlessHidden
```
public static void promptForEditingUnlessHidden(CommonFrame frame,
                                                FrameElement[] widgets,
                                                EventList goOn,
                                                java.lang.String label,
                                                Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditingUnlessHidden
```
public static void promptForEditingUnlessHidden(CommonFrame frame,
                                                FrameElement[] widgets,
                                                EventList goOn,
                                                java.lang.String[] enclosing,
                                                java.lang.String label,
                                                Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditingUnlessHidden
```
public static void setEditingUnlessHidden(CommonFrame frame,
                                          FrameElement[] widgets,
                                          java.lang.String label,
                                          Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditingUnlessHidden
```
public static void setEditingUnlessHidden(CommonFrame frame,
                                          FrameElement[] widgets,
                                          java.lang.String[] enclosing,
                                          java.lang.String label,
                                          Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditingUnlessHidden
```
public static void setEditingUnlessHidden(CommonFrame frame,
                                          FrameElement[] widgets,
                                          EventList goOn,
                                          java.lang.String label,
                                          Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditingUnlessHidden
```
public static void setEditingUnlessHidden(CommonFrame frame,
                                          FrameElement[] widgets,
                                          EventList goOn,
                                          java.lang.String[] enclosing,
                                          java.lang.String label,
                                          Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditingUnlessHidden
```
public static void updateEditingUnlessHidden(CommonFrame frame,
                                             FrameElement[] widgets,
                                             java.lang.String label,
                                             Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditingUnlessHidden
```
public static void updateEditingUnlessHidden(CommonFrame frame,
                                             FrameElement[] widgets,
                                             java.lang.String[] enclosing,
                                             java.lang.String label,
                                             Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditingUnlessHidden
```
public static void updateEditingUnlessHidden(CommonFrame frame,
                                             FrameElement[] widgets,
                                             EventList goOn,
                                             java.lang.String label,
                                             Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditingUnlessHidden
```
public static void updateEditingUnlessHidden(CommonFrame frame,
                                             FrameElement[] widgets,
                                             EventList goOn,
                                             java.lang.String[] enclosing,
                                             java.lang.String label,
                                             Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditing
```
public static void promptForEditing(CommonFrame frame,
                                    FrameElement[] widgets,
                                    java.lang.String label,
                                    Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditing
```
public static void promptForEditing(CommonFrame frame,
                                    FrameElement[] widgets,
                                    java.lang.String[] enclosing,
                                    java.lang.String label,
                                    Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditing
```
public static void promptForEditing(CommonFrame frame,
                                    FrameElement[] widgets,
                                    EventList goOn,
                                    java.lang.String label,
                                    Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - promptForEditing
```
public static void promptForEditing(CommonFrame frame,
                                    FrameElement[] widgets,
                                    EventList goOn,
                                    java.lang.String[] enclosing,
                                    java.lang.String label,
                                    Block block)
```
    Execute the given editing block for the given frame and widget list with PROMPT-FOR semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditing
```
public static void setEditing(CommonFrame frame,
                              FrameElement[] widgets,
                              java.lang.String label,
                              Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditing
```
public static void setEditing(CommonFrame frame,
                              FrameElement[] widgets,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditing
```
public static void setEditing(CommonFrame frame,
                              FrameElement[] widgets,
                              EventList goOn,
                              java.lang.String label,
                              Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - setEditing
```
public static void setEditing(CommonFrame frame,
                              FrameElement[] widgets,
                              EventList goOn,
                              java.lang.String[] enclosing,
                              java.lang.String label,
                              Block block)
```
    Execute the given editing block for the given frame and widget list with SET semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditing
```
public static void updateEditing(CommonFrame frame,
                                 FrameElement[] widgets,
                                 java.lang.String label,
                                 Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditing
```
public static void updateEditing(CommonFrame frame,
                                 FrameElement[] widgets,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditing
```
public static void updateEditing(CommonFrame frame,
                                 FrameElement[] widgets,
                                 EventList goOn,
                                 java.lang.String label,
                                 Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - updateEditing
```
public static void updateEditing(CommonFrame frame,
                                 FrameElement[] widgets,
                                 EventList goOn,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 Block block)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
  - leave
```
public static void leave()
                  throws LeaveUnwindException
```
    Break out of the nearest enclosing block.
    
    Throws:
    
    LeaveUnwindException
  - leave
```
public static void leave(java.lang.String label)
                  throws LeaveUnwindException
```
    Break out of the block associated with the given label. This will unwind the stack until the proper block has been reached. At that point the block will be left using the Java "break" statement.
    
    Parameters:
    
    label - The name of the block to be left.
    
    Throws:
    
    LeaveUnwindException
  - deferredLeave
```
public static boolean deferredLeave(java.lang.String label)
```
    Detect if there is a pending leave for the block named by the given label. If so, this deferred leave flag will be cleared and true will be returned. The caller is responsible for ensuring that the leave request is fully granted as no further state will be available for subsequent processing.
    
    Parameters:
    
    label - The name of the block to be checked against the deferred leave block name.
    
    Returns:
    
    true if there is a pending deferred leave and the name of the block to be left is the same as the given label. If the pending deferred block name is the "" (empty string), that is the equivalent of matching "any block" and so the first call to this method after that is set will cause a true to be returned.
  - next
```
public static void next()
                 throws NextUnwindException
```
    Continue (iterate) the nearest enclosing block.
    
    Throws:
    
    NextUnwindException
  - next
```
public static void next(java.lang.String label)
                 throws NextUnwindException
```
    Continue (iterate) the block associated with the given label. This will unwind the stack until the proper block has been reached. At that point the block will be iterated using the Java "continue" statement.
    
    Parameters:
    
    label - The name of the block to be iterated.
    
    Throws:
    
    NextUnwindException
  - deferredNext
```
public static boolean deferredNext(java.lang.String label)
```
    Detect if there is a pending next for the block named by the given label. If so, this deferred next flag will be cleared and true will be returned. The caller is responsible for ensuring that the next request is fully granted as no further state will be available for subsequent processing.
    
    Parameters:
    
    label - The name of the block to be checked against the deferred next block name.
    
    Returns:
    
    true if there is a pending deferred next and the name of the block to be iterated is the same as the given label. If the pending deferred block name is the "" (empty string), that is the equivalent of matching "any block" and so the first call to this method after that is set will cause a true to be returned.
  - stop
```
public static void stop()
                 throws StopConditionException
```
    Raise the STOP condition and cause control to be transferred to the nearest enclosing block that handles the associated condition.
    
    Throws:
    
    StopConditionException
  - quit
```
public static void quit()
                 throws QuitConditionException
```
    Raise the QUIT condition and cause control to be transferred to the nearest enclosing block that handles the associated condition.
    
    Throws:
    
    QuitConditionException
  - returnNormal
```
public static void returnNormal()
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(WrappedResource val)
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(BaseDataType val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - returnExtentNormal
```
public static void returnExtentNormal(BaseDataType[] val)
                               throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(java.lang.String val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(int val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(long val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(double val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - returnNormal
```
public static void returnNormal(boolean val)
                         throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue()
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(WrappedResource val)
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(BaseDataType val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - storeExtentReturnValue
```
public static void storeExtentReturnValue(BaseDataType[] val)
                                   throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(java.lang.String val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(int val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(long val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(double val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - storeReturnValue
```
public static void storeReturnValue(boolean val)
                             throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - returnConsume
```
public static void returnConsume()
                          throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Throws:
    
    ReturnUnwindException
  - returnConsume
```
public static void returnConsume(character val)
                          throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - returnConsume
```
public static void returnConsume(java.lang.String val)
                          throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Sets the given value as the return value for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - returnError
```
public static void returnError()
                        throws ReturnUnwindException,
                               ErrorConditionException
```
    Return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - returnError
```
public static void returnError(character val)
                        throws ReturnUnwindException,
                               ErrorConditionException
```
    Return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - returnError
```
public static void returnError(java.lang.String val)
                        throws ReturnUnwindException,
                               ErrorConditionException
```
    Return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value will be set as the RETURN-VALUE for internal/ external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - returnError
```
public static void returnError(object<? extends LegacyError> error)
                        throws ReturnUnwindException,
                               ErrorConditionException
```
    Return from the nearest enclosing top-level block by throwing the specified legacy error.
    
    Parameters:
    
    error - The error object.
    
    Throws:
    
    LegacyErrorException
    
    ReturnUnwindException
    
    ErrorConditionException
  - catchBlock
```
public static void catchBlock(Block block)
```
    Execute the default block associated with a CATCH statement.
    
    Parameters:
    
    block - The code to execute.
  - catchError
```
public static <T extends LegacyError> void catchError(java.lang.Class<T> type,
                                                      java.util.function.Consumer<object<T>> catchBlock)
```
    The CATCH statement. This API must be called from the Block's init method, and it will register a listener for the specified legacy error.
    The catch order is the order of this API registration calls.
    
    Parameters:
    
    type - The CATCH's error type.
    
    catchBlock - The code to be executed for this error.
  - processCatch
```
public static void processCatch(Body body)
```
    Execute the given catch block as if it was a simple DO block.
    
    Parameters:
    
    body - The catch block to execute.
  - undoThrowTopLevel
```
public static void undoThrowTopLevel(object<? extends LegacyError> error)
```
    Trigger a rollback of the current block and then throw a legacy condition.
    
    Parameters:
    
    error - The legacy error to throw.
  - undoThrow
```
public static void undoThrow(object<? extends LegacyError> error)
```
    Trigger a rollback of the current block and then throw a legacy condition.
    
    Parameters:
    
    error - The legacy error to throw.
  - undoLeave
```
public static void undoLeave()
                      throws LeaveUnwindException
```
    Trigger a rollback of the current block and then leave that block.
    
    Throws:
    
    LeaveUnwindException
  - undoLeave
```
public static void undoLeave(java.lang.String label)
                      throws LeaveUnwindException
```
    Trigger a rollback of the given block and then leave that block.
    
    Parameters:
    
    label - The name of the block that is the target of the undo and leave operations.
    
    Throws:
    
    LeaveUnwindException
  - undoLeave
```
public static void undoLeave(java.lang.String undo,
                             java.lang.String leave)
                      throws LeaveUnwindException
```
    Trigger a rollback of the given block and then leave that block or a more enclosing block.
    If the current block is a variant of a FOR block, then the buffers associated with the block's query must not change the referenced record.
    
    Parameters:
    
    undo - The name of the block that is the target of the undo operation.
    
    leave - The name of the block that is the target of the leave operation.
    
    Throws:
    
    LeaveUnwindException
  - undoNext
```
public static void undoNext()
                     throws NextUnwindException
```
    Trigger a rollback of the current block and then iterate that block.
    Infinite loop protection may convert the NEXT action into a LEAVE depending on runtime state.
    
    Throws:
    
    NextUnwindException
  - undoNext
```
public static void undoNext(java.lang.String label)
                     throws NextUnwindException
```
    Trigger a rollback of the given block and then iterate that block.
    Infinite loop protection may convert the NEXT action into a LEAVE depending on runtime state.
    
    Parameters:
    
    label - The name of the block that is the target of the undo and next operations.
    
    Throws:
    
    NextUnwindException
  - undoNext
```
public static void undoNext(java.lang.String undo,
                            java.lang.String next)
                     throws NextUnwindException
```
    Trigger a rollback of the given block and then iterate that block or a more enclosing block.
    Infinite loop protection may convert the NEXT action into a LEAVE depending on runtime state.
    
    Parameters:
    
    undo - The name of the block that is the target of the undo operation.
    
    next - The name of the block that is the target of the next operation.
    
    Throws:
    
    NextUnwindException
  - undoRetry
```
public static void undoRetry()
                      throws RetryUnwindException
```
    Trigger a rollback of the current block and then retry that block.
    
    Throws:
    
    RetryUnwindException
  - undoRetry
```
public static void undoRetry(java.lang.String label)
                      throws RetryUnwindException
```
    Trigger a rollback of the given block and then retry that block.
    
    Parameters:
    
    label - The name of the block that is the target of the undo and retry operations.
    
    Throws:
    
    RetryUnwindException
  - undoRetryTopLevel
```
public static void undoRetryTopLevel()
                              throws RetryUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then retry that block.
    
    Throws:
    
    RetryUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal()
                             throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel()
                                     throws ReturnUnwindException
```
    Trigger a rollback and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(BaseDataType val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel(BaseDataType val)
                                     throws ReturnUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then return from that block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label,
                                    BaseDataType val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label,
                                    java.lang.String val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel(java.lang.String val)
                                     throws ReturnUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then return from that block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return or null. For procedures or triggers, this must be a character value.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(int val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel(int val)
                                     throws ReturnUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then return from that block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label,
                                    int val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(double val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel(double val)
                                     throws ReturnUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then return from that block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label,
                                    double val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(boolean val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormalTopLevel
```
public static void undoReturnNormalTopLevel(boolean val)
                                     throws ReturnUnwindException
```
    Trigger a rollback of the nearest enclosing top-level block and then return from that block. Sets the RETURN-VALUE to the given character value for internal/external procedures and triggers. Saves the given value as the return value for a user-defined function. If val is null, then RETURN-VALUE will be set to the "" (empty string) for internal/external procedures and triggers. If val is null for a user-defined function, unknown value will be the default return.
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnNormal
```
public static void undoReturnNormal(java.lang.String label,
                                    boolean val)
                             throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. This should not be used for internal/external procedures and triggers, since the RETURN-VALUE can only be set to a character expression.
    For a user-defined function, this saves the given value as the function return value.
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsume
```
public static void undoReturnConsume()
                              throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsumeTopLevel
```
public static void undoReturnConsumeTopLevel()
                                      throws ReturnUnwindException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsume
```
public static void undoReturnConsume(character val)
                              throws ReturnUnwindException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsumeTopLevel
```
public static void undoReturnConsumeTopLevel(character val)
                                      throws ReturnUnwindException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsume
```
public static void undoReturnConsume(java.lang.String label)
                              throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsume
```
public static void undoReturnConsume(java.lang.String label,
                                     character val)
                              throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsume
```
public static void undoReturnConsume(java.lang.String label,
                                     java.lang.String val)
                              throws ReturnUnwindException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnConsumeTopLevel
```
public static void undoReturnConsumeTopLevel(java.lang.String val)
                                      throws ReturnUnwindException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block, consuming any pending event processing. Sets the RETURN-VALUE to the given value for internal/external procedures and triggers. Should not be called for a user-defined function.
    If executed for a trigger, force the event which caused the trigger execution to be consumed (no default processing of that event should occur).
    
    Parameters:
    
    val - The value to return or null.
    
    Throws:
    
    ReturnUnwindException
  - undoReturnError
```
public static void undoReturnError()
                            throws ReturnUnwindException,
                                   ErrorConditionException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnErrorTopLevel
```
public static void undoReturnErrorTopLevel()
                                    throws ReturnUnwindException,
                                           ErrorConditionException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnError
```
public static void undoReturnError(java.lang.String label)
                            throws ReturnUnwindException,
                                   ErrorConditionException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. Sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. Leaves unknown value as the default return from a user-defined function.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnError
```
public static void undoReturnError(character val)
                            throws ReturnUnwindException,
                                   ErrorConditionException
```
    Trigger a rollback of the current block and then return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnErrorTopLevel
```
public static void undoReturnErrorTopLevel(character val)
                                    throws ReturnUnwindException,
                                           ErrorConditionException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnError
```
public static void undoReturnError(java.lang.String label,
                                   character val)
                            throws ReturnUnwindException,
                                   ErrorConditionException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnError
```
public static void undoReturnError(java.lang.String label,
                                   java.lang.String val)
                            throws ReturnUnwindException,
                                   ErrorConditionException
```
    Trigger a rollback of the given block and then return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    label - The name of the block that is the target of the undo operation.
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - undoReturnErrorTopLevel
```
public static void undoReturnErrorTopLevel(java.lang.String val)
                                    throws ReturnUnwindException,
                                           ErrorConditionException
```
    Trigger a rollback of and then return from the nearest enclosing top-level block. If the given value is null, this sets the default RETURN-VALUE to "" (empty string) for internal/external procedures and triggers. It leaves unknown value as the default return from a user-defined function. If the value is not null, then that value (if it is a character type) will be set as the RETURN-VALUE for internal/external procedures and triggers. If not null, the value will be returned as the function return value for user-defined functions.
    If silent error mode is not enabled in the caller, an ERROR condition will be raised here and will unwind the stack (it will not be processed, but will instead it will be rethrown) until it reaches the caller's context at which time the error will be honored. If silent error mode is enabled, the error data will be stored in the ERROR-STATUS facility and a return will be executed to return processing to the caller without raising the error condition (without throwing an exception).
    
    Parameters:
    
    val - The value to return.
    
    Throws:
    
    ReturnUnwindException
    
    ErrorConditionException
  - mustManageLegacyError
```
static boolean mustManageLegacyError()
```
    Check if the top-level block is ROUTINE-LEVEL UNDO, THROW or the current program is BLOCK-LEVEL UNDO, THROW.
    
    Returns:
    
    see above.
  - mustManageLegacyError
```
static boolean mustManageLegacyError(BlockManager.WorkArea wa)
```
    Check if the top-level block is ROUTINE-LEVEL UNDO, THROW or the current program is BLOCK-LEVEL UNDO, THROW.
    
    Parameters:
    
    wa - The BlockManager.WorkArea instance.
    
    Returns:
    
    see above.
  - mustThrowLegacyError
```
static boolean mustThrowLegacyError(java.lang.Class<? extends LegacyError> errorClass)
```
    Check if we must throw a legacy compatible OO error. This will happen if either mustManageLegacyError() or anywhere on the stack the specified error is handled by a CATCH block.
    
    Parameters:
    
    errorClass - The error class to be throw.
    
    Returns:
    
    See above.
  - mustThrowLegacyError
```
static boolean mustThrowLegacyError(BlockManager.WorkArea wa,
                                    java.lang.Class<? extends LegacyError> errorClass)
```
    Check if we must throw a legacy compatible OO error. This will happen if either mustManageLegacyError() or anywhere on the stack the specified error is handled by a CATCH block.
    
    Parameters:
    
    errorClass - The error class to be throw.
    
    Returns:
    
    See above.
  - hasLegacyError
```
static boolean hasLegacyError(java.lang.Class<? extends LegacyError> type,
                              int levels)
```
    Check if any CATCH blocks defined at the specified enclosing block can manage this exception.
    If none found, ignore this exception. 4GL doesn't seem to propagate the errors further than then current block.
    
    Parameters:
    
    type - The error type to process.
    
    levels - Flag indicating which block to use (0 for current, 1 for parent, etc). Use -1 to search the entire stack.
    
    Returns:
    
    true if this exception can be processed by the current block.
  - getReturnType
```
static BlockManager.ReturnType getReturnType()
```
    Returns the type of return processing from the nearest top-level block. The returned value is the value passed to returnWorker(WorkArea, Object, ReturnType).
    The value is valid from the time the converted code implementing the top-level block is exited until after Scopeable.scopeFinished() is called.
    
    Returns:
    
    Type of return processing value or null if the nearest top-level code is not finished by execution of returnWorker(WorkArea, Object, ReturnType).
  - getFunctionReturn
```
static java.lang.Object getFunctionReturn()
```
    Get the function's return value.
    
    Returns:
    
    The latest BlockManager.WorkArea.funcRet value.
  - checkFunctionReturn
```
static boolean checkFunctionReturn(java.util.function.Function<java.lang.Object,java.lang.Boolean> func)
```
    Check the BlockManager.WorkArea.funcRet stack for the supplied condition.
    
    Parameters:
    
    func - The condition to check.
    
    Returns:
    
    true if the condition applies to any of object in the return stack.
  - getHelper
```
static BlockManager.BlockManagerHelper getHelper()
```
    Get an instance of ProcedureManager.ProcedureHelper, which has the context-local instance saved, so API access can be done without a context-local query.
    
    Returns:
    
    See above.
  - topLevelBlock
```
static void topLevelBlock(java.lang.Class<?> def,
                          java.lang.Object referent,
                          java.lang.String legacyName,
                          BlockManager.TransactionType lvl,
                          BlockType btype,
                          Block block)
```
    Execute the given top-level block with the given transaction level.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The instance of the containing business logic class from which this is being called. For external procedures, if this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection. For internal procedures and triggers, this is expected to be null.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    lvl - The transaction level for the given block.
    
    btype - The type of block represented by the given code.
    
    block - The code to execute.
  - ignoreNextCall
```
static void ignoreNextCall(java.lang.Runnable abend)
```
    Register the abend code to be executed when the next top-level block needs to be invoked, as the argument assignment failed.
    
    Parameters:
    
    abend - The code to execute instead of the top-level block.
  - setReturnValue
```
private static boolean setReturnValue(BlockManager.WorkArea wa,
                                      LegacyError err)
```
    If the error referenced is an AppError, then also set the RETURN-VALUE.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    err - The error being processed.
    
    Returns:
    
    true if this is referencing an AppError instance.
  - leave
```
private static void leave(BlockManager.WorkArea wa,
                          java.lang.String label)
                   throws LeaveUnwindException
```
    Break out of the block associated with the given label. This will unwind the stack until the proper block has been reached. At that point the block will be left using the Java "break" statement.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    label - The name of the block to be left.
    
    Throws:
    
    LeaveUnwindException
  - next
```
private static void next(BlockManager.WorkArea wa,
                         java.lang.String label)
                  throws NextUnwindException
```
    Continue (iterate) the block associated with the given label. This will unwind the stack until the proper block has been reached. At that point the block will be iterated using the Java "continue" statement.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    label - The name of the block to be iterated.
    
    Throws:
    
    NextUnwindException
  - checkJavaCall
```
private static java.lang.Boolean checkJavaCall(BlockManager.WorkArea wa,
                                               java.lang.Class<?> def,
                                               java.lang.Object referent,
                                               java.lang.String legacyName,
                                               Block block,
                                               boolean function,
                                               boolean externalProgram,
                                               boolean persistentProc)
```
    Check if we this call is a java-style call or is from ControlFlowOps APIs. If is not from ControlFlowOps, then resolve push the callee info.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    referent - The instance of the containing business logic class from which this is being called. For external procedures, if this is non-null, then block can be an instance created using lambdas. If null, then block MUST BE an anonymous inner class of the containing business logic instance so that instance can be calculated via reflection. For internal procedures and functions, this is expected to be null.
    
    def - The currently executing OE class or external program.
    
    legacyName - The legacy name associated with the function/procedure being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    block - The Block insance beeing executed.
    
    function - Flag indicating if we are calling a function.
    
    externalProgram - Flag indicating if we are calling an external program.
    
    persistentProc - Flag indicating if the called external program is persistent.
    
    Returns:
    
    true if we are in a java-style call, null if we need to abend.
  - processBody
```
private static void processBody(BlockManager.WorkArea wa,
                                Block block,
                                OnPhrase[] on,
                                OnPhrase[] defOn)
                         throws java.lang.Throwable
```
    Implements the body of all blocks or loops that are not related to the FOR language statement. The main feature is to ensure that any normal exit from the body will notify any Commitable instances for validation purposes. A normal exit is a non-exception return from Block.body(), or certain exception cases related to LEAVE, NEXT, RETURN or QUIT when they are not associated with an UNDO.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    block - The block to execute.
    
    on - List of user-defined ON phrases. May be null.
    
    defOn - List of implicit ON phrases for this block. May be null.
    
    Throws:
    
    java.lang.Throwable
  - processForBody
```
private static boolean processForBody(BlockManager.WorkArea wa,
                                      Block block,
                                      ToClause to,
                                      LogicalOp expr,
                                      OnPhrase[] on,
                                      OnPhrase[] defOn)
                               throws java.lang.Throwable
```
    Implements the body of all FOR language statement blocks or loops. The main feature is to ensure that any normal exit from the body will notify any Commitable instances for validation purposes. A normal exit is a non-exception return from Block.body(), or certain exception cases related to LEAVE, NEXT, RETURN or QUIT when they are not associated with an UNDO.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    block - The block to execute.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined ON phrases. May be null.
    
    defOn - List of implicit ON phrases for this block. May be null.
    
    Returns:
    
    true if the code should break out of the block on return (because the loop/block control expressions or incrementer forced an exit).
    
    Throws:
    
    java.lang.Throwable
  - isNormal
```
private static boolean isNormal(BlockManager.WorkArea wa,
                                java.lang.Throwable thr,
                                OnPhrase[] on)
```
    Detect if an exception represents a normal or abnormal condition.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    thr - The exception to analyze.
    
    on - List of user-defined on phrases.
    
    Returns:
    
    true if the exception is a normal control-flow condition.
  - deferredLeaveWorker
```
private static boolean deferredLeaveWorker(BlockManager.WorkArea wa,
                                           java.lang.String label)
```
    Detect if there is a pending leave for the block named by the given label. If so, this deferred leave flag will be cleared and true will be returned. The caller is responsible for ensuring that the leave request is fully granted as no further state will be available for subsequent processing.
    
    Parameters:
    
    wa - Local context.
    
    label - The name of the block to be checked against the deferred leave block name.
    
    Returns:
    
    true if there is a pending deferred leave and the name of the block to be left is the same as the given label. If the pending deferred block name is the "" (empty string), that is the equivalent of matching "any block" and so the first call to this method after that is set will cause a true to be returned.
  - deferredNextWorker
```
private static boolean deferredNextWorker(BlockManager.WorkArea wa,
                                          java.lang.String label)
```
    Detect if there is a pending next for the block named by the given label. If so, this deferred next flag will be cleared and true will be returned. The caller is responsible for ensuring that the next request is fully granted as no further state will be available for subsequent processing.
    
    Parameters:
    
    wa - Local context.
    
    label - The name of the block to be checked against the deferred next block name.
    
    Returns:
    
    true if there is a pending deferred next and the name of the block to be iterated is the same as the given label. If the pending deferred block name is the "" (empty string), that is the equivalent of matching "any block" and so the first call to this method after that is set will cause a true to be returned.
  - returnWorker
```
private static void returnWorker(BaseDataType val,
                                 BlockManager.ReturnType rtype)
                          throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This will process differently based on the type of the top-level block (internal/external procedures, triggers or user-defined functions), the type of return processing that is requested (see BlockManager.ReturnType) and the presence or absence of a value to return.
    The following behavior is provided:
```
 Codes   Meaning                
 ------  -----------------------------------------------------
 C       Invoke LogicalTerminal.consume()
 E       Invoke TransactionManager.triggerErrorInCaller()
 V       Invoke ControlFlowOps.setReturnValue(val)
 N       Invoke ControlFlowOps.setReturnValue("")
 F       Invoke setFuncReturn(val)
 U       Invoke setFuncReturn(null) (set return value as unknown)
 I       Invalid (compile error in Progress)

  Return    Return    Internal  External  Trigger  Function
  Value      Type       Proc      Proc
 --------  ---------  --------  --------  -------  --------
 null      NORMAL     N         N         N        U
 non-null  NORMAL     V         V         V        F
 null      CONSUME    N         N         NC       U
 non-null  CONSUME    V         V         VC       F
 null      ERROR      NE        NE        I        U
 non-null  ERROR      VE        VE        I        U
 
```
    In all cases, a ReturnUnwindException will be thrown and this will cause the stack to unwind to the nearest enclosing top-level block. That block will then handle the return in a block specific manner. For example, in a user-defined function, the given value or by default the unknown value will be returned to the caller. Procedures and triggers have void return values.
    Parameters:
    
    val - The value to return.
    
    rtype - The type of return processing.
    
    Throws:
    
    ReturnUnwindException
  - returnWorker
```
private static void returnWorker(BlockManager.WorkArea wa,
                                 java.lang.Object val,
                                 BlockManager.ReturnType rtype)
                          throws ReturnUnwindException
```
    Return from the nearest enclosing top-level block. This will process differently based on the type of the top-level block (internal/external procedures, triggers or user-defined functions), the type of return processing that is requested (see BlockManager.ReturnType) and the presence or absence of a value to return.
    The following behavior is provided:
```
 Codes   Meaning                
 ------  -----------------------------------------------------
 C       Invoke LogicalTerminal.consume()
 E       Invoke TransactionManager.triggerErrorInCaller()
 V       Invoke ControlFlowOps.setReturnValue(val)
 N       Invoke ControlFlowOps.setReturnValue("")
 F       Invoke setFuncReturn(val)
 U       Invoke setFuncReturn(null) (set return value as unknown)
 I       Invalid (compile error in Progress)

  Return    Return    Internal  External  Trigger  Function
  Value      Type       Proc      Proc
 --------  ---------  --------  --------  -------  --------
 null      NORMAL     N         N         N        U
 non-null  NORMAL     V         V         V        F
 null      CONSUME    N         N         NC       U
 non-null  CONSUME    V         V         VC       F
 null      ERROR      NE        NE        I        U
 non-null  ERROR      VE        VE        I        U
 
```
    In all cases, a ReturnUnwindException will be thrown and this will cause the stack to unwind to the nearest enclosing top-level block. That block will then handle the return in a block specific manner. For example, in a user-defined function, the given value or by default the unknown value will be returned to the caller. Procedures and triggers have void return values.
    Parameters:
    
    wa - Context local data or null if not available in caller.
    
    val - The value to return. If the function doesn't return an extent value, the element zero will be returned.
    
    rtype - The type of return processing.
    
    Throws:
    
    ReturnUnwindException
  - markReturnError
```
private static void markReturnError(BlockManager.WorkArea wa)
```
    Mark all blocks on the stack enclosed in this this top-level block (including it), as BlockDefinition.wasReturnError.
    This is called only when a RETURN ERORR (from within a top-level block) is being called, and is meant to mark all blocks on the stack, up to the nearest top-level block, that the exist is being done via a RETURN ERROR.
    Do not call this method from other code.
    
    Parameters:
    
    wa - The context-local instance.
  - functionBlock
```
private static <T extends BaseDataType> java.lang.Object functionBlock(java.lang.Class<?> def,
                                                                       java.lang.Object referent,
                                                                       java.lang.String legacyName,
                                                                       BlockManager.TransactionType level,
                                                                       Block block,
                                                                       java.lang.Class<T> retType,
                                                                       int extent)
```
    Execute the given function block with the given transaction level.
    
    Parameters:
    
    def - The Java class associated with a legacy OE class, if this code is part of a legacy OE class; otherwise, null.
    
    referent - The referent to which this method belongs.
    
    legacyName - The legacy name associated with the function being invoked via a java-style call. If is null, it will be resolved by ProcedureManager.resolveClosestMethod(java.lang.Object, boolean, boolean).
    
    level - The transaction level for the given block.
    
    block - The code to execute.
    
    retType - The type of the return value which is used in the case the unknown value must be returned.
    
    extent - For functions not returning an extent value, this is -1. Else, this extent size, which is 0 for dynamic-extent and >0 for fixed extent.
    
    Returns:
    
    The return value from the block (or its nested blocks) which is the unknown value by default or on error.
  - editingBlock
```
private static void editingBlock(CommonFrame frame,
                                 FrameElement[] widgets,
                                 EventList goOn,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 Block block,
                                 int etype)
```
    Execute the given editing block for the given frame and widget list with UPDATE semanics. All looping, sub-transaction properties and block properties will be honored. The exit from the editing block will be based on the given GO-ON event list.
    
    Parameters:
    
    frame - The frame for which the editing block is associated.
    
    widgets - The widgets in the given frame that are to be enabled for editing.
    
    goOn - The exit conditions for this loop or null if there are no explicit exit conditions.
    
    enclosing - The list of enclosing blocks of which this class is unaware. Any LEAVE or NEXT that references one of those enclosing blocks must not unwind the stack further using an exception, but rather it must return and let the caller check to see if a deferred LEAVE or NEXT must be honored.
    
    label - The label of the block for use in control flow statements such as LEAVE or NEXT.
    
    block - The code for the editing block body.
    
    etype - Editing block semantics (CommonFrame.PROMPT-FOR, CommonFrame.SET or CommonFrame.UPDATE).
  - doBlockWorker
```
private static void doBlockWorker(BlockManager.TransactionType lvl,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a simple DO block (not a loop) with the given configuration and no default properties.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - doTerminationBlockWorker
```
private static void doTerminationBlockWorker(BlockManager.WorkArea wa,
                                             BlockManager.TransactionType lvl,
                                             java.lang.String label,
                                             boolean finBlock,
                                             Block block)
```
    Execute a a termination block like CATCH and FINALLY, emulating doBlockWorker(com.goldencode.p2j.util.BlockManager.TransactionType, java.lang.String[], java.lang.String, com.goldencode.p2j.util.OnPhrase[], com.goldencode.p2j.util.Block).
    
    Parameters:
    
    wa - The BlockManager.WorkArea instance.
    
    lvl - The transaction level to be honored.
    
    label - The block name of the current block.
    
    finBlock - Flag identifying a FINALLY block when true and a CATCH block otherwise.
    
    block - The code to execute.
  - doLoopWorker
```
private static void doLoopWorker(BlockManager.TransactionType lvl,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a DO WHILE expression, DO TO var = val1 to val2 by val3 or DO TO WHILE expression loop with the given configuration and no default properties. At least one of the to clause or while expression must be passed and it is valid to have both passed in which case both of the conditions are tested with a logical AND.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - repeatWorker
```
private static void repeatWorker(BlockManager.TransactionType lvl,
                                 java.lang.String[] enclosing,
                                 java.lang.String label,
                                 ToClause to,
                                 LogicalOp expr,
                                 OnPhrase[] on,
                                 Block block)
```
    Execute a REPEAT, REPEAT WHILE expression, REPEAT TO var = val1 to val2 by val3 or REPEAT TO WHILE expression loop with the given configuration and with default properties. If neither the to clause or while expression is specified, this is an infinite loop. If both are specified then both of the conditions are tested with a logical AND. By default, the ON ENDKEY UNDO, LEAVE and ON ERROR UNDO, RETRY properties are supported.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - coreLoop
```
private static void coreLoop(BlockType btype,
                             boolean next,
                             BlockManager.TransactionType lvl,
                             java.lang.String[] enclosing,
                             java.lang.String label,
                             ToClause to,
                             LogicalOp expr,
                             OnPhrase[] on,
                             OnPhrase[] defOn,
                             Block block)
```
    Execute a DO or REPEAT loop with all possible loop constructs, the given configuration and with default properties.
    
    Parameters:
    
    btype - Current block type.
    
    next - true if on infinite loop protection a retry should be converted to a NEXT, false to convert to a LEAVE.
    
    lvl - The transaction level to be honored.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    on - List of user-defined on phrases.
    
    defOn - List of default properties for the block. Use null to indicate no default properties for the block.
    
    block - The code to execute.
  - forBlockWorker
```
private static void forBlockWorker(BlockManager.TransactionType lvl,
                                   P2JQuery query,
                                   int direction,
                                   java.lang.String[] enclosing,
                                   java.lang.String label,
                                   ToClause to,
                                   LogicalOp expr,
                                   OnPhrase[] on,
                                   Block block)
```
    Execute a FOR FIRST/LAST WHILE block, FOR FIRST/LAST TO block or FOR FIRST/LAST TO WHILE block with the given configuration and with default properties. Any TO or WHILE clause is treated as an additional condition that must be met before the block body is executed. Note that the presence of a TO or WHILE does not make this a loop. If neither the TO clause or WHILE expression is specified, this is a simple block. If both are specified then both of the conditions are tested with a logical AND. By default, the ON ENDKEY UNDO, LEAVE and ON ERROR UNDO, RETRY properties are supported.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself or if there is a TO or WHILE clause then the query processing should be located in the Block.enter() method. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block or in the enter method to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    The evaluation of the TO or WHILE block termination conditions is done AFTER the record retrieval. This causes any found record to remain available if the block is never entered because of the TO or WHILE conditions.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forBlock.
    
    direction - direction in which query will be iterating.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines the block condition. The block control variable is initialized before entering the block. Before the block body is entered, the control variable is compared to the termination value (which is dynamically resolved at that moment). if the termination condition is met, the block is never entered.
    
    expr - The WHILE clause that defines a block condition. This expression is evaluated before the block body is about to be entered. The block body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - forEachWorker
```
private static void forEachWorker(BlockManager.TransactionType lvl,
                                  P2JQuery query,
                                  java.lang.String[] enclosing,
                                  java.lang.String label,
                                  ToClause to,
                                  LogicalOp expr,
                                  OnPhrase[] on,
                                  Block block)
```
    Execute a FOR EACH, FOR EACH WHILE block, FOR EACH TO block or FOR EACH TO WHILE block with the given configuration and with default properties. Any TO or WHILE clause is treated as an additional condition that must be met before the loop body is executed. If both are specified then both of the conditions are tested with a logical AND. By default, the ON ENDKEY UNDO, LEAVE and ON ERROR UNDO, RETRY properties are supported.
    The record retrieval that is associated with FOR blocks or loops must be implemented directly inside the code of the block itself or if there is a TO or WHILE clause then the query processing should be located in the Block.enter() method. This means that the caller is responsible for all query processing. The record retrieval must be done on the first line of code in the block or in the enter method to duplicate the Progress behavior. Note that this is required to handle all error cases and 4GL conditions properly.
    The evaluation of the TO or WHILE block termination conditions is done AFTER the record retrieval. This causes any found record to remain available if the loop is never entered (or re-entered) because of the TO or WHILE conditions.
    
    Parameters:
    
    lvl - The transaction level to be honored.
    
    query - query that will iterate forEachBlock.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false.
    
    on - List of user-defined on phrases.
    
    block - The code to execute.
  - needsIterate
```
private static boolean needsIterate(ToClause to,
                                    LogicalOp expr)
```
    Test the given expressions to determine if the calling loop should iterate or if the loop should exit. Either or both parameters may be null individually or simultaneously.
    
    Parameters:
    
    to - The TO clause that defines a loop condition. The loop control variable is initialized on the first pass through and on subsequent passes it is incremented by a given factor. Before the loop body is entered, the loop control variable is compared to the termination value (which is dynamically resolved at each loop iteration). When the termination condition is met, the loop ends. If this is null, then a WHILE clause MUST be present to provide the condition for maintaining the loop.
    
    expr - The WHILE clause that defines a loop condition. This expression is evaluated every time the loop body is about to be entered. The loop body will be entered unless the expression evaluates to false. If this is null, then a TO clause MUST be present to provide the condition for maintaining the loop.
    
    Returns:
    
    true if all non-null parameters evaluate to true or if both parameters are null.
  - processLegacyError
```
private static void processLegacyError(BlockManager.WorkArea wa,
                                       LegacyErrorException lex,
                                       OnPhrase[] on,
                                       OnPhrase[] defOn)
```
    Check if any CATCH blocks defined at the current enclosing block can manage this exception.
    If none found, ignore this exception. 4GL doesn't seem to propagate the errors further than then current block.
    If a CATCH block is found, then execute it.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    lex - The thrown legacy error.
    
    on - List of user-defined ON phrases. May be null.
    
    defOn - List of implicit ON phrases for this block. May be null.
    
    Throws:
    
    LegacyErrorException - If the processing needs to be deferred.
  - hasLegacyError
```
private static boolean hasLegacyError(BlockManager.WorkArea wa,
                                      java.lang.Class<? extends LegacyError> type,
                                      int levels)
```
    Check if any CATCH blocks defined at the specified enclosing block can manage this exception.
    If none found, ignore this exception. 4GL doesn't seem to propagate the errors further than then current block.
    
    Parameters:
    
    wa - Context local data or null if not available in caller.
    
    type - The error type to process.
    
    levels - Flag indicating which block to use (0 for current, 1 for parent, etc). Use -1 to search the entire stack.
    
    Returns:
    
    true if this exception can be processed by the current block.
  - processLegacyException
```
private static void processLegacyException(BlockManager.WorkArea wa,
                                           LegacyErrorException e)
```
    Make sure that the legacy exception is honoring the roll-back of transactions in the current block. For now, this is not honoring the labeling of undo statements.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    e - The legacy error exception that caused the unwinding.
  - processCondition
```
private static BlockManager.Disposition processCondition(BlockManager.WorkArea wa,
                                                         OnPhrase[] user,
                                                         OnPhrase[] def,
                                                         ConditionException ce,
                                                         java.lang.String[] enclosing,
                                                         java.lang.String label)
                                                  throws ConditionException,
                                                         StackUnwindException,
                                                         RetryUnwindException
```
    Core worker to handle all the possible behavior in response to a condition being raised in an inner block (DO, REPEAT or FOR). The given condition exception will first be matched with the user-defined on phases and then if no match is found, with the default on phrases for the calling block. If nothing is found, then the condition exception will be re-thrown. If a match is found then condition-specific processing will be done to UNDO and then either unwind the stack using exceptions or a disposition will be returned so that the caller can properly implement a LEAVE or NEXT that is targetted at the current block or at an enclosing non-managed block.
    This honors infinite loop protection for converting NEXT to LEAVE based on runtime state.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    user - List of user-defined on phrases.
    
    def - List of default on phrases for the current block type.
    
    ce - The condition being raised.
    
    enclosing - The list of non-managed block names that enclose the current block.
    
    label - The block name of the current block.
    
    Returns:
    
    If an exception is not thrown (or re-thrown), then the caller will get a disposition code that should be honored to properly implement a LEAVE or NEXT action.
    
    Throws:
    
    ConditionException
    
    StackUnwindException
    
    RetryUnwindException
  - exceptionToCondition
```
static BlockManager.Condition exceptionToCondition(ConditionException ce)
```
    Translate exception into BlockManager.Condition code.
    
    Parameters:
    
    ce - Source exception.
    
    Returns:
    
    one of the BlockManager.Condition codes or null if no match is found.
  - matchCondition
```
private static OnPhrase matchCondition(OnPhrase[] user,
                                       OnPhrase[] def,
                                       BlockManager.Condition cond)
```
    Find a matching condition in the user-defined on phrases or the default on phrases for the block and return the on phrase that is matched. The user-defined on phrases are searched first and only if there is no match will the default on phrases be searched.
    
    Parameters:
    
    user - The set of user-defined on phrases for the current block.
    
    def - The set of default on phrases for the current block.
    
    cond - The condition being matched.
    
    Returns:
    
    The on phrase that defines the behavior to be implemented or null if there is no match in either list.
  - decodeConditions
```
private static int decodeConditions(OnPhrase[] user,
                                    OnPhrase[] def)
```
    Encode the conditions supported by this block as a bitfield.
    The inputs are analyzed to match Condition values with their corresponding bits in the TransactionManager properties bitfield.
    The bits are defined by TransactionManager.PROP_NONE, TransactionManager.PROP_ERROR, TransactionManager.PROP_ENDKEY, TransactionManager.PROP_STOP or TransactionManager.PROP_QUIT.
    
    Parameters:
    
    user - The set of user-defined on phrases for the current block.
    
    def - The set of default on phrases for the current block.
    
    Returns:
    
    The calculated bitmask with each bit set that matches one of the ON phrase conditions. PROP_NONE will be returned if both parameters are null and/or empty.
  - conditionMask
```
private static int conditionMask(BlockManager.Condition cond)
```
    Matches a Condition with its corresponding TransactionManager constant.
    
    Parameters:
    
    cond - The condition to match.
    
    Returns:
    
    The integer constant that represents the given condition.
  - testLeave
```
private static BlockManager.Disposition testLeave(BlockManager.WorkArea wa,
                                                  java.lang.String[] enclosing,
                                                  java.lang.String label)
```
    Detect if the leave event is referencing this block OR if it is referencing a directly enclosing block which is not managed by this class. In either case, the result will be to break out of the current block. In all other cases, the result will be to re-throw the exception and cause the stack to unwind to the nearest enclosing managed block.
    The target of the leave operation must have been stored in context local data when the leave exception was thrown (which caused the stack to unwind).
    This method is called from within a catch block to determine how to respond to the deferred leave operation for the current block.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    enclosing - The list of non-managed blocks that directly enclose the current block.
    
    label - The name of the current block. If this matches the target of the deferred leave operation, then the current block must be left.
    
    Returns:
    
    Either BREAK or THROW.
  - testNext
```
private static BlockManager.Disposition testNext(BlockManager.WorkArea wa,
                                                 java.lang.String[] enclosing,
                                                 java.lang.String label)
```
    Detect if the next event is referencing this block OR if it is referencing a directly enclosing block which is not managed by this class. In the first case, the result will be to continue the current block. In the second case, the caller must break out of the current block. In all other cases, the result will be to re-throw the exception and cause the stack to unwind to the nearest enclosing managed block.
    The target of the next operation must have been stored in context local data when the next exception was thrown (which caused the stack to unwind).
    This method is called from within a catch block to determine how to respond to the deferred next operation for the current block.
    
    Parameters:
    
    wa - Context local work area. Must not be null.
    
    enclosing - The list of non-managed blocks that directly enclose the current block.
    
    label - The name of the current block. If this matches the target of the deferred leave operation, then the current block must be left.
    
    Returns:
    
    Either BREAK, CONTINUE or THROW.
  - exitTopLevel
```
private static void exitTopLevel(BlockManager.WorkArea wa)
```
    Common worker to cleanup top-level block state just before exiting.
    
    Parameters:
    
    wa - The local context.
  - executeStateManaged
```
private static void executeStateManaged(BlockManager.WorkArea wa,
                                        java.lang.Runnable code)
```
    Preserve certain work area state before running the given code and then restore that state afterward. The code may contain and/or invoke arbitrarily complex code and control flow. Direct invocation (without the state backup/restore) would otherwise corrupt the current work area state.
    
    Parameters:
    
    wa - Context local data or null if not available in the caller.
    
    code - The code to execute.
  - setFuncReturn
```
private static void setFuncReturn(java.lang.Object bdt,
                                  BlockManager.WorkArea wa,
                                  BlockType nearest)
```
    Set the return value for the nearest enclosing function. This should only be called if the nearest enclosing top-level block is a FUNCTION. Multiple calls to this before returning from the function block will cause the value passed on the last call to be honored.
    
    Parameters:
    
    bdt - The return value to set. Passing null will reset the return value to unknown.
    
    wa - The current context's data or null to force a lookup of the context data.
    
    nearest - The nearest top-level block. Should be a FUNCTION block. Pass null to use the context data to find the block.
  - matches
```
private static boolean matches(java.lang.String[] list,
                               java.lang.String entry)
```
    Given a list of strings, detect if the given entry matches (case sensitively) any of the elements in the list.
    
    Parameters:
    
    list - The list of strings to check against.
    
    entry - The element for which to search.
    
    Returns:
    
    true if the given entry is found in the given list.
  - convertTransType
```
private static int convertTransType(BlockManager.TransactionType ttype,
                                    BlockType btype)
```
    Helper to convert between this class' enum and the corresponding TransactionManager constants.
    
    Parameters:
    
    ttype - The enum to convert.
    
    btype - The block type.
    
    Returns:
    
    The corresponding TransactionManager constant.
  - topLevelType
```
private static BlockType topLevelType(BlockManager.WorkArea wa)
```
    Accesses the type of the nearest enclosing top level block.
    
    Parameters:
    
    wa - The current context's data or null to force a lookup of the context data.
    
    Returns:
    
    The type of the enclosing top level block or null if there is no top-level block in the call stack.
  - isPersistentTriggerTopLevel
```
private static boolean isPersistentTriggerTopLevel(BlockManager.WorkArea wa)
```
    Check if we are on the top level of a persistent trigger.
    
    Parameters:
    
    wa - The current context's data.
    
    Returns:
    
    true if we are on the top level of a persistent trigger
  - recordExecutionStats
```
private static void recordExecutionStats(BlockType type,
                                         Block block,
                                         long start)
```
    Update block execution statistics for the given block instance. Depending of the block type, either the class name of the block will be inspected or the call stack will be inspected to determine the block name and then the usage statistics for that block will be incremented.
    
    Parameters:
    
    type - The type of the block.
    
    block - The block that is about to be executed.
    
    start - The start time of the block's execution.
  - dumpExecutionStats
```
private static void dumpExecutionStats()
```
    Generates a CSV file with the recorded execution statistics.

Class BlockManager

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOG

work

FINALLY_BLOCK_LABEL

CATCH_BLOCK_LABEL

STATS_FILE

NULL

statsFile

stats

times

Constructor Detail

BlockManager

Method Detail

onRoutineLevel

onBlockLevel

stopAfter

stopAfter

externalProcedure

externalProcedure

externalProcedure

externalProcedure

externalProcedure

externalProcedure

internalProcedure

internalProcedure

internalProcedure

internalProcedure

internalProcedure

internalProcedure

internalProcedure

internalProcedure

trigger

function

function

extentFunction

extentFunction

extentFunction

extentFunction

function

function

function

function

function

function

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

extentFunction

doBlock

doBlock

doBlock

doBlock

doBlock

doBlock

doBlock

doBlock

doWhile

doWhile

doWhile

doWhile

doWhile

doWhile

doWhile

doWhile

doTo

doTo

doTo