HELPLIB.HLB  —  DELETE
%DCL-I-DELKEY, DEFAULT key PF2 has been deleted %DCL-I-DELKEY, DEFAULT key PF3 has been deleted %DCL-I-DELKEY, DEFAULT key PF4 has been deleted $ In this example, the user has defined keys PF1 to PF4 in the default state. The DELETE/KEY command deletes all key definitions in the current state, which is the default state. 2.$ DEFINE/KEY PF3 "SHOW TIME" /TERMINATE %DCL-I-DEFKEY, DEFAULT key PF3 has been defined $ <PF3> $ SHOW TIME 14-DEC-2001 14:43:59 . . . $ DELETE/KEY PF3 %DCL-I-DELKEY, DEFAULT key PF3 has been deleted $ <PF3> $ In this example, the DEFINE/KEY command defines the PF3 key on the keypad as SHOW TIME. To delete the definition for the PF3 key, use the DELETE/KEY command. When the user presses PF3, only the system prompt is displayed.

8    /MAILBOX

    Valid for Alpha and Integrity server systems only.

    Deletes the specified mailbox.

    Requires PRMMBX (permanent mailbox) privilege.

    Format

      DELETE/MAILBOX  name

8.1  –  Parameter

 name

    Specifies the name of the mailbox device (MBAn) or the logical
    name pointing to the mailbox to be deleted

8.2  –  Qualifier

8.2.1    /LOG

       /LOG
       /NOLOG (default)

    Displays a notice when the mailbox is marked for deletion.)

8.3  –  Example

  $SHOW LOGICAL MY_MBX
     "MY_MBX" = "MBA37:" (LNM$SYSTEM_TABLE)
  $SHOW DEVICE MBA37

  Device                  Device           Error
   Name                   Status           Count
  MBA37:                  Online               0
  $DELETE/MAILBOX/LOG MBA37
  %DELETE-I-MBXDEL, Mailbox MBA37 has been marked for deletion
  $SHOW DEV MBA37
  %SYSTEM-W-NOSUCHDEV, no such device available

      This example shows the status of mailbox MBA37, which is
      pointed to by logical name MY_MBX, before and after it is
      deleted.

9    /QUEUE

    Deletes a print or batch queue created by the INITIALIZE/QUEUE
    command, and deletes all the jobs in the queue. The /QUEUE
    qualifier is required.

    Requires manage (M) access to the queue.

    To delete a queue manager on a node or OpenVMS Cluster system,
    add the /MANAGER qualifier.

    Format

      DELETE/QUEUE  queue-name[:]

9.1  –  Parameter

 queue-name[:]

    Specifies the name of the queue to be deleted.

9.2  –  Qualifier

9.2.1    /LOG

       /LOG
       /NOLOG (default)

    Controls whether the DELETE/QUEUE command displays the name of
    each queue after it is deleted.

9.3  –  Example

  $ INITIALIZE/QUEUE/DEFAULT=FLAG/START/ON=LPA0 LPA0_QUEUE
     .
     .
     .
  $ STOP/QUEUE/NEXT LPA0_QUEUE
  $ DELETE/QUEUE LPA0_QUEUE

      In this example, the first command initializes and starts the
      printer queue LPA0_QUEUE. The STOP/QUEUE/NEXT command stops the
      queue. The DELETE/QUEUE command deletes the queue.

9.4    /MANAGER

    Deletes a queue manager on a node or OpenVMS Cluster system. All
    queues and jobs managed by the specified queue manager are also
    deleted. You must first stop the queue manager. The /NAME_OF_
    MANAGER qualifier is required.

    Requires OPER (operator) and SYSNAM (system logical name)
    privileges.

    Format

      DELETE/QUEUE/MANAGER/NAME_OF_MANAGER=name

9.4.1  –  Qualifier

9.4.1.1    /NAME_OF_MANAGER

       /NAME_OF_MANAGER=string

    Identifies the name of the queue manager to be deleted. The
    /NAME_OF_MANAGER qualifier is required. The required name value
    can be up to 31 characters long and can be a logical name.

9.4.2  –  Example

  $ DELETE/QUEUE/MANAGER/NAME_OF_MANAGER=BATCH_MANAGER

      The DELETE/QUEUE/MANAGER/NAME_OF_MANAGER command in this
      example deletes the queue manager named BATCH_MANAGER. The
      command removes all references to the specified queue manager
      from the shared master file of the queue database and deletes
      the queue and journal files associated with the BATCH_MANAGER's
      database.

10    /SYMBOL

    Deletes one or all symbol definitions from a local or global
    symbol table. The /SYMBOL qualifier is required.

    Format

      DELETE/SYMBOL  [symbol-name]

10.1  –  Parameter

 symbol-name

    Specifies the name of the symbol to be deleted. A name is
    required unless the /ALL qualifier is specified. The symbol-name
    parameter is incompatible with the /ALL qualifier. Symbol names
    can have from 1 to 255 characters. By default, the DELETE/SYMBOL
    command assumes that the symbol is in the local symbol table for
    the current command procedure.

10.2  –  Qualifiers

10.2.1    /ALL

    Deletes all symbols from the specified table. If you do not
    specify either the /LOCAL or the /GLOBAL qualifier, all symbols
    defined at the current command level are deleted. The /ALL
    qualifier is incompatible with the symbol-name parameter.

10.2.2    /GLOBAL

    Deletes the symbol from the global symbol table of the current
    process.

10.2.3    /LOCAL

       /LOCAL (default)

    Deletes the symbol from the local symbol table of the current
    process.

10.2.4    /LOG

       /LOG
       /NOLOG (default)

    Controls whether an informational message listing each symbol
    being deleted is displayed.

10.3  –  Examples

    1.$ DELETE/SYMBOL/ALL

      In this example, the DELETE/SYMBOL command deletes all symbol
      definitions at the current command level.

    2.$ DELETE/SYMBOL/LOG KUDOS
      %DCL-I-DELSYM, LOCAL symbol KUDOS has been deleted

      In this example, the DELETE/SYMBOL command deletes the symbol
      KUDOS from the local symbol table for the current process. In
      addition, the /LOG qualifier causes an informational message,
      listing the symbol being deleted, to be displayed.

    3.$ DELETE/SYMBOL/GLOBAL PDEL

      In this example, the DELETE/SYMBOL command deletes the symbol
      named PDEL from the global symbol table for the current
      process.
Close Help