System Debug Reference Manual (32650-90888)

Chapter 6 253
System Debug Command Specifications M-X
RET[URN]
was created by the STORE command.
Based on the selector (MACROS or VARIABLES), all currently defined macros or variables are
immediately discarded, and are
replaced entirely by the contents of the STORE file.
The current limits (as set by ENV MACROS or ENV VARS and ENV VARS_LOC) are
automatically changed to the limits that were in effect at the time the STORE file was created.
After the RESTORE, macros or variables can be referenced, created, listed, or deleted in the
normal manner.
Parameters
MACROS Specifies that macros are to be restored. This keyword can be abbreviated
and entered in uppercase or lowercase.
VARIABLES Specifies that variables are to be restored. This keyword can be
abbreviated and entered in uppercase or lowercase.
filename The name of the file (previously built by the STORE command) from which
the macros or variables are to be restored.
Examples
$nmdat > store var savevar
$nmdat > vard @
$nmdat > restore var savevar
Stores the currently defined variables into the file SAVEVAR. All variables are deleted, then
the RESTORE command is used to restore them all again.
Related command: STORE.
Related ENV variables: MACROS, VARS, VARS_LOC.
Limitations, Restrictions
STORE/RESTORE are currently very version dependent.
If the internal versions of macros, variables, or storage management change, it may not be
possible to RESTORE from a file that was stored with earlier versions of STORE. An error is
generated.
RET[URN]
Exits from a macro, optionally returning a specified value.
Syntax
RET[URN] [ value ]
The RETURN command can be used only within a macro.