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

    The MOVE command is synonymous with the FILE command. Moves the
    current message to the specified folder. Note that the MOVE
    command deletes the message from the original folder, unlike
    the COPY command, which leaves a copy.

    If you omit the folder and file name parameters, you are prompted
    for both; if you supply only the folder name, the current Mail
    file is used and you are not prompted for the file name.

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

    Format

      MOVE  foldername [file-spec]

1 - Parameters

 foldername

    Indicates the name of the folder to which the current message is
    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 moved. If the specified file does not exist, Mail creates
    it. If the file name is omitted, Mail moves the message to the
    specified folder in the current file.

2 - Qualifiers

 2.1 - /ALL

    Moves all the currently selected messages to the specified
    folder.

 2.2 - /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Determines whether you are prompted to create a new folder. The
    default qualifier is /CONFIRM.

3 - Examples

    1.MAIL> 2
      MAIL> MOVE
      _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 MOVE command to move a
      message to a new folder named WINNERS.

      First, you enter the MOVE command to transfer the current
      message to a new folder. Then, specify a name for the new
      folder and press the Return key to retain the default file.
      Then enter the SELECT command, followed by the name of the new
      folder (WINNERS) to move to the new folder. Finally, enter the
      DIRECTORY command to see the transferred message in the newly
      created folder (WINNERS).