MakePersistent

(Engine-Level Function)

Description: Takes a variable and makes it persistent (static).
Returns: Nothing
Usage: Script or steady state.
Function Groups: Compilation and On-Line Modifications,  Variable
Related to: AddVariable | FindVariable | MakeNonPersistent | MakeNonShared | MakeShared | PersistentSize
Format: MakePersistent(Variable, Size)
Parameters:  
Variable
Required. Any expression for the variable value. This value is typically returned from a FindVariable or an AddVariable call.
Size
Required. Any numeric expression giving the number of bytes of storage allocated in the .VAL persistent variable file for this variable.
For array types, set this to the byte size of the largest array element (normally 8 bytes for numeric values). For arrays containing text, enter the character length of the longest string element.
Comments: Because a variable can not be persistent without being shared as well it will make Variable shared. (see MakeShared for the results of this). If the variable is already persistent,. there will be no change made to the variable. In particular, the persistent size of the variable will not change.