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