PMDF User's Guide
OpenVMS Edition

A folder collection is a folder specification for a collection of folders on one system. For example, it can be all of your VMS MAIL folders which have the name prefix INFO-, or it can be all of your UNIX mail folders on a system called foo.bar.com, or it can be all of your VMS MAIL folders in a different mail file than you normally use. You can access multiple different folder collections from within Pine.

By default, PMDF Pine knows only about the local folder collection, corresponding to your VMS MAIL mailbox. The use of additional folder collections is controlled by the folder-collections option in your Pine resource file. Normally, this option is set from within Pine by using the SETUP menu and then selecting the L (collectionList) menu. However, the option can also be set by manually editing your Pine resource file.

7.4.2.1 folder-collection Option Syntax

optional-label {imaphost}optional-file[view]

or

optional-label {imaphost:port/user=username}optional-file[view]

optional-label is a label which will be displayed by Pine in place of the full name of the folder collection.

The optional field imaphost is the name of a host where the mail file resides. imaphost can be any system which has an IMAP4 server, and need not necessarily be an OpenVMS system.

The optional port specification can be included if you want to connect to a port other than the default (for IMAP) of 143.

The optional username can be included if you want to log in to the imaphost under a different account name.

The optional field optional-file is the file specification of a mail file. If optional-file is omitted but imap-host is specified, then the default mail file on the remote imaphost system will be used. If neither optional-file nor imap-host is specified, then your local default mail file will be used.

When optional-file is specified for an OpenVMS host locally or remotely running PMDF's legacy IMAP server,⁵ it must have the format

#disk:<directory>mailfile.mai#

where disk, directory, and mailfile.mai specify the full path, disk, directory, and file name, to the mail file. For instance, to select the mail file MEMOS.MAI of DISK$USER1:[BOB], you would specify

#DISK\$USER1:<BOB>MEMOS.MAI#

Finally, the view field controls which folders from the mail file are part of the collection. If specified as being empty, [], then all folders from the mail file are treated as part of the collection. Wild cards can be used to select folders matching a pattern. For example, [INFO-*] would select all folders beginning with the string INFO- from the mail file. Again, note that folder names are considered to be case sensitive.

For POP3 access to a new mail folder on a remote system, the format is:

"foldername" {pop3host/POP3}INBOX

or

"foldername" {pop3host/POP3/USER=username}INBOX

where foldername is the name by which Pine will refer to the folder, pop3host is the name of the system running the POP3 server, and username is the name under which to log in to the remote POP3 server.

7.4.2.1.1 Example folder-collections Option Setting

folder-collections=local [], archive #DRA0:<JONES.ARCHIVE>OLDMAIL.MAI#[], remoteVMS {vax.example.com}#DUA2:<JONES.MAIL>MAIL.MAI#[INFO*] remoteUNIX {sun.example.com}mail/[]

In the above example, four collections with the names local, archive, remoteVMS, and remoteUNIX are created. local consists of all folders in the local default mail file; archive consists of all folders in the mail file DRA0:[JONES.ARCHIVE]OLDMAIL.MAI; remoteVMS consists of all folders whose name begin with INFO in the mail file DUA2:[JONES.MAIL]MAIL.MAI on the remote host vax.example.com; and remoteUNIX consists of all folders from the mail directory mail/ on the remote system sun.example.com.

7.4.2.2 Saving Messages in Folder Collections

For local or remote OpenVMS servers, you can also specify the file name where the folder resides directly as

#disk:[directory]mailfilename#foldername

when prompted with the folder name. If you are saving to the same file in the folder collection, then only the folder name itself is needed.