Library /sys$common/syshlp/mailhelp.hlb COPY  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Copies a message to another folder without deleting it from the
    current folder. If the specified folder does not exist, it is
    created.

    If you want to copy a message to a sequential file (outside of
    Mail) instead of to a mail file, use the EXTRACT command.

    If you decide (after entering the COPY command, pressing Return,
    and supplying a folder name at the prompt, but before pressing
    Return again) that you do not want to copy the message, press
    Ctrl/C. Ctrl/C aborts the operation and keeps you within Mail.

    Format

      COPY  foldername [file-spec]

1 - Parameters

 foldername

    Indicates the name of the folder to which the message is to be
    copied. If the specified folder does not exist (and you have
    not entered the qualifier /NOCONFIRM), Mail asks if you want to
    create it. If you respond with Y, Mail creates the new folder. If
    you specify /NOCONFIRM, Mail creates the folder and displays the
    message: %MAIL-I-NEWFOLDER, folder foldername created

    A folder name can be 1 to 39 characters in length. Valid
    characters for folder names are alphanumeric characters, dollar
    signs ($), and underscores (_). If your folder name contains
    lowercase letters, spaces, or special characters, the folder name
    must be enclosed in quotation marks (" ").

 file-spec

    Indicates the name of the mail file to which the message is
    copied. If the specified mail file does not exist, Mail creates
    it. If you do not specify the /NOCONFIRM qualifier, Mail
    asks if you want to create the file, but creates the folder
    automatically. If you omit the file name, Mail copies the message
    to the specified folder in the current file.

2 - Qualifiers

 2.1 - /ALL

    Indicates that all of the currently selected messages are to
    be copied to another folder, file, or both. Select a folder
    by entering the SELECT command followed by the name of the
    folder. See the SELECT command for more information. If the /ALL
    qualifier is omitted, only the current message is copied.

 2.2 - /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Determines whether Mail prompts you to create a new folder or
    file. The default qualifier is /CONFIRM.

3 - Examples

    1.MAIL> 2

      MAIL> COPY
      _Folder: MEMOS
      _File: <RETURN>
      MAIL>

      This example shows how to put a copy of a mail message into
      another folder (MEMOS) in the default mail file. If folder
      MEMOS does not exist, you receive the following message:

        Folder MEMOS does not exist.
        Do you want to create it (Y/N, default is N)? Y
        %MAIL-I-NEWFOLDER, folder MEMOS created.