1  SELECT
   Establishes a set of messages that you can manipulate. You can
   copy or move selected messages from one folder to another. You
   can read, delete, search, or extract a set of messages. After you
   select a set of messages, you can then use the following commands
   to affect them:

      COPY
      DELETE
      DIRECTORY
      EXTRACT
      FILE
      MOVE
      READ
      SEARCH

   You can also use the SELECT command to move from one folder
   to another. If you select a folder that does not exist, Mail
   displays a message similar to the following:

         %MAIL-E-NOTEXIST, folder "foldername" does not exist

   Format

     SELECT  [foldername]
 

2  Parameter
 

foldername

   Specifies the name of the folder from which to select messages.

   If you omit the foldername, the folder to be used is determined
   in the following order:

   1. The current folder is used, if any (unless the /NEW qualifier
      is specified)

   2. The NEWMAIL folder is used if:

      o  You specify the /NEW qualifier

      o  You omit selection qualifiers and you have new mail

   3. The MAIL folder is used.
 

2  Qualifiers
 

/BEFORE

      /BEFORE=date

   Selects all the mail messages received before the specified
   date. If you do not specify a date, Mail selects all of the
   mail messages received before the current day (today). You can
   also specify the keywords YESTERDAY and TODAY. For example, the
   command SELECT/BEFORE=YESTERDAY would select all mail messages
   received before yesterday.
 

/CC_SUBSTRING

      /CC_SUBSTRING=text

   Selects messages containing the specified text in the CC: field
   of the message, where the specified text is usually a node name
   or user name.
 

/FROM_SUBSTRING

      /FROM_SUBSTRING=text

   Selects messages containing the specified text in the From: field
   of the message, where the specified text is usually a node name
   or user name. This command searches only the node name and user
   name of the sender; it does not search the personal name field.
 

/MARKED

      /MARKED
      /NOMARKED

   Selects messages that have been marked. The /NOMARKED qualifier
   selects messages that are not marked.
 

/NEW

   Selects the NEWMAIL folder and displays new mail messages
   received while you are in Mail. If there are no new messages,
   Mail displays the message "%MAIL-W-NONEWMAIL, no new messages".
   When a mail file other than your default mail file is open, Mail
   closes the file and opens your default mail file.
 

/REPLIED

      /REPLIED
      /NOREPLIED

   Selects messages that have been replied to with the REPLY
   command. The /NOREPLIED qualifier selects messages to which you
   have not replied.
 

/SINCE

      /SINCE=date

   Selects all of the mail messages received on or after the
   specified date. The format for the date is dd-mmm-yyyy. If
   you do not specify a date, Mail selects all of the mail
   messages received on the current day. You can also specify the
   keywords YESTERDAY and TODAY. For example, the command SELECT
   /SINCE=YESTERDAY would select all mail messages received since
   yesterday.
 

/SUBJECT_SUBSTRING

      /SUBJECT_SUBSTRING=text

   Selects messages containing the specified text in the Subj: field
   of the message.
 

/TO_SUBSTRING

      /TO_SUBSTRING=text

   Selects messages containing the specified text in the To: field
   of the message, where the specified text is usually a node name
   or user name. The /TO_SUBSTRING qualifier will not search the
   personal name field.
 

2  Examples

   1.MAIL> DIRECTORY/FOLDERS
     Listing of folders in DISK$APEX:[MACDONALD]MAIL.MAI;1
     Press Ctrl/C to cancel listing

     MAIL               JUNK
     NEWMAIL            WASTEBASKET

     MAIL> SELECT WASTEBASKET
     %MAIL-I-SELECTED, 3 messages selected
     MAIL> DIRECTORY

                                           WASTEBASKET
     #   From    Date               Subject

     1   MORRIS  11-DEC-1994        Venus Fly Traps
     2   MORRIS  21-DEC-1994        The Aloe
     3   BURT    22-DEC-1994        Scales

     This example shows how to use the SELECT command to move from
     the MAIL folder to the WASTEBASKET folder.

   2.MAIL> SELECT/BEFORE=12-DEC-1994
     %MAIL-I-SELECTED, 2 messages selected
     MAIL> DIRECTORY

                                           MAIL
     #   From    Date               Subject

     1   MARTY   10-DEC-1994        Food
     2   BART    11-DEC-1994        Soup

     This example shows how to display all the mail messages
     received before December 12, 1994.

   3.MAIL> SELECT/SUBJECT_SUBSTRING=report
     %MAIL-I-SELECTED, 3 messages selected
     MAIL> DIRECTORY

                                           MAIL
     #   From        Date               Subject

     1   MARSHALL    11-DEC-1994        Final Report
     2   CARBONE     15-NOV-1994        November 1994 Report
     3   BARTEN      23-OCT-1994        Annual report

     This example shows how to use the SELECT command to display
     mail messages containing the string "report" in the subject
     field of the message.

   4.MAIL> SELECT/NEW

     This example shows how to select all the new (unread) mail
     messages. Because NEWMAIL is the implied folder name, you do
     not need to specify a folder name.