PMMASort v.1.0.  PMMail Addressbook Sorter (for PMMail v.1.9x)
Copyright (c) 1997 Gyan Scott Penrose-Kafka (spk@ibm.net)

PMMASort is E:MailWare, which means, if you use this program, please
send me an e:mail (at spk@ibm.net) to let me know.


*********************************************
See end of document for revision history.
*********************************************


I wrote PMMASort because I got tired of PMMail not sorting the address book
for the pop-up address book.  It is a simple little program which will allow
you so sort your address book by either the alias field or the name field.


////////////////////////////////////////////////////////
NOTICE:  You may run PMMASort while PMMail is running,
         but you must exit and restart PMMail before 
         the new sort order will take effect.
////////////////////////////////////////////////////////

PMMASort is a command line utility, however, if you put the parameters into
a WPS program object, you can run it from the WPS.  PMMASort will backup the
original ADDR.DB file to ADDR.DB.BAK.

Usage:  PMMASORT x:\path\ADDR.DB name/alias

To Sort by name:
PMMASort h:\apps\southsde\tools\addr.db name

To Sort by alias:
PMMASort h:\apps\southsde\tools\addr.db alias


You should run this program periodically in order to make sure that your
pop-up address books always have the new entries in alphabetical order.
Hopefully, in the near future PMMail will keep the address book datatbase
sorted rather than just sticking newly added addresses at the end of the
database.  But until that happens, use PMMASort.



*********************************************
Revision History
*********************************************
v1.0á2
	FIX: Solved a problem caused by incorrect compiler settings.
	ADD: Better memory management.

v1.0á3
	CHG: New syntax for command line.
	     Output file no long needed on command line.
		Usage:  PMMASORT x:\path\ADDR.DB name/alias
	ADD: Original ADDR.DB file backed up to ADDR.DB.bak
	     and sorted file saved as ADDR.DB.
	ADD: Progress monitors.
	ADD: Error testing.
v1.0á4
	FIX: Bug when address book entry contained extended information beyond
	     the name/e:mail address/alias info, (especially notes that had
	     CR/LF in them), and which had addresses following it in the 
	     database.  Unfortunately, this bug was corrupting the address 
	     book.
	CHG: Now using different methodology to back up the input file which 
             is faster than previous method as well as preserves date and time
	     on the backed up file.
v1.0 (GA)
	ADD: Program Icon.  Thanks to Gerard Pinkas for being so creative.
	CHG: Minor cosmetic changes on error messages.



                            Standard  Disclaimer 

     This  program  is  provided  AS IS without any warranty, expressed or
implied,  including  but  not limited to fitness for a particular use. The
user  is responsible for the results of correct or incorrect usage of this
software.  Your use  of this product signifies  you agreement to the terms 
and conditions of this licence agreement.