Marc's Place

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.

   Deassigns a logical queue from a printer or terminal queue and
   stops the logical queue (see /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 a colon
   is present in the logical name, you must type two colons in the
   logical-name parameter of the DEASSIGN command (for example,
   DEASSIGN 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.
 

/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 SYSPRV
   (system privilege) 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.
 

/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, you 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 DBA1: 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. 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.
Software development, photography, jokes, ....

Sites by me

Hosting Favorites

Blogroll

Marc's Place

1 DEASSIGN
