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

    Displays a list of the messages in the current mail file,
    including message number, sender's name, date, and subject.

    Mail creates a new set of selected messages every time you use
    any of the following qualifiers:

       /BEFORE
       /CC_SUBSTRING
       /FROM_SUBSTRING
       /MARKED or /NOMARKED
       /NEW
       /SINCE
       /SUBJECT_SUBSTRING
       /TO_SUBSTRING

    Format

      DIRECTORY  [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 messages received before the specified date. If you do
    not specify a date, Mail displays a listing of all the mail
    messages received before the current day (today). You can also
    specify the keywords YESTERDAY and TODAY. For example, the
    command DIRECTORY/BEFORE=YESTERDAY would give you a listing of
    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 - /EDIT

    Invokes a text editor using the output of the DIRECTORY command
    as input to the editor. Unless you have selected a different
    editor, the DECTPU-based EVE editor is invoked. The /EDIT
    qualifier enables you to find messages by scrolling through
    folders or searching text.

 2.4 - /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.5 - /FOLDER

    Displays a listing of all the folders contained in the current
    Mail file.

 2.6 - /FULL

    Displays the number of records in the message and whether you
    have replied to the message. External message identification
    numbers (for messages larger than 3 blocks) are also displayed.

 2.7 - /MARKED

       /MARKED
       /NOMARKED

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

 2.8 - /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.9 - /PAGE

       /PAGE[=keyword]
       /NOPAGE (default)

    Controls the display of information on the screen.

    You can use the following keywords with the /PAGE qualifier:

    CLEAR_SCREEN   Clears the screen before each page is displayed.

    SCROLL         Displays information one line at a time.

    SAVE[=n]       Enables screen navigation of information, where n
                   is the number of pages to store.

    The /PAGE qualifier allows you to navigate through a maximum of 5
    screens containing up to 255 columns of information. When you use
    the /PAGE qualifier, you can use the following keys as well:

    Key Sequence              Description

    Up arrow (^  ), Ctrl/B    Scroll up one line.
    Down arrow (v  )          Scroll down one line.
    Left arrow (< - )         Scroll left one column.
    Right arrow (- > )        Scroll right one column.
    Find (E1)                 Specify a string to find where the
                              information is displayed.
    Insert Here (E2)          Scroll right one half screen.
    Remove (E3)               Scroll left one half screen.
    Select (E4)               Toggle 80/132 column mode.
    Prev Screen (E5)          Get the previous page of information.
    Next Screen (E6),         Get the next page of information.
    Return, Enter, Space
    F10, Ctrl/Z               Exit.
    Do (F16)                  Toggle the display to oldest/newest
                              page.
    Ctrl/W                    Refresh the display.

 2.10 - /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.11 - /SINCE

       /SINCE=date

    Selects 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 displays a listing of all the mail messages received
    on the current day. You can also specify the keywords YESTERDAY
    and TODAY. For example, the command DIRECTORY/SINCE=YESTERDAY
    would give you a listing of all mail messages received since
    yesterday.

 2.12 - /START

       /START=start-point

    Indicates the first message number you want to display. For
    example, to display all the messages beginning with number three,
    enter the command DIRECTORY/START=3. Use the /START qualifier
    with the /FOLDER qualifier to indicate the first folder name you
    want to display. For example, to display all the folder names
    alphabetically following PLEAT, enter the command line DIRECTORY
    /START=PLEAT/FOLDER.

 2.13 - /SUBJECT_SUBSTRING

       /SUBJECT_SUBSTRING=text

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

 2.14 - /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
                                                        MAIL
      #   From    Date               Subject

      1   MARK    11-DEC-1994        The Yen
      2   MARK    11-DEC-1994        The Buck
      3   BILL    13-DEC-1994        The Pound
      4   BILL    13-DEC-1994        The Dollar
      5   BILL    14-DEC-1994        The Cent
      6   MARK    17-DEC-1994        The Dime

      This example shows how to display a listing of all the messages
      in the current folder by using the DIRECTORY command.

    2.MAIL> DIRECTORY/SINCE=13-DEC-1994
                                                        MAIL
      #   From    Date               Subject

      1   BILL    13-DEC-1994        The Pound
      2   BILL    13-DEC-1994        The Dollar
      3   BILL    14-DEC-1994        The Cent
      4   MARK    17-DEC-1994        The Dime

      This example shows how to use the /SINCE qualifier with the
      DIRECTORY command to display a listing of all the mail messages
      in the current folder received on or after December 13, 1994.

    3.MAIL> DIRECTORY/SUBJECT_SUBSTRING= POUND
                                                        MAIL
      #   From    Date               Subject

      1   BILL    13-DEC-1994        The Pound

      This example shows how to use the /SUBJECT_SUBSTRING qualifier
      with the DIRECTORY command to find messages that contain the
      substring POUND.

    4.MAIL> DIRECTORY/FOLDER
      Listing of folders in DISK$:[BACON]MAIL.MAI;1
          Press Ctrl/C to cancel listing
      MAIL                                  NEW_HIRES
      PROJECTS                              SALES_LEADS

      This example shows how to display a listing of all the folders
      in the current mail file.