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>