gmplStorageStatement
Mark Juras
Owned by Mark Juras
Storage Statement Summary
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.
Table of Contents