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, re-enter them in the queue cache database, and run the associated channel so the messages can be processed. Messages which have been held can be listed with the DIRECTORY/HELD command.

The messages to be released 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.

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