HP 3000 Manuals

HPTOOLSET XL Reference Manual

SETREF 

Designates the Reference version of a source file.

Syntax 

     SETR[EF] filename1[version designator1]
              [,filename2[version designator2]]...

Parameters 

Filename                  Name of the file for which you want to specify
                          a reference version.

Version Designator        Specifies the particular version of the file.
                          Takes the form:

                          #n where n is an integer, L[atest], or
                          R[eference]

Description 

Only the owner of a file can set the reference version for other users
and setting it requires exclusive access to the file.

You can display the reference versions of files with the SHOW FILES
command.

Example 

The current LATEST version of AFILE is version #5.  If the following
command instructions are performed on AFILE, the reference version will
no longer be the LATEST version.

     (1)  >>SETREF AFILE#3

Sets the reference version to #3.  The users reference version #3.  The
owner of AFILE references the LATEST version, version #5, by default.

     (2)  >>SETREF AFILE

Sets the reference version equal to the LATEST, version #5.  Users and
the file owner both reference version #5 by default.

     (3)  >>SETVERSION AFILE

Freezes version #5 so that no further changes can be made to it.  Sets
the latest version equal to #6.  The reference version does not change.
It is equal to #5.

     (4)  >>PURGE AFILE#R

Purges the current reference version, #5.  This sets the reference
version equal to the LATEST version which is #6 until the SETREF command
is performed.

MPE/iX 5.0 Documentation