Sun Java System Messaging Server 6.3 Administration Reference

imsimta qm Options

The delete, history, hold, read, release, and return sub-commands all support the following options and parameter:

Option  

Description  

-channel=name

Operates on the specified channel. 

-all

The -all option may be used to operate on all of the previously listed messages. When used in conjunction with the -channel option, only those previously listed messages for the specified channel are operated on. The -all option may not be used in conjunction with an id parameter. However, -all or at least one id parameter must be specified. 

-confirm and -noconfirm

When the id parameter is not used to explicitly select messages, you will be prompted to confirm the operation. This prevents accidental delete -all sub-commands from being executed. You can use the -noconfirm option to suppress this prompt. Similarly, -confirm causes a confirmation prompt to be required.

-log and -nolog

Controls whether or not the operation on each selected message is reported. 

id

The identification number of a message shown in the most recent listing generated by either the directory or the held sub-command. The identification number for a message is the integer value displayed in the left-most column of the listing. The id can also be a range or comma-separated list.

These options identify the messages to which the command is applied. When none of the options are specified, at least one id parameter must be supplied.

For example, in the following listing the first message displayed has an identification number of 1 and the second 2:


qm.maint> directory tcp_local

Channel: tcp_local                Size Queued since
--------------------------------------------------------------
1 XS01IVX1T0QZ18984YIW.00       24 16-APR-1998 00:30:30.07
2 YH01IW2MZLN0RE984VUK.00       24 20-APR-1998 00:30:40.31

These two messages can therefore be selected by either “1,2” or “1-2”.