List any currently selected messages.

Syntax

DIRECTORY [folder-name [mail-file-spec]]

Qualifiers	Defaults
/BEFORE=date	None
/CC_SUBSTRING=text	None
/EDIT	/NOEDIT
/FIRST	None
/FROM_SUBSTRING=text	None
/FULL	/NOFULL
/LAST	None
/MARKED	None
/NEW	None
/OUTPUT=out-file-spec	None
/REPLIED	None
/SINCE=date	None
/SUBJECT_SUBSTRING=text	None
/START=message-number	/START=1
/TO_SUBSTRING=text	None

Parameters

folder-name

Optional parameter specifying the name of the folder to select messages from.

mail-file-spec

Optional parameter specifying the mail file to open.

Description

The DIRECTORY command lists any currently selected messages. If a folder name or mail file parameter is specified or any of the qualifiers /BEFORE, /CC_SUBSTRING, /FROM_SUBSTRING, /NEW, /REPLIED, /SINCE, /SUBJECT_SUBSTRING, or /TO_SUBSTRING are used, then a new set of messages will be selected.

If no messages are currently selected, and no folder name is specified, then the default folder for the open mail file is used. (If no mail file is open, then the default mail file, MAIL.MAI, is first opened.) The name of the default folder depends upon which mail file is open. For the default mail file, the default folder is NEWMAIL if it contains any new messages, and MAIL otherwise. When a mail file other than the default file is open, the default folder is the folder with the same name as the mail file itself (e.g., JOKES is the default folder for the mail file JOKES.MAI).

If you specify a folder that does not exist, PMDF MAIL displays the following message:

%EMAIL-E-NOTEXIST, folder "folder-name" does not exist

where folder-name is the folder you tried to select.

Qualifiers

/BEFORE[=date]

Select messages dated before the specified date. All the messages received before the current day are selected if no date is specified.

/CC_SUBSTRING=text

Select messages containing text in the VMS MAIL Cc: header line of the message.

/EDIT

/NOEDIT (default)

Invoke the editor to display the listing.

/FIRST

/LAST

Begin the directory list with the first message, /FIRST, or last message, /LAST.

/FROM_SUBSTRING=text

Select messages containing text in the VMS MAIL From: header line of the message.

/FOLDER

Consult the DIRECTORY/FOLDER command documentation.

/FULL

/NOFULL (default)

The /FULL qualifier requests that an extended, verbose directory listing be generated.

/MARKED

/NOMARKED

Select messages that have been marked, /MARKED, or are not marked, /NOMARKED.

/NEW

Select new (unread) messages from the NEWMAIL folder of your default mail file, MAIL.MAI. If any other mail file is open, it is closed and the default mail file opened.

/OUTPUT=out-file-spec

Output the directory listing to the specified file.

/REPLIED

/NOREPLIED

Select messages that have been replied to, /REPLIED, or have not been replied to, /NOREPLIED.

/SINCE[=date]

Select messages dated since the specified date. If no date is specified, all the messages received on the current day are selected.

/START=message-number

Specify the message number to begin the directory listing at.

/SUBJECT_SUBSTRING=text

Select messages containing text in the VMS MAIL Subject: header line of the message.

/TO_SUBSTRING=text

Select messages containing text in the VMS MAIL To: header line of the message.

Examples

EMAIL> DIRECTORY/NEW
                                                                   NEWMAIL
 # From              Date         Subject
 
 1 BOB               23-FEB-2012  Apples
 2 SID               23-FEB-2012  Oranges
 3 info-pmdf@ymir.cl 24-FEB-2012  PMDF MAIL!
 4 BOB               24-FEB-2012  RE: Apples
 
EMAIL>
      

In this example, the DIRECTORY/NEW command is used to select any new, unread mail messages and display a listing of them.

EMAIL> DIRECTORY/NEW/FROM_SUBSTRING=BOB
                                                                   NEWMAIL
 # From              Date         Subject
 
 1 BOB               23-FEB-2012  Apples
 2 BOB               24-FEB-2012  RE: Apples
 
EMAIL>
      

Here, the /FROM qualifier is used with DIRECTORY/NEW so as to select and list only those new messages with a From: field including the string "BOB".

EMAIL> DIRECTORY/FOLDER
Listing of folders in D1:[BOB]MAIL.MAI;1
     Press CTRL/C to cancel listing
MAIL                                    NEWMAIL
WASTEBASKET
EMAIL> DIRECTORY WASTEBASKET
                                                                   NEWMAIL
 # From              Date         Subject
 
 1 info-pmdf@ymir.cl 21-FEB-2012  RE: Who's Mrochek?
 
EMAIL>
      

In this example, a listing of the available folders is obtained with the DIRECTORY/FOLDER command. Next, the WASTEBASKET folder is selected and its contents displayed with the DIRECTORY WASTEBASKET command.