Place copies of one or more mail messages into another folder.

Syntax

COPY 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 copy 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 COPY command copies the specified messages to another folder without deleting the specified messages themselves. The messages to be copied are specified with the /ALL, /MARKED, /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 copied 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 copy operation will be aborted. To select 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 MOVE command if you want to copy messages to another folder, deleting them from the current folder in the process. Use the EXTRACT command to extract messages to an ordinary text file.

Qualifiers

/ALL

Copy 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 copy as well as the creation of folders and files. /NOCONFIRM specifies that all prompting is to be suppressed; the file and folder will be created if necessary and all selected messages copied.

/MARKED

/NOMARKED

Copy 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 copied. Cannot be used in conjunction with /ALL.

/READ

/NOREAD

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

/REPLIED

/NOREPLIED

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

Examples

In the following example, the COPY/REPLIED/NOMARKED command is used to copy to the NEWMAIL folder in the mail file NEWMAIL.MAI all messages which have both been answered and not marked with the MARK command.

EMAIL> SET FOLDER NEWMAIL EMAIL> COPY/NOMARK/REPLIED NEWMAIL NEWMAIL.MAI File D1:[BOB]NEWMAIL.MAI; does not exist. Do you want to create it (Y/N, default is N)? Y %MAIL-S-CREATED, D1:[BOB]NEWMAIL.MAI;1 created EMAIL>