Deletes mail messages from SMTP queues.

    Without the user parameter, all messages from the user name that
    correspond to your process's user name are deleted.

    Related commands: SEND MAIL, SHOW MAIL

    Applies to: SMTP

    Format

      REMOVE MAIL  [ user ]

                   [ /[NO]COPY=[directory] ]

                   [ /[NO]CONFIRM ]

                   [ /ENTRY=n ]

1  –  Restrictions

    Requires SYSPRV or BYPASS privilege for mail messages that are
    not yours.

2  –  Parameters

 user

    Optional. Default: All mail messages with your process's user
    name.

    Removes messages sent from the specified user name.

3  –  Qualifiers

3.1    /COPY

       /COPY=[directory]
       /NOCOPY=[directory]

    Optional. Default: Messages copied to the user's default
    directory.

    Copies messages to be deleted to the specified directory.

    /NOCOPY: Messages are not copied.

3.2    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Defaults:

    o  With an entry number specified - /NOCONFIRM

    o  Without an entry number specified - /CONFIRM

    If you specify /CONFIRM, or if you omit an entry number, requests
    confirmation before deleting each message. Respond to the
    CONFIRM: prompt by entering one of the following:

    o  Y to delete the mail message

    o  N to retain the mail message

    o  G to change to NO CONFIRMATION mode

    If you specify the /NOCONFIRM qualifier or an entry, the
    operation is performed without asking you to confirm the request.

3.3    /ENTRY

       /ENTRY=n

    Optional. Default: All.

    Queue entry numbers to remove from the SMTP queue.

4  –  Examples

    1.TCPIP> REMOVE MAIL

      Removes all messages for your process's user name, or deletes
      everything in the SMTP queue if you have either SYSPRV or
      BYPASS privilege.

    2.TCPIP> REMOVE MAIL /ENTRY=781

      Removes message 781, if it corresponds to your process's user
      name, or if you have either SYSPRV or BYPASS privilege.

    3.TCPIP> REMOVE MAIL BROOD

      Removes all messages for BROOD, if your process's user name is
      BROOD, or if you have either SYSPRV or BYPASS privilege.

    4.TCPIP> REMOVE MAIL /USER_NAME=COCKATOO /COPY=[COCKATOO.OLD_MAIL]

      Removes all messages for COCKATOO, if this is your process's
      user name, or if you have either SYSPRV or BYPASS privilege.
      Before deletion, copies this queued mail to the specified
      directory.