VMS Help  —  DEFINE  Qualifiers

1    /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.

2    /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.

3    /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.

4    /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.

5    /LOG

       /LOG (default)
       /NOLOG

    Displays a message when a new logical name supersedes an existing
    name.

6    /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.

7    /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.

8    /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.

9    /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.

10    /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.

11    /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.

12    /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.
Close Help