List currently queued messages which have been marked as held.

Syntax

held [channel-name]

Command Qualifiers	Defaults
-database	See text
-directory_tree	See text
-envelope	See text
-file_info	-file_info
-held	-held

Parameters

channel-name

An optional parameter specifying the channel for which to obtain a directory listing. Wildcards are permitted.

Description

The held command is a synonym for the directory -held command. See the description of the directory command for further information.

Qualifiers

-database

-directory_tree

Controls whether the information presented is gathered from the queue cache database, -database, or by looking at the actual directory tree containing the channel queues, -directory_tree. When neither -database or -directory_tree is specified, then the "view" selected with the view command will be used. If no view command has been issued, then -directory_tree is assumed.

-envelope

Display envelope To: and From: for the held messages listed.

-file_info (default)

-nofile_info

By default, message file size and creation date information is gathered. However, this requires accessing each message file. Specify -nofile_info if you want to avoid that overhead.

-held (default)

-noheld

Show information only for those channels with held messages.