1.$ DEFINE/USER_MODE TM1 $DISK1:[ACCOUNTS.MEMOS]WATER.TXT
In this example, the DEFINE command defines TM1 as equivalent
to a file specification. After the next image runs, the logical
name TM1 is automatically deassigned.
2.$ DEFINE CHARLIE XXX1:[CHARLES]
$ PRINT CHARLIE:TEST.DAT
Job 274 entered on queue SYS$PRINT
In this example, the DEFINE command associates the logical name
CHARLIE with the directory name [CHARLES] on the disk XXX1. The
PRINT command queues a copy of the file XXX1:[CHARLES]TEST.DAT
to the system printer.
3.$ DEFINE PROCESS_NAME LIBRA
$ RUN WAKE
In this example, the DEFINE command places the logical name
PROCESS_NAME in the process logical name table with an
equivalence name of LIBRA. The logical name is created in
supervisor mode. The program WAKE translates the logical name
PROCESS_NAME to perform some special action on the process
named LIBRA.
4.$ DEFINE TEMP: XXX1:
.
.
.
$ DEASSIGN TEMP::
In this example, the DEFINE command creates an equivalence
name for the logical name TEMP: and places the name in the
process logical name table. The colon is retained as part of
the logical name. The DEASSIGN command deletes the logical
name. Note that two colons are required on the logical name
in the DEASSIGN command. One colon is deleted by the DEASSIGN
command. The other colon is kept as part of the logical name.
5.$ DEFINE PORTLAND PRTLND::YYY0:[DECNET.DEMO.COM]
In this example, the DEFINE command places the logical name
PORTLAND in the process logical name table with an equivalence
name of PRTLND::YYY0:[DECNET.DEMO.COM]. Subsequent references
to the logical name PORTLAND result in the correspondence
between the logical name PORTLAND and the node, disk, and
subdirectory specified.
6.$ DEFINE LOCAL "BOSTON""JAY_SABLE JKS""::"
In this example, the DEFINE command places the logical name
LOCAL in the process logical name table with a remote node
equivalence name of BOSTON"JAY_SABLE JKS"::. To satisfy
conventions for local DCL command string processing, you
must use three sets of quotation marks. The quotation marks
ensure that access control information is enclosed in one set
of quotation marks in the equivalence name.
7.$ DEFINE MYDISK XXX0:[MYDIR], YYY0:[TESTDIR]
In this example, the DEFINE command places the logical name
MYDISK in the process logical name table with two equivalence
names: XXX0:[MYDIR] and YYY0:[TESTDIR].
8.$ DEFINE/TABLE=LNM$CLUSTER_TABLE FIRENZE FIRENZE::FIESOLE:[ETRUSCAN]
In this example, the DEFINE command equates FIRENZE to the
directory specification FIRENZE::FIESOLE:[ETRUSCAN] and places
both the new logical name (FIRENZE) and its equivalence string
(FIRENZE::FIESOLE:[ETRUSCAN]) in the default clusterwide table.
The new logical name is automatically propagated to all nodes
in the cluster.
9.$ CREATE/NAME_TABLE TABLE1
$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY LNM$FILE_DEV -
_$ TABLE1,LNM$PROCESS,LNM$JOB,LNM$GROUP,LNM$SYSTEM
$ DEFINE/TABLE=TABLE1 -
_$ /TRANSLATION_ATTRIBUTES=CONCEALED WORK_DISK DKA1:
In this example, the CREATE/NAME_TABLE command creates the
process private logical name table TABLE1.
The first DEFINE command ensures that TABLE1 is searched
first in any logical name translation of a device or file
specification (because TABLE1 is the first item in the
equivalence string for the logical name LNM$FILE_DEV, which
determines the default search sequence of logical name tables
whenever a device or file specification is translated).
The second DEFINE command assigns the logical name WORK_DISK
to the physical device DKA1 and places the name in TABLE1.
The logical name has the concealed attribute. Therefore, the
logical name WORK_DISK is displayed in system messages.
10$ CREATE/NAME_TABLE SPECIAL
$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY LNM$FILE_DEV -
_$ SPECIAL,LNM$PROCESS,LNM$JOB,LNM$GROUP,LNM$SYSTEM
$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY TAB SPECIAL
$ DEFINE/TABLE=TAB REPORT [CHELSEA]STORES
$ SHOW LOGICAL/TABLE=SPECIAL REPORT
"REPORT" = "[CHELSEA]STORES" (SPECIAL)
In this example, the CREATE/NAME_TABLE command is used to
create a new logical name table called SPECIAL. This table
is defined in the process directory, LNM$PROCESS_DIRECTORY.
The first DEFINE command ensures that SPECIAL is searched
first in any logical name translation of a device or file
specification (because SPECIAL is the first item in the
equivalence string for the logical name LNM$FILE_DEV, which
determines the default search sequence of logical name tables
whenever a device or file specification is translated). The
logical name LNM$FILE_DEV is placed in the process directory,
LNM$PROCESS_DIRECTORY.
With the next DEFINE command, a new logical name, TAB, is
defined. TAB translates to the string SPECIAL, which identifies
a logical name table. You must define TAB in the process
directory because it translates iteratively to a logical name
table.
Next, the logical name REPORT is placed into the logical name
table TAB. Because TAB translates to the table SPECIAL, the
name REPORT is entered into SPECIAL table. The SHOW LOGICAL
command verifies that the name REPORT has been entered into the
table SPECIAL.
Note that you can redefine TAB so it translates to a different
table. Therefore, if you run different programs that use the
name TAB as a table name, you can change the actual tables
where the names are entered or referenced.