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

    Establishes a set of messages that you can affect as a group. You
    can copy or move this set of messages from one folder to another.
    You can also read, delete, search or extract a set of messages.
    After you enter the SET FOLDER command, you can use the following
    commands to affect the selected messages:

       COPY
       DELETE
       DIRECTORY
       EXTRACT
       FILE
       MOVE
       READ
       SEARCH

    For more information on the above commands, enter HELP command at
    the MAIL> prompt.

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

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

    The SHOW FOLDER command displays the current folder name. You
    cannot specify any parameters or qualifiers with this command.

    Format

      SET FOLDER  [foldername]

      SHOW FOLDER

1 - Parameter

 foldername

    When using SET FOLDER, specifies the name of the folder from
    which messages will be selected.

    If you omit the folder name when specifying SET FOLDER, the
    folder 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 SET FOLDER/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 SET FOLDER
    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:[HARRINGTON]MAIL.MAI;1
      Press Ctrl/C to cancel listing

      MAIL            NEWMAIL
      WASTEBASKET     CLASSES

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

                                            WASTEBASKET
      #   From    Date             Subject

      1   MORRIS  19-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 SET FOLDER command to move
      from the MAIL folder to the WASTEBASKET folder.

    2.MAIL> SET FOLDER/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> SET FOLDER/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.