HELPLIB.HLB  —  DEASSIGN  Qualifiers

1    /ALL

    Deletes all logical names in the same or an outer (less
    privileged) access mode. If no logical name table is specified,
    the default is the process table, LNM$PROCESS. If you specify the
    /ALL qualifier, you cannot enter a logical-name parameter.

2    /CLUSTER_SYSTEM

    You must be signed in to the SYSTEM account or have SYSNAM
    (system logical name) or SYSPRV (system) privilege to deassign
    a clusterwide logical name.

    Deassigns a logical name from the LNM$SYSCLUSTER table.

3    /EXECUTIVE_MODE

    Requires SYSNAM (system logical name) privilege to deassign
    executive-mode logical names.

    Deletes only entries that were created in the specified mode
    or an outer (less privileged) mode. If you do not have SYSNAM
    privilege for executive mode, a supervisor-mode operation is
    assumed.

4    /GROUP

    Requires GRPNAM (group logical name) or SYSPRV privilege to
    delete entries from the group logical name table.

    Indicates that the specified logical name is in the group
    logical name table. The /GROUP qualifier is synonymous with the
    /TABLE=LNM$GROUP qualifier.

5    /JOB

    Indicates that the specified logical name is in the jobwide
    logical name table. The /JOB qualifier is synonymous with the
    /TABLE=LNM$JOB qualifier. If you do not explicitly specify a
    logical name table, the default is the /PROCESS qualifier.

    You should not deassign jobwide logical name entries that were
    made by the system at login time, for example, SYS$LOGIN,
    SYS$LOGIN_DEVICE, and SYS$SCRATCH. However, if you assign new
    equivalence names for these logical names (that is, create new
    logical names in outer access modes), you can deassign the names
    you explicitly created.

6    /LOG

       /LOG (default)
       /NOLOG

    /NOLOG overrides the default /LOG to suppress output of a fatal
    error that would be returned if the specified logical name were
    not found. When you specify /NOLOG, $STATUS is set to Success
    instead of to Fatal and no error message is output.

7    /PROCESS

       /PROCESS (default)

    Indicates that the specified logical name is in the process
    logical name table. The /PROCESS qualifier is synonymous with
    the /TABLE=LNM$PROCESS qualifier.

    You cannot deassign logical name table entries that were made by
    the command interpreter, for example, SYS$INPUT, SYS$OUTPUT, and
    SYS$ERROR. However, if you assign new equivalence names for these
    logical names (that is, create new logical names in outer access
    modes), you can deassign the names you explicitly created.

8    /SUPERVISOR_MODE

       /SUPERVISOR_MODE (default)

    Deletes entries in the specified logical name table that were
    created in supervisor mode. If you specify the /SUPERVISOR_MODE
    qualifier, the DEASSIGN command also deassigns user-mode entries
    with the same name.

9    /SYSTEM

    Indicates that the specified logical name is in the system
    logical name table. The /SYSTEM qualifier is synonymous with
    the /TABLE=LNM$SYSTEM qualifier.

10    /TABLE

       /TABLE=name

    Specifies the table from which the logical name is to be deleted.
    Defaults to LNM$PROCESS. The table can be the process, group,
    job, or system table, one of the directory tables, or the name
    of a user-created table. (The process, job, group, and system
    logical name tables should be referred to by the logical names
    LNM$PROCESS, LNM$JOB, LNM$GROUP, and LNM$SYSTEM, respectively.)

    The /TABLE qualifier also can be used to delete a logical name
    table. To delete a process-private table, enter the following
    command:

    $ DEASSIGN/TABLE=LNM$PROCESS_DIRECTORY table-name

    To delete a shareable table, enter the following command:

    $ DEASSIGN/TABLE=LNM$SYSTEM_DIRECTORY table-name

    To delete a shareable logical name table, you must have delete
    (D) access to the table or write (W) access to the directory
    table in which the name of the shareable table is cataloged.

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

11    /USER_MODE

    Deletes entries in the process logical name table that were
    created in user mode. If you specify the /USER_MODE qualifier,
    the DEASSIGN command can deassign only user-mode entries. Also,
    user-mode logical names are automatically deleted when invoking
    and exiting a command procedure.
Close Help