Setup new Error Flush Mode

This Subprogram allows an Application Programmer to modify the default response to an error being detected. This default is to unwind the Command File Stack and flush the Input Buffer such that all text that has been entered but not yet decoded will be lost.

Short Name Calling Sequence

STATUS = UIFLMD(MODE[,OLDMOD])

Long Name Calling Sequence

STATUS = UI_FLUSH_MODE(...)

Input Arguments

MODE (Logical) Flush Mode (see notes)

Output Arguments

OLDMOD (Logical) Old Flush Mode (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. The MODE Argument may take on two values:-

   UIFLUSHDISABLED ) Error Flushing Disabled UIFLDI )

   UIFLUSHENABLED ) Error Flushing Enabled UIFLEN )

2. The Flush Mode is set to UI_FLUSH_ENABLED (.TRUE.) by default.
3. The OLDMOD Argument is Optional and, if present, will be set to the Old Flush Mode prior to this call (.TRUE. or .FALSE.).