* MaxFile/PM Version 1.22 * To get started with MaxFile/PM run the REXX command script INSTALL.CMD and follow the prompts. It will lead you through the steps of getting MaxFile/PM installed into its own directory. I *DO* recommend a clean install. However, if you wish to use your old MAXFMPM.INI from a previous version, tell install to use the directory that you have your current version of MaxFile/PM installed in. The install is smart enough to find your old MAXFMPM.INI and modify it accordingly. ********************************************************************* * Go through EACH page of the notebook and make sure the settings are * * accurate for your system! I can NOT stress this enough. * ********************************************************************* MaxFile/PM requires MSGAPI32.DLL, this DLL does NOT get copied anywhere for you, it is your responsibility to put it in your LIBPATH if you need it. This file is now included with MaxFile/PM for the convenience of those users who are not running Squish. As far as documentation is concerned, MAXFMPM.INF will always be current. MAXFMPM.TXT won't be too far off, but it may not always follow the latest code changes as closely as the Online Reference. Have fun! Craig =============================================================================== Necessary files The only files absolutely needed for MaxFile/PM to operate correctly are: MAXFMPM.EXE MAXFMPM.INI EXECDOS.EXE MAXFMPM.INF (Not absolutely needed, but does come in handy.) MSGAPI32.DLL The rest are just examples and the documentation files. =============================================================================== What's New (or been fixed) I may not always put everything that has changed in this section of this file. I get quite wrapped up in the code and sometimes can't remember every little thing that I have worked on. But for the most part this section should be pretty accurate. 07-01-94 Removed Origin line from File Announcement messages that are generated in a FILES.BBS window. REXX announcements are unaffected by this. Also bumped the max message size up to 32k since Squish 1.10 can handle the larger message size now. Changed the way DOS archivers are handled, you can now configure them just like OS/2 based archivers. Added a few more REXX enhancements. Removed most of the directory sensitive code so that directory changes won't bring MaxFile/PM down in a nasty fashion. Cleaned up the install a little bit, it only copies the needed files to the destination directory. Increased buffer sizes for reading in FILES.BBS files. Added support for ZOO as per popular request. Fixed bug in recognizing archivers other than ZIP, ARC, ARJ or LZH. They ALL work now.. I have tested them all and added some suggested switches for all of them to MAXFMPM.TXT. Added a few more status reports to the FILES.BBS windows. A successful "touch" on a file now flags the File Database Utility so that it will run on the area(s) that files were touched in. 07-02-94 If no adoptee extensions are set up, MaxFile/PM will no longer do an adopt. Rearranged the code that opens windows from the main file area window so that the queue wouldn't get blocked as long. All the open calls are now initiated by a WinPostMsg() call, this should help out with the problems that were occurring under 2.11. I wish I could do this in another thread, but PM doesn't allow it.. Squashed a little buglet that occurred when opening a window from the Search Results dialog box. Before, if you opened a window from that dialog you couldn't bring the main window to the front unless you closed the window you opened. Added another command file to the distribution archive, SHOWINI.CMD. Its sole purpose in life is to report the pertinent INI information to standard output. 07-03-94 Final registration incentives added in preparation for standard release. It's put or shut up time. :-( Adoptee extensions were being ignored, because the code was missing to parse filenames for the Adopt function. Whoops! It's been fixed. 07-05-93 Increased maximum line lengths to accommodate both the 8.3 filename and a description for each entry in a FILES.BBS file. When an extended description marker is defined the maximum line length is now 1036 characters (8+1+3+1024), otherwise the line length is limited to 278 characters (8+1+3+256). Fixed a little problem with the case sensitivity of ZIP and UNZIP when trying to extract a FILE_ID.DIZ from ZIP archives. Overlooked the ^D hotkey for Remove Items, its back in now. Fixed the overwrite code for drag and drop, it now works as advertised. 07-06-93 BC++ libraries strike again.. For some odd reason, free() was trapping on certain size FILE_ID.DIZ's (241 characters), beats the hell out of me why it was doing it, heap corruption could be a possible cause. Fixed by using DosAllocMem()/DosFreeMem() instead of the library functions. Solved the problem with context menus not appearing, PM's heap was filling up which in turn stopped the menus from loading. I am now explicitly destroying each menu when it is no longer needed. This should also clear up a few other PM related problems. When unprintable characters are stripped from incoming FILE_ID.DIZ files all extra whitespace is now removed. Makes for a cleaner import. Any truncations that may occur are done AFTER the garbage is stripped out. Tweaked the menu handling code to work a little better, this fix is mostly cosmetic. 07-07-93 Added another button to the button bar.. Format Descriptions. (Elliott? ;-) When a program macro is run against a file in a FILES.BBS window MaxFile/PM now checks the file statistics against what is stored in the container record and updates the container record if they don't match. 07-08-94 First draft of the Online Reference is included. It doesn't have any jumps in it yet, but it is still VERY readable. 07-09-94 Fixed the settings notebook so the error reporting message boxes don't go into an endless loop requiring MaxFile/PM to be killed by another process. 'Format Description' will now always strip whitespace from descriptions and remove any present extended description characters. This makes for a cleaner description. 07-12-94 Reinstalled the Performance Beta 1 to evaluate MaxFile/PM's performance. It works, no hangs so far. Tweaked EXECDOS code, there was a possibility that a return code from it could be bogus and meaningless. Not anymore.. Reinstalled 2.10 and applied the service pack.. (Ick!) So I could do some more testing. 2 days, 3 different versions of OS/2.. Removed presentation parameter calls for setting the fonts for MLE controls. This should help with 2.11 and its picky nature. 07-14-94 Small problem occured if no FILES.BBS was found for a file area, no files in the download path were added to the container for that area. Fixed.. 07-15-94 Fixed Trap when there was no FILES.BBS for a file area and the directory was empty. 07-16-94 MAJOR change in the way the Insert->File option on the FILES.BBS context menu works. It does *NOT* copy the file anymore, instead it inserts the file with a *_FULLY QUALIFIED PATH_* into the FILES.BBS. 07-19-94 Removed case sensitivity in searching with MPM_QueryFileInfo(). 07-20-94 New FILES.BBS context menu item, 'Descriptions->Cleanse'. It strips out all high-ASCII, non-visible ASCII and extra whitespace characters from all the highlighted descriptions or comments in a FILES.BBS window. 07-22-94 Fixed a problem that ocurred when dropping a fully pathed file onto the main File Area window, the wrong file path was written to the FILES.BBS and the file couldn't be found. 07-25-94 Added another Mutex Semaphore to handle the main File Area window resource contentions. I found out that I was incorrect in my assumption that I could use one semaphore to handle all the possible scenarios where contention for resources might come into play. 08-30-94 Added a ^aMSGID kludge to file announcements so that some of the brain-dead mail readers would show the correct address for the message (they were -incorrectly- looking for a MSGID to obtain the origination address for the message.) Also fixed the incorrect date stamps for them in the process. 09-12-94 Registration incentives (nag dialogs) have been removed so that interested parties may fully evaluate the performance of the program. The usage timer still ticks away, though.. Through Scott Dudley's generousity, I am now including MSGAPI32.DLL in the distribution archive for those who don't run Squish. 09-14-94 Added code to "peek" the termQ before actually doing a read on the termQ, this was done to fix a trap that occured under 2.11 in some instances when MaxFile/PM has to wait on an executable to finish. Make sure that you are using a display driver that is certified as compatible with the version of OS/2 that you are running. I found out the hard way that using the WD 640x480 256 color driver that comes with 2.10 will NOT work reliably with 2.11, it was causing MaxFile/PM to lock the WPS up tight after spawning an external process and waiting for it. 09-21-94 Changed 'Extract To...' to only ask for the directory to extract files to once. All the archives selected will get expanded into the same directory. The earlier behaviour of asking for each file was locking up the WPS when a display driver of 640x480/256 colors or greater was being used (buggy drivers, not my code!) 09-25-94 *Finally* cleaned up dupe check results. Duplicate files are now only listed once like they should be, in alphabetical order. Rearranged the Settings notebook, the Adopt page has been renamed to Main - Pg 3 (more for consistency than anything else.) At the same time, added two new configuration items. For "Remove Items" you can now set a default action, options selectable are; "Prompt", "Entries" and "Entries and Files." For "Descriptions->Copy" you can now configure whether or not you want the (xx of xx) counter appended to the end of the copied description. "Copying" files and/or comments can now be accomplished via Drag and Drop. Hold the CTRL key down while you are dragging file or comment objects, when dropped on either the Main File Area window or on a FILES.BBS window, the objects will get copied to the destination and the original objects will be left intact. Most of the above was suggested by Michael Roedeske. Also found a small bug related to FILE_ID.DIZ extraction, some archives come with the read only attribute set on the files in the archive. This bit is now removed from any _extracted_ FILE_ID.DIZ's so that they can be deleted when no longer needed. 09-26-94 Added a few more options to the File Area window Context Menu; "Edit REXX Macro..." this option allows you to create/edit REXX scripts by calling on your favorite editor from inside MaxFile/PM. And "Details View", this option will allow you to either have a full details view or just the area tag of the file areas displayed in the Main File Area window. A checkmark is used show which view is in effect (you should be able to figure it out by looking at the container...) When checked; details view is in effect, otherwise the view is text. 09-27-94 Added another option to the File Area window Context Menu, "Create FREQ List..." This option allows you to create a list of directories for mailers that use an OKFILE.* for file requests. Added "Files->Remove Missing" to the FILES.BBS window Context Menu. It searches through a FILES.BBS window and removes orphaned file entries. The download counter string is now configurable, it is on Main - Page 3 with the rest of the adopt options. 09-28-94 Added "Files->Purge Dupes" to the FILES.BBS window Context Menu. This item scans through a FILES.BBS window and purges duplicate entries based on filenames. Useful when a TICK processor adds an entry for a file that already exists (during a replace, etc..) 10-01-94 Modified the behaviour of "Remove Items", when you choose to remove only entries, the old behaviour was to remove the entry for a file from the FILES.BBS window. This has been changed to show the file, which is still present, as an orphaned file (this is the way it should have been in the first place.) Comments are still handled in the old fashion. Added another option to the FILES.BBS window Context Menu, "Select All Files". It selects all files in a FILES.BBS window that are not orphans. 10-05-93 The number of significant characters for a duplicate file search can be configured now. Look for it in the Settings Notebook on Main - Page 2. 10-14-94 Removed debug code from ExecAndWait() function. This removes the message box that presents the "Bad RC" message. You will still be notified of errors with spawning archivers, but only if it is a serious error that requires your attention. "Remove Items", orphaned file entries (entry in FILES.BBS with no file in the download directory) can now be removed when you select to "Remove Entries and Files." Purge missing will perform the same operation. Phillip Perlman brought the above items my attention. Tweaked menu handling code.