1  DEASSIGN
   Cancels a logical name assignment that was made with one of
   the following commands: ALLOCATE, ASSIGN, DEFINE, or MOUNT.
   The DEASSIGN command also deletes a logical name table that was
   created with the CREATE/NAME_TABLE command.

   You can also specify /QUEUE to deassign a logical queue from a
   printer or terminal queue and stop the logical queue.

   Format

     DEASSIGN  [logical-name[:]]


2  Parameter


logical-name[:]

   Specifies the logical name to be deassigned. Logical names can
   have from 1 to 255 characters. If the logical name contains
   any characters other than alphanumerics, dollar signs ($),
   or underscores (_),  enclose it in quotation marks (" "). The
   logical-name parameter is required unless you use the /ALL
   qualifier.

   If the logical-name parameter ends with a colon (:),  the command
   interpreter ignores the colon. (Note that the ASSIGN and ALLOCATE
   commands remove a trailing colon, if present, from a logical name
   before placing the name in a logical name table.) If the logical
   name contains one or more trailing colons, you must append one
   additional colon to the DEASSIGN logical-name parameter (for
   example, type DEASSIGN FILE:: to deassign the logical name
   FILE:).

   To delete a logical name table, specify the table name as the
   logical-name parameter. You must also use the /TABLE qualifier to
   indicate the logical name directory table where the table name is
   entered.


2  Qualifiers


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


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


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


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


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


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


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


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


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


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


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


2  Examples

   1.$ DEASSIGN MEMO

     The DEASSIGN command in this example deassigns the process
     logical name MEMO.

   2.$ DEASSIGN/ALL

     The DEASSIGN command in this example deassigns all process
     logical names that were created in user and supervisor mode.
     This command does not, however, delete the names that were
     placed in the process logical name table in executive mode by
     the command interpreter (for example, SYS$INPUT, SYS$OUTPUT,
     SYS$ERROR, SYS$DISK, and SYS$COMMAND).

   3.$ DEASSIGN/TABLE=LNM$PROCESS_DIRECTORY TAX

     The DEASSIGN command in this example deletes the logical name
     table TAX, and any descendant tables. When you delete a logical
     name table, you must specify either the /TABLE=LNM$PROCESS_
     DIRECTORY or the /TABLE=LNM$SYSTEM_DIRECTORY qualifier, because
     the names of all tables are contained in these directories.

   4.$ ASSIGN USER_DISK:   COPY
     $ SHOW LOGICAL COPY
        "COPY" = "USER_DISK:" (LNM$PROCESS_TABLE)
     $ DEASSIGN COPY

     The ASSIGN command in this example equates the logical name
     COPY with the device USER_DISK and places the names in the
     process logical name table. The DEASSIGN command deletes the
     logical name.

   5.$ DEFINE SWITCH:  TEMP
     $ DEASSIGN SWITCH::

     The DEFINE command in this example places the logical name
     SWITCH: in the process logical name table. The trailing
     colon is retained as part of the logical name. Two colons
     are required on the DEASSIGN command to delete this logical
     name because the DEASSIGN command removes one trailing colon,
     and the other colon is needed to match the characters in the
     logical name.

   6.$ ASSIGN/TABLE=LNM$GROUP DKA1: GROUP_DISK
     $ DEASSIGN/PROCESS/GROUP GROUP_DISK

     The ASSIGN command in this example places the logical name
     GROUP_DISK in the group logical name table. The DEASSIGN
     command specifies conflicting qualifiers; because the /GROUP
     qualifier is last, the name is successfully deassigned.



   7.$ ASSIGN DALLAS::USER_DISK:   DATA
        .
        .
        .
     $ DEASSIGN DATA

     The ASSIGN command in this example associates the logical name
     DATA with the device specification USER_DISK on remote node
     DALLAS. Subsequent references to the logical name DATA result
     in references to the disk on the remote node. The DEASSIGN
     command cancels the logical name assignment.


2  /QUEUE
   Deassigns a logical queue from a printer or terminal queue and
   stops the logical queue. The DEASSIGN/QUEUE command cannot be
   used with batch queues.

   Requires manage (M) access to the queue.

   Format

     DEASSIGN/QUEUE  logical-queue-name[:]


3  Parameter


logical-queue-name[:]

   Specifies the name of the logical queue that you want to deassign
   from a specific printer or terminal queue.


3  Example

 $ ASSIGN/QUEUE LPA0  ASTER
    .
    .
    .
 $ DEASSIGN/QUEUE  ASTER
 $ ASSIGN/MERGE LPB0  ASTER

     The ASSIGN/QUEUE command in this example associates the logical
     queue ASTER with the print queue LPA0. Later, you deassign the
     logical queue with the DEASSIGN/QUEUE command. The ASSIGN/MERGE
     command reassigns the jobs from ASTER to the print queue LPB0.