Copyright Digital Equipment Corp. All rights reserved.
Qualifiers
/CLUSTER_SYSTEM
You must be signed in to the SYSTEM account or have SYSNAM
(system logical name) or SYSPRV (system) privilege to use this
qualifier.
Defines a clusterwide logical name in the LNM$SYSCLUSTER table.
/EXECUTIVE_MODE
Requires SYSNAM (system logical name) privilege to create an
executive-mode logical name.
Creates an executive-mode logical name in the specified table.
If you specify the /EXECUTIVE_MODE qualifier and you do not have
SYSNAM privilege, the DEFINE command ignores the qualifier and
creates a supervisor-mode logical name. The mode of the logical
name must be the same or less privileged than the mode of the
table in which you are placing the name.
/GROUP
Requires GRPNAM (group logical name) or SYSNAM (system logical
name) privilege to place a name in the group logical name table.
Places the logical name in the group logical name table. Other
users who have the same group number in their user identification
codes (UICs) can access the logical name. The /GROUP qualifier is
synonymous with the /TABLE=LNM$GROUP qualifier.
If you enter more than one of the qualifiers /PROCESS, /JOB,
/GROUP, /SYSTEM, or /TABLE, only the last one entered is
accepted.
/JOB
Places the logical name in the jobwide logical name table. All
processes in the same job tree as the process that created the
logical name can access the logical name. The /JOB qualifier is
synonymous with the /TABLE=LNM$JOB qualifier.
If you enter more than one of the qualifiers /PROCESS, /JOB,
/GROUP, /SYSTEM, or /TABLE, only the last one entered is
accepted.
/LOG
/LOG (default)
/NOLOG
Displays a message when a new logical name supersedes an existing
name.
/NAME_ATTRIBUTES
/NAME_ATTRIBUTES[=(keyword[,...])]
Specifies attributes for a logical name. By default, no
attributes are set. Possible keywords are as follows:
CONFINE The logical name is not copied into a spawned
subprocess. This qualifier is relevant only for logical
names in a private table.
The logical name inherits the CONFINE attribute from
the logical name table where it is entered; if the
logical name table is "confined," then all names in the
table are "confined."
NO_ALIAS A logical name cannot be duplicated in the specified
table in a less privileged access mode; any previously
created identical names in an outer (less privileged)
access mode within the specified table are deleted.
If you specify only one keyword, you can omit the parentheses.
Only the attributes you specify are set.
/PROCESS
/PROCESS (default)
Places the logical name in the process logical name table. The
/PROCESS qualifier is synonymous with the /TABLE=LNM$PROCESS
qualifier.
If you enter more than one of the qualifiers /PROCESS, /JOB,
/GROUP, /SYSTEM, or /TABLE, only the last one entered is
accepted.
/SUPERVISOR_MODE
/SUPERVISOR_MODE (default)
Creates a supervisor-mode logical name in the specified table.
The mode of the logical name must be the same as or less
privileged than the mode of the table in which you are placing
the name.
/SYSTEM
Requires write (W) access or SYSNAM (system logical name)
privilege to place a name in the system logical name table.
Places the logical name in the system logical name table. All
system users can access the logical name. The /SYSTEM qualifier
is synonymous with the /TABLE=LNM$SYSTEM qualifier.
If you enter more than one of the qualifiers /PROCESS, /JOB,
/GROUP, /SYSTEM, or /TABLE, only the last one entered is
accepted.
/TABLE
/TABLE=name
Requires write (W) access to the table to specify the name of a
shareable logical name table.
Specifies the name of the logical name table in which the logical
name is to be entered. You can use the /TABLE qualifier to
specify a user-defined logical name table (created with the
CREATE/NAME_TABLE command); to specify the process, job, group,
system, or clusterwide logical name tables; or to specify the
process or system logical name directory tables.
If you specify the table name using a logical name that has more
than one translation, the logical name is placed in the first
table found. For example, if you specify DEFINE/TABLE=LNM$FILE_
DEV and LNM$FILE_DEV is equated to LNM$PROCESS, LNM$JOB,
LNM$GROUP, and LNM$SYSTEM, then the logical name is placed in
LNM$PROCESS.
The default is the /TABLE=LNM$PROCESS qualifier.
If you enter more than one of the qualifiers /PROCESS, /JOB,
/GROUP, /SYSTEM, or /TABLE, only the last one entered is
accepted.
/TRANSLATION_ATTRIBUTES
/TRANSLATION_ATTRIBUTES[=(keyword[,...])]
Equivalence-name qualifier.
Specifies one or more attributes that modify an equivalence
string of the logical name. Possible keywords are as follows:
CONCEALED Indicates that the equivalence string is the name of
a concealed device. When a concealed device name is
defined, the system displays the logical name, rather
than the equivalence string, in messages that refer to
the device.
TERMINAL Logical name translation should terminate with
the current equivalence string; indicates that
the equivalence string should not be translated
iteratively.
If you specify only one keyword, you can omit the parentheses.
Only the attributes you specify are set.
Note that different equivalence strings of a logical name can
have different translation attributes.
/USER_MODE
Creates a user-mode logical name in the specified table.
User-mode logical names created within the process logical
name tables are used for the execution of a single image; for
example, you can create a user-mode logical name to allow an
image executing in a command procedure to redefine SYS$INPUT.
User-mode entries are deleted from the process logical name table
when any image executing in the process exits (that is, after
a DCL command or user program that executes an image completes
execution). Also, user-mode logical names are automatically
deleted when invoking and exiting a command procedure.