SAVE

SAVE writes all active nu/TPU procedures and key definitions to a section file. SAVE is the only built-in used to create nu/TPU section files. SAVE does not save buffer modifications. Use either WRITE_FILE or EXIT to save buffer modifications. SAVE creates a section file that contains both the executable code from the original section as well as the additions made during the current session, writing only the following items:

All compiled procedures.

All variables (name only).

All key definitions bound to a program or learn.

All key-maps.

All key-map-lists.

All constants.

Optionally, SAVE will take the string "IDENT" and use the parameter following "IDENT" as the version number for the section file. By default, the saved section file is written to your current directory. Section files start up faster than command files because the compilation step is not needed. Note that SET variables are not saved in section files. NO_DEBUG_NAMES and NO_PROCEDURE_NAMES provide only porting compatibility for VAX TPU.

Syntax:

SAVE ( section_file_name )

SAVE ( section_file_name, "NO_DEBUG_NAMES" )

SAVE ( section_file_name, "NO_PROCEDURE_NAMES" )

SAVE ( section_file_name, "IDENT", version_name )

Example:

The following saves all current customizations and preferences to file new$section.

SAVE ("new$section");

Errors:

TPU$_BADSYMTAB Internal table errors.

TPU$_SAVEAMBIGSYM Writing an ambiguous symbol.

TPU$_SAVEERROR Internal errors.

TPU$_SAVEUNDEFPROC Writing an undefined procedure.

TPU$_SECTUNDEFPROC Undefined procedure.