Release one or more held messages.

    Syntax

      RELEASE  [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/HELD command. Ranges are
    allowed.

2  –  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.

3  –  Qualifiers

3.1    /ALL

       /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.

3.2    /CHANNEL

       /CHANNEL=name

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

3.3    /CONFIRM

       /CONFIRM
       /NOCONFIRM (default)

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

3.4    /LOG

       /LOG (default)
       /NOLOG

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

4  –  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, 15 Nov 2012 13:43:39 PDT
  Data gathered from the queue directory tree

  Channel: tcp_local                Size Queued since
  --------------------------------------------------------------
      1 ZZ01HNP17LSUWY9D4DNR.HELD      4 13-NOV-2012 03:12:00
      2 ZZ01HNP1RP3B6G9D4DNR.HELD     10 14-NOV-2012 11:46:23
      3 ZZ01HNP42MAMAI9D4DNR.HELD      5 14-NOV-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>