Move one or more mail messages to another folder.

Syntax

MOVE folder-name [file-spec]

Qualifiers	Defaults
/ALL	None
/CONFIRM	See text
/MARKED	None
/MESSAGES=number	None
/READ	None
/REPLIED	None

Parameters

folder-name

Required parameter specifying the name of the folder to which to move the messages. The folder need not already exist.

file-spec

Optional parameter specifying the name of the mail file containing the specified folder. The mail file need not already exist.

Description

The MOVE command moves the specified messages to another folder. Unlike the COPY command, the messages are removed from the current folder in the process of moving them. The messages to be moved are selected with the /ALL, /MARKED, and /NOMARKED, /READ, /NOREAD, /REPLIED, and /NOREPLIED qualifiers. These qualifiers can be combined as demonstrated in the supplied example. If none of these qualifiers are specified then only the last message read will be copied.

The messages are moved into the specified folder. If that folder does not already exist, then you will be asked whether or not it should be created. If you answer in the negative, then the move operation will be canceled. To specify a folder in a different mail file, specify that file's name with the optional file-spec parameter. If that mail file does not exist, then you will be asked whether or not it should be created. If you omit the file-spec parameter, then the folder is assumed to be in the current mail file.

Use the COPY command if you want to move messages to another folder without deleting them from the current folder in the process. Use the EXTRACT command to extract messages to an ordinary text file.

Qualifiers

/ALL

Move all currently selected messages. Cannot be used in conjunction with /MESSAGES.

/CONFIRM

/NOCONFIRM

When neither /CONFIRM or /NOCONFIRM is specified, you will only be prompted to confirm file or folder creations should the specified file or folder not exist. When /CONFIRM is specified, you will be prompted to confirm each message move as well as the creation of files or folders. /NOCONFIRM specifies that all prompting is to be suppressed; any file or folder will be created if necessary and all selected messages moved.

/MARKED

/NOMARKED

Move all currently selected messages which have been previously marked, /MARK, or are not marked, /NOMARK.

/MESSAGES=(number[,...])

Specifies the identification number or numbers of the messages to be moved. Cannot be used in conjunction with /ALL.

/READ

/NOREAD

Move all currently selected messages which have been previously read, /READ, or are unread, /NOREAD.

/REPLIED

/NOREPLIED

Move all currently selected messages which have been replied to, /REPLIED, or have not been replied to, /NOREPLIED.

Examples

EMAIL> SET FOLDER MAIL
EMAIL> MOVE/MARKED/REPLIED MAIL_93
Folder MAIL_93 does not exist.
Do you want to create it (Y/N, default is N)? Y
%MAIL-I-NEWFOLDER, folder MAIL_93 created
EMAIL>
      

In the following example, the MOVE/MARKED/REPLIED command is used to move to the MAIL_93 folder all messages which have been both replied to and marked with the MARK command.

EMAIL> MOVE/MESSAGES=(1,5-8,10) MAIL_93
EMAIL>
      

In this example, messages 1, 5, 6, 7, 8, and 10 are moved to the folder MAIL_93.