home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / mpm1_28.zip / maxfmpm.txt < prev    next >
Text File  |  1995-10-05  |  103KB  |  2,477 lines
  1.  
  2.  
  3.                         MaxFile/PM - VERSION 1.28
  4.  
  5.         COPYRIGHT 1993,94,95 by Craig Morrison. All Rights Reserved.
  6.  
  7.                 A FILES.BBS Manager for Presentation Manager
  8.  
  9.  
  10.  
  11.         Portions of the header files used in compilation are:
  12.  
  13.           Copyright (C) 1992 by Scott Dudley
  14.           Copyright (C) 1993 by Aki Antman
  15.           Copyright (C) 1994 by Marco Maccaferri
  16.  
  17.         MSGAPI portions of the Announce Files option are:
  18.  
  19.           Copyright 1991,94 by Scott J. Dudley.  All rights reserved.
  20.           "Squish" and "Maximus" are trademarks of Lanius Corporation.
  21.  
  22.         From the Development Team of:
  23.  
  24.           Craig Morrison - MaxFile/PM Development
  25.             1:201/60@fidonet.org
  26.  
  27.           Ronald Van Iwaarden - MaxFile/2 Development
  28.             1:104/338@fidonet.org
  29.  
  30.         UNRAR.EXE is included in the distribution archive by special
  31.         permission from:
  32.  
  33.           Andrey Spasibozhko
  34.  
  35.         UNRAR.EXE is:
  36.  
  37.           Copyright 1994 by Eugene Roshal
  38.  
  39.  
  40.  
  41. Special Thanks go out to:
  42.  
  43.  Mark Kimes
  44.  
  45.   For putting up with my never ending questions and general bull-headedness
  46.   when it comes to programming under OS/2. (Very handy guy to talk to when it
  47.   comes to programming in general!)
  48.  
  49.  Andrey Spasibozhko
  50.  
  51.   For allowing me to include UNRAR.EXE as a part of the archive. RAR is an
  52.   up and coming compression utility, if you haven't done so yet, it might
  53.   be worth your while to take a look at it. The authors are very responsive
  54.   to all inquiries.
  55.  
  56.  Elliott Goodman
  57.  
  58.   Beta Tester
  59.   ANNOUNCE.CMD author
  60.  
  61.  Philip Perlman
  62.  
  63.   Beta Tester
  64.  
  65.  Ronald Van Iwaarden
  66.  
  67.   Cohort in crime and Beta Tester
  68.  
  69.  
  70. ------------------------------------------------------------------------------
  71. --- Foreword -----------------------------------------------------------------
  72. ------------------------------------------------------------------------------
  73.  
  74.         MaxFile/PM is a FILES.BBS manager that runs under Presentation
  75.         Manager. While it was written with the Maximus-CBCS in mind,
  76.         any BBS software package that uses the standard FILES.BBS
  77.         format is supported.
  78.  
  79.         Including these features:
  80.  
  81.             *  All Files and New Files List Generation
  82.  
  83.             *  Auto Adopt Orphaned Files with File Description Import
  84.  
  85.             *  Automatic Generation of FILES.BBS Headers
  86.  
  87.             *  Built-In Support for Maximus 2.xx/3.xx, LoraBBS, SuperBBS
  88.  
  89.             *  Check for Duplicate Files
  90.  
  91.             *  Context Sensitive Online Help
  92.  
  93.             *  Create File Announcements in *.MSG/Squish Message Bases
  94.  
  95.             *  Create File Attaches for *.MSG/Squish Message Bases
  96.  
  97.             *  Create File Requests for *.MSG/Squish Message Bases
  98.  
  99.             *  Create Text Okfiles for Mailers
  100.  
  101.             *  Drag and Drop Enabled
  102.  
  103.             *  Extract Archives
  104.  
  105.             *  Extended Description Support
  106.  
  107.             *  FILE_ID.DIZ, DESC.SDI, SDN.ID Import
  108.  
  109.             *  Generic Configuration for ANY FILES.BBS Based File System
  110.  
  111.             *  Kill or Move Outdated Files
  112.  
  113.             *  Process Received File Requests and Toss them to Proper Area
  114.                with File Descriptions
  115.  
  116.             *  Purge Duplicate File Entries
  117.  
  118.             *  Rearchive Files to a Preferred Format
  119.  
  120.             *  Remove Missing or Orphaned File Entries
  121.  
  122.             *  REXX Macro Support
  123.  
  124.             *  Scan through Documentation Files to Cut and Paste a
  125.                Description
  126.  
  127.             *  Sorts File Areas By Name, Date, Size or Description. Comments
  128.                are left intact and in place
  129.  
  130.             *  Support for ARC, ARJ, HA, LZH, RAR, UC2, ZIP and ZOO archivers
  131.  
  132.             *  Tests Archives
  133.  
  134.             *  User Definable Button Bars for Quick Function Access
  135.  
  136.             *  User Definable Shift Key Functions
  137.  
  138.             *  Virus Scanner Support
  139.  
  140.  
  141. ------------------------------------------------------------------------------
  142. --- Registration -------------------------------------------------------------
  143. ------------------------------------------------------------------------------
  144.  
  145.         I'm going to keep this short, sweet and to the point. It is
  146.         $25 to register the program. You have unrestricted use of this
  147.         program for the first 45 days you use it. After that period of
  148.         time the program will display a registration incentive dialog
  149.         for 45 seconds each time you run it.
  150.  
  151.         MaxFile/PM is not freeware, it is shareware, you are expected
  152.         to register the program if you continue using it.
  153.  
  154.         Please print out and read the REGISTER.FRM file that is included
  155.         in the archive for more information on registering the program.
  156.  
  157.         Registration provides me with the incentive to keep working on
  158.         the program, it's all up to you folks that use the program. I
  159.         treat registered users VERY well.
  160.  
  161.         'Nuff said...
  162.  
  163.  
  164. ------------------------------------------------------------------------------
  165. --- Support ------------------------------------------------------------------
  166. ------------------------------------------------------------------------------
  167.  
  168.         If you need to contact me about the program I can be reached
  169.         in a number of places. NetMail will get you the fastest
  170.         response, but I read the OS2PRODSUP, OS2BBS and MUFFIN
  171.         conferences everyday and intend on answering any questions
  172.         posted there. There is also a local conference on my BBS
  173.         called MFILEPMSUP that you are more than welcome to poll for.
  174.         Contact either myself, Elliott Goodman at 1:102/1319 or Pete
  175.         Norloff at 1:109/347 for more information about getting hooked
  176.         up.
  177.  
  178.         Due to the large cost in crashing netmail all over the world I
  179.         will only be sending replies out crash to registered users who
  180.         report a problem. Sorry folks, but most of my income is
  181.         generated by these projects. If they don't get registered I
  182.         can't provide free support. I will respond to everyone who sends
  183.         netmail, but it will be routed netmail in most cases.
  184.  
  185.         While I will answer questions from those of you who have not
  186.         registered the program, you will get a much quicker response
  187.         from me if you have.
  188.  
  189.         I *will* support MaxFile/PM, all you need to do is ask.
  190.  
  191.  
  192. ------------------------------------------------------------------------------
  193. --- Before You Start - READ THIS!! -------------------------------------------
  194. ------------------------------------------------------------------------------
  195.  
  196.         The default installation of OS/2 defines Mouse Button 1 as the
  197.         left button and Mouse Button 2 as the right button. Please
  198.         keep this in mind as you read through this document if you
  199.         have redefined your mouse buttons.
  200.  
  201.         A word to the wise here..
  202.  
  203.                      BACKUP *BEFORE* USING MAXFILE/PM !
  204.  
  205.         Here comes the standard disclaimer...I don't promise that
  206.         MaxFile/PM will do anything for you except take up space on
  207.         your hard drive. While I am fairly certain I have got all the
  208.         nasties out of it, there is a chance that I may have missed
  209.         something. So please be safe and backup prior to using the
  210.         program. Suffice it to say, you have been warned..
  211.  
  212.  
  213. ------------------------------------------------------------------------------
  214. --- Configuring MaxFile/PM ---------------------------------------------------
  215. ------------------------------------------------------------------------------
  216.  
  217.         To configure MaxFile/PM for use, simply start MaxFile/PM by
  218.         typing MAXFMPM and pressing ENTER at an OS/2 Command Prompt.
  219.         The MaxFile/PM Settings notebook will be presented for you, so
  220.         that you can enter the vital information about your system and
  221.         BBS setup.
  222.  
  223.         The Settings Notebook is where you configure MaxFile/PM so
  224.         that it fits your particular system. There are a lot of
  225.         options here, some required, some not, all depending on
  226.         whether you want to be able to use that particular feature or
  227.         not. There are 4 major categories of information here; Main,
  228.         Archivers, Viewers and Other. Some of the categories have more
  229.         than one page devoted to them. A detailed discussion of the
  230.         categories follows.
  231.  
  232. Main - Basic information
  233.  
  234.         The Main section of the notebook consists of three pages that
  235.         contain the information that tells MaxFile/PM the basics about
  236.         your BBS configuration and how to handle certain options.
  237.  
  238. Main - Page 1
  239.  
  240.     Registration Key
  241.  
  242.         Your registration key, if you have one. If not leave it blank.
  243.  
  244.         Enter the registration key exactly the same as it is given to you.
  245.  
  246.     Registration Name
  247.  
  248.         Your name, this works in conjunction with the Registration Key
  249.         field. MaxFile/PM hashes your name against your Key to see if
  250.         you really are a registered user.
  251.  
  252.         The Registration XXXX fields when filled out properly, stop
  253.         the usage timer.
  254.  
  255.     BBS Package
  256.  
  257.         Four choices here:
  258.  
  259.             Maximus
  260.             Maximus 3.0
  261.             Lora
  262.             SuperBBS
  263.             Generic
  264.  
  265.         Simply select one from the drop down list box. Or type in one
  266.         of the names in the list above.
  267.  
  268.     BBS Directory
  269.  
  270.         This is the directory that your BBS software resides in. Enter
  271.         the FULL path specification.
  272.  
  273.     Temp Directory
  274.  
  275.         This is the FULL path to an EXISTING directory that MaxFile/PM
  276.         can use to store temporary files in and use for rearchiving
  277.         files. Don't use this directory for ANYTHING else while
  278.         MaxFile/PM is running. EVERYTHING, INCLUDING ANY
  279.         SUB-DIRECTORIES WILL BE REMOVED BEFORE Maxfile/PM TERMINATES!
  280.  
  281.     File Area Data
  282.  
  283.         This is the FULL path and filename of the file that contains
  284.         your file area definitions. For Maximus 2.xx users this will
  285.         be AREA.DAT, Maximus 3.0 users FAREA.DAT, for Lora users this
  286.         will be SYSFILE.DAT, for SuperBBS users this will be
  287.         FLSEARCH.BBS, for those using the Generic setup this should be
  288.         the name of the text file you created according the guidelines
  289.         in the "Generic File Area Definitions" section.
  290.  
  291.     File Database Utility
  292.  
  293.         The next field is for the filename of your File Database
  294.         Utility. For Maximus this will be either FB.EXE or FBP.EXE. On
  295.         my system I have this set to FBP, since the utility is in my
  296.         path. For Lora-BBS users, this will be FILEIDX.EXE. Please see
  297.         the "Known Problems" section at the end of this document for
  298.         more information about FILEIDX.EXE. For SuperBBS users, I
  299.         don't have a clue. If someone would fill me in on this one I'd
  300.         really appreciate it! This entry is only required if you want
  301.         MaxFile/PM to run the utility for you.
  302.  
  303.     File Inbound
  304.  
  305.         This is the directory that your mailer places incoming files in.
  306.         MaxFile/PM will look in this directory for files when you
  307.         perform a Receive Files... from the File Area window context
  308.         menu.
  309.  
  310. Main - Page 2
  311.  
  312.     Hide CDs
  313.  
  314.         When checked your CD file areas will be hidden from view in the
  315.         main File Area Window.
  316.  
  317.         NOTE: When you have this option turned on it would be wise to
  318.         make sure there is a CD in the CD-ROM drive, MaxFile/PM needs to
  319.         ask the file system drivers for some information about the drive
  320.         and in the process the CD-ROM drive has to be accessed.
  321.  
  322.     File Headers
  323.  
  324.         When checked MaxFile/PM will generate an information header that
  325.         is written to the top of the FILES.BBS for an area when you
  326.         perform a save in a FILES.BBS window.
  327.  
  328.         The header looks much like the area headers that are written to
  329.         the All Files and New Files lists. The only exception being that
  330.         the custom information from ALLFILES.CUS is not written to the
  331.         header in the FILES.BBS.
  332.  
  333.     AutoSave
  334.  
  335.         This tells MaxFile/PM whether or not you want your FILES.BBS
  336.         files automatically saved when you close a file area. If you
  337.         check this option MaxFile/PM will save the FILES.BBS for you
  338.         as soon as you close the window associated with a FILES.BBS,
  339.         if not, it will prompt you and ask if you want the information
  340.         saved.
  341.  
  342.     Button Bar
  343.  
  344.         This check box tells MaxFile/PM whether or not you want the
  345.         button bar turned on in your FILES.BBS windows.
  346.  
  347.     Create File Summaries
  348.  
  349.         When checked MaxFile/PM will create a summary of the file
  350.         statistics for a file area when the FILES.BBS for the area is
  351.         saved. The name of the file will the same as the file list
  352.         (FILES.BBS in most cases) with the extension removed and
  353.         replaced with SUM. It will be saved into the same directory as
  354.         the file list. An example:
  355.  
  356.                 C:\BBS\FILES\OS2\FILES.BBS
  357.  
  358.         The summary file would be saved in:
  359.  
  360.                 C:\BBS\FILES\OS2\FILES.SUM
  361.  
  362.     Header Size
  363.  
  364.         For those of you using programs such as DownSort, this option
  365.         will allow you to tell MaxFile/PM how many lines at the
  366.         beginning of your FILES.BBS to skip when reading them in. The
  367.         headers ARE preserved when MaxFile/PM writes out a new
  368.         FILES.BBS.
  369.  
  370.         NOTE: When you have File Headers checked, MaxFile/PM takes care
  371.         of this setting for you.
  372.  
  373.     Dupe Length
  374.  
  375.         Tells MaxFile/PM how many characters to look at in a filename
  376.         when performing a search for duplicates.
  377.  
  378.     ED Marker
  379.  
  380.         For those BBS packages that support extended descriptions this
  381.         option will come in handy. Here you tell MaxFile/PM what
  382.         character is associated with extended descriptions for your
  383.         BBS Package. This character can not be a space or a dash.
  384.  
  385.         Defining this character causes a few changes in the way
  386.         MaxFile/PM handles your file descriptions. When this option is
  387.         used, file descriptions are allowed to be up to 1024
  388.         characters in length and nothing is stripped from FILE_ID.DIZ,
  389.         DESC.SDI or SDN.ID descriptions read in from archives.
  390.         MaxFile/PM does not insert this character in multiple line
  391.         descriptions for you, you need to do this. However, when you use
  392.         'Format Description' MaxFile/PM will take care of putting this
  393.         character where it belongs.
  394.  
  395.     FileList Margin
  396.  
  397.         This setting causes a change in the file description handling
  398.         similar to the ED Marker. NOTE: If an ED Marker is defined,
  399.         FileList Margin is IGNORED. However, if an ED Marker is NOT
  400.         defined and FileList Margin is greater than zero; File
  401.         descriptions are limited to 1024 characters, FILE_ID.DIZ
  402.         DESC.SDI and SDN.ID are imported as is, when a FILES.BBS is
  403.         written _FileList Margin_ spaces are added to the beginning of
  404.         each extra line in the file description so that they line up in
  405.         a file listing.
  406.  
  407.         If an ED Marker is not defined and this is set to zero, file
  408.         descriptions are limited to 255 characters, any non-printable
  409.         ASCII characters (0-31) and high-bit ASCII characters are
  410.         stripped from the file description.
  411.  
  412.     Run FD Utility
  413.  
  414.         The options for Run FD Utility determine when and if the File
  415.         Database utility will get run. There are three; Always, Prompt
  416.         and Never. Always will run your file database utility
  417.         every time you exit MaxFile/PM. If no changes have been made,
  418.         it will prompt you before running it. Prompt will ask you if
  419.         you wish to run it. Do I need to explain Never? :-}
  420.  
  421.     Display
  422.  
  423.         The Display options control whether or not the file size and
  424.         date information gets displayed for your files in the
  425.         FILES.BBS windows. Simply check or un check the check boxes to
  426.         set your preferences.
  427.  
  428. Main - Page 3
  429.  
  430.     Extensions edit control
  431.  
  432.         This is a simple edit control that you use to enter in the
  433.         extensions that you want add to the list box to the right. You
  434.         may enter up to 3 characters for each extension, wild cards are
  435.         allowed. These extensions are used while adopting files,
  436.         anything not defined here will be ignored. These extensions are
  437.         use when you perform an Adopt from the FILES.BBS window context
  438.         menu or you have Auto Adopt turned on.
  439.  
  440.     Add button
  441.  
  442.         After entering an extension in the edit control click this
  443.         button to add it to the list of extensions in the list box.
  444.  
  445.     Remove button
  446.  
  447.         This button allows you to remove an entry from the list box.
  448.         Simply highlight the entry you want to remove from the list
  449.         box and click here.
  450.  
  451.     Auto Adopt
  452.  
  453.         This check box tells MaxFile/PM if you want it to automatically
  454.         perform an Adopt when a file area is first opened. This only
  455.         works if you have actually added at least one extension for
  456.         MaxFile/PM to scan for.
  457.  
  458.     Download counters
  459.  
  460.         If you want download counters added to the description of
  461.         files that get adopted, check this box.
  462.  
  463.     Default Description
  464.  
  465.         You may enter up to 80 characters for a default description.
  466.         This text will get used any time you Insert, Adopt or drop
  467.         files from an outside source into a window in MaxFile/PM and
  468.         those files meet the following criteria: 1, they are not an
  469.         archive or 2, they are an archive and the archive does not
  470.         contain a FILE_ID.DIZ, DESC.SDI or SDN.ID description inside of
  471.         it.
  472.  
  473.     Add (x/xx) counter on description copy
  474.  
  475.         This option allows you to tell MaxFile/PM whether or not you
  476.         want the (xx of xx) counters appended onto the end of
  477.         descriptions when you perform a "Description->Copy" in a
  478.         FILES.BBS window. Check it if you want them, unchecked if you
  479.         don't. The default is for them to be added.
  480.  
  481.     Extract All Files on Document Scan
  482.  
  483.         When selected all the files in a selected archive will be
  484.         extracted when performing a Description->Scan Docs from a
  485.         FILES.BBS Window context menu. Otherwise, MaxFile/PM will
  486.         attempt to extract a common subset of files that are usually
  487.         documentation related files.
  488.  
  489.     Remove Items
  490.  
  491.         Three choices here:
  492.  
  493.             Prompt
  494.             Entries
  495.             Entries and Files
  496.  
  497.         This configuration option affects the default action of "Remove
  498.         Items" inside a FILES.BBS window. "Prompt" asks you each time.
  499.         "Entries" removes just the entries. "Entries and Files" removes
  500.         the entries and deletes the files associated with those entries.
  501.  
  502. Buttons
  503.  
  504.     This page allows you to customize the button bar that can be
  505.     displayed in a FILES.BBS window to your liking.
  506.  
  507.     Please Note:  If "Button Bar" on Main Pg 2 is not selected, the
  508.     button bar will NOT be displayed in your FILES.BBS windows.
  509.  
  510.     Each button definition consists of two items; A bitmap and a
  511.     function.
  512.  
  513.     The bitmaps used are stored in the directory you start MaxFile/PM
  514.     from. For best results they should 32x32 16 color bitmaps, larger
  515.     bitmaps will be clipped to size of the button. When a FILES.BBS
  516.     window is opened the bitmaps are loaded into memory, if the bitmap
  517.     doesn't exist the button is skipped and will not display. You can
  518.     use the Icon Editor that comes with OS/2 to create your own bitmaps
  519.     for use with MaxFile/PM.
  520.  
  521.     To define a button; first select a bitmap file from the drop down
  522.     list box labelled "Bitmaps" at the top of the notebook page. Then
  523.     select a function from the drop down list box labelled "Functions"
  524.     and click on the "Add" button. The button definition will then be
  525.     inserted into the "Buttons" list box at the bottom of the notebook
  526.     page.
  527.  
  528.     Directly above and to the right of the Buttons list box are a set of
  529.     buttons that allow you to add, remove or reorder your button
  530.     definitions. We have already covered the Add button.
  531.  
  532.     To remove a button definition; Select the button definition you want
  533.     to delete and then click on the "Remove" button. The definition will
  534.     then be discarded from the Buttons list box.
  535.  
  536.     To reorder the button definitions; Select the button definition you
  537.     want to move and then click on either the up or down arrow button to
  538.     the right of the Buttons list box to move the definition in the
  539.     respective direction.
  540.  
  541.     You can have as many buttons as you want but remember, they take up
  542.     screen real estate. If the button bar would extend beyond the right
  543.     hand side of the window it will be wrapped downwards so that all of
  544.     your buttons are visible.
  545.  
  546.     To help you remember what button does what, when you move the mouse
  547.     pointer over a button the window title bar the button is in will
  548.     display the function associated with that button.
  549.  
  550. Archivers - Archiver Information
  551.  
  552.     This section causes the most confusion when configuring
  553.     MaxFile/PM. The best I can do to help is to tell you what I use
  554.     here on my system to give you a few hints.
  555.  
  556.     There are eight pages, one each for; Zip, Arj, Lzh, Arc, HA, RAR,
  557.     UC2 and ZOO. I don't use HA, RAR or UC2 so you are on your own with
  558.     these archivers.
  559.  
  560.     You will need to enter the executable name and the appropriate
  561.     switches for each of the actions for each archiver. You should
  562.     include any switches necessary for recursing sub-directories and
  563.     if you want to make MaxFile/PM's job a little easier, any switches
  564.     to tell the archivers to 'move' files into archives when adding to
  565.     or creating a new archive. Below I will give a short description
  566.     of each entry and the settings for the archivers I use. You will
  567.     have MUCH better success with OS/2 based archivers.
  568.  
  569.     NOTE: Each of the archivers you use must be able to accept
  570.     filenames on the command line other than just the archive name.
  571.     Some versions of UNARJ do not allow you to do this.
  572.  
  573.     I also believe I have gotten the DOS kludge worked around in the
  574.     code. So you *should* be able to just define your DOS archivers just
  575.     like OS/2 based archivers, I.E, PKUNZIP -v, for listing an archive.
  576.     The settings for the DOS archivers below worked for me for what
  577.     little time I spent with them.
  578.  
  579.         Extract
  580.  
  581.             This entry should contain the command and switches
  582.             necessary to extract a file from an archive.
  583.  
  584.                 ZIP     unzip -xo -U -C
  585.                 ARJ     unarj e
  586.                 ARJ     x -y
  587.                 LZH     lh x
  588.                 ARC     arc x
  589.                 RAR     rar -o+ -std -y
  590.                 HA      ha ey
  591.                 UC2     uc2 ESF
  592.                 ZOO     zoo xO
  593.  
  594.         Add
  595.  
  596.             This entry should contain the command and switches
  597.             necessary to add files to an archive.
  598.  
  599.                 ZIP     zip -9 -r
  600.                 ARJ     a -r -y
  601.                 LZH     lh a
  602.                 ARC     arc a
  603.                 RAR     a -r -y -ep1 -std
  604.                 HA      ha a12rd
  605.                 UC2     uc ASF
  606.                 ZOO     zoo ah
  607.  
  608.         List
  609.  
  610.             This entry should contain the command and switches
  611.             necessary to list the files in an archive to standard
  612.             output.
  613.  
  614.                 ZIP     unzip -v
  615.                 ARJ     unarj l
  616.                 ARJ     arj v -y
  617.                 LZH     lh l
  618.                 ARC     arc l
  619.                 RAR     v -std -y
  620.                 HA      l
  621.                 UC2     VS
  622.                 ZOO     zoo L
  623.  
  624.         Test
  625.  
  626.             This entry should contain the command and switches
  627.             necessary to test the integrity of an archive with the
  628.             output going to standard output.
  629.  
  630.                 ZIP     unzip -t
  631.                 ARJ     unarj t
  632.                 ARJ     arj t -y
  633.                 LZH     lh t
  634.                 ARC     arc v
  635.                 RAR     t -std -y
  636.                 HA      t
  637.                 UC2     TF
  638.                 ZOO     zoo xN
  639.  
  640. Viewers - File Viewers
  641.  
  642.     Here you can define viewers for use with the View function in a
  643.     FILES.BBS window. Enter the filename and any necessary switches
  644.     for each of the programs. There are entries for the following file
  645.     types:
  646.  
  647.         Archives
  648.         GIF
  649.         PCX
  650.         JPG
  651.         TIF
  652.         BMP
  653.         Other
  654.  
  655.     The 'Other' entry catches anything that is not an archive, GIF,
  656.     PCX, JPG, TIF or BMP file. I.E, text files.
  657.  
  658. Other - Things I couldn't figure out where else to put. :-)
  659.  
  660.     Virus Scanner
  661.  
  662.         This should be the name of the program to scan files for
  663.         viruses, make sure to include any necessary switches. I use
  664.         McAfee's scanner for OS/2 like so:
  665.  
  666.             OS2SCAN /A /NOEXPIRE
  667.  
  668.     Editor
  669.  
  670.         Here you can define a text editor for editing text based files.
  671.         Currently this is only used for editing REXX macro scripts.
  672.  
  673.     Shift F6
  674.     Shift F7
  675.     Shift F8
  676.     Shift F9
  677.     Shift F10
  678.  
  679.         These five entries are for things I may have overlooked or for
  680.         some special processing that you would like to do to a file.
  681.         Enter the program name and any switches they need. When in a
  682.         FILES.BBS window and you press one of the above keystrokes,
  683.         the appropriate entry will get started with one of the
  684.         selected files as a parameter on its command line, this will
  685.         continue one file at a time until all selected files have been
  686.         processed.
  687.  
  688.  
  689. ------------------------------------------------------------------------------
  690. --- Generic File Area Definitions --------------------------------------------
  691. ------------------------------------------------------------------------------
  692.  
  693.         To provide support for any BBS system that uses the standard
  694.         FILES.BBS format for their file listings I have come up with a
  695.         very simple text file format that will allow you to tell
  696.         MaxFile/PM how your file areas are defined.
  697.  
  698.         The file is made up of a verb that tells MaxFile/PM how many
  699.         areas it can expect to find in the text file. Each successive
  700.         line after that verb defines the file areas themselves. A
  701.         sample file is shown below:
  702.  
  703. ----------------------------- AREAS.CFG sample --------------------------------
  704. AreaCount 5
  705. 0 d:\max\file\uncheck    d:\max\file\uncheck\files.bbs    Unchecked Uploads
  706. 1 d:\max\file\max        d:\max\file\max\files.bbs        BBS Stuff
  707. 2 d:\max\file\dos\games  d:\max\file\dos\games\files.bbs  Dos Games
  708. 3 d:\max\file\os2\util   d:\max\file\os2\util\files.bbs   OS/2 Utilities
  709. 4 d:\max\file\os2\apps   d:\max\file\os2\apps\files.bbs   OS/2 Applications
  710. -------------------------------------------------------------------------------
  711.  
  712.         The 'AreaCount' keyword tells MaxFile/PM how many area
  713.         definitions it can expect to find in the file. The AreaCount
  714.         keyword must come BEFORE the area definition lines.
  715.  
  716.         The format for each area definition line is:
  717.  
  718.             <area tag> <file path> <list name> <area description>
  719.  
  720.      ────────────────────────────────────────────────────────────────────
  721.       <area tag>           Is a short name to identify the file area.
  722.  
  723.       <file path>          Is the download path of the file area.
  724.  
  725.       <list name>          Is the full drive:\path and filename of the
  726.                            FILES.BBS for the area.
  727.  
  728.       <area description>   Is a short description of the area.
  729.      ────────────────────────────────────────────────────────────────────
  730.  
  731.         You can name this file what ever you wish, just make sure you
  732.         specify the name of this file for the File Area Data option in
  733.         the Main Settings Dialog and make sure the BBS Package is set
  734.         to 'Generic'.
  735.  
  736. ------------------------------------------------------------------------------
  737. --- Using MaxFile/PM ---------------------------------------------------------
  738. ------------------------------------------------------------------------------
  739.  
  740.         When MaxFile/PM first comes up a window will be displayed that
  741.         contains all of your file areas. I will be referring to this
  742.         window by the term 'File Area Window' throughout the rest of
  743.         this document.
  744.  
  745.         When you open up a file area, a window that is very similar in
  746.         appearance to the File Area window will appear. This window
  747.         will contain all the files listed in the FILES.BBS for that
  748.         area. These windows will be referred to as 'FILES.BBS Windows'
  749.         from here on out.
  750.  
  751. --- File Area Window ---------------------------------------------------------
  752. ------------------------------------------------------------------------------
  753.  
  754.         The File Area window serves two basic purposes. First, it
  755.         allows you to open FILES.BBS Windows and second, it also
  756.         serves as a dropping point for files so that you can quickly
  757.         move files to another file area without having to open the
  758.         file area.
  759.  
  760.     File Area Window Context Menu
  761.  
  762.     The File Area Window Context Menu is where you control the overall
  763.     operations of MaxFile/PM. A somewhat detailed explanation of each
  764.     menu item follows.
  765.  
  766.     Open...
  767.  
  768.         This menu item allows you to open the highlighted file area(s).
  769.  
  770.         The various ways of opening a file area are: Highlighting the
  771.         area you want to open and pressing enter or double-clicking
  772.         mouse button 1 on a file area.
  773.  
  774.         If the file area is already open it will be brought into view,
  775.         even if it is minimized to the Minimized Window Viewer folder.
  776.  
  777.  
  778.     Area Sort
  779.  
  780.         Tag
  781.         Description
  782.         Files Dir
  783.  
  784.         These options sort the File Area Window listing by the
  785.         appropriate field in ascending order.
  786.  
  787.  
  788.     Check for Duplicates
  789.  
  790.         To check your file areas for duplicate files choose this menu
  791.         item after selecting the area(s) you want MaxFile/PM to check
  792.         against all of your file areas. Please note that the scan
  793.         performed when checking for duplicates does not involve the
  794.         FILES.BBS files for the areas scanned, it looks at the contents
  795.         of the download directory for each area. So all duplicates will
  796.         be found regardless of whether there is a FILES.BBS entry for
  797.         them or not. However, the files searched for come directly from
  798.         the FILES.BBS files of the areas selected in the File Area
  799.         window. So make sure if you have a FILES.BBS window open for one
  800.         of the areas you will be checking for duplicates from, that you
  801.         have saved any changes made in that window.
  802.  
  803.         The File Area window will be locked open until you close the
  804.         DupeCheck Results dialog box. This dialog will appear as soon as
  805.         the file scanning is complete. Inside this dialog you will see a
  806.         listing of all the files found. To open the file area associated
  807.         with a file, simply double-click on its entry. If you decide
  808.         that you want to delete the file from this dialog, highlight the
  809.         entry and click the delete button.
  810.  
  811.  
  812.     Search...
  813.  
  814.         This function is very similar to the Dupe Checker option, with
  815.         the exception that instead of checking for duplicate files you
  816.         can enter a string of text that MaxFile/PM will search for in
  817.         each of the FILES.BBS files for each of the selected areas.
  818.  
  819.         First select the areas that you want to search, then bring up
  820.         the context menu and select 'Search...' A dialog box will come
  821.         up asking you what to search for. You may enter up to 80
  822.         characters. Click ok to begin the search.
  823.  
  824.         The search is not case nor position sensitive. Both the filename
  825.         and description are searched for the text, if the text appears
  826.         in of these two places a 'hit' will occur. The dialog box that
  827.         comes up after the search is complete works exactly the same as
  828.         the dialog box showing the results of the Dupe Checker option.
  829.  
  830.  
  831.     Find Area...
  832.  
  833.         This function will allow you to enter an area tag, MaxFile/PM
  834.         will find the area and then scroll it into view for you.
  835.  
  836.  
  837.     All Files List
  838.  
  839.         Probably the most requested feature had to be the ability to
  840.         generate a list of available files from the FILES.BBS listings.
  841.         MaxFile/PM will generate an all files list for you. It's highly
  842.         customizable and can be run automagically from a batch file once
  843.         configured correctly.
  844.  
  845.         To use the all files generator interactively, simply start
  846.         MaxFile/PM and then select the areas from the File Area window
  847.         that you want included in the listing. Then bring up the context
  848.         menu and select "All Files List". MaxFile/PM will then process
  849.         each FILES.BBS and produce two listings under the filenames
  850.         ALLFILES.LST and NEWFILES.LST in the directory that MaxFile/PM
  851.         resides in.
  852.  
  853.         Each time you run the all files generator from the context menu,
  854.         a file called ALLFILES.CFG will be written that contains a list
  855.         of the area tags for each of the areas in the listing. Do NOT
  856.         modify this file. The purpose behind this file is to tell
  857.         MaxFile/PM what areas to include when you run the all files
  858.         generator in batch mode. If you add or delete file areas, you
  859.         MUST run the all files generator from the context menu in
  860.         interactive mode at least once to keep the ALLFILES.CFG in sync
  861.         with your file areas. I'll put it this way... IF YOU WANT TO RUN
  862.         IN BATCH MODE YOU MUST KEEP allfiles.cfg IN SYNC WITH YOUR FILE
  863.         AREAS.
  864.  
  865.         To customize the all files generator to suit your tastes, you
  866.         can create some text files which will be written to your file
  867.         listing at the appropriate times.
  868.  
  869.         The names for the files are:
  870.  
  871.             ALLFILES.HDR    NEWFILES.HDR
  872.             ALLFILES.FTR    NEWFILES.FTR
  873.             ALLFILES.CUS
  874.  
  875.         ALLFILES.HDR and ALLFILES.FTR are written verbatim to the file
  876.         listing at the beginning and ending of the listing,
  877.         respectively. ALLFILES.CUS is a little more complex. It allows
  878.         you to insert text into the headers that are written to the
  879.         listing for each file area. The format of the file is:
  880.  
  881.             <AreaTag> <Header text......>
  882.  
  883.         <AreaTag> is the area tag of the file area header the text that
  884.         follows it should be inserted into. You may place as many lines
  885.         as you need to for each area as long as they all follow this
  886.         format. <AreaTag> is checked against the area tag for each area
  887.         in such a manner that if the tag for the area begins with the
  888.         tag specified in this file the text will get inserted. An
  889.         example might be of some help here..
  890.  
  891.         You have the following areas:
  892.  
  893.             CICA001
  894.             CICA002
  895.             CICB001
  896.             001
  897.             002
  898.  
  899.         In your ALLFILES.CUS file you have:
  900.  
  901.             CICA Files in this area are NOT freq'able.
  902.             CIC These files are on my CD-ROM.
  903.             00 These files are freq'able anytime but ZMH.
  904.  
  905.         CICA would match CICA001 and CICA002. CIC would match CICA001,
  906.         CICA002 and CICB002. 00 would match 001 and 002. Get the idea?
  907.         Its rather simple once you get used it.
  908.  
  909.         To run the all files generator in batch mode from the command
  910.         line, specify the -A switch on MaxFile/PM's command line.
  911.         MaxFile/PM will do its thing and then return to the command
  912.         prompt when it is done. -a, -A, /a and /A are all recognized as
  913.         valid switches for this mode of operation.
  914.  
  915.         NOTE: This function is run at IDLE priority so that it won't
  916.         degrade other processes in the system.
  917.  
  918.  
  919.     Outdated Files...
  920.  
  921.         This option will allow you to either remove or move to a file
  922.         area those files that are older than a certain number of days.
  923.  
  924.         The process of taking care of your outdated files begins by
  925.         selecting the areas that you wish to scan from the File Area
  926.         window. Now, bring up the context menu and select 'OutDated
  927.         Files...', you will be presented with a dialog box, this is
  928.         where you tell MaxFile/PM how to manage the old files.
  929.  
  930.         To remove files, select the Kill radio button. To move files to
  931.         a selected file area, select the Move radio button and then
  932.         enter the Area Tag of the file area you want the files to go
  933.         into. The Area Tag you type in MUST exactly match one of the
  934.         area tags listed in the first column of the File Area window,
  935.         upper and lower case letters are important here.
  936.  
  937.         Now you need to tell MaxFile/PM the number of days old a file
  938.         has to be before it will be moved or deleted. Either type in the
  939.         number of days or use the spin button to adjust the number of
  940.         days to your liking. To give you some indication of the date
  941.         range you will be working with, the date below the spin button
  942.         will tell you what the date on the oldest file can be.
  943.  
  944.         After entering the above, click OK and sit back and let
  945.         MaxFile/PM do its thing. If a file area you have selected is
  946.         open, it will be skipped. Also, if you are moving files, the
  947.         file area that will receive the dated files will be skipped.
  948.  
  949.  
  950.     Create FREQ List...
  951.  
  952.         Here you can tell MaxFile/PM to create an OKFILE listing for
  953.         your mailer based on the selected items in the File Area window.
  954.  
  955.         After selecting this option, you will be presented with a
  956.         standard File Save As dialog to choose a filename from. You can
  957.         either type in the name of an existing file, or the name you
  958.         want the listing to have. If it doesn't exist MaxFile/PM will
  959.         create it for you.
  960.  
  961.         If the file "MAGIC.TXT" exists in the directory you start
  962.         MaxFile/PM from, the entries in it will be copied to the output
  963.         file. The directory listing will then be appended to the output
  964.         file.
  965.  
  966.  
  967.     Request Files...
  968.  
  969.         Allows you to create a file request message to request files
  970.         from another FTN capable system.
  971.  
  972.         After selecting this option you will be presented with a dialog
  973.         box that asks you for a number of items; The message base path,
  974.         mail processor, message base type, message flags, who the file
  975.         request is generated for and who you are. More information about
  976.         these options can be found in the discussion of the Announce
  977.         Files option on the FILES.BBS Window Context Menu.
  978.  
  979.         The remaining controls in the dialog box deal with what files
  980.         you want to request and what areas the files go into. An example
  981.         will explain this best. Let's say we want to request the
  982.         following files:
  983.  
  984.             FILES           Magic name, doesn't go in any area.
  985.             MPM1_26.ZIP     For area - BBS
  986.  
  987.         For the first file, FILES, you would enter 'FILES' in the edit
  988.         control labelled "File:" and then select the "Request" button.
  989.         This will add the entry "FILES" to the listbox directly beneath
  990.         the "File:" and "Area:" edit controls.
  991.  
  992.         For the second file, MPM1_26.ZIP, you would enter 'MPM1_26.ZIP'
  993.         in the edit control labelled "File:" and then enter 'BBS' in the
  994.         edit control labelled "Area:" and then select the "Request"
  995.         button. This will add the entry "MPM1_26.ZIP - BBS" to the file
  996.         request list listbox.
  997.  
  998.         If you make a mistake or just want to remove an entry for a
  999.         requested file, select the entry to remove from the request list
  1000.         listbox and then select the "Remove" button.
  1001.  
  1002.         Please Note: If you don't enter an area for a file that is
  1003.         requested no processing will take place for that file when you
  1004.         perform a "Receive Files".
  1005.  
  1006.  
  1007.     Receive Files
  1008.  
  1009.         Receives or processes the files requested with Request Files
  1010.         after actually receiving them.
  1011.  
  1012.         When you requested files with "Request Files..." a file called
  1013.         MAXFMPM.REQ was written to your MaxFile/PM directory. This file
  1014.         contains both the name of the file requested and the area the
  1015.         file should be tossed into. You really shouldn't edit this file,
  1016.         but if you have a burning desire to do so... Each line of the
  1017.         file consists of the filename requested, EXACTLY one space, a
  1018.         hyphen '-' character, EXACTLY one space and the area tag (or
  1019.         name) of the file area the file should go into.
  1020.  
  1021.  
  1022.     REXX Macro...
  1023.  
  1024.         Don't like the way MaxFile/PM does something? Well, now YOU can
  1025.         change it! REXX scripts are now supported. In addition to all
  1026.         the commands available from REXX, there are 30+ REXX extensions
  1027.         added by MaxFile/PM so that you can manipulate your files from a
  1028.         REXX command script.
  1029.  
  1030.         A discussion of REXX is well beyond the scope of this document,
  1031.         instead what you will read about here are the extensions that
  1032.         MaxFile/PM adds to REXX to allow you to work with your files.
  1033.         The supplied TESTREXX.CMD file is a sample that shows the syntax
  1034.         and usage of some of the added functions. PLEASE use this file
  1035.         as a guide when you are constructing your macros.
  1036.  
  1037.         REXX commands and programs that communicate with the user via
  1038.         Standard input and Standard output are fully supported by
  1039.         MaxFile/PM's REXX interface. When the REXX interface first
  1040.         starts up a window entitled "MaxFile/PM REXX Output" will appear
  1041.         on your desktop, this window is your means of communication with
  1042.         REXX.
  1043.  
  1044.         The top line of the REXX output window contains a single line
  1045.         edit control that can accept up to 80 characters. When you wish
  1046.         to actually send the typed text to standard input, click on the
  1047.         Send button. Clicking on the Send button when the control is
  1048.         empty sends a CR/LF pair to standard input.
  1049.  
  1050.         The remainder of the output window is reserved for the output
  1051.         coming from your REXX commands and/or application programs.
  1052.         REXX's PULL and SAY commands are fully supported. There are some
  1053.         limitations to what the output window can do though. It doesn't
  1054.         support; reverse tabs, vertical tabs, backspace or cursor
  1055.         movements. For applications that use this type of output or
  1056.         expect to be able to write to the screen using other methods
  1057.         than standard output you are going to need to use the START
  1058.         command or some other similar utility to run them in another
  1059.         session.
  1060.  
  1061.         To stop a REXX script that is running, bring the Main File Area
  1062.         window to the front and pull up the context menu, then select
  1063.         'Stop REXX' this will halt the script after the current
  1064.         instruction is complete.
  1065.  
  1066.         Starting MaxFile/PM with the -r switch will cause MaxFile/PM to
  1067.         open its main window, immediately run the REXX script specified
  1068.         and then exit. An example:
  1069.  
  1070.             MAXFMPM -rTESTREXX.CMD
  1071.  
  1072.         Would start MaxFile/PM, run TESTREXX.CMD to completion and then
  1073.         exit. -r -R /r and /R are all valid forms of the "REXX"
  1074.         switch.
  1075.  
  1076.         Listed below you will see the REXX extensions for use with
  1077.         MaxFile/PM, they will be listed by name with a short explanation
  1078.         of each. All the functions return 'ERROR' if something goes
  1079.         wrong. Those functions that aren't meant to return some type of
  1080.         information return 'OK' for success.
  1081.  
  1082.                   *******************************************
  1083.                   *   PAY ATTENTION TO THE NEXT PARAGRAPH   *
  1084.                   * IT WILL MAKE OR BREAK YOUR REXX SCRIPTS *
  1085.                   *******************************************
  1086.  
  1087.         You *MUST* be in the directory that MaxFile/PM resides in when
  1088.         you call one of the extensions added by MaxFile/PM. You can
  1089.         change directories throughout the lifetime of your script, but
  1090.         MaxFile/PM needs to be able to find its files and it expects
  1091.         them to be in the directory that your script gets called from.
  1092.         So if things start acting strangely when you are testing a
  1093.         script, make sure the current directory is your MaxFile/PM
  1094.         directory before you call one of the extensions listed here. The
  1095.         standard REXX function DIRECTORY() will return the current
  1096.         directory for you, use it to save the directory your script
  1097.         starts out in. Then just before your script ends, use it to
  1098.         restore the current directory.
  1099.  
  1100.  
  1101.                          MaxFile/PM REXX Extensions
  1102.                          --------------------------
  1103.  
  1104.         MPM_GetVersion()
  1105.  
  1106.             Returns MaxFile/PM's revision or version number.
  1107.  
  1108.  
  1109.         MPM_ClearWindow()
  1110.  
  1111.             Clears the REXX output window.
  1112.  
  1113.  
  1114.         MPM_MsgBox(message, title)
  1115.  
  1116.             Displays a simple message box using 'message' as the text
  1117.             displayed in the message box and 'title' as the title for
  1118.             the message box.
  1119.  
  1120.  
  1121.         MPM_QueryArea([area tag])
  1122.  
  1123.             Works in two different ways. Called with no arguments it
  1124.             returns the area tag of the first file area listed in the
  1125.             Main File Area window listing. When called with a single
  1126.             argument containing the area tag of an existing file area,
  1127.             it will return the area tag of the NEXT file area in the
  1128.             list. In either case, if an area can't be found it returns
  1129.             'ERROR'.
  1130.  
  1131.  
  1132.         MPM_QueryAreaList('stemvar')
  1133.  
  1134.             Creates a compound stem variable containing the area tag,
  1135.             description, download path and the full path/filename of the
  1136.             FILES.BBS for each area.
  1137.  
  1138.             The stem variable name is passed to the function as a
  1139.             string. stemvar.0 contains the total number of areas that
  1140.             information has been returned for.
  1141.  
  1142.             An example of how to use this function follows:
  1143.  
  1144.                 /* MPM_QueryAreaList() example */
  1145.                 rc = MPM_QueryAreaList('arealist')
  1146.  
  1147.                 Say arealist.0' items in Area List.'
  1148.                 Say arealist.1.area' is the first area.'
  1149.                 Say arealist.1.desc' is the first area description.'
  1150.                 Say arealist.1.path' is the first area download path.'
  1151.                 Say arealist.1.fbbs' is the first area FILES.BBS location.'
  1152.  
  1153.  
  1154.         MPM_QueryAreaInfo(area tag, '0' | '1' | '2')
  1155.  
  1156.             Queries and returns the specified information for 'area
  1157.             tag.' The level info is as follows:
  1158.  
  1159.                 0 - Area description
  1160.                 1 - Download Path
  1161.                 2 - FILES.BBS Location
  1162.  
  1163.  
  1164.         MPM_DeselectArea([area tag])
  1165.  
  1166.             Detags a file area in the Main File Area window. If area tag
  1167.             is ommitted the selection emphasis is removed from all items
  1168.             in the window.
  1169.  
  1170.  
  1171.         MPM_SelectArea(area tag)
  1172.  
  1173.             Tags a file area in the Main File Area Window.
  1174.  
  1175.  
  1176.         MPM_OpenArea(area tag)
  1177.  
  1178.             Opens the FILES.BBS Window associated with 'area tag'. If
  1179.             this function returns 'OK' the window _IS_ open, v. the old
  1180.             behaviour of just letting you know the message to open the
  1181.             window got posted okay.
  1182.  
  1183.  
  1184.         MPM_CloseArea(area tag)
  1185.  
  1186.             Closes the FILES.BBS window associated with 'area tag.'
  1187.  
  1188.  
  1189.         MPM_IsAreaOpen(area tag)
  1190.  
  1191.             Returns "1" if the FILES.BBS window associated with 'area
  1192.             tag' is open, "0" otherwise.
  1193.  
  1194.  
  1195.         MPM_AllFilesList()
  1196.  
  1197.             Starts up the All Files List generator in interactive mode,
  1198.             the list generated will be made up of the file areas that
  1199.             are selected in the File Area window. Use MPM_SelectArea()
  1200.             and MPM_DeselectArea() to select areas from REXX.
  1201.  
  1202.  
  1203.         MPM_OutDated(days, 'MOVE | KILL', areatag)
  1204.  
  1205.             Performs an outdated file scan on the selected file areas in
  1206.             the File Area window based on the arguments passed. All
  1207.             three arguments MUST be present.
  1208.  
  1209.             days is the number of days old a file can be, anything older
  1210.             than 'days' will either be deleted or moved.
  1211.  
  1212.             'MOVE | KILL' selects whether you want the files MOVEd or
  1213.             KILLed. If you want files moved, areatag must contain the
  1214.             area tag or name (case MUST match) of an existing file area.
  1215.  
  1216.             When "KILL" is selected the areatag is ignored, but it still
  1217.             MUST be present.
  1218.  
  1219.  
  1220.         MPM_SetFDUFlag(area tag)
  1221.  
  1222.             Sets the File Database Utility flag for the FILES.BBS that
  1223.             is associated with 'area tag.' Use this to tell MaxFile/PM
  1224.             that the File Database Utility needs to be run to update
  1225.             your file database after making changes that MaxFile/PM
  1226.             doesn't know about.
  1227.  
  1228.  
  1229.         MPM_QueryFile(area tag[, filename])
  1230.  
  1231.             Returns the base filename of a file from a FILES.BBS window.
  1232.             When called with just the area tag of an open window it
  1233.             returns the first file in the window. When called with both
  1234.             the area tag and an existing filename it will return the
  1235.             NEXT filename in the window. If something goes wrong it
  1236.             returns ERROR.
  1237.  
  1238.  
  1239.         MPM_QueryFileList(area tag, 'stemvar')
  1240.  
  1241.             Creates a compound stem variable containing a list of all
  1242.             the files in the FILES.BBS associated with 'area tag'. The
  1243.             stem variable name is passed as a string to the function.
  1244.             stemvar.0 contains how many items are in the list.
  1245.  
  1246.             An example follows:
  1247.  
  1248.                 /* MPM_QueryFileList() example */
  1249.                 mpmarea = 'TEST'
  1250.  
  1251.                 /* Open up the file area */
  1252.                 retval = MPM_OpenArea(mpmarea)
  1253.  
  1254.                 If MPM_IsAreaOpen(mpmarea) = '0' then Exit
  1255.  
  1256.                 rc = MPM_QueryFileList(mpmarea, 'files')
  1257.  
  1258.                 rc = MPM_CloseArea(mpmarea)
  1259.  
  1260.                 Say 'There are 'files.0' files in the list.'
  1261.                 Say
  1262.                 Say files.1.file' is the first file.'
  1263.                 Say files.1.path' is the path of the first file.'
  1264.                 Say files.1.desc' is the description of the first file.'
  1265.  
  1266.  
  1267.         MPM_QueryFileInfo(area tag, filename, '0' | '1' | '2' | '3')
  1268.  
  1269.             Queries and returns the specified information about
  1270.             'filename.' The level information is as follows:
  1271.  
  1272.                 0 - File Path
  1273.                 1 - File Date in DD MMM YYYY format
  1274.                 3 - File Size
  1275.                 4 - File Description
  1276.  
  1277.  
  1278.         MPM_SelectFile(area tag, filename)
  1279.         MPM_DeselectFile(area tag, filename)
  1280.  
  1281.             Select and deselect 'filename', respectively, in the area
  1282.             identified by 'area tag'.
  1283.  
  1284.  
  1285.         MPM_SetFileInfo(area tag, filename, '0' | '1' | '2')
  1286.  
  1287.             Set the displayed information for a file in a FILES.BBS
  1288.             window. The level information is as follows:
  1289.  
  1290.                 0 - Set File Date
  1291.                 1 - Set File Size
  1292.                 2 - Set Description
  1293.  
  1294.             Please note that options 0 and 1 are only for display
  1295.             purposes, if you want to set the file's date ("touch" it)
  1296.             you need to perform this yourself, MaxFile/PM does not do
  1297.             this for you, the same goes for the file's size. This REXX
  1298.             extension is merely to update the display in the FILES.BBS
  1299.             window. Option 2, for setting descriptions, does actually
  1300.             alter the description that will get saved for the file.
  1301.  
  1302.             Dates should be in the FTSC format DD MMM YYYY, 01 Dec 1993.
  1303.             Sizes should be unformatted with no thousands separators.
  1304.  
  1305.  
  1306.         MPM_RemoveFile(area tag, filename)
  1307.  
  1308.             Removes the file 'filename' from the FILES.BBS window
  1309.             associated with 'area tag'.
  1310.  
  1311.  
  1312.         MPM_AddFile(area tag, filename, description)
  1313.  
  1314.             Adds 'filename' with description to the FILES.BBS window
  1315.             associated with 'area tag'. 'filename' MUST be a FULL file
  1316.             specification in the form of D:\PATH\FILENAME.EXE! The
  1317.             function returns 'ERROR' if something goes wrong.
  1318.  
  1319.  
  1320.         MPM_AnnounceFiles('stemvar')
  1321.  
  1322.             Creates a file announcement message and writes it to a
  1323.             Squish or *.MSG message base. The message is built from the
  1324.             information stored in the compound stem variable 'stemvar'.
  1325.  
  1326.             Please see TANN.CMD (included in the distribution archive)
  1327.             for an example of how to use this extension.
  1328.  
  1329.             The elements of the message that need to be placed in
  1330.             'stemvar' are as follows:
  1331.  
  1332.                 stemvar.msgpath  - is the root path of the message area
  1333.                                    to place the message in.
  1334.  
  1335.                 stemvar.msgproc  - is the executable name and switches
  1336.                                    needed to run your mail
  1337.                                    tosser/packer, this one is optional,
  1338.                                    if it isn't defined it is ignored.
  1339.  
  1340.                 stemvar.msgtype  - this defines the type of message base
  1341.                                    and must be one of:
  1342.  
  1343.                                        SQUISH
  1344.                                        MSG
  1345.                                        MSGECHO
  1346.  
  1347.                 stemvar.msgflag  - is the message flag you want to use
  1348.                                    for this message, it must be one of:
  1349.  
  1350.                                        HOLD
  1351.                                        NORMAL
  1352.                                        CRASH
  1353.                                        DIRECT
  1354.  
  1355.                 stemvar.to       - is the name to address the message
  1356.                                    to, if it isn't defined it defaults
  1357.                                    to 'All'.
  1358.  
  1359.                 stemvar.toaddr   - this the Fidonet style address of the
  1360.                                    recipient of the message. It must be
  1361.                                    in the format Zone:Net/Node.Point,
  1362.                                    I.E, 1:201/60.0, if not defined it
  1363.                                    defaults to stemvar.fromaddr.
  1364.  
  1365.                 stemvar.from     - is the name the message is from, this
  1366.                                    one is required.
  1367.  
  1368.                 stemvar.fromaddr - is the address of who the message is
  1369.                                    from, in other words, the originating
  1370.                                    Fidonet address. This one is also
  1371.                                    required.
  1372.  
  1373.                 stemvar.subject  - this gets put in the subject field of
  1374.                                    the message. If not defined it
  1375.                                    defaults to 'File Announcement'.
  1376.  
  1377.                 stemvar.header   - is the header of the message, it gets
  1378.                                    placed just before the file list in
  1379.                                    the message. This one is optional.
  1380.                                    1024 character limit.
  1381.  
  1382.                 stemvar.footer   - this is similar to the header, except
  1383.                                    it comes after the file list in the
  1384.                                    message. It is also optional. 1024
  1385.                                    character limit.
  1386.  
  1387.                 stemvar.origin   - this is the text that will get put in
  1388.                                    the origin line of the message. The
  1389.                                    " * Origin: " and from fidonet
  1390.                                    address are taken care for you. All
  1391.                                    you need to enter here is what text
  1392.                                    you want added in between the two.
  1393.                                    This is optional, if it is not
  1394.                                    defined no origin line is generated.
  1395.  
  1396.                 stemvar.0        - contains the number files being
  1397.                                    announced.
  1398.  
  1399.                 stemvar.x.file   - this is the base filename of a file
  1400.                                    to announce.
  1401.  
  1402.                 stemvar.x.path   - is the drive and path to the above
  1403.                                    base filename. Do NOT include the
  1404.                                    filename here.
  1405.  
  1406.                 stemvar.x.desc   - this is the description you want to
  1407.                                    use for this file in the message.
  1408.                                    1024 character limit.
  1409.  
  1410.                 'x' in the above three is a place holder for each of the
  1411.                 files that you want announced, up to stemvar.0 files.
  1412.  
  1413.  
  1414.         MPM_FileAreaSort(area tag, 'Name|Date|Size|Desc', 'Asc|Desc'[, 'All'])
  1415.  
  1416.             Sorts the file area 'area tag' by; Name, Date, Size or Desc.
  1417.             In either ascending or descending order, optionally
  1418.             deselecting all highlighted files.
  1419.  
  1420.             This function behaves just like the menu options on the
  1421.             FILES.BBS context menu, if any items are selected ONLY those
  1422.             items are sorted. If you want to sort the entire area make
  1423.             sure you pass the fourth argument 'All' to it.
  1424.  
  1425.             Here are a few examples:
  1426.  
  1427.                 rc = MPM_FileAreaSort('0', 'Name', 'Asc')
  1428.  
  1429.                     Sorts area 0 by name in ascending order.
  1430.  
  1431.                 rc = MPM_FileAreaSort('FWBBS', 'Date', 'Desc')
  1432.  
  1433.                     Sorts area FWBBS by date in descending order.
  1434.  
  1435.                 rc = MPM_FileAreaSort('FWCOMM', 'Date', 'Desc', 'All')
  1436.  
  1437.                     Sorts area FWCOMM by date in descending order, first
  1438.                     deselecting all selected files.
  1439.  
  1440.  
  1441.         MPM_AdoptFiles(area tag)
  1442.  
  1443.             Performs an adopt on all orphaned files in the file area
  1444.             'area tag'. area tag MUST be open.
  1445.  
  1446.  
  1447.         MPM_ReArchive(area tag, archivetype)
  1448.  
  1449.             Rearchives all selected files in the area 'area tag' to
  1450.             'archivetype'. area tag MUST be open.
  1451.  
  1452.             archivetype should be one of:
  1453.  
  1454.                 ZIP
  1455.                 ARJ
  1456.                 LZJ
  1457.                 ARC
  1458.                 HA
  1459.                 RAR
  1460.                 UC2
  1461.                 ZOO
  1462.  
  1463.  
  1464.         MPM_PurgeDupes(area tag)
  1465.  
  1466.             Scans through the file area 'area tag' and removes all
  1467.             duplicate file entries. area tag MUST be open.
  1468.  
  1469.  
  1470.         MPM_RemoveMissingFiles(area tag)
  1471.  
  1472.             Scans through the file area 'area tag' and removes all
  1473.             entries for files that do not exist. area tag MUST be open.
  1474.  
  1475.  
  1476.         MPM_CleanseDescriptions(area tag)
  1477.  
  1478.             Cleanses the descriptions for all selected files in the area
  1479.             'area tag'. area tag MUST be open.
  1480.  
  1481.  
  1482.         MPM_GetDIZFiles(area tag)
  1483.  
  1484.             Attempts to extract and use FILE_ID.DIZ, DESC.SDI or SDN.ID
  1485.             for the selected files in the area 'area tag'. area tag MUST
  1486.             be open.
  1487.  
  1488.         MPM_QueryFilesBBS(area tag, stemvar)
  1489.  
  1490.             Returns the FILES.BBS for 'area tag' in the compound stem
  1491.             variable 'stemvar'. area tag does not have to be open, but
  1492.             if it is, make sure you save the FILES.BBS before you call
  1493.             this function. 'ERROR' is returned if an error occurs or
  1494.             there are no entries in the FILES.BBS file.
  1495.  
  1496.             stemvar.0 will contain the number of entries.
  1497.  
  1498.             stemvar.1 - stemvar.x will each contain one entry from the
  1499.             FILES.BBS. The FILES.BBS will be parsed according to your
  1500.             settings for Extended Description Marker, FileList Margin,
  1501.             File Headers and Header Size. In general, each string is
  1502.             formatted just like the entries you view in your FILES.BBS
  1503.             windows.
  1504.  
  1505.         MPM_SaveFilesBBS(area tag)
  1506.  
  1507.             Saves the FILES.BBS for 'area tag'. Should be used after any
  1508.             changes are made to a FILES.BBS window. area tag MUST be
  1509.             open.
  1510.  
  1511.  
  1512.         MPM_SetWindowState([area tag, ]'MAXIMIZE | MINIMIZE | RESTORE')
  1513.  
  1514.             Sets the state of a window. If 'area tag' is ommitted, the
  1515.             File Area Window is set, otherwise, the state of the
  1516.             FILES.BBS window 'area tag' will be set.
  1517.  
  1518.             The possible window states are; MAXIMIZE, MINIMIZE or
  1519.             RESTORE, only one may be specified per call to this
  1520.             function. Examples:
  1521.  
  1522.  
  1523.                 rc = MPM_SetWindowState('MINIMIZE')
  1524.  
  1525.                     Would minimize the File Area window to either the
  1526.                     desktop or Minimized Window viewer, depending on
  1527.                     your object settings.
  1528.  
  1529.                 rc = MPM_SetWindowState('1' ,'RESTORE')
  1530.  
  1531.                     Would restore the FILES.BBS window associated with
  1532.                     file area '1' to its previous state.
  1533.  
  1534.  
  1535.         MPM_Crc32('filename')
  1536.  
  1537.             Examines 'filename' and returns a CRC32 value calculated
  1538.             according to FIPS PUB 71 and FED-STD-1003. This should prove
  1539.             useful for rolling your own TIC processor.
  1540.  
  1541.  
  1542.         MPM_ExecPgm(title, program, arguments [, "WAIT | NOWAIT"])
  1543.  
  1544.             Starts another program session. title is the text that will
  1545.             be displayed in the title bar of the session. program is the
  1546.             name of the executable file. arguments are the command line
  1547.             parameters you want to pass to the program. The last
  1548.             argument is optional, if it is present and is 'WAIT'
  1549.             MaxFile/PM will wait until the program has finished running
  1550.             before returning control to your REXX script.
  1551.  
  1552.             The return value will be the return code from the program if
  1553.             run with the 'WAIT' parameter, or the return code from
  1554.             DosStartSession() if run asynchronously.
  1555.  
  1556.             PLEASE NOTE: if you wish to do any command line redirection
  1557.             you must pass the correct command processor as the program
  1558.             (CMD.EXE, COMMAND.EXE, etc..) and pass the name of the
  1559.             executable you want to run as part of the arguments.
  1560.  
  1561.  
  1562.         MPM_ExtractFromArc(filename, filespec(s), filepath)
  1563.  
  1564.             Extracts filespec(s) from filename into the directory
  1565.             filepath. filename should be a fully qualified filename.
  1566.             filepath MUST exist.
  1567.  
  1568.  
  1569.     Stop REXX
  1570.  
  1571.         Stops the currently running REXX macro. The current instruction
  1572.         in the macro will finish executing before the macro stops.
  1573.  
  1574.  
  1575.     Edit REXX Macro...
  1576.  
  1577.         Here you can find and edit a REXX macro script, provided you
  1578.         have an editor defined in your configuration.
  1579.  
  1580.         After selecting this option you will be presented with a
  1581.         standard file dialog to select from the files on your system.
  1582.         After selecting a file, the editor you have configured will be
  1583.         started with the selected file as its one and only argument.
  1584.  
  1585.  
  1586.     Settings...
  1587.  
  1588.         Brings up the Settings Notebook for MaxFile/PM. Please see
  1589.         'Configuring MaxFile/PM' for more information.
  1590.  
  1591.  
  1592.     Product Information
  1593.  
  1594.         Displays MaxFile/PM's Product Information Dialog.
  1595.  
  1596.  
  1597. --- FILES.BBS Window ---------------------------------------------------------
  1598. ------------------------------------------------------------------------------
  1599.  
  1600.         FILES.BBS windows are the heart and soul of MaxFile/PM, these
  1601.         windows are where you will be spending most of your time. A
  1602.         FILES.BBS window is very similar to the File Area window in
  1603.         appearance. What you will see when you open one of these
  1604.         windows is the contents of the FILES.BBS that is associated
  1605.         with the file area this window belongs to.
  1606.  
  1607.     FILES.BBS Window Context Menu
  1608.  
  1609.     Revert...
  1610.  
  1611.         Discards changes made in a FILES.BBS window since the window was
  1612.         opened or the last save was performed, which ever occured last.
  1613.  
  1614.     Save FILES.BBS
  1615.  
  1616.         Performs an unconditional save of the FILES.BBS for the
  1617.         current FILES.BBS Window. At the same time it also sets the
  1618.         flag for this area to tell MaxFile/PM that the File Database
  1619.         Utility (if you have one configured) needs to be run on it.
  1620.  
  1621.  
  1622.     Shift-Macros
  1623.  
  1624.         Each of your defined program macros will be listed on this
  1625.         sub-menu. See Configuring MaxFile/PM -- Other for more
  1626.         information on program macros.
  1627.  
  1628.  
  1629.     Sort Ascending
  1630.  
  1631.         Name
  1632.         Date
  1633.         Size
  1634.         Description
  1635.  
  1636.         Sorts the FILES.BBS entries for the current FILES.BBS Window
  1637.         in ascending order.
  1638.  
  1639.  
  1640.     Sort Descending
  1641.  
  1642.         Name
  1643.         Date
  1644.         Size
  1645.         Description
  1646.  
  1647.         Sorts the FILES.BBS entries for the current FILES.BBS Window
  1648.         in descending order.
  1649.  
  1650.         Please note the following: If you want the entire FILES.BBS
  1651.         sorted make sure that none of the items in the window are
  1652.         selected. If any items are selected ONLY those items get
  1653.         sorted. Deselect All or CTRL+\ will remove the selection
  1654.         emphasis on all items in the window. This applies to both
  1655.         ascending and descending sorts.
  1656.  
  1657.         Comments lines are skipped, the file blocks between them are
  1658.         sorted according to the sort selection made.
  1659.  
  1660.  
  1661.     Descriptions
  1662.  
  1663.         Copy
  1664.  
  1665.             This selection takes the first description from a group of
  1666.             selected items and copies it to the rest of the files in
  1667.             the group. The copied description will have '(xx of xx)'
  1668.             appended to the end of it. This is convenient to use with
  1669.             a group of files that are all part of one program or file
  1670.             collection.
  1671.  
  1672.  
  1673.         Cleanse
  1674.  
  1675.             This option goes through each of the selected items in a
  1676.             FILES.BBS window and removes all the extra whitespace,
  1677.             non-printable ASCII and high-ASCII characters from the
  1678.             descriptions or comments.
  1679.  
  1680.  
  1681.         Edit
  1682.  
  1683.             Many of you asked for this one. Edit Description allows
  1684.             you to edit the description of a selected item by first
  1685.             selecting it, then choosing this option from the context
  1686.             menu. It works the same way as ALT+clicking mouse button 1
  1687.             on an item's description.
  1688.  
  1689.  
  1690.         Format...
  1691.  
  1692.             This option is only usable when you have an Extended
  1693.             Description Marker (ED Marker) or a FileList Margin defined
  1694.             in the Settings Notebook.
  1695.  
  1696.             When an ED Marker is defined:
  1697.  
  1698.                 What it does is take a file description and break it up
  1699.                 into smaller parts and insert the defined ED Marker at
  1700.                 the beginning of the excess lines so that your BBS
  1701.                 package will understand the excess lines are part of the
  1702.                 description for a file.
  1703.  
  1704.                 After selecting this option from the context menu a
  1705.                 dialog box will be presented asking you for a left
  1706.                 margin and a line length. The left margin is where you
  1707.                 want the ED Marker placed on the line and the line
  1708.                 length is how many characters past the ED Marker the
  1709.                 description is allowed to go on each line.
  1710.  
  1711.             When an ED Marker is NOT defined and FileList Margin is
  1712.             greater than zero:
  1713.  
  1714.                 What it does is take a file description and wrap it into
  1715.                 smaller line segments based on 80 - _FileList Margin_.
  1716.  
  1717.  
  1718.         Get FILE_ID.DIZ
  1719.  
  1720.             This option goes through the selected items in the window
  1721.             and attempts to extract the FILE_ID.DIZ, DESC.SDI or SDN.ID
  1722.             from them. Comments and files that aren't archives are
  1723.             skipped over by this function. If one of the above is
  1724.             present in the archives selected, it will be read from it
  1725.             and placed in the description field. You will need to edit
  1726.             this text to suit your needs.
  1727.  
  1728.  
  1729.         Set FILE_ID.DIZ
  1730.  
  1731.             Here you can insert the file description for selected
  1732.             archives into the archives as a FILE_ID.DIZ. You will need
  1733.             to edit the description to conform to the 45/10 standard.
  1734.  
  1735.         Scan Docs...
  1736.  
  1737.             This works only with archives. MaxFile/PM will go through
  1738.             and extract all the documentation files it can find for a
  1739.             selected archive. It will then present a dialog box that
  1740.             will allow you to copy text from a file to use as a
  1741.             description.
  1742.  
  1743.             Each selected archive is processed in sequence, in other
  1744.             words, the Get Description Text dialog gets presented once
  1745.             for each selected archive.
  1746.  
  1747.             When the dialog first comes up a standard File Open dialog
  1748.             will be presented for you to choose a file to open. NOTE: If
  1749.             there were directories stored in the archive, they will be
  1750.             present and you might have to go down a few to find the
  1751.             files.
  1752.  
  1753.             After selecting a file the first 8K of it will be loaded
  1754.             into the text entry control in the Get Description dialog.
  1755.             You can edit the text if necessary to get it somewhere close
  1756.             to what you want.
  1757.  
  1758.             If you choose to open an INF file, the OS/2 View application
  1759.             will be started so that you can view the file selected.
  1760.             Using the Services menu from View you can copy a page to the
  1761.             clipboard from the INF file. Then you can switch back to
  1762.             the Get Description Dialog and paste the contents of the
  1763.             clipboard into the entry control by clicking on the "Paste
  1764.             from Clipboard" button.
  1765.  
  1766.             To copy and use part of the text in the entry control,
  1767.             highlight the text you want to copy and click on the "Copy"
  1768.             button. The highlighted text will be copied into the
  1769.             description of the selected file that the file in the entry
  1770.             control was extracted from.
  1771.  
  1772.             All the normal description handling characteristics apply to
  1773.             the copied text. If you do NOT have an Extended Description
  1774.             Marker defined and FileList Margin is set to 0; all
  1775.             whitespace, unprintable characters (CR, LF, etc..) and
  1776.             high-bit ASCII are stripped from the description and it is
  1777.             truncated to 255 characters.
  1778.  
  1779.  
  1780.         Download Flags...
  1781.  
  1782.             Allows you to place or remove time and byte download flags
  1783.             on the currently selected files.
  1784.  
  1785.             This function is only available to Maximus Sysops.
  1786.  
  1787.  
  1788.     Files
  1789.  
  1790.         Find...
  1791.  
  1792.             Many, many of you asked for this one. After selecting this
  1793.             option you will be asked to type in a filename. MaxFile/PM
  1794.             will search for the name and scroll it into view if it is
  1795.             found. Partial filenames are okay, case is not important.
  1796.  
  1797.  
  1798.         Adopt
  1799.  
  1800.             Adopt Files allows you to add any orphan files in a
  1801.             particular file area to the FILES.BBS for that area.
  1802.             Adopting is performed in a separate thread so that you may
  1803.             continue to work in the window for the file area while the
  1804.             adopt is going on. The window will be locked open while
  1805.             the Adopt is being performed.
  1806.  
  1807.  
  1808.         Remove Missing
  1809.  
  1810.             This option automates the process of removing entries in a
  1811.             FILES.BBS window that have no file associated with them.
  1812.  
  1813.             No special setup is required, just bring up the context menu
  1814.             and select this option. MaxFile/PM will then search through
  1815.             the FILES.BBS window and remove all entries that meet the
  1816.             following criteria; The entry is a file, is 0 bytes in size
  1817.             and has a date/time stamp of 00/00/00 00:00:00.
  1818.  
  1819.  
  1820.         Purge Dupes
  1821.  
  1822.             Purge Dupes scans the FILES.BBS window looking for duplicate
  1823.             file entries. Only the last entry for each file that has a
  1824.             duplicate entry is kept.
  1825.  
  1826.             This option is useful for removing extra entries added after
  1827.             a TIC processor has added new files to a FILES.BBS file.
  1828.  
  1829.  
  1830.         Announce...
  1831.  
  1832.             This option will allow you to write a customized message
  1833.             announcing selected files directly to any Squish, *.MSG or
  1834.             *.MSG ECHO message base. You may also specify a mail
  1835.             processor so that you can scan for the message to send it
  1836.             out of your system.
  1837.  
  1838.             The whole process gets started by selecting the files you
  1839.             wish to announce from a FILES.BBS window. Next you bring up
  1840.             the context menu and select 'Announce Files...' You will
  1841.             be presented with a configuration dialog you must fill out
  1842.             to tell MaxFile/PM the particulars about the message you
  1843.             want to send. As it stands right now, you have to fill out
  1844.             the dialog for each different window. The configuration
  1845.             for each window will be saved separately and will be used
  1846.             each subsequent time you announce files from each
  1847.             particular window.
  1848.  
  1849.             There are a few things MaxFile/PM needs to know to be able
  1850.             to send the message correctly and they are as follows:
  1851.  
  1852.                 Message Base Path   -The full path and base filename
  1853.                 of the message area put the message in. For *.MSG
  1854.                 areas this will be the full path to the directory that
  1855.                 contains the *.MSG files. For Squish areas this will
  1856.                 be the path and base filename of the Squish files
  1857.                 related to the message area. This is a required entry.
  1858.  
  1859.                 Mail Processor      -This is an optional entry to
  1860.                 allow you to scan for the message that was just
  1861.                 written by a mail tosser/scanner. Please see the
  1862.                 documentation for your tosser/scanner for more
  1863.                 information.
  1864.  
  1865.                 Message Type        -This is the message base type,
  1866.                 *.MSG and Squish are fairly self-explanatory. *.MSG
  1867.                 Echo, refers to a Fidonet style *.MSG echo mail area
  1868.                 that stores the high-water mark in 1.MSG.
  1869.  
  1870.                 Message Flags       -These are the attribute flags for
  1871.                 the message you will be creating. They are mutually
  1872.                 exclusive. I will be adding Direct to the available
  1873.                 flags when I get the time to research the flags more.
  1874.  
  1875.                 To:                 -This is the name of the recipient
  1876.                 of the message. If you leave it blank, MaxFile/PM will
  1877.                 automatically default to 'All.'
  1878.  
  1879.                 To Addr:            -This is the address of the
  1880.                 recipient of the message. If left blank, the From
  1881.                 Address will be used. (Please see the From Address
  1882.                 discussion for more information on entering Fidonet
  1883.                 addresses.)
  1884.  
  1885.                 From:               -This is a required entry. This is
  1886.                 the name of the sender of the message.
  1887.  
  1888.                 From Addr:          -This is a required entry. This is
  1889.                 the address of the sender of the message. Most likely
  1890.                 this will be your fidonet address if you have one. If
  1891.                 not it doesn't matter what you enter here, as it won't
  1892.                 get used by your message bases.
  1893.  
  1894.                 The format for entering Fidonet addresses into
  1895.                 MaxFile/PM is:
  1896.  
  1897.                     zone:net/node.point
  1898.  
  1899.                 All four elements are required. To use my address as
  1900.                 an example, the field would have 1:201/60.0 entered
  1901.                 into it.
  1902.  
  1903.                 Header              -This is an optional entry that
  1904.                 you can use to place a customer banner at the top of
  1905.                 the message just before the files that are being
  1906.                 announced in the message. It is pretty much free-form,
  1907.                 but you will be much better off if you leave the
  1908.                 formatting up to MaxFile/PM. You may enter up to 1024
  1909.                 characters in this field.
  1910.  
  1911.                 Footer              -This entry is basically the same
  1912.                 as the Header field, except it comes after the
  1913.                 announced files. You may enter up to 1024 characters
  1914.                 in this field.
  1915.  
  1916.                 The 'Subject' line of the message is 'File
  1917.                 Announcement' it is currently hard coded. If I get
  1918.                 enough requests, I will add it as an option but as you
  1919.                 can see, the message dialog is quite full as it is.
  1920.                 The same holds true with the Tear and Origin lines,
  1921.                 they are not configurable. The Tear line will always
  1922.                 read '--- MaxFile/PM......' and the Origin line will
  1923.                 always just be a standard origin line with your
  1924.                 Fidonet address in it. These two I will probably be
  1925.                 adding macros for so that you can place them into
  1926.                 either the header or footer of the message. It all
  1927.                 depends on user feedback.
  1928.  
  1929.  
  1930.         Send...
  1931.  
  1932.             Here you can create a file attach message. First select the
  1933.             file or files that you want to send, then select this item.
  1934.             The same dialog that is used for the Announce Files option
  1935.             is presented for you to fill out, please see the discussion
  1936.             of that function for more information on the dialog
  1937.             controls.
  1938.  
  1939.             The Header and Footer text are combined together to create
  1940.             the body of the message, if you enter any text for them. No
  1941.             tearline or origin are added to the message. In addition to
  1942.             the message attributes you set in the message information
  1943.             dialog box, the File Attach and Kill/Sent bits are set.
  1944.  
  1945.  
  1946.         Touch
  1947.  
  1948.             "Touching" is the process of updating the Time and Date
  1949.             stamps of files to the current time and date. This option
  1950.             allows you to do that for the selected files in the
  1951.             current window.
  1952.  
  1953.  
  1954.         View
  1955.  
  1956.             The View option works in conjunction with the external
  1957.             program options. For archives it will fire up the proper
  1958.             archiver to create a list of files contained in the
  1959.             archive and display a dialog containing that list. For
  1960.             pictures and text files the appropriate viewer will be
  1961.             started. View is also the action that is associated with
  1962.             double-clicking mouse button 1 on an entry in the window.
  1963.  
  1964.  
  1965.         Virus Scanner
  1966.  
  1967.             This option runs the virus scanner you have set up on each
  1968.             file selected in the current FILES.BBS window. The window
  1969.             that the virus scanner is run in is not closed when the
  1970.             scan is complete so that you may view the results.
  1971.  
  1972.             Nothing is extracted from the archives. The files are
  1973.             passed to the 'Other->Virus Scanner' entry from the
  1974.             Settings Notebook one at a time until all the selected
  1975.             files have been scanned. At this writing it is up to you to
  1976.             perform any additional processing.
  1977.  
  1978.  
  1979.     Archives
  1980.  
  1981.         Test Archive
  1982.  
  1983.             This option only works with archives. It simply invokes
  1984.             the appropriate archiver for each selected item in the
  1985.             window. The output from the archiver will be displayed in
  1986.             a dialog box after the testing is completed is completed
  1987.             for each archive.
  1988.  
  1989.  
  1990.         Extract To...
  1991.  
  1992.             Here you can extract a selected archive to a directory
  1993.             that you specify. Note that the directory you specify must
  1994.             exist.
  1995.  
  1996.             After you have used this option at least once, the directory
  1997.             will be remembered the next time the dialog box comes up
  1998.             asking you for a directory. You can just press ENTER to
  1999.             accept it.
  2000.  
  2001.  
  2002.         Touch Arc Dates
  2003.  
  2004.             This option will call upon the appropriate archiver(s) to
  2005.             set the time/date stamp for the selected archive(s) to the
  2006.             time/date of newest file in the archive(s).
  2007.  
  2008.  
  2009.         ReArchive
  2010.  
  2011.             to ZIP
  2012.             to ARJ
  2013.             to LZH
  2014.             to ARC
  2015.             to HA
  2016.             to RAR
  2017.             to UC2
  2018.  
  2019.             Each of these options takes an existing archive or group
  2020.             of archives and converts them to the appropriate archive
  2021.             type.
  2022.  
  2023.             If one the ADD entry for an archive is not defined its
  2024.             entry on this sub-menu will be disabled.
  2025.  
  2026.  
  2027.     Insert
  2028.  
  2029.         Comment
  2030.  
  2031.             To Insert a comment into the current FILES.BBS window,
  2032.             first select the item in the window that you want the
  2033.             comment to go in FRONT of. Then bring up the context menu
  2034.             and select Insert->Comment. A blank comment will then be
  2035.             inserted in the FILES.BBS window.
  2036.  
  2037.  
  2038.         File...
  2039.  
  2040.             Insert/File works much the same way as Insert/Comment, first
  2041.             select the item in the window that you want the file to go
  2042.             in FRONT of, then select Insert->File from the context menu.
  2043.             A file dialog will be displayed so that you can find the
  2044.             file you want to insert. Once you have found the file,
  2045.             select the Insert button in the dialog box. The file will
  2046.             then be inserted into the current window. Selecting the
  2047.             Cancel button inside the file dialog box aborts the insert
  2048.             operation.
  2049.  
  2050.             THE FILE WILL BE INSERTED INTO THE FILES.BBS WITH A FULL
  2051.             PATH SPECIFICATION. It does NOT get copied or moved to the
  2052.             download directory. This allows you to point to a single
  2053.             file from multiple FILES.BBS files.
  2054.  
  2055.  
  2056.     Remove Items
  2057.  
  2058.             This item removes or deletes items from the FILES.BBS
  2059.             window. When you select it from the context menu, a dialog
  2060.             box will appear allowing you two options. 'Entries' just
  2061.             removes the entry from the FILES.BBS window, 'Entries and
  2062.             Files' causes the entries to be removed and the associated
  2063.             with the entries to be deleted. Click Ok to remove the
  2064.             items, or Cancel to abort the operation.
  2065.  
  2066.  
  2067.     Select All
  2068.  
  2069.             Selects all items in the current FILES.BBS Window.
  2070.  
  2071.  
  2072.     Select All Files
  2073.  
  2074.             Selects all files in the current FILES.BBS window, excluding
  2075.             orphans.
  2076.  
  2077.  
  2078.     Deselect All
  2079.  
  2080.             Deselects all items in the current FILES.BBS Window.
  2081.  
  2082.  
  2083.     Display Date
  2084.  
  2085.             Toggles the display of the File Date column in the current
  2086.             FILES.BBS Window. This setting is temporary, FILES.BBS
  2087.             Windows will always open according to the settings defined
  2088.             in the Settings Notebook.
  2089.  
  2090.     Display Size
  2091.  
  2092.             Toggles the display of the File Size column in the current
  2093.             FILES.BBS Window. This setting is temporary, FILES.BBS
  2094.             Windows will always open according to the settings defined
  2095.             in the Settings Notebook.
  2096.  
  2097.     Area Statistics
  2098.  
  2099.             This option displays an information message box containing
  2100.             how many files are in the current area, how much space
  2101.             they take up and how much free space remains on the
  2102.             volume.
  2103.  
  2104.  
  2105. ------------------------------------------------------------------------------
  2106. --- Presentation Parameters --------------------------------------------------
  2107. ------------------------------------------------------------------------------
  2108.  
  2109.         Container windows are the windows that hold your file area
  2110.         information or file lists.
  2111.  
  2112.         The only presentation parameters that are saved for your windows
  2113.         are the foreground/background color of the container windows and
  2114.         the fonts dropped on the status bar and the container windows.
  2115.         The size and position of each window is also saved.
  2116.  
  2117.         These parameters are saved to your MAXFMPM.INI, which is usually
  2118.         kept in the directory you start MaxFile/PM from.
  2119.  
  2120.         The foreground (text) and background colors of the container
  2121.         window can be changed by dropping a color from the Solid Color
  2122.         Palette on it.
  2123.  
  2124.         The font used for the status bars and context menus can be
  2125.         changed by dropping a font from the Font Palette on the status
  2126.         bar. The container window font can be changed by dropping a font
  2127.         on the container.
  2128.  
  2129.  
  2130. ------------------------------------------------------------------------------
  2131. --- Selecting Items ----------------------------------------------------------
  2132. ------------------------------------------------------------------------------
  2133.  
  2134.         Perhaps the most confusing part of working in a FILES.BBS
  2135.         window is selecting or deselecting items. I wrote the program
  2136.         and I still have to think about it. Basically it works like
  2137.         this; Clicking mouse button 1 on an item selects it and clears
  2138.         the selection from any other items in the window. To select
  2139.         multiple items in the window, press mouse button 1 on the
  2140.         first item you want selected and hold it down while you drag
  2141.         the mouse cursor. This allows you to select a contiguous range
  2142.         of items. If you want to select multiple items and they aren't
  2143.         adjacent to each other, hold down the CTRL key while you click
  2144.         mouse button 1 on each item. If the item is not selected it
  2145.         will become selected, if the item is already selected the
  2146.         selection is cleared for that item.
  2147.  
  2148.         Another technique to select items uses a combination of the
  2149.         CTRL and SHIFT keys along with mouse button one. The SHIFT key
  2150.         when used in conjunction with mouse button 1 will
  2151.         select/deselect all items between the first marked item and the
  2152.         item SHIFT-clicked on. An example might help:
  2153.  
  2154.             COMMENT
  2155.             FILE1       <-- click mouse button one here
  2156.             FILE2
  2157.             FILE3
  2158.             FILE4
  2159.             FILE5       <-- SHIFT-click mouse button one here
  2160.             COMMENT
  2161.             FILE6       <-- CTRL-click mouse button one here
  2162.             FILE7
  2163.             FILE8
  2164.             FILE9
  2165.             FILE10
  2166.             FILE11
  2167.             FILE12      <-- CTRL-SHIFT-click mouse button one here
  2168.  
  2169.         With no items selected, the above actions would select two
  2170.         non-contiguous blocks of files; FILE1-FILE5 and FILE6-FILE12.
  2171.  
  2172.         If you need to select or deselect all the items in a window,
  2173.         your best bet is to use the Select All/Deselect All options
  2174.         from the context menu.
  2175.  
  2176.  
  2177. ------------------------------------------------------------------------------
  2178. --- Hotkeys ------------------------------------------------------------------
  2179. ------------------------------------------------------------------------------
  2180.  
  2181.                           ^ = CTRL, ! = SHIFT
  2182.  
  2183.         The following accelerator keys may be used when you are
  2184.         working in the File Area window:
  2185.  
  2186.                         Check for Duplicates    ^D
  2187.                         Search                  ^S
  2188.                         Find                    ^F
  2189.                         Find Again              ^N
  2190.                         All Files List          ^L
  2191.                         Outdate Files           ^O
  2192.                         Create FREQ List        ^Q
  2193.                         Request Files           ^R
  2194.                         Receive Files           ^V
  2195.                         REXX Macro              ^M
  2196.                         Stop REXX               ^P
  2197.  
  2198.         The following accelerator keys may be used when you are
  2199.         working in FILES.BBS window:
  2200.  
  2201.                           Sort Ascending
  2202.                               Name        ^1
  2203.                               Date        ^2
  2204.                               Size        ^3
  2205.                               Description ^4
  2206.                           Sort Descending
  2207.                               Name        ^5
  2208.                               Date        ^6
  2209.                               Size        ^7
  2210.                               Description ^8
  2211.                           Description
  2212.                               Edit        ^E
  2213.                               Format      ^F
  2214.                               Get DIZ     ^G
  2215.                               Set DIZ     ^S
  2216.                           Files
  2217.                               Adopt       ^A
  2218.                               Announce    ^N
  2219.                               Touch       ^O
  2220.                               View        ENTER
  2221.                               Virus Scan  ^C
  2222.                           Archives
  2223.                               Test        ^T
  2224.                               Extract to  ^X
  2225.                               ReArchive
  2226.                                   to ZIP  !F2
  2227.                                   to ARJ  !F3
  2228.                                   to LZH  !F4
  2229.                                   to ARC  !F5
  2230.                           Remove Items    ^D
  2231.  
  2232.  
  2233. ------------------------------------------------------------------------------
  2234. --- Renaming Files -----------------------------------------------------------
  2235. ------------------------------------------------------------------------------
  2236.  
  2237.         To rename a file, press and hold the ALT key and click mouse
  2238.         button 1 on the file that you want to rename. Then enter the
  2239.         new filename and click button 1 anywhere outside the edit box
  2240.         or press the keypad Enter key. Pressing ESC will discard any
  2241.         changes you have made to the filename.
  2242.  
  2243.  
  2244. ------------------------------------------------------------------------------
  2245. --- Editing File Descriptions ------------------------------------------------
  2246. ------------------------------------------------------------------------------
  2247.  
  2248.         Editing descriptions works in the much the same manner as
  2249.         renaming files, ALT+click mouse button 1 on the description
  2250.         you want to edit. To save the description, click outside the
  2251.         edit box or press the keypad Enter key. Pressing ESC will
  2252.         discard any changes made to the description or comment.
  2253.  
  2254.         The standard CUA conventions for cutting and pasting text work
  2255.         while the editing window is open for you to edit descriptions.
  2256.         They are as follows:
  2257.  
  2258.             Ctrl+INS    Copy to the Clipboard
  2259.             Shift+Del   Cut to the Clipboard
  2260.             Del         Cut (to the black hole of bits)
  2261.             Shift+INS   Paste from the Clipboard
  2262.  
  2263.         These aren't well documented, but they are standard items that
  2264.         you can expect *most* applications to use when working with
  2265.         text, including MaxFile/PM.
  2266.  
  2267.  
  2268. ------------------------------------------------------------------------------
  2269. --- Program Macros -----------------------------------------------------------
  2270. ------------------------------------------------------------------------------
  2271.  
  2272.         FILES.BBS windows are the only place that the Shift-F(x)
  2273.         macros will operate. When pressing one of these key
  2274.         combinations MaxFile/PM will search through the container in
  2275.         the window and pass the fully qualified filename of the
  2276.         selected files to your macro one at a time. Comments are
  2277.         ignored. Don't make any assumptions about what directory the
  2278.         macro will start out in, that will be determined by the
  2279.         default OS/2 shell.
  2280.  
  2281.  
  2282. ------------------------------------------------------------------------------
  2283. --- Drag and Drop ------------------------------------------------------------
  2284. ------------------------------------------------------------------------------
  2285.  
  2286.               *************************************************
  2287.               * THIS IS HOW YOU MOVE FILES BETWEEN FILE AREAS *
  2288.               *************************************************
  2289.  
  2290.         Remember, MaxFile/PM is a Workplace Shell and Presentation
  2291.         Manager friendly program. The basic operations of changing,
  2292.         editing and moving objects work the same way.
  2293.  
  2294.         A drag operation is started by pressing mouse button 2 down
  2295.         and dragging the mouse cursor. The operation is considered
  2296.         complete when you release mouse button 2. Should you wish to
  2297.         abort the drag, press the ESC key on your keyboard.
  2298.  
  2299.         When dragging files between windows in MaxFile/PM, holding down
  2300.         the CTRL key will cause the objects to be copied instead of
  2301.         moved. This works for both files and comments.
  2302.  
  2303.         You will need to make sure that both the source and
  2304.         destination windows are visible on your display.
  2305.  
  2306.         You can drag files from anywhere on your system and drop them
  2307.         either on a FILES.BBS window or onto the File Area window.
  2308.         When dropping on an open FILES.BBS window, the files are
  2309.         inserted into the FILES.BBS at the point at which they were
  2310.         dropped. When dropping on the File Area window, the files are
  2311.         inserted at the end of the FILES.BBS for the area they are
  2312.         dropped on.
  2313.  
  2314.         You can also rearrange the items in a window by selecting
  2315.         them, then dragging them and dropping them where you want them
  2316.         to be.
  2317.  
  2318.         Many of you have asked about this one...To delete one or more
  2319.         items from a FILES.BBS window; highlight the items you want
  2320.         deleted, then drag them to the shredder object and delete
  2321.         them. Or, alternatively you can use the 'Remove Items' option
  2322.         on the context menu.
  2323.  
  2324.  
  2325. ------------------------------------------------------------------------------
  2326. --- Excluding File Areas------------------------------------------------------
  2327. ------------------------------------------------------------------------------
  2328.  
  2329.         If MaxFile/PM finds a file called MAXFMPM.EXC in the directory
  2330.         it is started from it will scan that file as it is populating
  2331.         the File Area window. If the area tag of a file area is found in
  2332.         that file, the area will NOT be added to the file area list.
  2333.  
  2334.         MAXFMPM.EXC is a simple text file that contains one area tag per
  2335.         line in the file.
  2336.  
  2337. ------------------------------------------------------------------------------
  2338. --- Known Problems -----------------------------------------------------------
  2339. ------------------------------------------------------------------------------
  2340.  
  2341.         In a system as configurable as OS/2 there are always going to
  2342.         be problems, this section is devoted to those problems and in
  2343.         some cases work-arounds. If you are having trouble with
  2344.         MaxFile/PM this is the first place to look to see if you can
  2345.         find some help.
  2346.  
  2347. --- FILEIDX.EXE --------------------------------------------------------------
  2348.  
  2349.         Lora-BBS File index maintenance utility
  2350.  
  2351.             Make sure that you specify the files IDX file that you
  2352.             want rebuilt in the Main Settings dialog box. For example:
  2353.  
  2354.                                 ┌────────────────────────────────────┐
  2355.         File Database Utility   │ E:\LORA\FILEIDX E:\LORA\FILES.IDX  │
  2356.                                 └────────────────────────────────────┘
  2357.  
  2358.         MaxFile/PM will take care of the rest. (The "AREA .. .. .."
  2359.         part.)
  2360.  
  2361.  
  2362. --- CONTAINER DISPLAY CORRUPTION ---------------------------------------------
  2363.  
  2364.         Moving vertical separator bar messes up highlighting
  2365.  
  2366.             The Service Pack for OS/2 2.1 screwed up the way the
  2367.             highlighting is handled when the vertical separator bar is
  2368.             moved. I didn't it break folks, IBM did.
  2369.  
  2370.  
  2371. --- VIEW AND TEST DIALOG LOCKUPS ---------------------------------------------
  2372.  
  2373.         Archive Statistics Dialog comes up as a grey window
  2374.  
  2375.             When run under 2.11 the View and Test functions lock up
  2376.             after opening more than one window. I have NOT been able
  2377.             to reproduce this under 2.10, so I don't even know where
  2378.             to begin to look. I have made several modifications to the
  2379.             code, hopefully one of them fixed the problem. :-( [06 Jun
  2380.             1994] This *HAS* been fixed!!
  2381.  
  2382. --- MAXFMPM.INI CORRUPTION ---------------------------------------------------
  2383.  
  2384.         MAXFMPM.INI gets trashed if a REXX script bombs out and won't
  2385.         quit.
  2386.  
  2387.             Always keep a backup of your MAXFMPM.INI file someplace
  2388.             safe. I need specific examples of scripts that I can use to
  2389.             recreate the problem. I'm not sure what is causing it, but I
  2390.             am looking.
  2391.  
  2392.             The key to safety is to BACKUP before you start a new script
  2393.             and try to debug it to get it to work.
  2394.  
  2395.  --- LAUNCH PAD SHREDDER WON'T SHRED MY FILES --------------------------------
  2396.  
  2397.         Create a shadow of your shredder object on the desktop and drag
  2398.         the items you want deleted to it or use Remove Items from the
  2399.         context menu in a FILES.BBS window.
  2400.  
  2401. --- MOVING ITEMS -------------------------------------------------------------
  2402.  
  2403.         Moving items up in a FILES.BBS window more than one window at a
  2404.         time can be a major chore. Here's a simple work around:
  2405.  
  2406.         1)  Select the item(s) at the bottom of the window you want to
  2407.             move.
  2408.         2)  Move up into the list approximately where you want them to go.
  2409.         3)  Hold down the CTRL key and click on an item to highlight it
  2410.             along with the other item(s).
  2411.         4)  Select one of the Sort options off the Context Menu.
  2412.  
  2413.         NOTE: This only works for moving items towards the TOP of your
  2414.         FILES.BBS.
  2415.  
  2416. --- CAN'T EXTRACT FILE_ID.DIZ ------------------------------------------------
  2417. --- DOS ARCHIVERS NOT WORKING ------------------------------------------------
  2418.  
  2419.         The following is the results of a lot of head scratching on my
  2420.         part for about the 30th time, now it is documented.
  2421.  
  2422.    -------------------------------------------------------------------------
  2423.    Area: OS2BBS
  2424.  
  2425.    Date : Dec 23 '94, 23:31
  2426.    From : Craig Morrison                                         1:201/60.0
  2427.    To   : Rick Cooke
  2428.    Subj : MaxFile/PM 1.24
  2429.    -------------------------------------------------------------------------
  2430.  
  2431.    Following up a message from Craig Morrison to Rick Cooke:
  2432.  
  2433.     RC> Robert Jung. My arj version is 2.41a also by Robert Jung.
  2434.     RC> can you suggest an alternative, as neither one works.
  2435.  
  2436.     CM>   I just did some checking.. :-(
  2437.  
  2438.     CM>   Somehow I've broken the DOS archiver support, I'll be
  2439.     CM> damned if I know what I did to break it but sure enough it's
  2440.     CM> hosed.
  2441.  
  2442.     CM>   This WILL be fixed ASAP, hopefully by the time you read
  2443.     CM> this message..
  2444.  
  2445.      After some more testing, make sure that in the AUTOEXEC.BAT for your
  2446.    DOS sessions you have the directory that your DOS archivers are in
  2447.    listed in the PATH statement. The DOS archiver support is _NOT_ broken
  2448.    in MaxFile/PM.
  2449.  
  2450.      I just got done testing MaxFile/PM with ARJ 2.41a and the following
  2451.    settings:
  2452.  
  2453.          Extract     ARJ x -y
  2454.          Add         ARJ a -r -y
  2455.          List        ARJ l -y
  2456.          Test        ARJ t -y
  2457.  
  2458.      All functions operated normally.
  2459.  
  2460.      It did NOT work until I remembered I had to reinstall OS/2 because of
  2461.    a drive failure and that I had forgotten to add my Utilities directory
  2462.    to the DOS PATH statement in my AUTOEXEC.BAT. Once I added the directory
  2463.    to the path ARJ/PKZIP/PKUNZIP et al magically started functioning
  2464.    correctly.
  2465.  
  2466.      Good luck! :-)
  2467.  
  2468.        See ya,
  2469.  
  2470.    Craig
  2471.    cam@wpc.cioe.com
  2472.  
  2473.    --- timEd/2 1.00
  2474.     * Origin: Workplace Connection * (317) 742-2680 (1:201/60)
  2475.  
  2476. ------------------------------------------------------------------------------
  2477.