HELP DEASSIGN — MicroVMS 4.4
Deletes a logical name. Logical names in private tables are deleted automatically when your process terminates. All logical names in the job table and the job table itself are deleted when your process terminates. User mode logical names in the process table are deleted automatically when the next image exits. All other logical names in shareable tables remain unless explicitly deassigned. All names in descendant tables are deleted when the parent table logical name is deassigned. Format DEASSIGN [logical-name[:]]
Additional information available:
Parameters
logical-name
The logical name to be deleted. Names containing other than
alphanumeric, dollar sign, or underscore characters must be enclosed
in quotation marks ("). If the name ends with a colon, you must
specify two colons. Incompatible with the /ALL qualifier.
Qualifiers
Additional information available:
/ALL/EXECUTIVE_MODE/GROUP/PROCESS/SUPERVISOR_MODE
/SYSTEM/TABLE/USER_MODE
/ALL
Deletes all logical names in the same or an outer (less privileged) access mode. Incompatible with the logical-name parameter.
/EXECUTIVE_MODE
/SUPERVISOR_MODE (default) /USER_MODE Requires SYSPRV privilege for /EXECUTIVE_MODE. Deletes only entries that were created in the specified mode or an outer (less privileged) mode. If you do not have SYSPRV privilege for /EXECUTIVE_MODE, a /SUPERVISOR_MODE operation is assumed.
/GROUP
/JOB /PROCESS (default) /SYSTEM Group logical names require GRPNAM or SYSPRV privilege. System logical names require SYSNAM or SYSPRV privilege. Specifies the table in which the logical name resides. The /GROUP qualifier is synonymous with /TABLE=LNM$GROUP. The /JOB qualifier is synonymous with /TABLE=LNM$JOB. The /PROCESS qualifier is synonymous with /TABLE=LNM$PROCESS. The /SYSTEM qualifier is synonymous with /TABLE=LNM$SYSTEM.
/PROCESS
See /GROUP.
/SUPERVISOR_MODE
See /EXECUTIVE_MODE.
/SYSTEM
See /GROUP.
/TABLE=name
Requires write access to the table to delete a shareable logical name. Requires SYSPRV or delete access to delete a shareable logical name table. 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.
/USER_MODE
See /EXECUTIVE_MODE.
/QUEUE
Deassigns a logical queue from a physical device queue. Any jobs in the queue are left pending until the logical queue is reassigned to another device queue. Format DEASSIGN/QUEUE logical-queue-name[:] Requires the Secure User Environment Option. Requires the OPER privilege or EXECUTE access to the queue.
Additional information available:
Parameters
logical-queue-name[:] Name of the logical queue.