UNDO
undo on | off | <n>| SKIP=<f_range>|<null> | <INDEX=on|off>
| pause | awake
Function
This command restores last BOOKMARK and enables REDO.
Parameters
|
<null> |
Restores last bookmark stack status and enables redo. This only works if UndoMode is enabled (see UNDO ON). |
|
|
|
|
ON |
Enables UNDO/REDO and bookmarkers |
|
|
|
|
OFF |
Disables UNDO/REDO and bookmarkers, whilst cleaning the backup buffers. |
|
|
|
|
SKIP=<f_range> |
Fragment range which should be ignored in any UNDO process. |
|
|
|
|
<n> |
Define the number of bookmarks which to undo. UNDO 3 would be the equivalent of UNDO;UNDO;UNDO |
|
|
|
|
INDEX=ON|OFF |
INDEX=ON|OFF enables or disables the restore of the indices when undoing a saved state. The default is INDEX=ON, which means that the indices are restored. (Introduced 12.3.3) Example: UNDO ON ... BOOKMARK ... UNDO INDEX=OFF UNDO |
|
|
|
|
PAUSE
|
The PAUSE primer will suspend the undo mechanism in order to facilitate handling of critical situations. The undo function may be reactivated using the AWAKE primer. (Introduced v12.4.2) |
|
|
|
|
AWAKE |
The AWAKE primer will reactivates the undo mechanism after an earlier PAUSE primer has been issued. (Introduced v12.4.2) |
Examples
UNDO ON
UNDO OFF
UNDO
UNDO SKIP=8,20\25,100
UNDO 3
Notes
UNDO and the related BOOKMARK and REDO commands work on data only. The dynamics of language variables, files, user interface, etc. are not “undoable” meaning that the application should be programmed to handle these elements.
UNDO, like the GET command uses the current value of P1 to load the model file. The DEFAULT i= setting (new default IN attach point number. At program startup the value is 1.) can be used to change the default location.
There is an environment variable (INI/Reg) called MAX_UNDO_LEVELS which defines the maximum levels of UNDO possible. The default is 16. (Introduced 12.3.0b14)
See also