Mark one or more messages as being held.

    Syntax

      HOLD  [message-id[,...]]

    Command Qualifiers             Defaults

    /ALL                           /NOALL
    /CHANNEL=name                  None
    /CONFIRM                       /NOCONFIRM
    /LOG                           /LOG

1  –  Parameters

 message-id[,...]

    A comma separated list of one or more message identification
    numbers shown with a previous DIRECTORY command. Ranges are
    allowed.

2  –  Description

    Use the HOLD command to mark as held any messages which should
    temporarily be placed on "hold". PMDF will not attempt to deliver
    any messages which are marked as held. To resume processing of a
    held message, use the RELEASE command. 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
    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.

3  –  Qualifiers

3.1    /ALL

       /ALL
       /NOALL (default)

    Hold all messages shown by the last DIRECTORY command. When used
    in conjunction with the /CHANNEL qualifier, only those messages
    shown by the last directory command for the specified channel
    will be held.

    Unless /NOCONFIRM is specified with /ALL, you will be required to
    confirm any HOLD/ALL operation.

3.2    /CHANNEL

       /CHANNEL=name

    Specifies the name of the channel from which to hold messages.
    Wildcards are not permitted.

3.3    /CONFIRM

       /CONFIRM
       /NOCONFIRM (default)

    When /CONFIRM is specified, you will be prompted to confirm each
    message hold operation.

3.4    /LOG

       /LOG (default)
       /NOLOG

    Specifies whether informational messages for each message hold
    operation are generated.

4  –  Examples

      In the following example, the DIRECTORY command is used to
      list the messages in the local, l, channel. Then, the HOLD
      command is used to hold messages 1, 3, 20, 21, and 22. A range
      specification, 20-22, is used to specify message numbers 20,
      21, and 22.

  qm.maint> DIRECTORY L
  Fri, 10 Mar 2012 13:43:39 PDT
  Data gathered from the queue directory tree

  Channel: l                        Size Queued since
  --------------------------------------------------------------
      1 ZZ01HNP17LSUWY9D4DNR.00        4 15-NOV-2012 01:10:23
      2 ZZ01HNP1RP3B6G9D4DNR.00       10 10-MAR-2012 01:10:24
      3 ZZ01HNP42MAMAI9D4DNR.00        3 10-MAR-2012 01:10:24
      4 ZZ01HNP4MEWC8G9D4DNR.00        8 10-MAR-2012 06:18:57
        ...
     24 ZZ01HNP90X63ZG9D4DNR.00        6 10-MAR-2012 13:21:14
  --------------------------------------------------------------

  24 total messages queued
  qm.maint> HOLD 1,3,20-22
  %QM-I-HELD, held the message file PMDF_QUEUE:[L]ZZ01HNP17LSUWY9D4DNR.00
  %QM-I-HELD, held the message file PMDF_QUEUE:[L]ZZ01HNP42MAMAI9D4DNR.00
  %QM-I-HELD, held the message file PMDF_QUEUE:[L]ZZ01HNP76RTGHY9D4DNR.00
  %QM-I-HELD, held the message file PMDF_QUEUE:[L]ZZ01HNP82HTXYB9D4DNR.00
  %QM-I-HELD, held the message file PMDF_QUEUE:[L]ZZ01HNP83JPOCV9D4DNR.00
  qm.maint>