BREAK

Syntax:

       Then: BREAK ON

       Then: BREAK OFF

Version Ref:  3.x

Description:

BREAK turns the <BREAK> key OFF and ON during processing. Use BREAK OFF when you don't want the user to break out of the current operation.

IMPORTANT: Don't add the BREAK statements to your tables until the tables have been debugged. Otherwise, on DOS systems, you'll have to reboot your computer to stop your processing. On UNIX/ XENIX systems, you'll have to use the emergency BREAK key, either <CTRL> <\> or <CTRL> <7>,to get out of the operation. Exiting this way may turn off the ECHO function, the cursor, <CTRL> <D> and <BACKSPACE>.

Examples:

If your program posts financial data from a sales file to a client file, you don't want the user to be able to cancel the operation before all the data from a particular record is correctly posted:

       Then: lookup client k=1 i=a -nx
         If: not client
       Then: goto subr
       Then: break off; sales (l0)=2; sales (11)=3
       Then: write; break on

Note: BREAK cannot be used on automatic processing tables.

Release 5.0.14: If BREAK OFF is executed in a CALL/CHAIN process, it did not remain off upon returning prior to release 5.0.14. It now remains off upon returning. Also, it is restored to ON if you go to a new record.