HP 3000 Manuals

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