Storage is a terminal, command statement that occurs in command scripts. This statement specifies the
status of the virtual binary information file to be used. It must be the first statement in the script
and should always be included.
The attributes of the Storage statement are as follows:
Attribute
Description
Action
This required attribute specifies the storage action
to be performed. It can have one of five options --
CREATE, OPEN, APPEND, CLOSE,
and SAVE. These actions are described below.
Identifier
This optional attribute is the full pathname of the file
containing or to contain the information being stored.
Optionally, the filename extension may be omitted. In
which case the extension vbi is used. If this
attribute is omitted, then a memory-based storage area
is used. Memory-based storage is much quicker to use, but
any information stored is lost when the run ends.
Startup
This optional attribute is the full pathname of a file
whose content should be used to initialize the current
storage area when it is created. Optionally, the filename
extension may be omitted. In this case, vbi is
used. This attribute is only valid when a file-based
storage area is being created. The content of the
startup file itself is not changed.
The create action creates a new storage area. If no startup file is
specified, then the storage area is initially empty. If the startup file is
specified and the storage area is file-based, then it is initialized with
the information in the startup file. In addition, if the startup file was
closed with a save action, then the additional save runtime information
is loaded as well.
The open action opens an existing file-based storage area for read-
only access. No changes to the storage can be made.
The append action opens an existing file-based storage area for
read-write access.
The close flushes any information being retained in memory for the
storage area and the closes the storage file if it is file-based. Memory
based storage areas are destroyed by the close.
The save action saves the internal tool runtime status information
in the storage area and then performs a normal close operation. This
ensures that when a later script uses this file for its startup, then the
tool will be in the same state as when the previous save was performed.
Note that the UseLocalMemory select attribute can be used to override the
Identifier attribute of this command. When UseLocalMemory is turned on,
only memory-based storage areas are created.