RESTORE [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
RESTORE
Restores macros or variables from a file that was previously created by
the STORE command.
Syntax
RESTORE MACROS filename
RESTORE VARIABLES filename
The RESTORE command quickly restores saved macros or variables from a
binary file that 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.
CAUTION The output format of all System Debug commands is subject to
change without notice. Programs that are developed to
postprocess System Debug output should not depend on the exact
format (spacing, alignment, number of lines, uppercase or
lowercase, or spelling) of any System Debug command output.
MPE/iX 5.0 Documentation