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, 10 Mar 1998 13:43:39 PDT Data gathered from the queue directory tree Channel: tcp_local Size Queued since -------------------------------------------------------------- 1 ZZ01HNP17LSUWY9D4DNR.HELD 4 10-MAR-1998 03:12:00 2 ZZ01HNP1RP3B6G9D4DNR.HELD 10 10-MAR-1998 11:46:23 3 ZZ01HNP42MAMAI9D4DNR.HELD 5 11-MAR-1998 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>