PEGASUS.INI explained.

Updated on 08-Aug-2011.

A description on PEGASUS.INI
Copyright (c) 1990-2004, David Harris, all rights reserved.

*** This information is provided as-is, with no warranty of fitness for
*** any purpose, nor that it is accurate or complete. If you use this
*** information in any way, you agree to remove all burden of
*** responsibility from the author and that you do not create any
*** obligation on the author's part to notify you of changes nor to
*** ensure that changes have no effect on you.


In essence, I finally decided that the commandline was becoming
ridiculous and that I needed to start doing something about it. It is now 
possible to create a file called PEGASUS.INI in the same directory as 
WINPMAIL.EXE that contains program settings. Use of this file will 
increase heavily in future (I expect to amalgamate all the information 
from PMAIL.CFG and PMGATE.SYS into this file for future releases) but for 
now you can do the following things using it:

* Set the -Z flag values - all of them, including -Z 2048
* Force standalone operating mode (the -A switch)
* Specify the language in use (the -X switch)
* Specify an alternative PMAIL.CFG file (the -E switch)

In most cases, commandline switches will override the values in this
file (the exception is NetWare mode vs Standalone mode - you cannot
change the operating mode once it is specified). The file is optional - 
all the commandline switches whose functions it duplicates can still be 

The principal use I see for this is in tech support: it will be possible 
to mail someone a file and say "place this file in the same directory as 
your copy of WINPMAIL.EXE", rather than trying to offer arcane 
explanations about the commandline and how to edit it under various 
versions of Windows.

I've done quite a lot of work with the Windows Registry recently and 
considered storing settings in there, but decided that there were few 
advantages and a considerable number of problems with that idea.

BTW: PEGASUS.INI may also be called WINPMAIL.INI

-- David Harris, Author and Owner Pegasus Mail --

Sample file

;-------------------------- Cut here ----------------------------
;  Sample WINPMAIL.INI configuration file for WinPMail v2.53
;  and later.
;  For WinPMail v2.53, the following sections can appear in this file:
;      [WinPMail 16-bit]     - Settings for the Win-16 version of WinPMail
;      [WinPMail 32-bit]     - Settings for the Win32 version of WinPMail
;  Both sections can contain the following commands:
;     Set WPMFLAGS = x       - equivalent to the -Z x commandline switch
;     Set standalone = Y|N   - equivalent to the -A commandline switch if 'Y'
;     Set language = XX      - equivalent to the -X commandline switch
;     Set configuration = X  - equivalent to the -E commandline switch
;  This file is parsed before any other considerations: items on the command
;  line will override settings from this file. Commands and section names are
;  not case-sensitive, but internal white space is significant (so the string
;  "set  language" is regarded as different from "set language").

[WinPMail 16-bit]
set wpmflags = 32770
set standalone = Y
set language = FR

[WinPMail 32-bit]
set wpmflags = 256
set standalone = Y
set language = FR

; Once you have installed the enabler, Pegasus Mail will run in French 
; permanently from this point on. To "cancel" operation in French, you 
; need to edit PEGASUS.INI in your Pegasus Mail installation directory 
; and remove the language directive, or set "EN", thus selecting the 
; base resource set.


; You probably used the ctrl+Noticeboards option to create your 
; noticeboards. When you do so Pegasus Mail for Windows creates 
; a PEGASUS.INI file in the program directory where it stores the 
; nb=<path>.
; If no noticeboard structure has been defined the first time you click 
; the "Noticeboard" button or select the "File" menu option, you'll now 
; get a noticeboard setup wizard that will create the initial structure for 
; you. Environment variables are no longer required for noticeboards - 
; Pegasus Mail looks for an entry in PEGASUS.INI in the same 
; directory as the executable in order to find the path.


[WinPMail 32-bit environment]

; You can now set environment variables in PEGASUS.INI: create a 
; section called [WinPMail 32-bit environment] and simply have one 
; equation per line - like this:
; Settings in this section override "real" environment variables, although 
; the "real" ones are still used if they are present and there is no 
; equivalent entry in this section.

PMR = \\urania\sys\abooks
MAI = o:\public\mail

; In WinPMail 4.2 the following section is added:

[Systemwide Folders]

; You can now have as many separate public folder trees as your 
; system will support (typically a maximum of 15) - see the new 
; "Public folders" option on the "Tools" menu for defining this. 
; Definitions for public folders are stored in a new section in 
; PEGASUS.INI and are shared by everyone running the copy of 
; Pegasus Mail. Public folders can be arranged in any order (the 
; dialog has controls for this). The dialog will create the proper paths 
; for you - no expertise is required to set up a shared folder directory 
; now.

PublicTree = "System-wide folders", "d:\\shared\\folders\\"
PublicTree = "Added420b18", "D:\\SHARED\\420B18"

; In WinPMail 4.62 the following section is added:
; You can specify the number in bytes, or using KB or MB suffixes. 
; The display in the about dialog also uses reduces the number to KB or MB.

Set MsgSizeSoftLimit = 5000000
Set MsgSizeHardLimit = 5000000000
Set AttmtSizeSoftLimit = 1000000
Set AttmtSizeHardLimit = 5000000000

;-------------------------- Cut here ----------------------------

Go back to my homepage  Mail me.