HP 3000 Manuals

USE [ HPTOOLSET XL Reference Manual ] MPE/iX 5.0 Documentation


HPTOOLSET XL Reference Manual

USE 

Allows two workspaces to share a file and specifies the version to be
shared.

Syntax 

     USE filename1[version designator] [,filename2[version designator]]...

     USE [formal1 |FOR|] filename1[version designator]
         [,[formal2 |FOR|] filename2[version designator]] ...

The first format allows you to share a file that is owned by another
workspace.  A specific version of the file can be shared if you specify a
version number.  If you do not, a default access version will be
assigned.  The default version of a shared file is the Reference version.

The second version is an extension of the first and allows you to specify
a formal designator.  It generates a file equation between formal and
filename so you can refer to the shared file by a different name.

Parameters 

Filename1                 Name assigned to the file you want to share.

Version Designator        Takes the form:  #n where n is an integer,
                          L[ATEST], or R[EFERENCE].

                          Allows you to specify which version of a file
                          you want to share.  If a version designator is
                          not specified, TOOLSET/XL will use the default
                          (Reference) version.

Formal                    Is the formal file designator.  It may be up to
                          8 alphanumeric characters long.

Filename                  Actual file designator for the file equation.

Description 

TOOLSET/XL automatically generates the file equations implied by the
second format every time you enter the associated workspace.  The USE
command need only be issued once per file.

A file version that is specified in the USE command can be overridden by
specifying another version number in a subsequent TOOLSET/XL operation.
For example, if you have entered the USE command:

>>USE ZFILE#2

Version 2 of ZFILE will be accessed by default.  You can override this
default by specifying a new version.

>>CONVERT ZFILE#4 TO NEWFILE

converts version #4 of ZFILE, overriding the version specified in the USE
command.

Example 

     (1) >>USE JFILE FOR KFILE.group
               .         .
               .         .
               Work-     .
               space A   .
                         .
                         Work-
                         space B

Allows Workspace A to share KFILE owned by Workspace B. Because Workspace
B resides in a different group, KFILE must be qualified with its group.
Since no version is specified for KFILE, Workspace A uses the default
version (Reference version).

TOOLSET/XL sets up a file equation for JFILE and KFILE.group.

     (2)  >>USE GFILE#5

Indicates that version 5 of GFILE is to be used by default when GFILE is
opened.  This command can be entered by the owner of GFILE or a user
sharing GFILE.


MPE/iX 5.0 Documentation