Read the first message of the current folder, or the first part or page of the current message.

Syntax

FIRST

Qualifiers	Defaults
/EDIT	/NOEDIT
/FILTER_CTRL	/NOFILTER_CTRL
/MESSAGE	/MESSAGE
/PAGE	/MESSAGE
/PART	/MESSAGE
/PAUSE	/PAUSE
/TRIM_HEADER	/TRIM_HEADER

Parameters

None.

Description

The FIRST command displays the first message from those currently selected, /MESSAGE, or the first part, /PART, or page, /PAGE, of the current message.

Qualifiers

/EDIT

/NOEDIT (default)

When /EDIT is specified, the editor will be invoked to display the message. This is the default when PMDF MAIL is invoked with the command PMDF MAIL/EDIT=(READ). /NOEDIT prevents the editor from being invoked.

/FILTER_CTRL

/NOFILTER_CTRL (default)

When /FILTER_CTRL is specified, 7-bit and 8-bit control characters in messages are filtered out. Messages which contain such control characters can cause problems with the terminal when they are displayed. When /FILTER_CTRL is specified, such a character is displayed as its hexidecimal value in the format "=XX".

/ENTIRE

/MESSAGE (default)

/PAGE

/PART

Display the first message of those currently selected, /MESSAGE or /ENTIRE, or the first part, /PART, or page, /PAGE, of the current message. The /PAGE qualifier is treated as /PART when the editor is invoked to display the message. When the current message is a single-part message, the commands FIRST/PART and CURRENT/MESSAGE are equivalent.

/PAUSE (default)

/NOPAUSE

When displaying the message, after a page of information has been output PMDF MAIL pauses and requests that you press [RETURN] if you want to continue reading. To suppress these prompts, specify /NOPAUSE.

/TRIM_HEADER (default)

/NOTRIM_HEADER

When /NOTRIM_HEADER is specified, all header lines in the message will appear when the header is next displayed. By default, message header lines are trimmed; this behavior is explicitly requested with the /TRIM_HEADER qualifier.