HPlogo System Debug Reference Manual > Chapter 6 System Debug Command Specifications M-X

RESTORE

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

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.



REGLIST

RET[URN]