PMDF System Manager's Guide
PMDF-REF-6.0

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
Tue, 10 Mar 1998 13:43:39 -0800 (PST) 
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>