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[:]]
1 – 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
2.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.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.
2.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.
2.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.
2.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.
2.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.
2.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.
2.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.
2.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.
2.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.
2.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.
3 – 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.
4 /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[:]
4.1 – Parameter
logical-queue-name[:]
Specifies the name of the logical queue that you want to deassign
from a specific printer or terminal queue.
4.2 – 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.