HELPLIB.HLB  —  ASSIGN  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.

    Assigns a clusterwide logical name in the LNM$SYSCLUSTER table.

2    /EXECUTIVE_MODE

    Requires SYSNAM (system logical name) privilege.

    Creates an executive-mode logical name. If you specify executive
    mode, but do not have SYSNAM privilege, a supervisor-mode logical
    name is created. The mode of the logical name must be the same
    as or external to (less privileged than) the mode of the table in
    which you are placing the name.

3    /GROUP

    Requires SYSPRV (system privilege) or GRPNAM (group logical name)
    privilege.

    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.

4    /JOB

    Places the logical name in the jobwide logical name table. All
    processes within the same job tree as the process creating the
    logical name can access the logical name. The /JOB qualifier is
    synonymous with the /TABLE=LNM$JOB qualifier.

5    /LOG

       /LOG (default)
       /NOLOG

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

6    /NAME_ATTRIBUTES

       /NAME_ATTRIBUTES[=(keyword[,...])]

    Specifies the attributes for a logical name. By default, no
    attributes are set. You can specify the following keywords for
    attributes:

    CONFINE    Does not copy the logical name into a spawned
               subprocess; this keyword is relevant only for logical
               names in a private table.

    NO_ALIAS   Prohibits creation of logical names with the same name
               in an outer (less privileged) access mode within the
               specified table. If another logical name with the same
               name and an outer access mode already exists in this
               table, the name is 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.

8    /SUPERVISOR_MODE

       /SUPERVISOR_MODE (default)

    Creates a supervisor-mode logical name in the specified table.

9    /SYSTEM

    Requires SYSNAM (system logical name) or SYSPRV (system
    privilege) privilege.

    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.

10    /TABLE

       /TABLE=name

    Requires write (W) access to the table if the table is
    shareable.

    Specifies 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, or system 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 ASSIGN/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.

    If you do not explicitly specify the /TABLE qualifier, the
    default is the /TABLE=LNM$PROCESS qualifier.

11    /TRANSLATION_ATTRIBUTES

       /TRANSLATION_ATTRIBUTES[=(keyword[,...])]

    Equivalence-name qualifier.

    Specifies attributes of the equivalence-name parameter. 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. If you
               specified the CONCEALED attribute, then the equivalence
               string must be a physical device name.

    TERMINAL   Indicates that the equivalence string should not be
               translated iteratively; logical name translation should
               terminate with the current equivalence string.

    If you specify only one keyword, you can omit the parentheses.
    Only the attributes you specify are set.

    Note that different equivalence strings of the same logical name
    can have different translation attributes specified.

12    /USER_MODE

    Creates a user-mode logical name in the specified table.

    If you specify a user-mode logical name in the process logical
    name table, that logical name is used for the execution of
    a single image only; user-mode entries are deleted from the
    logical name table when any image executing in the process
    exits; that is, after any DCL command that executes an image or
    user program completes execution. Also, user-mode logical names
    are automatically deleted when invoking and exiting a command
    procedure.
Close Help