ArborX


savevars

Longname: save var iable s   Open the Documentation Legend
Released: not available 
Created: not available 
See also: run ^

Summary
Variables only retain their values until Arbortext APP is shut down. Variables that need to be preserved until the next time Arbortext APP is started can be saved to a file with savevars and reinstated next time they are needed, usually with run.
Example extract

The following examples illustrate typical uses of savevars:

 savevars "c:/all_vars.3m","*"

The above syntax saves all the variables to a file called all_vars.3m

 savevars "myvars.3m","dave_*"

The above example saves all the variables that begin with "dave_" to a file called myvars.3m

 savevars "d:/3d/types.3m","type_?_var"

This example saves the variables that begin with "type_?_var" to a file called types.3m in the folder d:/3d/.

 savevars "c:/temp/myvars.3m","myvars_*"

Saves all the variables which that begin with "myvars_" in a file named myvars.3m, in the folder c:/temp.

It is often useful to save variables directly to a tag that is actually contained within the document, such as the autoexec tag. You can do this by saving variables to one of Arbortext APP's internal file areas. Beloew are three examples of this:

 savevars "{0}autoexec.sc"*"pattern"

Overwrite or create a new autoexec tag.

 savevars "{1}autoexec" "*"

Inserts at the top of autoexec.

 savevars "{2}autoexec" "*"

Inserts at the end of autoexec.


Syntax (SVNNA)
filename:s

The full name of the file to which to save Arbortext APP variables. For the sake of consistency, this should usually have the extension .3m, to denote a macro file.

pattern:s

A wildcard pattern specifying which variables are to be saved to filename. If you want to make your own macro files (for example, to set Arbortext APP up in a particular way) we suggest using a file extension of .3m for the sake of consistency.


Document created on 08-Feb-2003 (revision 1)