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

    Moves the current message to the specified folder. You can use
    the FILE command and the MOVE command interchangeably because
    they work the same way. Note, however, that the FILE command
    deletes the message from the original folder, unlike the COPY
    command, which leaves a copy.

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

    If you omit the folder and file name parameters, Mail prompts
    you for both. If you supply only the foldername, Mail uses the
    current mail file and does not prompt you for the file name.

    Format

      FILE  foldername [file-spec]

1 - Parameters

 foldername

    Indicates the name of the folder to which the current message
    is to be moved. If the specified folder does not exist, Mail
    asks whether you want to create it. If you respond with Y, Mail
    creates the new folder.

    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 current message
    is to be moved. If you omit the file name, Mail moves the message
    to the specified folder in the current file.

2 - Qualifiers

 2.1 - /ALL

    Moves all of the currently selected messages to the specified
    folder.

 2.2 - /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Determines whether you are queried about creating a new folder or
    file. The default qualifier is /CONFIRM.

3 - Examples

    1.MAIL> 2
      MAIL> FILE
      _Folder: WINNERS
      _FILE: <RETURN>
      Folder WINNERS does not exist.
      Do you want to create it (Y/N, default is N)? y
      %MAIL-I-NEWFOLDER, folder WINNERS created
      MAIL> SELECT WINNERS
      %MAIL-I-SELECTED, 1 message selected
      MAIL> DIRECTORY
                                                        WINNERS
      #   From    Date             Subject

      1   BURK    11-DEC-1994      Early American Art

      MAIL>

      This example shows how to use the FILE command to move a
      message to a new folder named WINNERS and the SELECT command
      to move to the newly created folder.