HP 3000 Manuals

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