HP 3000 Manuals HP 3000 Manuals
TSAM Files & Version Management Whether you operate in a single or multiple programming environment, programs undergo multiple changes. TOOLSET/XL recognizes and manages each changed file as a version. As you make changes to your file (additions, deletions, and updates), these changes are kept as versions of the same file. Adding Versions The TOOLSET/XL SETVERSION command freezes changes to a file and increments the LATEST version. Versions are referred to by number and the most recent copy of a file is known as the LATEST version. When a file is created, it is version 1. The first SETVERSION command adds version 2 and subsequent SETVERSION commands add versions 3, 4, and so on. Each version logically includes records from previous versions. You can list all changes with the LIST CHANGE command. Latest Version The Latest version of a file is the working or most recent version of a text file, and is the only one that can be modified. Modifications can only be made by the owner of the workspace. Each text file can have up to 32 active versions. An active version is one that has not been purged. Reference Version The Reference version is the version that is accessed by users other than the owner of the workspace. It must be defined with the SETREF command. If you do not define the Reference version the LATEST version will be the default. Version Access Versions are accessed according to the access pointer setting. The owner of a file that is shared can set the access pointer with the SETREF command. This will specify the version of the file that is to be referenced by other users. The version that is set with the SETREF command is the Reference version. If no version has been set by the file owner, other users access the LATEST version by default. Only the LATEST version of a file can be modified. If you own a file, you always access the LATEST version of the file unless you issue a USE or request a particular version. While the LATEST version is being edited, it is locked and no other users can access it. To enable other users, including the compiler, to read the LATEST version, you must end the edit operation with the END EDIT command or function key. By default, you compile the LATEST versions of the files you own and the most stable (Reference) versions of the files you do not own or have issued a USE on. A USE overrides an OWN. If you issue a USE command for a file which you own, you access the Reference version of the file by default until a DISCARD is issued to negate the USE. If an abnormal termination occurs while you are accessing the LATEST version of the file, the file remains locked. It must be recovered before it can be accessed. A LIST CHANGE command is available to provide a listing of the changes from one version of a file to a higher version.