List the folders present in the current mail file.

Syntax

DIRECTORY/FOLDER [folder-pattern [mail-file-spec]]

Qualifiers	Defaults
/EDIT	/NOEDIT
/EXCLUDE	None
/NEW	None
/OUTPUT=out-file-spec	None
/START=name	None

Parameters

folder-pattern

Optional folder name pattern. Can contain wild cards.

mail-file-spec

Optional parameter specifying the mail file to open.

Description

Use the DIRECTORY/FOLDER command to obtain a listing of the folders contained in the current mail file. If no mail file is currently open, then your default mail file will be opened first. To cancel the listing, press CTRL/C.

If a mail file specification is supplied, then any currently opened mail file will first be closed and then the specified mail file will be opened. The folder listing will be of the folders in the newly opened mail file.

When an optional folder name pattern is supplied, only those folders whose names match the pattern will be displayed.

Qualifiers

/EDIT

/NOEDIT (default)

Invoke the editor to display the listing.

/EXCLUDE

Display those folder names which do not match the folder name pattern.

/NEW

Mark with an asterisk any folder which contains unread messages.

/OUTPUT=out-file-spec

Output the directory listing to the specified file.

/START=name

Only list folders whose names are the same as the specified starting name or lexicographically follow it.

Examples

EMAIL> DIRECTORY/FOLDER
Listing of folders in D1:[BOB]MAIL.MAI;1
     Press CTRL/C to cancel listing
MAIL                                    NEWMAIL
WASTEBASKET
EMAIL>
      

Here the DIRECTORY/FOLDER command is used to list the folders in the currently open mail file.

EMAIL> DIRECTORY/FOLDER/START=W
Listing of folders in D1:[BOB]MAIL.MAI;1
     Press CTRL/C to cancel listing
WASTEBASKET
EMAIL>
      

In this example, the /START qualifier specifies that only folders with names beginning with "W", "X", "Y", or "Z" are to be listed.