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

    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]

1 - 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

 2.1 - /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.

 2.2 - /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.

 2.3 - /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.

 2.4 - /MARKED

       /MARKED
       /NOMARKED

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

 2.5 - /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.

 2.6 - /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.

 2.7 - /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.

 2.8 - /SUBJECT_SUBSTRING

       /SUBJECT_SUBSTRING=text

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

 2.9 - /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.

3 - 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.