Release one or more held messages.

Syntax

release [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 numbers shown with a previous directory -held command. Ranges are allowed.

Description

Use the release command to release any messages previously marked as held and re-enter them in the queue cache database. Messages which have been held can be listed with the directory -held command.

The messages to be held are specified by their message identification numbers shown by the most recent directory -held command. That number appears in the leftmost column of the directory -held command listing. Ambiguous message numbers must be qualified by the proper channel name with the -channel qualifier.

Qualifiers

-all

-noall (default)

Release all messages shown by the last directory -held command. When used in conjunction with the -channel qualifier, only those messages shown by the last directory -held command for the specified channel will be released. Unless -noconfirm is specified with -all, you will be required to confirm any release -all operation.

-channel=name

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

-confirm

-noconfirm (default)

When -confirm is specified, you will be prompted to confirm each message release operation.

-log (default)

-nolog

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

EXAMPLES

In the following example, the directory -held command is used to list held messages in the tcp_local channel. Then, the release command is used to release all of the held messages from that channel.

qm.maint> directory -held tcp_local Fri, 15 Nov 2002 13:43:39 -0800 (PST) Data gathered from the queue directory tree Channel: tcp_local Size Queued since -------------------------------------------------------------- 1 ZZ01HNP17LSUWY9D4DNR.HELD 4 15-Nov-2002 03:12:00 2 ZZ01HNP1RP3B6G9D4DNR.HELD 10 15-Nov-2002 11:46:23 3 ZZ01HNP42MAMAI9D4DNR.HELD 5 15-Nov-2002 18:17:01 -------------------------------------------------------------- Total size: 19 3 total messages queued qm.maint> release -all Release all message files (Y/N, default is N)? YES %QM-I-RELEASED, released the message file /pmdf/queue/tcp_local/ZZ01HNP17LSUWY9D4DNR.HELD %QM-I-RELEASED, released the message file /pmdf/queue/tcp_local/ZZ01HNP1RP3B6G9D4DNR.HELD %QM-I-RELEASED, released the message file /pmdf/queue/tcp_local/ZZ01HNP42MAMAI9D4DNR.HELD qm.maint>