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

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.

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).

Qualifiers

/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.

/CHANNEL=name

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

/CONFIRM

/NOCONFIRM (default)

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

/LOG (default)

/NOLOG

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

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>