Delete one or more messages from the channel queue directory.

    Syntax

      DELETE  [message-id[,...]]

    Command Qualifiers             Defaults

    /ALL                           /NOALL
    /CHANNEL=name                  None
    /CONFIRM                       /NOCONFIRM
    /LOG                           /LOG

1  –  Parameters

 message-id[,...]

    A comma separated list of one or more message identification
    number or numbers shown by a previous DIRECTORY command. Ranges
    are allowed.

2  –  Description

    The DELETE command is used to delete one or more messages from
    the channel queue directories. The messages to be deleted are
    specified by their message identification numbers shown by
    the most recent DIRECTORY command. That number appears in the
    leftmost column of the DIRECTORY command listing. Ambiguous
    message numbers must be qualified by the proper channel name
    with the /CHANNEL qualifier.

    Note that the DELETE command irrevocably deletes each message
    it is instructed to delete: the messages are not returned to
    their originators nor will any further attempts to be made to
    deliver them to their recipients. The messages are permanently
    deleted. Often, it is preferable to use the RETURN command so as
    to return the message to its originator, (e.g., bounce it back to
    the sender).

3  –  Qualifiers

3.1    /ALL

       /ALL
       /NOALL (default)

    Delete all messages shown by the last DIRECTORY command. When
    used in conjunction with the /CHANNEL qualifier, only those
    messages shown by the last DIRECTORY command for the specified
    channel will be deleted.

    Unless /NOCONFIRM is specified with /ALL, you will be required to
    confirm any DELETE/ALL operation.

3.2    /CHANNEL

       /CHANNEL=name

    Specifies the name of the channel from which to delete messages.
    Wildcards are not permitted.

3.3    /CONFIRM

       /CONFIRM
       /NOCONFIRM (default)

    When /CONFIRM is specified, you will be prompted to confirm each
    message delete operation.

3.4    /LOG

       /LOG (default)
       /NOLOG

    Specifies whether informational messages for each message delete
    operation are generated.

4  –  Examples

      In the following example, the DIRECTORY command is used to
      list the messages in the local, l, channel. Then, the DELETE
      command is used to delete messages 1, 3, 20, 21, and 22. A
      range specification, 20-22, is used to specify message numbers
      20, 21, and 22.

  qm.maint> DIRECTORY L
  Mon, 23 Sep 2012 13:43:39 PDT
  Data gathered from the queue directory tree

  Channel: l                        Size Queued since
  --------------------------------------------------------------
      1 ZZ01HNP17LSUWY9D4DNR.00        4 23-SEP-2012 01:10:23
      2 ZZ01HNP1RP3B6G9D4DNR.00       10 23-SEP-2012 01:10:24
      3 ZZ01HNP42MAMAI9D4DNR.00        3 23-SEP-2012 01:10:24
      4 ZZ01HNP4MEWC8G9D4DNR.00        8 23-SEP-2012 06:18:57
        ...
     24 ZZ01HNP90X63ZG9D4DNR.00        6 23-SEP-2012 13:21:14
  --------------------------------------------------------------
  Total size:                        108

  24 total messages queued
  qm.maint> DELETE 1,3,20-22
  %QM-I-DELETED, deleted the message file PMDF_QUEUE:[L]ZZ01HNP17LSUWY9D4DNR.00
  %QM-I-DELETED, deleted the message file PMDF_QUEUE:[L]ZZ01HNP42MAMAI9D4DNR.00
  %QM-I-DELETED, deleted the message file PMDF_QUEUE:[L]ZZ01HNP76RTGHY9D4DNR.00
  %QM-I-DELETED, deleted the message file PMDF_QUEUE:[L]ZZ01HNP82HTXYB9D4DNR.00
  %QM-I-DELETED, deleted the message file PMDF_QUEUE:[L]ZZ01HNP83JPOCV9D4DNR.00
  qm.maint>