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 DIRECTORY_FORMAT

SET NODIRECTORY_FORMAT

SHOW DIRECTORY_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
/TO=(option)	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, /SUBJECT, and /TO 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.

Note 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.

/FROM[=option[,...]

Specifies the position of the messages To: 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 parentheses.

/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.

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

Specifies the position of the message's To: 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 To: field.
WIDTH=n	Number of characters of the To: field to display.

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

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>