SETVERSION [ HPTOOLSET XL Reference Manual ] MPE/iX 5.0 Documentation
HPTOOLSET XL Reference Manual
SETVERSION
Freezes changes to a file and increments the latest version number.
Syntax
SETV[ERSION] [filename]
Parameters
Filename Name of the file to which you want to assign a
version number. If the file name is not
specified, TOOLSET/XL will assign a version
number to the file you are currently editing.
Description
The SETVERSION command freezes a version so that no further changes can
be made and associates a new version number with the file. This command
is valid only for files that are owned by the current workspace, and
requires exclusive access to the file. Other users cannot access the
file while the command is executing. New files are automatically
assigned version 1. Further versions are assigned in ascending sequence
starting with version 2. When a new version is assigned to a file, the
contents of the previous version are frozen. You can have up to 32
active (non-purged) versions of a file at one time.
Each version logically includes active records from previous versions.
For example, if version 1 has 10 records and 3 records are added to
version 2, version 2 logically contains 13 records.
Example
Version 1:
1 This
2 is
3 version
4 1
5 of
6 the
7 file
8 YOURFILE
>>SETVERSION YOURFILE
Creates version 2 of YOURFILE. Version 1 above is now frozen and no
further changes can be made to it. Only the LATEST version, version 2,
can be modified. After modifying line 4, deleting line 6, and adding
lines 9 through 22, this is how version 2 would look.
Version 2:
1 This
2 is
3 version
4 2
5 of
7 file
8 YOURFILE
9 Notice
10 that
11 changes
12 can
13 be
14 made
15 to
16 it
17 because
18 it
19 is
20 the
21 LATEST
22 version
>>SETVERSION YOURFILE
Version 2 of YOURFILE has now been set. It contains records 1 through 5
and 7 through 22 since record #6 was deleted in version 2 above. You can
only make changes in version 3.
MPE/iX 5.0 Documentation