PMDF User's Guide
OpenVMS Edition
PMDF-USR-VMS-6.0

Control the formatting of directory listings.

restrictions

Requires SYSPRV privilege to set information for users other than yourself; requires SYSPRV or SYSNAM privilege to show information about users other than yourself.

Syntax

SET DATE_FORMAT

SET NODATE_FORMAT

SHOW DATE_FORMAT

Qualifiers	Defaults
/DATE=(option)	None
/DELETED=(option)	None
/FROM=(option)	None
/ID=(option)	None
/MARKED=(option)	None
/READ=(option)	None
/REPLIED=(option)	None
/SIZE=(option)	None
/SUBJECT=(option)	None
/SYSTEM_DEFAULT	None
/UIC="[g,m]"	None
/USER=username	None

PARAMETERS

None.

DESCRIPTION

With SET and SHOW DIRECTORY_FORMAT commands, you may control and rearrange the information displayed in directory listings produced with the DIRECTORY command.

The format to use for each line in a directory listing is specified through the use of the /DATE, /DELETED, /FROM, /ID, /LOG, /MARKED, /READ, /REPLIED, /SIZE, and /SUBJECT qualifiers. The order in which those qualifiers appear on the command line designates the order in which the associated information is displayed.

Use the SET NODIRECTORY_FORMAT command to restore the default behavior.

No WIDTH information need be specified for the last field to be displayed; the correct width will automatically be computed.

QUALIFIERS

/DATE[=(option[,...])]

Specifies the position of the message's date of reception in the directory listing. The accepted options are:

COMPRESSED	Display the date in a "compressed" format. If the message was received during the current month then display the day of the month, hour, and minute of its arrival. If it was received in a previous month then display the usual date.
HEADING=text	Heading to display at the top of each screen or page of output.
NOCOMPRESSED	Do not display the date in a compressed format.
SKIP=n	Number of spaces to skip over before displaying the date.
WIDTH=n	Number of characters of the date to display.

If you specify only one option, you may omit the parentheses.

/DELETED[=(option[,...])]

Specifies the position of a flag character denoting whether the message has been deleted or moved. The accepted options are

FLAGS=xy	Two characters: the first specifying the deleted flag and the second the moved flag.
SKIP=n	Number of spaces to skip over before displaying the flag.

If you specify only one option, you may omit the parantheses.

/FROM[=(option[,...])]

Specifies the position of the message's From: field in the directory listing. The accepted options are

HEADING=text	Heading to display at the top of each screen or page of output.
SKIP=n	Number of spaces to skip over before displaying the From: field.
WIDTH=n	Number of characters of the From: field to display.

If you specify only one option, you may omit the parantheses.

/ID[=(option[,...])]

Specifies the position of the message's identification number in the directory listing. The accepted options are the same as those for the /FROM qualifier.

/MARKED[=(option[,...])]

Specifies the position of a flag character denoting whether the message has been marked or not. Uses the same options as /DELETED. The FLAG option specifies first the character to display when the message is marked and second the character to display when the message is not marked.

/READ[=(option[,...])]

Specifies the position of a flag character denoting whether the message has been read or not. Uses the same options as /DELETED. The FLAG option specifies first the character to display when the message has been read and second the character to display when the message has not been read.

/REPLIED[=(option[,...])]

Specifies the position of a flag character denoting whether the message has been replied to or not. Uses the same options as /DELETED. The FLAG option specifies first the character to display when the message has been replied to and second the character to display when the message has not been answered.

/SIZE[=(option[,...])]

Specifies the position of the message's size (in lines) in the directory listing. The accepted options are the same as those for the /FROM qualifier.

/SUBJECT[=(option[,...])]

Specifies the position of the message's Subject: field in the directory listing. The accepted options are the same as those for the /FROM qualifier.

/SYSTEM_DEFAULT

The setting is the system-wide default for users who have not themselves selected a directory format with SET DIRECTORY_FORMAT. When used with SET NODIRECTORY_FORMAT, removes the system-wide default.

Examples

The default directory listing format would be specified with the command shown below. This command should be entered on a single line; in the example it is shown as several lines for purposes of clarity only.

EMAIL> SET DIRECTORY_FORMAT/MARKED=(FLAGS="* ")
        /ID=(HEADING="  #",SKIP=0,WIDTH=4)
        /FROM=(HEADING="From",SKIP=1,WIDTH=20)
        /DATE=(HEADING="Date",SKIP=1,WIDTH=11)
        /SUBJECT=(HEADING="Subject",SKIP=2)
EMAIL>