home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt59.zip / DOWNSORT.DOC < prev    next >
Text File  |  1993-12-19  |  138KB  |  3,567 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                                                    DOWNSORT
  19.  
  20.                            Maximus CBCS DOWNload file SORT and List Utility
  21.  
  22.                                                  Version 5.9 (OS/2 and DOS)
  23.  
  24.  
  25.  
  26.  
  27.                                                           December 19, 1993
  28.  
  29.  
  30.                                                               Rob Hamerling
  31.  
  32.                                                     Vianen, The Netherlands
  33.                                              Phone: ++31-3473-72136 (voice)
  34.                                                      FIDO-net: 2:512/4.1098
  35.  
  36.                  Maximus Download File Sort and List Utility (OS/2 and DOS)
  37.  
  38.  
  39.  
  40.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  41.  
  42.  
  43.  
  44.     CONTENTS
  45.  
  46.  
  47.       1.0 About Downsort  . . . . . . . . . . . . . . . . . . . . . . . . 1
  48.     | 1.1 Quick start   . . . . . . . . . . . . . . . . . . . . . . . . . 1
  49.       1.2 Registration and Shareware Fee  . . . . . . . . . . . . . . . . 2
  50.       1.3 Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  51.       1.4 Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . 2
  52.  
  53.       2.0 Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  54.       2.1 Purpose and Objectives  . . . . . . . . . . . . . . . . . . . . 3
  55.  
  56.       3.0 User's Guide  . . . . . . . . . . . . . . . . . . . . . . . . . 5
  57.       3.1 Initial setup   . . . . . . . . . . . . . . . . . . . . . . . . 5
  58.       3.2 Data Collection   . . . . . . . . . . . . . . . . . . . . . . . 6
  59.       3.3 List Type Selection   . . . . . . . . . . . . . . . . . . . . . 7
  60.       3.4 Data Selection   . . . . . . . . . . . . . . . . . . . . . . . 12
  61.       3.5 List Customisation   . . . . . . . . . . . . . . . . . . . . . 14
  62.       3.6 Miscellaneous report information   . . . . . . . . . . . . . . 17
  63.  
  64.       4.0 Parameter Specifications   . . . . . . . . . . . . . . . . . . 20
  65.       4.1 Commandline parameters   . . . . . . . . . . . . . . . . . . . 20
  66.       4.2 Configuration file Parameters  . . . . . . . . . . . . . . . . 20
  67.       4.3 Compiling the IPF lists  . . . . . . . . . . . . . . . . . . . 22
  68.  
  69.       5.0 Sample of Getting organised  . . . . . . . . . . . . . . . . . 23
  70.       5.1 Downsort   . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  71.       5.2 BinkleyTerm  . . . . . . . . . . . . . . . . . . . . . . . . . 24
  72.  
  73.       6.0 Packaging  . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  74.       6.1 Availability   . . . . . . . . . . . . . . . . . . . . . . . . 25
  75.       6.2 RUN-time material  . . . . . . . . . . . . . . . . . . . . . . 25
  76.       6.3 Source material  . . . . . . . . . . . . . . . . . . . . . . . 26
  77.       6.4 Installation   . . . . . . . . . . . . . . . . . . . . . . . . 27
  78.       6.5 Dependencies and restrictions  . . . . . . . . . . . . . . . . 27
  79.       6.6 Storage and Performance  . . . . . . . . . . . . . . . . . . . 28
  80.       6.7 Problems   . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  81.       6.8 Wishlist   . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  82.  
  83.       7.0 Internals  . . . . . . . . . . . . . . . . . . . . . . . . . . 30
  84.       7.1 Development Environment  . . . . . . . . . . . . . . . . . . . 30
  85.       7.2 Program Organisation   . . . . . . . . . . . . . . . . . . . . 30
  86.       7.3 Main Data Organisation   . . . . . . . . . . . . . . . . . . . 32
  87.  
  88.       Appendix A.  History of changes  . . . . . . . . . . . . . . . . . 35
  89.       8.1 Version 5.9  . . . . . . . . . . . . . . . . . . . . . . . . . 35
  90.       8.2 Version 5.8  . . . . . . . . . . . . . . . . . . . . . . . . . 36
  91.       8.3 Version 5.7  . . . . . . . . . . . . . . . . . . . . . . . . . 36
  92.       8.4 Version 5.6  . . . . . . . . . . . . . . . . . . . . . . . . . 37
  93.       8.5 Version 5.5  . . . . . . . . . . . . . . . . . . . . . . . . . 38
  94.       8.6 Version 5.4  . . . . . . . . . . . . . . . . . . . . . . . . . 38
  95.       8.7 Version 5.3  . . . . . . . . . . . . . . . . . . . . . . . . . 39
  96.       8.8 Version 5.2  . . . . . . . . . . . . . . . . . . . . . . . . . 40
  97.       8.9 Version 5.1  . . . . . . . . . . . . . . . . . . . . . . . . . 40
  98.       8.10 Version 5.0   . . . . . . . . . . . . . . . . . . . . . . . . 41
  99.  
  100.  
  101.                                                                Contents  ii
  102.  
  103.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  104.  
  105.  
  106.  
  107.  
  108.       Appendix B.  World-wide use of Downsort  . . . . . . . . . . . . . 42
  109.  
  110.       Appendix C.  Sample Lists  . . . . . . . . . . . . . . . . . . . . 44
  111.       10.1 ALL-list  . . . . . . . . . . . . . . . . . . . . . . . . . . 44
  112.       10.2 GBL-list  . . . . . . . . . . . . . . . . . . . . . . . . . . 44
  113.       10.3 NEW-list  . . . . . . . . . . . . . . . . . . . . . . . . . . 44
  114.       10.4 EMI-list  . . . . . . . . . . . . . . . . . . . . . . . . . . 45
  115.       10.5 FILES.BBS   . . . . . . . . . . . . . . . . . . . . . . . . . 45
  116.       10.6 OKfile  . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
  117.       10.7 ORPhan list   . . . . . . . . . . . . . . . . . . . . . . . . 46
  118.  
  119.       Appendix D.  Sample Configuration File   . . . . . . . . . . . . . 47
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                                               Contents  iii
  165.  
  166.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  167.  
  168.  
  169.  
  170.     1.0 ABOUT DOWNSORT
  171.  
  172.     Downsort was originated in 1987 as a program for my own use when I was
  173.     SYSOP of the Bulletin Board PC-Square (2:512/4), to automatically
  174.     generate daily overviews of my download material for the users.  The
  175.     program name is related to the SORTing of the collection of
  176.     DOWNloadable files, in DOWNward time-stamp sequence and an online
  177.     Bulletin was the only list that was produced at that time.  PC-Square
  178.     was running BinkleyTerm and OPUS under DOS, and file-requesting was not
  179.     so popular then.
  180.  
  181.     Now PC-Square runs with OS/2, BinkleyTerm and MAXIMUS CBCS.  I'm not
  182.     SYSOP anymore but still strongly involved.  As a contribution to
  183.     PC-Square and the large international Bulletin Board community of
  184.     MAXIMUS CBCS boards, and in the highly appreciated spirit of
  185.     BinkleyTerm, I decided to upgrade my Downsort program to the current
  186.     software.  During the past years a lot of improvements and extensions
  187.     have been made: many user-configurable options for many more output
  188.     formats then the original Downsort.
  189.  
  190.     The only dependency of Downsort on MAXIMUS CBCS is a parameter-file
  191.     AREA.DAT, which is usually created with a MAXIMUS utility (SILT(P)),
  192.     which itself can be used without actually running MAXIMUS!  This is the
  193.     way I work for testing of Downsort.
  194.  
  195.     "Appendix A.  History of changes" on page 35 gives an impression of
  196.     recent history.
  197.  
  198.     Downsort is now developed in an OS/2 environment, but it is distributed
  199.     as 'family'-application: it runs under OS/2 and DOS.  Recently a
  200.     32-bits version for OS/2 2.0 has been added for OS/2 2.0 and up.
  201.  
  202.     Downsort is in its 7-th year of development and has entered a period
  203.     where life becomes more and more complicated.  While adding new
  204.     features, I have tried to maintain compatibility.  This is a main cause
  205.     of complications.  Maybe in one of the newer versions I have to leave
  206.     this compatibility in favour of maintainability and user-friendliness.
  207.     In anticipation of this, please do not use undocumented features, or
  208.   | styles of usage that are not described in this document.
  209.  
  210.  
  211.   | 1.1 QUICK START
  212.  
  213.   | I appreciate that you are eager to use Downsort.  You don't have to
  214.   | make a comprehensive study of this document.  But please read the
  215.   | comments in Downsort.Cfg before making the changes you consider
  216.   | appropriate.
  217.  
  218.   | And before reporting supposed bugs or missing features, please continue
  219.   | to read this document!
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                                                           About Downsort  1
  228.  
  229.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  230.  
  231.  
  232.  
  233.     1.2 REGISTRATION AND SHAREWARE FEE
  234.  
  235.     Downsort is a $ 0.00 Shareware (Freeware) Program.  This means (to me)
  236.     that you respect the commonly known rules for shareware, but you don't
  237.     have to pay me anything.
  238.  
  239.     Registration is voluntary: please send me a netmail message with your
  240.     name and (net-)address if you are a regular user of Downsort as SYSOP.
  241.     That gives me an impression of the usage and the impact of changes to
  242.     Downsort.
  243.  
  244.     If you tell me that you are running Downsort on your Bulletin Board as
  245.     service to your users, and you appreciate to be mentioned, I'll add
  246.     your name to the reference list in "Appendix B.  World-wide use of
  247.     Downsort" on page 42.
  248.  
  249.  
  250.     1.3 WARRANTY
  251.  
  252.     For this price?  You must be kidding!  But I'll listen to your
  253.     complaints and suggestions, and if time permits, I'll work on the
  254.     improvements you suggested.
  255.  
  256.  
  257.     1.4 ACKNOWLEDGEMENTS
  258.  
  259.     I would like to thank all users that contributed with constructive
  260.     remarks and encouraging appraisals.  Without doubt Emmanuel Sandorfi,
  261.     former SYSOP of 2:320/5, holds the record in number of suggestions and
  262.     amount of additionally required programming effort.  He also provided
  263.     some additional title-fonts (2 and 3).
  264.  
  265.     I also would like to thank the regular users (SYSOP's of Bulletin
  266.     Boards) who made Downsort much more popular than I ever dreamed of!  A
  267.     collection of geographically dispersed Boards can be found in "Appendix
  268.     B.  World-wide use of Downsort" on page 42.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.                                                           About Downsort  2
  291.  
  292.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  293.  
  294.  
  295.  
  296.     2.0 OVERVIEW
  297.  
  298.     Downsort is a program to make lists of available download files for
  299.     Bulletin Board Systems, especially MAXIMUS CBCS.  The different types
  300.     of lists are each for a specific audience (online bulletin board user,
  301.     file-requestor, SYSOP) and purpose (all files, recent acquisitions).
  302.     Within each type there are many ways to customise the contents
  303.     (selection on user-privilege or user-interest), and format
  304.     (sort-sequence of files, titles, logo, etc).
  305.  
  306.     Downsort can produce the following report-types (1)for you:
  307.     (all these can be produced in one run).
  308.  
  309.     ■  user-lists
  310.        ∙  BBS-list, a colorful overview for online users of MAXIMUS CBCS
  311.        ∙  NEW-list of the most recent files (as a response to a
  312.           file-request of 'NEWFILES')
  313.        ∙  ALL-list for a complete overview in a file-group per area (as a
  314.           response to a filerequest of 'FILES' of 'ALLFILES')
  315.        ∙  IPF-list similar contents as ALL-list, but in a different
  316.           presentation format (VIEW-able under OS/2)
  317.        ∙  GBL-list for a complete overview over the area-boundaries, as an
  318.           alternative for ALL-list if you don't want to bother
  319.           file-requestors with your area-structure
  320.  
  321.     ■  SYSOP lists:
  322.        ∙  ORPHAN-report as a help with management of the contents of your
  323.           area's and directories, and to correct possible upload problems
  324.           or inconsistencies
  325.        ∙  DUP-list for a list of duplicate filenames as a help to control
  326.           your disk-space and with version management.
  327.        ∙  OKFile for (Binkley) File Requests.
  328.        ∙  EMI-list for a list of new file arrivals to be included in an
  329.           announcement message.
  330.        ∙  Updated FILES.BBS files
  331.  
  332.     The lists can be generated for different privilege levels, and be
  333.     customised to a very high extend to present your system as you like it
  334.     to be seen by your users (headers, log, etc).  At the same time Maximus
  335.     (and OPUS) conventions are reflected in the way the file information is
  336.     presented.
  337.  
  338.     A sample of most of these lists can be found in "Appendix C.  Sample
  339.     Lists" on page 44.
  340.  
  341.     In short: Downsort is a very versatile tool to manage your database of
  342.     files, both in an OS/2 and DOS environment.
  343.  
  344.  
  345.     2.1 PURPOSE AND OBJECTIVES
  346.  
  347.  
  348.     ────────────────────
  349.     (1)     For the target audience the distiction between 'user' and
  350.             'sysop' is strictly the author's view!
  351.  
  352.  
  353.                                                                 Overview  3
  354.  
  355.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  356.  
  357.  
  358.  
  359.     Downsort is designed for the following purposes:
  360.  
  361.     1. Produce different overviews of files which are available for
  362.        download by online users of the Bulletin Board and by File
  363.        Requestors.  QUICK and EASY file retrieval is the main goal for the
  364.        lists.  Therefore many lists-types and within a type several
  365.        variations should be available for SYSOP and users.
  366.  
  367.     2. Should not disclose files to users (file-requesters) without
  368.        positive agreement by SYSOP.
  369.  
  370.     3. Detect discrepancies between the contents of FILES.BBS and the
  371.        corresponding download directory, such as:
  372.        ■  The directory contains so called orphan-files, which have no
  373.           descriptive entry in FILES.BBS.
  374.        ■  FILES.BBS contains entries of which the file in not in the
  375.           directory (is 'offline').  This may be on purpose!
  376.  
  377.     4. Must be able to be run unattended (typically overnight).  The
  378.        file-access privilege system of a Bulletin Board System like Maximus
  379.        CBCS should be respected by the reports.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.                                                                 Overview  4
  417.  
  418.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  419.  
  420.  
  421.  
  422.     3.0 USER'S GUIDE
  423.  
  424.     This chapter explains the possibilities of Downsort.  Parameter
  425.     specifications will be covered in "4.0 Parameter Specifications" on
  426.     page 20.
  427.  
  428.  
  429.     3.1 INITIAL SETUP
  430.  
  431.     When you are going to use Downsort for the first time, you have to make
  432.     a number of decisions.  Below you'll find a kind of check-list, which
  433.     is setup to help you with a logical sequence of tasks to make the use
  434.     of Downsort succesful.  It does NOT give detailed specifications, these
  435.     can be found in "4.0 Parameter Specifications" on page 20.
  436.  
  437.     The specifications will be put into a configuration file Downsort.CFG,
  438.     which may contain information about:
  439.  
  440.     1. Data Collection
  441.  
  442.        File information will be collected from:
  443.        ■  Privilege and download path-information from AREA.DAT
  444.        ■  Actual file-information from download directories
  445.        ■  FILES.BBS files for file descriptions
  446.  
  447.     2. List Type Selection
  448.  
  449.        Downsort can produce the following report types for you (all in one
  450.        run).
  451.        ■  ORPHAN-report for SYSOP use only
  452.        ■  BBS-list for online users of MAXIMUS CBCS
  453.        ■  NEW-list(s) for a list of the most recent files
  454.        ■  ALL-list(s) for a complete overview in a file-group per area
  455.        ■  IPF-list(s) same as ALL-list, but in a different presentation
  456.           format (VIEW-able under OS/2, there is a special IP2-list for
  457.           OS/2 2.0).
  458.        ■  GBL-list(s) for a complete overview over area-boundaries
  459.        ■  DUP-list(s) for a list of possibly duplicate filenames
  460.        ■  OKFile(s) for (Binkley) File Requests
  461.        ■  EMIFile(s) to for a list of file arrivals over the last period
  462.        ■  Updated FILES.BBS files
  463.  
  464.     3. File selection
  465.  
  466.        Reporting of file-information can be limited by:
  467.        ■  Reporting privilege: only those files up to a certain privilege
  468.           level will be listed
  469.        ■  Area INclude or EXclude: for sub-selection for special interest
  470.   |       groups
  471.   |    ■  Maximus area key/lock system
  472.   |    ■  Explicit exclusion by specification of filespecs (wildcards)
  473.        ■  Number of files or period (days, weeks or months) to be reported
  474.  
  475.     4. List Customisation
  476.  
  477.  
  478.  
  479.                                                             User's Guide  5
  480.  
  481.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  482.  
  483.  
  484.  
  485.        The layout of the lists can be jazzed-up with:
  486.        ■  BLOCK-title and its font
  487.        ■  TopTitle, SubTitle, BottomTitle, Include (logo-) file
  488.        ■  Sorting sequence of area's in ALL-list (unsorted, name, include)
  489.        ■  Sorting sequence of files (unsorted, date, filename)
  490.        ■  Truncation, or wrapping and indenting of file descriptions
  491.        ■  Area- or file-privilege information
  492.        ■  Message and Warning texts
  493.        ■  Handling of Avatar codes in comment lines (strip or mimic).
  494.  
  495.        All in the language which suites your audience best.
  496.  
  497.     The sample Downsort.CFG file (see "Appendix D.  Sample Configuration
  498.     File" on page 47) contains defaults and a brief information to help you
  499.     with the parameter specifications.
  500.  
  501.     Below you can find some more explanation.
  502.  
  503.  
  504.     3.2 DATA COLLECTION
  505.  
  506.  
  507.  
  508.     3.2.1 AREA.DAT
  509.  
  510.     A MAXIMUS file 'AREA.DAT' is absolutely required by Downsort.  It is
  511.     however not necessary to run MAXIMUS yourself, the AREA.DAT file is
  512.     created with SILT(P) from the MAXIMUS package.  You can use this
  513.     utility without the other MAXIMUS stuff.  In fact I do that myself (NOT
  514.     running a MAXIMUS board)!  If you run Downsort in a directory without
  515.     AREA.DAT, then you should use specify the filespec for AREA.DAT.  It
  516.     allows also to specify a different AREA.DAT file than the one that is
  517.     used by your MAXIMUS.
  518.  
  519.     With SILT(P) you may build a special AREA.DAT for exclusive use by
  520.     Downsort, with different, less, or even more directories!  Probably
  521.     much more convenient is the use of AreaINclude or AreaEXclude in
  522.     Downsort.CFG to limit the contents of the lists to a group of area's,
  523.     that you want to report together, while you use the regular AREA.DAT.
  524.     A combination of a 'special' AREA.DAT and AreaIN/EXcludes is another
  525.     option to obtain areagroups.
  526.  
  527.     Remember: The combination of area privilege in AREA.DAT and the
  528.     report-privilege specification in Downsort.CFG may restrict the
  529.     contents of reports.  AreaINclude is subordinate to this and will work
  530.   | only for the collection of area's within these privilege limits.
  531.   | Area-selection on Maximus' userkey may be another restriction.
  532.  
  533.   | In addition files may explicitly excluded during the data collection
  534.   | process by specification of a number of filespecifications (wildcards
  535.   | allowed).
  536.  
  537.     If Downsort reports a memory constraint (see also "6.6 Storage and
  538.     Performance" on page 28), you may use these techniques as
  539.     circumvention: exclude one or more of the file area's and rerun
  540.  
  541.  
  542.                                                             User's Guide  6
  543.  
  544.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  545.  
  546.  
  547.  
  548.     Downsort.
  549.  
  550.  
  551.     3.2.2 FILES.BBS
  552.  
  553.     Downsort uses the information in AREA.DAT to locate the description
  554.     files, usually called FILES.BBS.  So either the ListFile specification
  555.     in AREA.DAT, or the download directory to locate them (Maximus
  556.     default).
  557.  
  558.  
  559.     3.3 LIST TYPE SELECTION
  560.  
  561.     Downsort can produce several types of output reports, indicated by type
  562.   | of list.  The following list types are available (all list types may be
  563.   | generated in multiple variants within one run of Downsort, i.c. with a
  564.   | single directory scan!).
  565.  
  566.  
  567.     3.3.1 ORPHAN-LIST
  568.  
  569.     This is a list of all files in download directories for which there is
  570.     no entry in any FILES.BBS file of all areas which have this directory
  571.     specified as download path.  The report contains date, area-name and
  572.   | area-path of the orphan.  The entries are sorted on area and filename.
  573.  
  574.   | Not reported are the files that match all FileEXclude specifications.
  575.   | Normally you would exclude FILES.*, *.BAK, DIR.?BS and SYSTEM*.?BS.
  576.  
  577.     If you have more than 1 area pointing to the same download directory,
  578.     but with different FILES.BBS files, the orphans are reported for the
  579.     first of these areas only.
  580.  
  581.     Note: If there is an entry for a file in FILES.BBS without a
  582.     description, the file is NOT considered to be an Orphan!
  583.  
  584.  
  585.     3.3.2 BBS-LIST
  586.  
  587.     This is a list of downloadfiles that became recently available on your
  588.     system.  File selection is on date, but for presentation the list may
  589.     be sorted on date, newest first or on filename.
  590.  
  591.     The list contains compiled MECCA control sequences, for direct use in
  592.     MAXIMUS bulletins: a user-privilege sensitive list!  It might be a good
  593.     idea to put a translated [onexit] string, which translates into:
  594.     ^OFpath.  When a user exits from the BBS-list bulletin, it will fall
  595.     back to the exit-bulletin.
  596.  
  597.     The length of the file (number of file-entries) may be limited by
  598.     parameters:
  599.  
  600.     ■  file-count
  601.     ■  file age in days, weeks or months (30 days)
  602.     ■  maximum privilege
  603.  
  604.  
  605.                                                             User's Guide  7
  606.  
  607.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  608.  
  609.  
  610.  
  611.     (never more than available within the privilege limit).  If neither
  612.     specified it will contain all available files in all download
  613.     directories.
  614.  
  615.     To make it easy for you to build a complete MAXIMUS bulletin-file a
  616.     user-provided header is included preceding the list and a trailer at
  617.     the end of the list.  Header and trailer can be built by SYSOP, and may
  618.     contain any information and bulletin-control sequences (a sample is
  619.     provided).
  620.  
  621.  
  622.     3.3.3 NEW-LIST
  623.  
  624.     Basically the same list as above, but in simple ASCII format.  This
  625.     list is suitable for regular file-requestors as brief overview of the
  626.     latest additions, updates or replacements.
  627.  
  628.  
  629.     3.3.4 EMI-LIST
  630.  
  631.     Basically the same as NEW-list, but more compact:
  632.  
  633.     ■  contains file also file-time and exact filesize in bytes.
  634.     ■  Description wrapping (if used) is overlapping the file-details
  635.        except filename (may be justified with indentation).
  636.  
  637.     The EMI-list is especially suitable to generate file-arrival messages
  638.     (the output should be included by another program).
  639.  
  640.  
  641.     3.3.5 ALL-LIST
  642.  
  643.     A list of all downloadfiles by area.  Files of the same area are listed
  644.     in groups, separated by imbedded headers with area-name, -description,
  645.     and -privilege.  Actual status information is provided in the
  646.     area-header as well: area-filecount and -bytecount, and latest
  647.     acquisition (date and file-name).
  648.  
  649.     At the end a SUMMARY report shows per area: area-title, file-count,
  650.     byte-count, and totals.
  651.  
  652.     The size of this list is limited only by the privilege parameter.  The
  653.     numbers in area-header and summary report show only what is available
  654.     for the particular privilege.
  655.  
  656.  
  657.     3.3.6 IPF- AND IP2-LIST
  658.  
  659.     Same contents as ALL-list but in a different format.  Only useful for
  660.     users that run OS/2 (OS/2 version 1.2+ under Presentation Manager).
  661.     This file has the format of an input-file for the Information
  662.     Presentation Facility Compiler (IPFC).
  663.  
  664.     There is a separate form of this list (called IP2-list) for OS/2 2.0.
  665.     It produces information that can be compiled only with the accompanying
  666.  
  667.  
  668.                                                             User's Guide  8
  669.  
  670.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  671.  
  672.  
  673.  
  674.     IPF Compiler of the OS/2 2.0 Toolkit.  The result however can be VIEWed
  675.     under OS/2 1.3!
  676.  
  677.  
  678.     3.3.7 GBL-LIST
  679.  
  680.     Similar to ALL-list, but where ALL-list gives the files in groups per
  681.     area, the GBL-list ignores area-boundaries and gives a single group.
  682.     It contains an extra column with the area-code for each file, there is
  683.     no area-summary.
  684.  
  685.     SYSOP may choose which of both is suitable to make available to users,
  686.     and which to use for himself (or even both).
  687.  
  688.     The GBL-list can be used in stead of the ALL-list if your users prefer
  689.     searching in the list without having to bother about area-organisation.
  690.     Although one of the original purposes of the GBL-list was checking for
  691.     duplicate files, there is now also a special report for this particular
  692.     purpose (see "3.3.8 DUP-list").
  693.  
  694.  
  695.     3.3.8 DUP-LIST
  696.  
  697.     Simple report of possibly duplicate files over the area's.  The format
  698.     is basically the same as the GBL-list, but only files with the same
  699.     filename are reported.  'Offline' files are included in the check,
  700.     orphans are not!
  701.  
  702.     Please note that the DUP-list may not always contain what you expect.
  703.     It can be more or less, for example:
  704.  
  705.     ■  Downsort looks primarily at filenames only (extension is of second
  706.        importance, path is completely ignored).
  707.     ■  You may have explicitly excluded area's from the search.
  708.     ■  You may have excluded area's by privilege: Downsort completely
  709.        ignores area's with a higher privilege than any report asked for.
  710.     ■  You have duplicates in 'orphan'-state.
  711.  
  712.     These circumstances may give 'false' signals or hide duplicates!
  713.  
  714.     All duplicate files within the privilige-range will be reported, even
  715.     when a counterpart has a higher privilege or are orphan (and thus will
  716.     not be reported in the DUP-list)!  You may need a file-finder-utility
  717.     to search for the 'partner'-file in one of the directories with a
  718.     higher privilege.
  719.  
  720.     There are very few other parameters applicable to this list.  File
  721.     descriptions may be specified as truncated or wrapped.  All user-titles
  722.     are left out and only a sort on filename is supported.
  723.  
  724.     Suppression of reporting files with equal filenames and different
  725.     extensions is possible with the "NonDupEXT" keyword in Downsort.Cfg.
  726.     You specify pairs of extensions.  Two files with equal filename and one
  727.     of each having an extension specified as 'pair' will not be reported as
  728.     duplicate.  For example, if you specify:
  729.  
  730.  
  731.                                                             User's Guide  9
  732.  
  733.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  734.  
  735.  
  736.  
  737.        NonDupEXT  SDN  SDA
  738.  
  739.     then file pairs xyz.SDN and xyz.SDA will not be reported in the
  740.     DUP-list.
  741.  
  742.     This pair-exclusion can also be used for more than 2 extensions, but
  743.     the exclusion works only for pairs of files.  So then you must specify
  744.     as many pairs as can be formed.  For example if you want to exclude
  745.     file combinations like xyz.IDX xyz.DAT and xyz.EXT, then you should
  746.     specify:
  747.  
  748.        NonDupEXT  IDX DAT  IDX EXT  DAT EXT
  749.  
  750.     Warning: The check on duplicates by Downsort works only when you
  751.     specify all  possible pairs of extensions!  If you fail to specify any
  752.     possible pair, the Dup-list may contain false signals.
  753.  
  754.     Multiple pairs may be specified on a line, and multiple lines are
  755.     allowed.
  756.  
  757.  
  758.     3.3.9 OKFILE
  759.  
  760.     List filespecifications for file-requests in BinkleyTerm style.  The
  761.     generated paths in the list obey the following rules:
  762.  
  763.     ■  the area-privilege is within the privilege limit of the report
  764.  
  765.     ■  the area is not excluded (by areaEXclude)
  766.  
  767.     ■  the area has at least 1 file within the privilege limit of the
  768.        report
  769.  
  770.     The paths are sorted on area-name (although the area-name is not part
  771.     of the list).  There is no check on duplicate paths.
  772.  
  773.     The list is not jazzed-up with titles, etc, but a file may be included
  774.     in front of the list if specified on the OKFileList in Downsort.CFG
  775.     (see "Appendix D.  Sample Configuration File" on page 47).  This option
  776.     allows you to insert a list of 'magic' names in the OKFile.
  777.  
  778.     Two formats are available:
  779.  
  780.     ■  SHORT format with lines in the format "filepath\*.*".  This is the
  781.        regular format for BinkleyTerm and other mailers.
  782.     ■  LONG format with lines in the format: "@filespec
  783.        filepath\filespec".  All files have a 'magic'-name assigned and
  784.        there are no generic file specifications in the OKFileList.  This
  785.        prevents directory searches for BinkleyTerm for each file request.
  786.  
  787.     Note: Some newer versions of BinkleyTerm can use the file base of
  788.     Maximus to find a file even faster.
  789.  
  790.  
  791.  
  792.  
  793.  
  794.                                                            User's Guide  10
  795.  
  796.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  797.  
  798.  
  799.  
  800.     3.3.10 REBUILD FILES.BBS
  801.  
  802.     New "FILES.BBS" type of file may be (re-)created, one for every area.
  803.     The contents of the file-information will be about the same as the
  804.     original FILES.BBS, but with the following notes:
  805.  
  806.     ■  A header is generated with area-name, -title, and -privilege.  Also
  807.        the total amount of files and bytes and the most recently acquired
  808.        new file in this area is part of the header information.
  809.     ■  Files with a privilege up to and including the area-privilege are
  810.        listed first.
  811.     ■  Files can have a privilege other than the area-privilege when the
  812.        original FILES.BBS file contains ^Pp-sequences ('p' being a
  813.        privilege letter).  This construction will be rebuilt by Downsort.
  814.        Files with a higher privilege than the area-privilege will follow
  815.        after a compiled MECCA-sequence (^Pp) in the new FILES.BBS.
  816.        Downsort respects these indicators when reading FILES.BBS, so all
  817.        file-privilege information is retained.  This ensures no accidental
  818.        loss of file-information, and the regular user won't see more than
  819.        he should.
  820.     ■  Wild-card specifications in the original FILES.BBS are not
  821.        propagated to the new FILES.BBS.
  822.     ■  The file description is kept internally as a single string of about
  823.        2 KBytes (Maximus 2.0 supports up to 240 bytes!)  When creating
  824.        FILES.BBS files, this will be the file format (single record per
  825.        file-entry).  The original FILES.BBS may contain a (long) single
  826.        string description, or multiple (short) multiline descriptions.
  827.        When encountering multi-line descriptions in input-FILES.BBS,
  828.        Downsort concatenates the separate description lines with a single
  829.        intermediate space up to a maximum of 2 KBytes.  This will be the
  830.        output format if the FIL-list is requested.
  831.     ■  Comments in FILES.BBS will be preserved onlywhen the Keep-Sequence
  832.        option is used (specify /K on the FilFileList line of Downsort.Cfg).
  833.  
  834.     Special attention is requested for the following:
  835.  
  836.     ■  The first 8 lines, if comments (starting with a '-'-character), are
  837.        discarded.  These lines are assumed to be the standard header for
  838.        FILES.BBS of Downsort.
  839.     ■  Downsort from version 5.7 recognises its own headerlines with the
  840.        characters: <-><&delta.><&delta.><backspace><backspace> for each of
  841.        its header-lines, and will skip all lines starting with this
  842.        sequence during the data collection phase, even when encountered
  843.        after line 8.
  844.     ■  You can include your own file with the /I-option on the FILFilePath
  845.        line in Downsort.Cfg in the header of FILES.BBS.  All lines in the
  846.        include-file for FILES.BBS output will be prefixed by Downsort with
  847.        the 5-character sequence mentioned above to make sure that these
  848.        will also be 'refreshed' by Downsort.
  849.  
  850.     The destination of FILES.BBS-files is not by definition the same as the
  851.     origin!  When specified with the "FIL:"-parameter (or in the
  852.     configuration file), the output may be located in a different directory
  853.     than the original input FILES.BBS.
  854.  
  855.  
  856.  
  857.                                                            User's Guide  11
  858.  
  859.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  860.  
  861.  
  862.  
  863.     When the output is directed to a separate directory, the files will be
  864.     named as follows:
  865.  
  866.     FILES.ac      when all areanames (areacodes) of the selected areas in a
  867.                   single run of Downsort are 3 bytes or less.
  868.  
  869.     areaname.BBS  when any areaname is longer than 3 bytes.
  870.  
  871.     The format of the header will be slightly different.  Font
  872.     specification (/Fx in FILFileList) works for the second case only.
  873.  
  874.     Manual checking or post-processing by some other program may follow
  875.     Downsort, after which the files might be put back on the MAXIMUS
  876.     specified position.
  877.  
  878.  
  879.     3.4 DATA SELECTION
  880.  
  881.   | During the data collection phase of Downsort, files are selected on
  882.   | several criteria.  Generally speaking not more information is collected
  883.   | than needed for all lists in a single run of Downsort.
  884.  
  885.   | During the list creation phase a further file selection may take place.
  886.  
  887.   | Apart form the short OK-list, all lists are created from the file
  888.   | information.  This means for example that if a selection is such that
  889.   | no files of a certain area fall within the list criteria, the area will
  890.   | not appear in any list.
  891.  
  892.  
  893.     3.4.1 PRIVILEGE CONTROL
  894.  
  895.     The default file privilege to be shown in the lists is SYSOP.  All
  896.     files with a higher privilege than the specified (or defaulted)
  897.     report-privilege will not appear in the lists.
  898.  
  899.     Files without a matching filename-entry in FILES.BBS are treated as
  900.     Hidden.  That means that by default these files will not be listed,
  901.     unless the 'H' privilege is used on the report-request specification.
  902.  
  903.     If you run a mailer like BinkleyTerm and support file-requests, you
  904.     lack the extensive privilege system like Maximus.  The only distiction
  905.     BinkleyTerm makes with file-request is 'unknown', 'known' and
  906.     'password-protected'.  You may generate multiple download lists with
  907.     different privilege indictor, depending if you allow these categories
  908.     to request different file collections a sample of this kind of
  909.     environment is given in "5.0 Sample of Getting organised" on page 23.
  910.  
  911.     This is not needed for Downsort.BBS, since this file has imbedded
  912.     privilege control sequences for MAXIMUS users.  But you should specify
  913.     a sufficiently high privilege for the BBS-list to satisfy your most
  914.     valuable users!
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                                            User's Guide  12
  921.  
  922.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  923.  
  924.  
  925.  
  926.     3.4.2 AREA SELECTION
  927.  
  928.   | There are several ways to perform area selection:
  929.  
  930.   | 1. AREA.DAT file needs not be the regular complete AREA.DAT used by
  931.   |    your online Maximus system.
  932.  
  933.   | 2. AreaINclude and/or AreaEXclude statements may select groups of
  934.   |    area's by name from the used AREA.DAT file.
  935.  
  936.   | 3. Individual list specifications may further reduce the lists on file
  937.   |    privilege and userkeys.  The latter makes use of the Maximus feature
  938.   |    called 'key/locks'.
  939.  
  940.     You should realise that this is the latest selection during the data
  941.     collection phase.  Area-privilege selection has taken place already
  942.     before AreaIN/EXclude, or UserKeys are processed.  So make sure you
  943.     specified a sufficiently high report-privilege to get the proper areas
  944.   | into the group.
  945.  
  946.   | Note: During the reporting phase you may further restrict
  947.   | file-reporting with privilege, userkeys or time period!
  948.  
  949.  
  950.   | 3.4.3 FILENAME SELECTION
  951.  
  952.   | A completely separate selection is possible on filename.  Downsort
  953.   | scans download directories and collects data of all files (except those
  954.   | with the hidden or system attribute).  With the keyword FileEXclude in
  955.   | Downsort.cfg, you may indicate which files you want to exclude from
  956.   | processing by Downsort, based on filename.  With one or more filespecs,
  957.   | wildcards allowed, all files with matching filespec will be excluded
  958.   | during the data collection phase, regardless of the area.  The current
  959.   | implementation supports only the traditional 8.3 filename.ext format,
  960.   | no long names and no explicit path.
  961.  
  962.   | In versions of Downsort before 5.9 the hardcoded specification of
  963.   | certain 'system' files has been removed, and these filespecs should now
  964.   | be specified in Downsort.cfg.  The sample Downsort.cfg does contain
  965.   | these specifications.  I suggest to leave that line asis and add one or
  966.   | more new lines for your own use.  Warning: FileEXcluded files will even
  967.   | not appear in the FILES.BBS (re-)created  by Downsort!
  968.  
  969.  
  970.  
  971.     3.4.4 REPORT LENGTH
  972.  
  973.     For lists that are meant to show the latest file-information only
  974.     (BBS-, NEW- and ALL-list), the length of the list can be limited to a
  975.     maximum number of file-entries or to file-age in days, weeks or months.
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.                                                            User's Guide  13
  984.  
  985.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  986.  
  987.  
  988.  
  989.     3.5 LIST CUSTOMISATION
  990.  
  991.  
  992.  
  993.     3.5.1 HEADERS, TITLES AND INCLUDE FILES
  994.  
  995.     There are several ways to custimise the appearance of the lists for
  996.     Downsort.  All items in the following list are optional, but the
  997.     sequence in the reports is fixed and as listed:
  998.  
  999.     Pre-Title   Lines that should appear as the very first lines of your
  1000.                 lists.  Any text may be specified.  Leading '~'-characters
  1001.                 (tilde) will be treated as full-size required blanks,
  1002.                 mainly to manually align (center) the text in these lines.
  1003.                 There is no automatic centering.  You may have to
  1004.                 experiment a little.
  1005.  
  1006.     TITLE       A short title (8-12 characters), that will be magnified to
  1007.                 big BLOCK-letters.  There are 4 block-fonts to choose from.
  1008.                 Not all characters are supported and lower-case will be
  1009.                 translated to upper-case.  The '~'-character (tilde) will
  1010.                 be treated as full-size required blank, the '`'-character
  1011.                 (accent-grave) as half-size required blank.
  1012.  
  1013.                 If not specified, a default title is generated as
  1014.                 Downsortxy, where xy stands for the current version of
  1015.                 Downsort.
  1016.  
  1017.     TitleFont   Number of the font to be used for the BLOCK title.  If
  1018.                 specified as 0, the BLOCK-title will NOT be generated at
  1019.                 all.
  1020.  
  1021.     Include-file A text-file to be included.  There will be no manipulation
  1022.                 of the contents of this file.  This include-file may be all
  1023.                 you need to obtain a fully custimised list.  For the
  1024.                 IPF-list this include file will most likely have to contain
  1025.                 IPF tags for proper formatting, for the OK-file it will be
  1026.                 a list of 'magic' name entries.
  1027.  
  1028.     Sub-Title   Lines that should appear immediately following the
  1029.                 block-title.
  1030.  
  1031.     BottomTitle Lines that should appear as very last lines of the lists.
  1032.                 These follow my 'signature'.
  1033.  
  1034.     The BLOCK-title and Pre-, Sub-, and Bottom-titles are used for all
  1035.     reports identically, there is no such thing as an 'individual' title
  1036.     specification for each report.  However the Include-file may be
  1037.     different for each report.  If you want to build more than 1 list but
  1038.     with different 'headings' or no headings at all, you better forget the
  1039.     Title-options.  In stead make heading-files and use the Include option
  1040.     of the individual list specifications.
  1041.  
  1042.     Note: Exceptions:
  1043.  
  1044.  
  1045.  
  1046.                                                            User's Guide  14
  1047.  
  1048.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1049.  
  1050.  
  1051.  
  1052.     1. None of the above does apply to the BBS-list.  As it will generally
  1053.        be desirable to imbed (compiled) MECCA control sequences in this
  1054.        type of lists, this report will include dedicated top and bottom
  1055.        files (if available in the current default directory).  These files
  1056.        must be called Downsort.HDR (header) and Downsort.TRL (trailer).
  1057.  
  1058.     2. The ORPHAN report will not contain any user-titles.
  1059.  
  1060.     3. The FILES.bbs files will not use any of the title-specifications,
  1061.        but may use an Include-file.
  1062.  
  1063.     Recommendation: File-requestors appreciate a header with a clear
  1064.     indication of the source of the reports.  Many Bulletin Boards use
  1065.     FILES or ALLFILES as 'magic' name, but that is not very distinctive if
  1066.     you collect lists of different boards!  So use Downsort's facilities to
  1067.     generate a block-title with your system-name, or an include file with
  1068.     some kind of logo.
  1069.  
  1070.     Note: Specification details and samples can be found in Downsort.CFG.
  1071.  
  1072.     Some SYSOPs do not like to confront their users with privileges.  In
  1073.     most headers there will be a line with the reporting privilege.  This
  1074.     may be suppressed.
  1075.  
  1076.  
  1077.     3.5.2 FILE SORTING
  1078.  
  1079.     The file-entries in the lists can be sorted on different keys:
  1080.  
  1081.     ■  Filedate
  1082.  
  1083.     ■  Filename
  1084.  
  1085.     ■  Sequence of FILES.BBS
  1086.  
  1087.     The default sorting sequence depends on the type of list.  Some lists
  1088.     do not support some of these sorting keys.
  1089.  
  1090.     Note: File sorting has a local scope.  It can be specified for to each
  1091.     listtype individually.
  1092.  
  1093.  
  1094.     3.5.3 AREA SORTING
  1095.  
  1096.     The order in which the areas are presented in the lists can be
  1097.     specified:
  1098.  
  1099.     ■  Order of AREA.DAT
  1100.     ■  Sorted alphabetically on areaname
  1101.     ■  Order of areaINclude statement in Downsort.Cfg
  1102.     ■  Groupname-order
  1103.  
  1104.     The Groupname-order is a special order based on a popular naming
  1105.     convention for areas.  Many SYSOPs use areanames with a group-name or
  1106.     -letter followed by a sequence number.  With groupname sorting the
  1107.  
  1108.  
  1109.                                                            User's Guide  15
  1110.  
  1111.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1112.  
  1113.  
  1114.  
  1115.     areaname is split - if possible - into a groupname (if the first
  1116.     character is not be numeric) and a sequence number (if the last part of
  1117.     areaname is numeric).  Primary sort key is groupname, secundary sortkey
  1118.     is sequence number.  If the first character of the area-name is
  1119.     numeric, the groupname is empty, and if the last part of the areaname
  1120.     is not numeric, the second key is empty.
  1121.  
  1122.     If the ordering does not match your more complicated area naming
  1123.     convention, you can always fallback on a properly sequenced AREA.DAT,
  1124.     or on areaINclude sequence.
  1125.  
  1126.     If Include-order is specified, but AreaINclude is not, then the order
  1127.     falls back to Group-order.
  1128.  
  1129.     The area-order specification has a global scope.  It applies to every
  1130.     lists where the areaname is significant, including summaries in ALL-
  1131.     and IPF-lists.
  1132.  
  1133.     Default sorting order is 'Group'.
  1134.  
  1135.  
  1136.     3.5.4 WARNINGS, INDICATIONS, DESCRIPTIONS AND COMMENTS
  1137.  
  1138.     ■  There are two options for long file descriptions (those that do not
  1139.        fit on a 80-character line):
  1140.        ∙  Truncation at end-of-line
  1141.        ∙  Wrapping to multiple lines
  1142.  
  1143.        Both options are available for all lists, but the defaults vary with
  1144.        the type of the report.  If wrapping is used indentation of
  1145.        continuation lines.
  1146.  
  1147.     ■  Orphan description: Text that will be reported in the description
  1148.        column of a file, when for this file no entry in FILES.BBS could be
  1149.        located.
  1150.  
  1151.        Default: "--- Orphan ---".
  1152.  
  1153.     ■  Not-Found description: Text for the description column when the
  1154.        file-entry was found in FILES.BBS, but there was no description
  1155.        present.
  1156.  
  1157.        Default: "--- no description available ---".
  1158.  
  1159.     ■  Offline description: Text that will replace file-size and file-date,
  1160.        when an entry for this file was found in FILES.BBS, but the file
  1161.        could not be located in the download directory.
  1162.  
  1163.        Default: "** offline **".
  1164.  
  1165.     ■  Comments in FILES.BBS (mostly used for additional description for
  1166.        groups of files) will be listed when no sorting is specified (the /K
  1167.        option for ALL-, IPF- and FIL-lists).
  1168.  
  1169.  
  1170.  
  1171.  
  1172.                                                            User's Guide  16
  1173.  
  1174.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1175.  
  1176.  
  1177.  
  1178.        When Downsort encounters Avatar screen handling codes in FILES.BBS
  1179.        these are stripped of or partially imitated in the output lists
  1180.        (unless AVAstrip No is specified in Downsort.Cfg).  Typical screen
  1181.        handling commands (cursor movement, color settings) are just
  1182.        stripped, ohers (repeating characters of patterns) are imitated.
  1183.  
  1184.     ■  Size of a VIEW-page in IPF-list: The IPF-list of area's with more
  1185.        than 250 file entries will be splitted into 'parts' to prevent the
  1186.        IPF-compiler message 'page size exceeded'.  But if you have many
  1187.        long descriptions, or wish smaller parts, the page-size can be
  1188.        altered with a parameter on the IpfFileList line in Downsort.CFG.
  1189.  
  1190.        Default: 250.
  1191.  
  1192.  
  1193.  
  1194.     3.6 MISCELLANEOUS REPORT INFORMATION
  1195.  
  1196.  
  1197.  
  1198.     3.6.1 FILE INFORMATION IN LISTS
  1199.  
  1200.     1. Dates are marked with a 'new'-indicator: a '*' if the file is only
  1201.        since a week on this system, and a '+' if it is since a month.
  1202.        Filedates later than the current system date are marked '-'
  1203.        (negative age).
  1204.  
  1205.     2. In every outputfile the filename, MAXIMUS-area name, file-size and
  1206.        -date, and file-description from FILES.BBS is listed.  A report-line
  1207.        will never display more than 79 characters.
  1208.  
  1209.        The file-description will be multi-line in ALL-, IPF- and GBL-list
  1210.        if it is longer than would fit on the standard 79-position line, a
  1211.        word-wrapping technique is used for readability (line-split on word
  1212.        boundary).  The description is truncated at end of line in BBS-list
  1213.        and NEW-list.
  1214.  
  1215.        The -T option will force truncation of the description in all
  1216.        reports, the -W option will allow multi-line descriptions in all
  1217.        reports.  When wrapping is used, continuation lines will normally be
  1218.        aligned on the start position of the desription.  This may be
  1219.        modified with an indentation option.
  1220.  
  1221.        If a filename is found in FILES.BBS, but no accompanying
  1222.        description, a "--- no description available ---" will be put in
  1223.        place.  An alternative text may be specified with Downsort.CFG.
  1224.  
  1225.        Files for which there is no entry in the FILES.BBS (Orphans) are
  1226.        treated as Hidden files, which are only listed in the reports if the
  1227.        Hidden privilege is specified.
  1228.  
  1229.        Note: If you want the orphans to appear in FILES.BBS (or in any
  1230.        other report), you MUST also request an ORP-list!
  1231.  
  1232.     3. 'OFFLINE" in stead of file-size and file-date is reported if
  1233.  
  1234.  
  1235.                                                            User's Guide  17
  1236.  
  1237.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1238.  
  1239.  
  1240.  
  1241.        FILES.BBS contains an file-entry while the file is not in the
  1242.        corresponding directory.
  1243.  
  1244.     4. The BBS-list contains MAXIMUS authorisation controls
  1245.        (^PLp-sequences), corresponding to the privilege of the area or the
  1246.        individual file.  So it is not necessary to make different files for
  1247.        different categories of MAXIMUS users, even with the default
  1248.        privilege-limit SYSOP a user will not see the files he/she is not
  1249.        supposed to know about.
  1250.  
  1251.        Other lists do not contain any privilege information, the files (or
  1252.        complete area's) above the specified privilege are simply not
  1253.        listed, however multiple lists can be produced for different
  1254.        categories of users (based on privilege).
  1255.  
  1256.  
  1257.  
  1258.     3.6.2 FILE DATES
  1259.  
  1260.     One of the function of Downsort is sorting on file date.  Since the
  1261.     introduction of HPFS in OS/2 version 1.2, there is not one single
  1262.     file-date anymore!  A file on an HPFS volume has different values for:
  1263.  
  1264.     ■  Creation date
  1265.     ■  LastAccess date
  1266.     ■  LastWrite date
  1267.  
  1268.     The date you see normally in DIR-listings is the LastWrite date.  Most
  1269.     SYSOPs will have noticed that ZMODEM uploads and file-attaches give
  1270.     file-dates corresponding to the (LastWrite-) date of the sending
  1271.     system.  And most utilities handle only this 'single' date.  That means
  1272.     that old ZMODEM-uploaded files are generally not on top of the
  1273.     acquisition lists.
  1274.  
  1275.     But HPFS stores the date of arrival on your system (Creation) as well.
  1276.     Downsort handles the Creation date for sorting, but the lists (see
  1277.     below) contain the 'old fashioned' LastWrite date.  This has the
  1278.     following consequences:
  1279.  
  1280.     ■  A new acquisition is on top of lists, if that list is sorted on
  1281.        date, and are marked in the lists as new by a flag for an 'age' of a
  1282.        week or a month.
  1283.     ■  The listed file-date is the 'ordinary' date.  So users can judge for
  1284.        themselves if the file is 'new' for them as well.
  1285.  
  1286.     Note: The LastAccess date is not very relevant for the purposes of
  1287.     Downsort, although SYSOP may see when it was last downloaded.
  1288.  
  1289.     Downsort is delivered with a simple DIR-like utility 'HPFSDATE' to show
  1290.   | the three dates of a file on a HPFS volume.
  1291.  
  1292.   | Files with 'future' file dates will be indicated with a '-' flag in the
  1293.   | lists.  These files will never appear in: BBS-, NEW-, and EMI-lists.
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                                            User's Guide  18
  1299.  
  1300.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1301.  
  1302.  
  1303.  
  1304.     3.6.3 DUPLICATE FILENAMES
  1305.  
  1306.     Duplicate filenames are checked if the DUP-list is requested, and they
  1307.     will be reported only in the DUP-list.  So duplicates may appear in the
  1308.     regular user-lists, which means:
  1309.  
  1310.     ■  If a filename.ext is encountered more than once in different
  1311.        subdirectories of FILES.BBS files, it will appear that many times in
  1312.        the outputlist.  The file-privilege reflects that of the area where
  1313.        the file belongs to, unless overridden by a ^Px modifier in
  1314.        FILES.BBS.
  1315.     ■  It may happen that a file is reported as orphan in one area, and as
  1316.        duplicate in another.  It is likely that the file is found in a
  1317.        common download directory of more than one area but it is described
  1318.        in the FILES.BBS of a 'secundary' area, but with the wrong
  1319.        extension.
  1320.  
  1321.        Note: Duplicate file reporting may be influenced with the
  1322.        'NonDupExt' specification, see "3.3.8 DUP-list" on page 9.
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.                                                            User's Guide  19
  1362.  
  1363.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1364.  
  1365.  
  1366.  
  1367.     4.0 PARAMETER SPECIFICATIONS
  1368.  
  1369.     This chapter tells you how to customise the configuration file and what
  1370.     you might specify on the commandline.
  1371.  
  1372.     A sample configuration file (in "Appendix D.  Sample Configuration
  1373.     File" on page 47) is part of the package.  It contains a brief comments
  1374.     (in Binkley and MAXIMUS style) to help you.
  1375.  
  1376.  
  1377.     4.1 COMMANDLINE PARAMETERS
  1378.  
  1379.     This paragraph deals only with the commandline parameters!
  1380.  
  1381.  
  1382.   |   [drive:][path]  DOWNSORT  [@filespec] [/H | /Q | /V]
  1383.  
  1384.  
  1385.     @filespec   The character '@' followed by a complete file
  1386.                 specification of the Downsort configuration file(see "4.2
  1387.                 Configuration file Parameters" for details).  This file
  1388.                 will be used to specify processing parameters.
  1389.  
  1390.                 NOTE: The specification of a configuration file is
  1391.                 mandatory when the file AREA.DAT is not in the default
  1392.                 directory when running Downsort.
  1393.  
  1394.                 Default: Downsort.CFG in current default directory.
  1395.  
  1396.     /H /Q /V    Operating mode
  1397.                 ■  H - Help:  display screen with essential information
  1398.                    about running Downsort, such as the command syntax.  In
  1399.                    that case the program will not undertake any other
  1400.                    action.
  1401.                 ■  Q - Quiet:  display only start and finish-message, and
  1402.                    error messages which prevent the program from proceeding
  1403.                    normally.
  1404.                 ■  V - Verbose:  display a lot of progress messages.
  1405.                 If neither -Q nor -V is specified, than the number of
  1406.                 console messages will be 'intermediate': more than -Q, but
  1407.                 less than -V.
  1408.  
  1409.                 Default: none
  1410.  
  1411.  
  1412.  
  1413.     4.2 CONFIGURATION FILE PARAMETERS
  1414.  
  1415.     All processing options are specified in the configuration file.  The
  1416.     parameters are only mentioned here for completeness, see "Appendix D.
  1417.     Sample Configuration File" on page 47 for a documented specification
  1418.     sample of a configuration file.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.                                                Parameter Specifications  20
  1425.  
  1426.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1427.  
  1428.  
  1429.  
  1430.     4.2.1 PARAMETERS WITH GLOBAL SCOPE
  1431.  
  1432.     The parameters below influence the execution of Downsort, or have
  1433.     impact on every list (if it is applicable for that list).
  1434.  
  1435.   | ■  File Specification of the MAXIMUS CBCS file 'AREA.DAT'.
  1436.   | ■  Area selection by name
  1437.   | ■  Area and File selection by 'cumulative' privilege and/or Maximus'
  1438.   |    key/lock
  1439.   | ■  Explicit file exclusion
  1440.     ■  Sorting order of areas
  1441.     ■  List title with BLOCK-characters.
  1442.     ■  Pre-titles, Sub-titles and Bottom-lines in 'text' format
  1443.     ■  Descriptive text of orphans, files without a description and files
  1444.        for which an entry is found in FILES.BBS, but could not be found in
  1445.        the corresponding download directory.
  1446.  
  1447.  
  1448.  
  1449.     4.2.2 PARAMETERS WITH LOCAL SCOPE
  1450.  
  1451.     The parameters below are sub-parameters of the xxxFileList keyword.
  1452.  
  1453.   | ■  List privilege
  1454.   | ■  Userkeys for a list
  1455.     ■  Alternate output filename (in stead of the default Downsort).
  1456.     ■  Directory for the output FILES.BBS-lists
  1457.     ■  Maximum number of file entries in NEW- and BBS-list
  1458.     ■  File-entry sort sequence (filename or date).
  1459.     ■  Wrap or Truncate long file descriptions, and Indentation of
  1460.        continuation lines.
  1461.     ■  Title Font selection.
  1462.     ■  Suppression of privilege indications.
  1463.     ■  Include textfile in NEW-, ALL-, IPF- and GBL-lists, and in
  1464.        FILES.bbs.
  1465.  
  1466.   | Downsort can generate any number of lists in a single run.  If you are
  1467.   | clever with Maximus key/lock manipulations, you will master Downsort
  1468.   | quickly to make the proper selections.
  1469.  
  1470.     A sample configuration file is provided.  A listing of this file is
  1471.     imbedded as "Appendix D.  Sample Configuration File" on page 47.  It
  1472.     contains a complete specification with comments on:
  1473.  
  1474.     ■  which options are available
  1475.     ■  how to specify the options
  1476.  
  1477.     Read and modify the file as you like.  Copy the sample file to a save
  1478.     place before you start modifying the original Downsort.CFG!
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.                                                Parameter Specifications  21
  1488.  
  1489.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1490.  
  1491.  
  1492.  
  1493.     4.3 COMPILING THE IPF LISTS
  1494.  
  1495.     IPF-lists have to be processed by the Information Presentation Facility
  1496.     Compiler (IPFC).  This compiler is part of the IBM Programmers
  1497.     Development Toolkit version 1.2/1.3.  For the IP2-list the IBM OS/2 2.0
  1498.     or 2.1 Toolkit is needed.  The following command has to be issued:
  1499.  
  1500.         IPFC  Downsort.IPF  /INF
  1501.  
  1502.     The option "/INF" is needed to obtain a VIEWable file, if not specified
  1503.     a .HLP file will be generated.  Be sure to have the file Downsort.BMP
  1504.     in your current default directory, or in DPATH, as this will be
  1505.     imbedded by the IPF-compiler.  The result of the compilation is a file
  1506.     Downsort.INF, which can be VIEWed with the following command:
  1507.  
  1508.         VIEW  Downsort
  1509.  
  1510.     The names "Downsort", "IPF" and "INF" are used here as sample, actually
  1511.     the filename depends on the specification in the Downsort configuration
  1512.     file, the extensions are the IPFC defaults.
  1513.  
  1514.     If VIEW gives garbled columns and hardly readable block-titles, then it
  1515.     is most likely that you did not install (or removed) the standard fonts
  1516.     that are delivered with OS/2.  Start the 'control panel utility',
  1517.     select 'installation', 'add fonts'.  Specify in the 'from'-field
  1518.     C:\OS2\DLL (see HELP of control panel).  Now choose at least 1
  1519.     non-proportional font.
  1520.  
  1521.     Note: IPFC has a number of restrictions that you may encounter,
  1522.     especially when you try to compile large lists:
  1523.  
  1524.     ■  A "Page is too big" message, generally resulting in other errors or
  1525.        warnings to appear as well, means that the 16000 words limit is
  1526.        exceeded.  A file may not contain more than 16000 different items
  1527.        (character strings between blanks or punctuation marks).  There is
  1528.        nothing else you can do than make the list smaller (see "3.4 Data
  1529.        Selection" on page 12 for suggestions).  Sometimes a TRAP 000D
  1530.        occurs with very big lists if you ignore these error messages.
  1531.     ■  Sometimes also "invalid nesting of :cgraphics tag" is displayed.
  1532.        Just ignore these!
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.                                                Parameter Specifications  22
  1551.  
  1552.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1553.  
  1554.  
  1555.  
  1556.     5.0 SAMPLE OF GETTING ORGANISED
  1557.  
  1558.     Assume you are runnung MAXIMUS with BinkleyTerm as front end mailer.
  1559.     Suppose you make a distinction for file-requestors between Unknown,
  1560.     Known and Password-Protected (e.g. corresponding to Disgrace, Normal
  1561.     and Privileged MAXIMUS users).
  1562.  
  1563.  
  1564.     5.1 DOWNSORT
  1565.  
  1566.   | Your downsort.cfg file might contain among others the following
  1567.   | specifications:
  1568.  
  1569.   |   BBSFileList  p     3W
  1570.   |   NEWFileList  d     2m
  1571.   |   NEWFileList  n     2m
  1572.   |   NEWFileList  p     2m
  1573.   |   ALLFileList  d
  1574.   |   ALLFileList  n
  1575.   |   ALLFileList  p
  1576.   |   OKFileList   p
  1577.   |   OKFileList   n
  1578.   |   OKFileList   d
  1579.  
  1580.     This specification will produce the following lists:
  1581.  
  1582.     ■  Downsort.BBS with the last three weeks additions to your system, for
  1583.        users of category Privil.  Note: Users with a lower privilege will
  1584.        actually see a shorter list if the file contains Privil entries,
  1585.        since each line contains a privilege control sequence.
  1586.  
  1587.     ■  For file requests of the magic filename NEWFILES a list of the last
  1588.        2 months additions to your system.
  1589.        ∙  Downsort.N~D for UNKNOWN file-requestors
  1590.        ∙  Downsort.N~N for KNOWN file-requestors
  1591.        ∙  Downsort.N~P for Password Protected file-requestors
  1592.  
  1593.        Note that each NEW-list contains only the most recent files, but the
  1594.        contents will generally not be quite the same (depending on your
  1595.        privilege strategy).
  1596.  
  1597.     ■  For file requestors of the magic filename FILES a list, a list with
  1598.        all files (with optional titles via Downsort.CFG specifications):
  1599.        ∙  Downsort.A~D for UNKNOWN file-requestors
  1600.        ∙  Downsort.A~N for KNOWN file-requestors
  1601.        ∙  Downsort.A~P for Password Protected file-requestors
  1602.  
  1603.        Note that each list is a complete list of what is available to the
  1604.        user of the specific privilege class, but your system will generally
  1605.        contain more files than listed for UNKNOWN and KNOWN users!
  1606.  
  1607.     ■  For your mailer you'll have:
  1608.        ∙  Downsort.O~D for UNKNOWN file-requestors
  1609.        ∙  Downsort.O~N for KNOWN file-requestors
  1610.        ∙  Downsort.O~P for Password Protected file-requestors
  1611.  
  1612.  
  1613.                                             Sample of Getting organised  23
  1614.  
  1615.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1616.  
  1617.  
  1618.  
  1619.     In general: files, which the requestor is not supposed to know about
  1620.     due to his privilege status, will not be on his/her list!
  1621.  
  1622.     Note: The counters on top of the lists indicate what your system has
  1623.     available in total (including higher privileges), so a clever
  1624.     user/file-requester may come up with the question how that is possible:
  1625.     explain that he/she has to earn a higher privilege level!
  1626.  
  1627.  
  1628.     5.2 BINKLEYTERM
  1629.  
  1630.     In Binkley.Cfg you should specify for requests of FILES:
  1631.  
  1632.       Avail        Downsort.A~d
  1633.       KnownAvail   Downsort.A~n
  1634.       ProtAvail    Downsort.A~p
  1635.  
  1636.     Furthermore you need to specify different OKFILEs, for example:
  1637.  
  1638.   |   OKFile       Downsort.O~d
  1639.   |   KnownReqList Downsort.O~n
  1640.   |   ProtReqList  Downsort.O~p
  1641.  
  1642.     In each of the appropriate filerequest authorisation files you should
  1643.     specify the appropriate file-spec:
  1644.  
  1645.  
  1646.      ╔═══════════╦══════════════╦═══════════════╦═══════════════╗
  1647.      ║       in: ║ OKFile       ║ KnownReqList  ║ ProtReqList   ║
  1648.      ║           ║ (Download.N) ║ (Download.K)  ║ (Download.P)  ║
  1649.      ║ for:      ║              ║               ║               ║
  1650.      ╠═══════════╬══════════════╬═══════════════╬═══════════════╣
  1651.      ║ .....     ║ .........    ║ ...........   ║  ........     ║
  1652.      ║ @NEWFILES ║ Downsort.N~d ║ Downsort.N~n  ║  Downsort.N~p ║
  1653.      ║ @FILES    ║ Downsort.A~d ║ Downsort.A~n  ║  Downsort.A~p ║
  1654.      ║ .....     ║ .........    ║ ...........   ║  ........     ║
  1655.      ╚═══════════╩══════════════╩═══════════════╩═══════════════╝
  1656.  
  1657.     This will result in sending of the appropriate NEW-list to every
  1658.     requester of the magic filename: NEWFILES.  If you use the second magic
  1659.     filename, then the Avail-lines in Binkley.Cfg are not needed, and you
  1660.     might prefer this way.
  1661.  
  1662.     Of course if the privilege level of all download area's is the same,
  1663.     this construction is not needed, but in that case it is unlikely that
  1664.     you have specified KnownAvail and ProtAvail!
  1665.  
  1666.     Downsort may create a set of OK-files for you.  The privilege system of
  1667.     MAXIMUS CBCS is used to select the download paths in this list.
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.                                             Sample of Getting organised  24
  1677.  
  1678.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1679.  
  1680.  
  1681.  
  1682.     6.0 PACKAGING
  1683.  
  1684.  
  1685.  
  1686.     6.1 AVAILABILITY
  1687.  
  1688.     The most recent version of Downsort is always downloadable and
  1689.     file-requestable from Bulletin Board "PC-Square" of the Dutch IBM
  1690.     employee PC club.  Search or request DWNSRT??.* to be independent of
  1691.     the version and compression method!
  1692.  
  1693.   | FIDO-net address:  2:512/4; phone:  31-79-424107 (USR HST-DS).
  1694.  
  1695.   | Downsort is originally distributed in area FWBBS of the Fernwood
  1696.   | collection, and may also be distributed via SDSMAX.
  1697.  
  1698.     There is a fair chance you may find a recent version on one of the
  1699.     other bulletin boards, listed in "Appendix B.  World-wide use of
  1700.     Downsort" on page 42.
  1701.  
  1702.     Downsort is distributed in 2 archives:
  1703.  
  1704.     ■  A file "DWNSRTxy.ZIP", containing all material you need to run
  1705.        Downsort, including documentation, formatted for browsing or
  1706.        printing (formfeed is the only printer-control).
  1707.  
  1708.     ■  A file "DWNSRSxy.ZIP", containing all SOURCE material.
  1709.  
  1710.     Note: 'xy' is the version indication, for example DWNSRT59.ZIP is the
  1711.     version 5.9 runtime package.
  1712.  
  1713.  
  1714.     6.2 RUN-TIME MATERIAL
  1715.  
  1716.     WHATSNEW.59         Summary of amendments to version 5.9 of Downsort.
  1717.     DOWNSORT.EXE        Execution module for OS/2 and DOS (Family
  1718.                         Application)
  1719.     DOWN386.EXE         32-bits execution module for OS/2 (2.0 and higher).
  1720.     DOWN386.ICO         ICON file for DOWN386.EXE.
  1721.     DOWNSORT.DOC        Documentation (this file!).
  1722.     DOWNSORT.CFG        Sample configuration file.  This file contains
  1723.                         comment lines with extensive instructions how to
  1724.                         specify the parameters in the file.
  1725.     DOWNSORT.HDR        Sample BBS-list header.  You may use this header,
  1726.                         which is only imbedded in the BBS-list, to imbed
  1727.                         text and/or MECCA-sequences.  A good candidate for
  1728.                         the latter would be [onexit], which translates to
  1729.                         ^OFpath.  See the sample Downsort.HDR file!
  1730.     DOWNSORT.TRL        Sample BBS-list trailer.
  1731.     DOWNSORT.BMP        Bitmap for the IPF-list, to be included by the IPF
  1732.                         compiler.
  1733.     DOWNSORT.INC        Sample Include-file for the reports, referenced in
  1734.                         Downsort.CFG.
  1735.     DOWNSORT.MAG        Sample list of magic names to be included in
  1736.                         OKFile(s).  See BinkleyTerm documentation for
  1737.  
  1738.  
  1739.                                                               Packaging  25
  1740.  
  1741.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1742.  
  1743.  
  1744.  
  1745.                         details of its format and contents.
  1746.     HPFSDATE.EXE        Program to display all three timestamps of a file
  1747.                         on an HPFS volume, and optionally reset the
  1748.                         CREATION date to LASTWRITE date (helpful after
  1749.                         moving or copying of files).  Start the program
  1750.                         without options to display command syntax and help.
  1751.                         A 32-bits version for OS/2 2.0+ is included with
  1752.                         the name HPFSD386.EXE.
  1753.     PACKING.LST         The actual contents of the package (produced with
  1754.                         PKUNZIP -V), added to the ZIP-file after this was
  1755.                         created with the foregoing files of this archive.
  1756.                         This gives at least some authentication!
  1757.  
  1758.  
  1759.  
  1760.     6.3 SOURCE MATERIAL
  1761.  
  1762.     DOWNSORT.C          Mainline.
  1763.     DOWNCOL.C           Data collection functions.
  1764.     DOWNFNT.C           Font definition and formatting functions.
  1765.     DOWNPAR.C           Processing functions for commandline and
  1766.                         Downsort.CFG parameters.
  1767.     DOWNRPT1.C          Functions for NEW-, BBS- and EMI-list.
  1768.     DOWNRPT2.C          Functions for the IPF-lists.
  1769.     DOWNRPT3.C          Functions for the SYSOP-oriented lists, like
  1770.                         ORPhan-, OK-, and DUPlicate-lists, as well as
  1771.                         FILES.BBS files.
  1772.     DOWNRPT4.C          Functions for the ALL- and GBL-lists.
  1773.     DOWNSRV.C           Miscellaneous services functions.
  1774.     DOWNVARS.C          Constants and global variables.
  1775.     DOWNSORT.H          Header file, with external definitions of global
  1776.                         variables.
  1777.     DOWNFPRO.H          Common (global) function prototypes.
  1778.     DOWNSORT.SCR        Unformatted documentation file.  This file includes
  1779.                         formatting tags in BOOKMASTER style for printing on
  1780.                         whatever devices are supported (like IBM page
  1781.                         printers).  This format is compatible and can be
  1782.                         formatted on an IBM host system with DCF (SCRIPT)
  1783.                         as well.  The file can also processed by the
  1784.                         IPF-compiler (just ignore the warnings and
  1785.                         error-messages!).
  1786.     DOWNSORT.DEF        LINK definition file for OS/2 (1.3 and 2.0+)
  1787.     DOWN386.MAK         MAKE file for DOWN386.EXE with OS/2 2.1, C/C++
  1788.                         Tools Version 2 and OS/2 2.1 Toolkit.
  1789.     DOWNSORT.MAK        MAKE file for DOWNSORT.EXE OS/2 1.3, MS C-compiler
  1790.                         6.00a.  The program development toolkit (OS/2
  1791.                         1.2/1.3) is needed when using IBM C/2 1.1 compiler.
  1792.     PACKING.LST         The actual contents of the package (produced with
  1793.                         PKUNZIP -V), added to the ZIP-file after this was
  1794.                         created with the foregoing files of this archive.
  1795.                         This gives at least some authentication!
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.                                                               Packaging  26
  1803.  
  1804.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1805.  
  1806.  
  1807.  
  1808.     6.4 INSTALLATION
  1809.  
  1810.     With the following directions you should be able to setup and run
  1811.     Downsort in a very short time.
  1812.  
  1813.     1. Make a separate directory for Downsort, and make it the current
  1814.        default directory every time you run Downsort.  The separate
  1815.        directory is a recommendation, not a requirement!
  1816.  
  1817.     2. Copy the files Downsort.EXE and Downsort.CFG from the Downsort
  1818.        package into this directory.
  1819.  
  1820.     3. Modify (edit) the file Downsort.CFG to specify your environment and
  1821.        list requirements.  The sample file contains comments to help you
  1822.        with this process.  Most specifications are obvious.  AreaDat is the
  1823.        most important parameter: Downsort won't do anything useful thing if
  1824.        it cannot find this MAXIMUS file.  See "Appendix D.  Sample
  1825.        Configuration File" on page 47 for a printed sample.
  1826.  
  1827.     4. You may give Downsort a first shot by just using its name on the
  1828.        commandline, with the command parameter -H.  This will show a brief
  1829.        HELP-screen with the possible commandline parameter specifications.
  1830.  
  1831.     5. All reports will be created in the Downsort directory (unless you
  1832.        specified 'fpath' for the FILES.BBS output).  Browse the lists to
  1833.        see if you like the contents and titles, and modify the CFG-file to
  1834.        your convenience.
  1835.  
  1836.  
  1837.  
  1838.     6.5 DEPENDENCIES AND RESTRICTIONS
  1839.  
  1840.     ■  Applies to MAXIMUS CBCS 2.0
  1841.  
  1842.     ■  Requires OS/2 or DOS 3.0+.
  1843.  
  1844.     ■  To convert the IPF-list into VIEW-able format, the IPF-Compiler of
  1845.        the OS/2 Program Development Toolkit is required (for the IP2-list
  1846.        the corresponding OS/2 2.0 or 2.1 version of this compiler)
  1847.  
  1848.     ■  The input FILES.BBS files are assumed to contain only filename.ext
  1849.        (the regular 8.3 format, no support for OS/2 HPFS extended format),
  1850.        the remainder of the line is considered as file description.  The
  1851.        filename should be left-aligned (start in position 1).
  1852.  
  1853.        If a privilege modifier (^Px) is encountered in FILES.BBS then 'x'
  1854.        will become the privilege of all subsequent files (it assumes ^Px on
  1855.        a SEPARATE line, the REST OF THE LINE IS IGNORED!).  Heading,
  1856.        comments and blank lines in FILES.BBS are ignored, unless /K is
  1857.        specified on the FilFileList line of Downsort.Cfg.  In that case
  1858.        comments following line 8 (the standard header created by Downsort)
  1859.        or headerlines from a previous run are preserved.  The modified
  1860.        privilege might be higher (generally the case) or lower than the
  1861.        area-privilege.
  1862.  
  1863.  
  1864.  
  1865.                                                               Packaging  27
  1866.  
  1867.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1868.  
  1869.  
  1870.  
  1871.     6.6 STORAGE AND PERFORMANCE
  1872.  
  1873.     As a rough estimate of the memory requirements of Downsort, use sum of
  1874.     the following elements:
  1875.  
  1876.     ■  Program: about 100KB
  1877.  
  1878.     ■  Each area: 300 Bytes
  1879.  
  1880.     ■  Each file: 48 Bytes for each download file (excluding file
  1881.        descriptions and excluding orphans if no orphan-list requested)
  1882.  
  1883.     ■  The sum of the file description texts (average 80 bytes/file?)
  1884.  
  1885.     ■  The sum of the comments in FILES.BBS if -K option specified
  1886.  
  1887.     If you hit a memory shortage (only applicable wiht DOS!), then you
  1888.     could do one or more of the following:
  1889.  
  1890.     ■  Use AreaEXclude or AreaINclude to make a selection of groups (for
  1891.        example make separate OS/2 and a DOS file-lists).  Downsort will not
  1892.        collect information of 'excluded' areas.
  1893.     ■  If you have many orphans: get rid of them or do not generate an
  1894.        orphan report.  Downsort releases orphan-memory during the data
  1895.        collection phase as soon as it knows that a file is an orphan.
  1896.     ■  If you have many comment-lines in your FILES.BBS: do not specify /K
  1897.        for ALL- and IPF-lists AND do not activate the FILFilePath parameter
  1898.        in Downsort.Cfg.  Downsort will ignore comments in FILES.BBS when it
  1899.        does not need them for reporting.
  1900.  
  1901.  
  1902.  
  1903.     6.7 PROBLEMS
  1904.  
  1905.     Although I try to prevent the cause of them, there are some unresolved
  1906.     problems in the current version of Downsort:
  1907.  
  1908.     ■  Currently no unresolved problems are known.
  1909.  
  1910.  
  1911.  
  1912.     6.8 WISHLIST
  1913.  
  1914.     Downsort is not finished!  There are a number of wishes and
  1915.     requirements of users and myself to include in future releases.  I list
  1916.     them below not in any particular order, but some seem to be more
  1917.     important than others, that differs from SYSOP to SYSOP.  And some are
  1918.     more easy to implement than others, which depends mainly on the author!
  1919.     Some wishes don't even make it to be listed below and are implemented
  1920.     immediately!
  1921.  
  1922.     ■  Follow the MAXIMUS development (changing AREA.DAT and other
  1923.        structures), and support several versions simultaneously.
  1924.     ■  User-configurable options for:
  1925.        ∙  week and month indicators
  1926.  
  1927.  
  1928.                                                               Packaging  28
  1929.  
  1930.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1931.  
  1932.  
  1933.  
  1934.        ∙  indicator for continuation lines in wrapped descriptions
  1935.        ∙  [selectable] MECCA control in FILES.BBS
  1936.     ■  Logging to file in stead of stdout to obtain a history file of
  1937.   |    Downsort usage.  (may be done wiht redirection!).
  1938.     ■  Support for use of 'barricaded' areas.
  1939.     ■  List with the format of IPF-list but the contents of NEW-list.
  1940.     ■  Automatic removal of 'bad' files (like .BAK-files, obsolete files,
  1941.        files that are not in FILES.BBS), maybe move them to a special
  1942.        BAD_FILE directory.  Entries in FILES.BBS should be removed
  1943.        accordingly.
  1944.  
  1945.     Remember: Was there ever a time that all your wishes were fulfilled?
  1946.     That was the most boring time of your life, wasn't it?
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.                                                               Packaging  29
  1992.  
  1993.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  1994.  
  1995.  
  1996.  
  1997.     7.0 INTERNALS
  1998.  
  1999.  
  2000.  
  2001.     7.1 DEVELOPMENT ENVIRONMENT
  2002.  
  2003.     The family-version of Downsort (for OS/2 1.3 and DOS) is compiled with
  2004.     MicroSoft C compiler version 6.00a, with the IBM OS/2 Programming Tools
  2005.     and Information (generally called the OS/2 Toolkit) under IBM OS/2
  2006.     Extended Edition 1.3 as COMPACT memory model.  The generated code is at
  2007.     80286 level (Compiler option /G2), since I believe that only very few
  2008.     Bulletin Boards do use an XT these days.
  2009.  
  2010.     The 32-bit OS/2 2.0+ only version of Downsort is compiled with IBM
  2011.     C/C++ Tools version 2 and the OS/2 2.1 Toolkit.
  2012.  
  2013.     There is only a single set of source files.  A compiler variable takes
  2014.     care of the selection between 1.3 and 2.1 calls where necessary.
  2015.  
  2016.     Downsort has been tested for MAXIMUS CBCS 2.0, with the following
  2017.     Operating Systems:
  2018.  
  2019.     ■  IBM OS/2 versions 1.3 and 2.1
  2020.     ■  IBM PC/DOS version 6.1
  2021.  
  2022.  
  2023.  
  2024.     7.2 PROGRAM ORGANISATION
  2025.  
  2026.     The program is organised as follows:
  2027.  
  2028.     ■  Initialisation:
  2029.        ∙  Read configuration file.
  2030.        ∙  Process commandline parameters.
  2031.  
  2032.        Commandline parameters may override configuration file parameters.
  2033.  
  2034.     ■  Read AREA.DAT file to collect download pathnames (only of those
  2035.        area's that will participate this time).
  2036.  
  2037.     ■  For each file-area with a privilege not exceeding any list-request:
  2038.  
  2039.        ∙  Read subdirectory (with find-file-first/next function).  Take
  2040.           only Normal files: ignore directory entries, Hidden and System
  2041.           files and volume labels.  Also ignore files with the following
  2042.           specifications: FILES.*, *.BAK, DIR.?BS and SYSTEM*.?BS.
  2043.  
  2044.        ∙  For all regular file-entries found in subdirectory:
  2045.           -  Get filename.ext, attribute, date, time, size.
  2046.           -  Get file-description from FILES.BBS file.  The path to the
  2047.              FILES.BBS file is (1) obtained from the "ListFile"
  2048.              specification in MAXIMUS AREA.DAT file, or (2) if not
  2049.              specified from the "DownLoad" specification (among the
  2050.              download files).
  2051.           -  Add files with explicit path specifications.
  2052.  
  2053.  
  2054.                                                               Internals  30
  2055.  
  2056.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2057.  
  2058.  
  2059.  
  2060.           -  Get file privilege 1) from area, 2) from FILES.BBS file if
  2061.              higher.
  2062.           -  When no orphan reporting is required, then drop orphan entries
  2063.              area-by-area.
  2064.  
  2065.     ■  For the ORP-list:
  2066.  
  2067.        If any orphan found, and the orphan-report is requested, create the
  2068.        orphan report, with the file-entries sorted on (1) area and (2)
  2069.        filename.
  2070.  
  2071.     ■  For the BBS-list:
  2072.        ∙  Sort the files primarily on descending file-timestamp (and
  2073.           secundary on file-name and area-code).
  2074.        ∙  Resort the first files on filename if requested.
  2075.        ∙  Create output file for sorted list of filenames, -descriptions,
  2076.           etc.  The file is placed in the current subdirectory (which
  2077.           generally will be the MAXIMUS directory) with the name
  2078.           Downsort.BBS.
  2079.        ∙  Copy a headerfile (for a customised MAXIMUS bulletin).
  2080.        ∙  Put files in formatted outputfile (filename, area#, date, size,
  2081.           description), but only if description is found in FILES.BBS.
  2082.           Skip files with privilege higher than commandline (or default)
  2083.           parameter.  Precede each line with a privilege-control sequence
  2084.           (^PLx string) so that MAXIMUS users below the specified
  2085.           max-priv-level do effectively see only the files they can
  2086.           download.
  2087.        ∙  Include a trailerfile in the outputfile (for a custimised
  2088.           Bulletin).
  2089.        ∙  Report non-listed files on standard output device (which might be
  2090.           re-directed to printer or disk-file).
  2091.  
  2092.     ■  If requested, put the above file collection in Downsort.N~p with
  2093.        similar contents and layout as Downsort.BBS, but without BBS-control
  2094.        sequences, and without including a header and trailer file.  Produce
  2095.        a list for the default privilege (HIDDEN), or one for each specified
  2096.        privilege.
  2097.  
  2098.     ■  If requested, re-sort files on area and then filename or date, and
  2099.        create Downsort.A~p, containing all files (respecting the privilege
  2100.        restrictions!).  Area's with zero files within the applicable
  2101.        privilege limit will not be listed at all (will seem non-existing!).
  2102.        Produce a list for the default privilege (SYSOP), or one for each
  2103.        specified privilege.
  2104.  
  2105.        At the end of the list, an area summary report is generated.
  2106.  
  2107.     ■  If requested, re-sort files on filename or date only, and create
  2108.        Downsort.GBL.
  2109.  
  2110.     ■  If requested, re-sort files on area, privilege and filename, and
  2111.        create for each area a FILES.BBS-type of file.
  2112.  
  2113.     ■  If requested generate a list of probably DUPlicate files.
  2114.  
  2115.  
  2116.  
  2117.                                                               Internals  31
  2118.  
  2119.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2120.  
  2121.  
  2122.  
  2123.     ■  If requested generate a list of download-paths: the OK-file (not: it
  2124.        will contain only the paths that participated in this run.
  2125.  
  2126.     NOTE: the program firstly reads a directory for existing files (not
  2127.     Hidden- or System-files, and not Subdirectory or Volumelabel), and then
  2128.     reads FILES.BBS to assign a description to each file.  This means:
  2129.  
  2130.     ■  If more than 1 matching file-specification in FILES.BBS of the
  2131.        involved area is found (note that wild-card specifications in
  2132.        FILES.BBS are supported!), than the first matching description from
  2133.        FILES.BBS will appear in the lists (new in version 4.5, was 'last'
  2134.        in previous versions of Downsort).
  2135.     ■  Files for which no description is found in FILES.BBS will get "---no
  2136.        description available---" (or the replacement string you specified
  2137.        in Downsort.CFG) in the user reports.
  2138.     ■  Files for which no matching filename in FILES.BBS is found will be
  2139.        listed in the Orphan report (Downsort.ORP).
  2140.  
  2141.        Files for which there is an entry in FILES.BBS, but a corresponding
  2142.        file is not found in the directory will be reported as 'offline'.
  2143.  
  2144.        In special cases this might become a very large list.  For example
  2145.        if you collect files in a single directory for different area's, all
  2146.        the files of 'the other' areas are reported as orphan.  This will
  2147.        happen for every area, so each file might even be reported many
  2148.        times as orphan!  Since the Orphan-list is now optional (from
  2149.        version 5.0 on), this list can be suppressed.
  2150.  
  2151.        Filenames of Orphans appear only in the other reports when the
  2152.        FileList request explicitly specifies the Hidden privilege.
  2153.  
  2154.  
  2155.  
  2156.     7.3 MAIN DATA ORGANISATION
  2157.  
  2158.  
  2159.  
  2160.     7.3.1 AREA AND FILE INFORMATION
  2161.  
  2162.     Data structure for access to file information via:
  2163.  
  2164.     1. array of file-pointers (for file-sort!)
  2165.     2. pointerchain in file-info structures
  2166.     3. file structure contains pointer to file-description
  2167.     4. file-structure contains pointer to area-information
  2168.     5. Array of area-information
  2169.  
  2170.     The organisation is shown in the following figure.
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.                                                               Internals  32
  2181.  
  2182.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2183.  
  2184.  
  2185.  
  2186.  
  2187.     ╔══════╗
  2188.     ║  dm  ║
  2189.     ╚══════╝
  2190.         │         Array of pointers to structures with file info
  2191.         │      ╔═══════════╦════════════╦═════════════ . . . ══════╗
  2192.     (1) └─────>║ *file[0]  ║  *file[1]  ║ *file[2]                 ║
  2193.                ╚═══════════╩════════════╩═════════════ . . . ══════╝
  2194.                      │           │            │
  2195.     (2)              v           v            v
  2196.     ╔══════╗     ╔══════╗     ╔══════╗     ╔══════╗
  2197.     ║  ca  ║ ──> ║ next ║ ──> ║ next ║ ──> ║ next ║ ──> . . .
  2198.     ╚══════╝     ╠══════╣     ╠══════╣     ╠══════╣
  2199.      (first-     ║ file-║     ║ file-║     ║ file-║
  2200.      element)    ║ info ║     ║ info ║     ║ info ║    . . .
  2201.                  ║ [0]  ║     ║ [1]  ║     ║ [2]  ║
  2202.                  ╚══════╝     ╚══════╝     ╚══════╝
  2203.                      │ │         │  │wildcards│ │
  2204.                      │ └──┐      │  └──┐      │ │
  2205.                      │    │      │ ┌──────────┘ │
  2206.     (3)              v    │      v v   │ ┌──────┘
  2207.                  ╔══════╗ │   ╔══════╗ │ │
  2208.                  ║file- ║ │   ║file- ║ │ │(files of
  2209.                  ║descr ║ │   ║descr ║ │ │ same area)   . . .
  2210.                  ╚══════╝ │   ╚══════╝ │ │
  2211.                           │            │ │
  2212.     (4)                   v            v v
  2213.                   ╔════════════╦═════════════╦════════ . . . ══════╗
  2214.     (5) ┌────────>║  area[0]   ║   area[1]   ║                     ║
  2215.         │         ╚════════════╩═════════════╩════════ . . . ══════╝
  2216.         │              array of structures of area information
  2217.     ╔══════╗
  2218.     ║ area ║
  2219.     ╚══════╝
  2220.  
  2221.     Schematic overview of Downsort's in-storage database.
  2222.  
  2223.     Note: The area-array cannot be sorted itself: this would invalidate the
  2224.     pointers in the file-information records!
  2225.  
  2226.  
  2227.     7.3.2 BLOCK FONTS
  2228.  
  2229.     The block character image is basically a 10x7 matrix (10 vertical and 7
  2230.     horizontal 'pixels').  The pixel-array takes two rows at a time, so
  2231.     that each character can be represented with 5 rows of 7 horizontal
  2232.     'double-pixels'.  Each pixel is displayed as a solid block.
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.                                                               Internals  33
  2244.  
  2245.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2246.  
  2247.  
  2248.  
  2249.              1 2 3 4 5 6 7
  2250.             ╔═╦═╦═╦═╦═╦═╦═╗
  2251.             ║-║-║-║-║-║-║-║   line 1    (lower + upper)
  2252.             ╠═╬═╬═╬═╬═╬═╬═╣
  2253.             ║-║-║-║-║-║-║-║        2    (lower + upper)
  2254.             ╠═╬═╬═╬═╬═╬═╬═╣
  2255.             ║-║-║-║-║-║-║-║        3    (lower + upper)
  2256.             ╠═╬═╬═╬═╬═╬═╬═╣
  2257.             ║-║-║-║-║-║-║-║        4    (lower + upper)
  2258.             ╠═╬═╬═╬═╬═╬═╬═╣
  2259.             ║-║-║-║-║-║-║-║        5    (lower + upper)
  2260.             ╚═╩═╩═╩═╩═╩═╩═╝
  2261.  
  2262.     Each line is represented by a structure of seven 3-bit fields Each
  2263.     3-bit field represents a basic element:
  2264.  
  2265.      value    char       description
  2266.        0                 (blank)
  2267.        1     &BOXBOT.           lower half
  2268.        2       &BOXTOP.         upper half
  2269.        3         &BOX.       lower+upper halves
  2270.        4       &box34.         gray pattern
  2271.        5     &BOXLEFT.           left part of upper and lower half
  2272.        6       &BOXRIGHT.         right part of upper and lower half
  2273.        7         &box14.       gray pattern
  2274.        8      &box12.          gray pattern for not-supported characters
  2275.  
  2276.     The pitch is variable ('proportional font': a variable number of
  2277.     horizontal pixels).  Four fonts are provided with different
  2278.     character-image and size:
  2279.  
  2280.     1. 6x5 (three lines of max 5 characters)
  2281.     2. 10x7 (five lines of max 7 characters)
  2282.     3. 8x7 (four lines of max 7 characters)
  2283.     4. 10x7 (reverse video image of the 8x7 font)
  2284.  
  2285.     The following characters are supported in block-fonts:
  2286.  
  2287.        UPPER case  A..Z
  2288.        LOWER case  a..z  (but will be presented in UPPER case)
  2289.        Digits 0..9
  2290.        _  *  |  .  [  ]  (  )  /  \  -  and space
  2291.        Not-supported characters are displayed as blank.
  2292.        The '~'-character (tilde) represents a full width space,
  2293.        the '`'-character (reverse quote) a half width space.
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                                               Internals  34
  2307.  
  2308.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2309.  
  2310.  
  2311.  
  2312.     APPENDIX A.  HISTORY OF CHANGES
  2313.  
  2314.     The paragraphs below show a brief history of changes in Downsort (most
  2315.     recent revisions on top of list!).
  2316.  
  2317.     Downsort for MAXIMUS CBCS was developed from an OPUS equivalent (by the
  2318.     same author).  Its pre-MAXIMUS history is not really important here and
  2319.     therefore has been removed.  However the name Downsort has been
  2320.     maintained, so to prevent confusion, the version number is inherited
  2321.     (the last version for OPUS was 3.1).
  2322.  
  2323.  
  2324.     8.1 VERSION 5.9
  2325.  
  2326.     Please read also the commentlines marked '5.9' in Downsort.Cfg!
  2327.  
  2328.     ■  Considerable changes in parameter specifications:
  2329.        ∙  Support of most commandline parameters removed!
  2330.        ∙  Support for keywords 'MaxNewFiles' and 'TitleFont' in
  2331.           Downsort.Cfg also removed: use xxxFileList for individual
  2332.           specifications for each list.
  2333.        ∙  Multiple 'xxxFileList' lines in Downsort.Cfg are supported now:
  2334.           -  You may now specify as many xxxFileLists with the same(!) or
  2335.              different list types as you need.
  2336.           -  Each xxxFileList, regardless of same or different list, will
  2337.              generate one and only one list according to its own set of
  2338.              parameters.
  2339.           -  Only a single privilege is now accepted per xxxFileList line,
  2340.              but this may now be accompanied by 'userkeys'; specification
  2341.              in the form: p/kkk.
  2342.        ∙  File sort sequence (GROUP-sort) added for NEWFileList: primary
  2343.           sort on area, then on filename.  Each group will be preceeded in
  2344.           the list by a line with areaname and description.  GROUP-sort
  2345.           works also for ORPHAN-lists, but is for all other lists synonym
  2346.           with ALPHA.
  2347.     ■  The contents of ALLFileList can now be limited by file-age, so it
  2348.        can be called a NEWFileList in the format of ALLFileList or vice
  2349.        versa.  But the SUMMARY-report ignores the file age limitation!
  2350.     ■  FILES.BBS-files will be (re-)generated also when area does not
  2351.        contain any files.
  2352.     ■  Full support of Maximus' key/lock mechanism for filearea selection.
  2353.        Key-characters follow the xxxFileList privilege, separated with a
  2354.        slash, exactly the same as the area privilege specification in
  2355.        MAX.CTL.  The privilege line in area heading will now also show the
  2356.        arealocks.
  2357.     ■  With the new keyword 'FileEXclude' you can define filespecs (with
  2358.        wildcards) of files which should not appear in any list.
  2359.     ■  Tired of the complaints about specification limits, I removed most
  2360.        of these.  For example now unlimited number of title-lines,
  2361.        areaIN/EXclude strings, non-duplicate file extensions, xxxFileList
  2362.        lines, etc.
  2363.     ■  AreaINclude and AreaEXclude can now be used simultaneously.
  2364.     ■  Files with 'future' date will be excluded from NEW-, BBS- and
  2365.        EMI-lists (special feature for certain CDROMs!).
  2366.     ■  All block fonts now support same characterset (fonts 3 and 4 have
  2367.  
  2368.  
  2369.                                         Appendix A.  History of changes  35
  2370.  
  2371.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2372.  
  2373.  
  2374.  
  2375.        been extended with the characters supported in fonts 1 and 2), and
  2376.        specification of block-font parameter now honored in all lists.
  2377.        Default font for all lists changed to 3.
  2378.     ■  Performance improvements with sorts on filedate, and during
  2379.        directory scan (the latter only of 32-bits version).
  2380.     ■  bugfixes:
  2381.        ∙  Filedates beyond 2037(!) could cause empty BBS-, NEW- and
  2382.           EMI-FileLists.
  2383.        ∙  No 'duplicates' with only case differences in short OKList
  2384.           anymore.
  2385.     ■  Downsort's companion program HPFSDATE (and the 32-bit version
  2386.        HPFSD386) can now reset the creationdate of files also in other than
  2387.        current working directory.
  2388.  
  2389.  
  2390.  
  2391.     8.2 VERSION 5.8
  2392.  
  2393.     ■  Now an 'unlimited' number of files is supported, dependent only of
  2394.        available memory (virtual memory under OS/2!).  Limit was 16350
  2395.        files!
  2396.     ■  Continuation lines of file descriptions can now be indented, for
  2397.        example to align text when download counter fields are used in the
  2398.        description.  See Sample Downsort.Cfg file for details.
  2399.     ■  All filenames now translated to upper case and also reported in
  2400.        upper case in the lists.
  2401.     ■  Downsort's FILES.BBS 'header prefix' slightly changed for better
  2402.        screen presentation to online Maximus users.
  2403.     ■  Some cosmetic improvements in IPF-lists.
  2404.     ■  File size now reported in max 4 digits: KBytes or MBytes, depending
  2405.        on size, except in overviews.
  2406.     ■  Bug fixes:
  2407.        ∙  Several problems with 32-bits version related to occurances of
  2408.           filenames with lower case characters solved by translating
  2409.           filenames to upper case.
  2410.        ∙  Continuation lines in BBS-list will have now required
  2411.           privilege-prefix!
  2412.        ∙  Comments from FILES.BBS now correctly and completely represented
  2413.           in ALL-list, even with AVAstrip active.
  2414.        ∙  Explicit path specifications in FILES.BBS work now correctly.
  2415.  
  2416.     Note: This will be the last version with 'extended' commandline
  2417.     parameters.  List specification parameters will disappear,
  2418.     specification of a configuration file and some others, like 'run
  2419.     quiet/verbose', will remain.
  2420.  
  2421.  
  2422.     8.3 VERSION 5.7
  2423.  
  2424.     ■  A 32-bit version (OS/2 2.0+ only) added to runtime package, no
  2425.        functional differences with the family version.
  2426.     ■  ICON file DOWN386.ICO added for the 32-bit version of Downsort.
  2427.     ■  Long areanames (8 characters) are now supported in all reports.
  2428.     ■  Changed naming convention of 'FILES.BBS' output files when area's
  2429.        with 'long' (more than 3 character) names are used.
  2430.  
  2431.  
  2432.                                         Appendix A.  History of changes  36
  2433.  
  2434.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2435.  
  2436.  
  2437.  
  2438.     ■  The "FILES.BBS"-type of output (selected with FILFileList in
  2439.        Downsort.Cfg) now produces a slightly different header.  Downsort
  2440.        recognises its own header and an included-file without
  2441.        'multiplication'-effects.
  2442.     ■  Explicit path specifications of files in FILES.BBS are now
  2443.        supported.  As a consequence:
  2444.        ∙  The long format of OK-FileList will contain this explicit path in
  2445.           stead of the filearea path.
  2446.        ∙  It seems more appropriate to list the pathspec in the
  2447.           DUP-FileList rather than the file description.
  2448.        Generic filenames (wildcard specifications) are NOT supported
  2449.        (yet)!
  2450.     ■  File size and date can be included in FILES.BBS output with the '-L'
  2451.        option on the FILFileList line in Downsort.Cfg.
  2452.     ■  A new keyword 'NonDupEXT' allows suppression of reporting a file as
  2453.        'duplicate' when it is a member of a pair of files with specified
  2454.        extensions.  Example xyz.SDN and xyz.SDA can be excluded from
  2455.        DupFileList.
  2456.     ■  Doc-file now also included as provisional .INF file for OS/2 VIEW.
  2457.     ■  Improved Avatar stripping.
  2458.     ■  Bug fix for long 'new'-filelist periods (>32000 days).
  2459.     ■  Separation between progress signals (stdout) and error messages
  2460.        (stderr) and other 'internal' changes:
  2461.     ■  Preparations made to remove most commandline parameters.  It has
  2462.        been redundant for a long time.  Every Downsort specification on the
  2463.        commandline can also be made via Downsort.Cfg.  Exception:
  2464.        Specification of a configuration file will remain possible!  Good
  2465.        arguments may change this intention, so please object if I am
  2466.        overlooking something.
  2467.  
  2468.  
  2469.  
  2470.     8.4 VERSION 5.6
  2471.  
  2472.     ■  In stead of the regular OKFile format (path\*.*), there is now also
  2473.        an option (/L) to produce a LONG format of the OKFile, containing
  2474.        explicitly all files within privilege with complete
  2475.        file-specification (path\filename.ext).  Useful for file-requests at
  2476.        systems with large directories, and especially with CDROM's.  With
  2477.        this option in effect, the *.* entries will not be generated, so
  2478.        file requests are only honored with EXACT filenames: wildcard
  2479.        specifications do not work anymore!
  2480.     ■  Improved display of long areanames (>3 char) in ALL- and IPF-lists.
  2481.     ■  Avatar codes may be stripped from comment lines in reports.
  2482.     ■  Missing include-files are now only reported when running Downsort in
  2483.        -V(erbose) mode.
  2484.     ■  Some bug fixes (some of them causing Trap 000D under OS/2):
  2485.        ∙  If 'downsort.cfg' not found, return code 2 is reported, and
  2486.           downsort.cfg now closed at end of file.
  2487.        ∙  Output of FILES.BBS could be erraneous when also IP2-list
  2488.           selected.
  2489.        ∙  Limit of 217 active area's now relieved (this limit was not
  2490.           documented!).
  2491.        ∙  Improved handling of parameters of FILFilePath-line in the sample
  2492.           Downsort.Cfg file.  Also the explanatory comments are revised.
  2493.  
  2494.  
  2495.                                         Appendix A.  History of changes  37
  2496.  
  2497.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2498.  
  2499.  
  2500.  
  2501.     ■  '-'-character now precedes the formfeed character in newly created
  2502.        FILES.BBS files (version 5.6h+).
  2503.     ■  Downsort source is now compilable with IBM C-Set/2 compiler and IBM
  2504.        OS/2 2.0 toolkit to obtain a real 32-bit version for OS/2 2.0+.
  2505.  
  2506.  
  2507.  
  2508.     8.5 VERSION 5.5
  2509.  
  2510.     ■  Finally(!) a sort capability for area-sequence.  Areas can now be
  2511.        presented in order of AREA.DAT ('K'eep original sequence), sorted on
  2512.        areaname ('A'lphabetically), sorted in alphanumeric ('G'roup)
  2513.        sequence or in order of areaINclude ('I').  The group-sequence is
  2514.        useful with a popular naming convention whereby the areaname starts
  2515.        with one or more letters followed by one or more digits.  Names
  2516.        starting with a digit will be sorted as if it were all numeric, and
  2517.        will be sorted accordingly.
  2518.     ■  NEW-, BBS-list and EMI-list (see below) can now also be limited in
  2519.        length by file-age (period specification in number of Days, Weeks or
  2520.        Months).
  2521.     ■  A new list-type introduced: EMI-list (new file EMIsions).  I is a
  2522.        simple list, comparable to NEW-list.  It has a more compact format,
  2523.        and gives also file-time and the file-size (in exact bytes).  It is
  2524.        especially useful to generate messages with file arrivals over the
  2525.        last period (in combination with a period specification).
  2526.     ■  Readability improvements in IP2-list.
  2527.     ■  Documentation extended with sample output for new users of Downsort.
  2528.     ■  Some bug-fixes:
  2529.        ∙  Compares of path- and area-names now case INdependent
  2530.        ∙  Memory allocation error during collection of comments in
  2531.           FILES.BBS
  2532.        ∙  Index out-of-range in report preparation phase
  2533.        ∙  Processing of /K-option for areas with FILES.BBS but otherwise
  2534.           empty.
  2535.  
  2536.  
  2537.  
  2538.     8.6 VERSION 5.4
  2539.  
  2540.     ■  Inline comments in FILES.BBS will be reproduced now!  When AND ONLY
  2541.        WHEN the /K option is specified for All- or IPF-list, or for
  2542.        FILFilePath, the original existing comments in FILES.BBS are copied
  2543.        into All- or IPF-list or newly created FILES.BBS files.  So note: /K
  2544.        means now: Keep sequence of FILES.BBS and Keep comments in
  2545.        FILES.BBS and other lists that support the /K option (ALL-, IPF and
  2546.        IP2-list).
  2547.  
  2548.        Note: /K is now the default sort parameter for FILFilePath, so that
  2549.        you do not loose your comments accidently.
  2550.     ■  Downsort's interpretation of the meaning of 'orphan' changed a
  2551.        little: an 'orphan' is from now on defined as a file for which there
  2552.        is no description in any FILES.BBS of all areas pointing to the same
  2553.        directory.  This may reduce improper(?) orphan-reporting by previous
  2554.        versions of Downsort considerably when you have physically a single
  2555.        large directory of which the files are grouped logically in
  2556.  
  2557.  
  2558.                                         Appendix A.  History of changes  38
  2559.  
  2560.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2561.  
  2562.  
  2563.  
  2564.        different areas with separate FILES.BBS files.
  2565.     ■  Duplicate download directories in OK-files will be suppressed.
  2566.     ■  Area-summaries in ALL- and IPF-lists are again sorted alphabetically
  2567.        on area-name.
  2568.     ■  A check during the data collection phase on maximum supported file
  2569.        entries (16350) has been added to prevent problems when exceeding
  2570.        this limit.
  2571.     ■  Orphan entries in FILES.BBS are now preceeded with '^PS' in stead of
  2572.        the unsupported '^PH' (bug fix).
  2573.     ■  Some specific adaptations for version 2.0:
  2574.        ∙  All files conforming to filespec 'FILES.*' will not be reported
  2575.           anymore.
  2576.        ∙  Area code will be handled as 9 character string: area-name!  But
  2577.           in some reports it will be truncated to the first 3 or 4
  2578.           characters.
  2579.        ∙  AreaINclude and AreaEXclude are used as 'prefix'.  Area-name
  2580.           specifications will be treated as group-names: you can include or
  2581.           exclude groups of areas starting with the same characters.
  2582.        ∙  The /b, /t, /bt or /tb flag in FILES.BBS will not appear in the
  2583.           lists, but only when it appears immediately after the filename.
  2584.           It is not stripped from FILES.BBS.
  2585.     ■  As experiment a new list has been added: IP2FileList.  It is a copy
  2586.        if IPF-list, but uses some new formatting features offered by the
  2587.        IPF-compiler of the OS/2 2.0-beta toolkit (i.c.
  2588.  
  2589.        The result is a faster generation, but above al a faster
  2590.        compilation and a better VIEW.  VIEWing under OS/2 1.2 or 1.3 is
  2591.        still possible!
  2592.  
  2593.  
  2594.  
  2595.     8.7 VERSION 5.3
  2596.  
  2597.     ■  New report added: DUP-list, a simple list, for SYSOP-use only, that
  2598.        shows (possibly) duplicate fileNAMES over the area's (the
  2599.        file-extension is not considered in the comparison).
  2600.     ■  Another new report: OKFile in BinkleyTerm style.  A list of
  2601.        download paths within privilege, with option to include magic
  2602.        names.
  2603.     ■  IpfFileList line in Downsort.Cfg now also allows specification of
  2604.        the IPF pagesize (maximum number of file-entries per VIEW 'page' or
  2605.        'part').
  2606.     ■  Progress signals streamlined, /Q is really silent now!
  2607.     ■  Fixed bug which caused Trap 000D under OS/2 (protection violation)
  2608.        under some rare conditions.  The restriction that first area may
  2609.        not be empty or not contain only orphans has been removed with this
  2610.        change.
  2611.     ■  Support for MAXIMUS CBCS 1.00 removed: only version 1.02 is
  2612.        supported (and most likely 2.00 as well).
  2613.     ■  Downsort's change-history before version 5.0 removed from
  2614.        documentation.
  2615.     ■  Use of MicroSoft C Compiler 6.00a: more free memory for DOS users
  2616.        (also because of slightly improved program structuring).
  2617.  
  2618.  
  2619.  
  2620.  
  2621.                                         Appendix A.  History of changes  39
  2622.  
  2623.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2624.  
  2625.  
  2626.  
  2627.     8.8 VERSION 5.2
  2628.  
  2629.     ■  Area selection is now possible within Downsort.  Two new keywords
  2630.        are provided in Downsort.CFG: AreaINclude to make reports for
  2631.        selected download area's, AreaEXclude to omit area's from the
  2632.        reports.  These keywords have only effect within the collection
  2633.        that would otherwise have been reported completely (restricted by
  2634.        AREA.DAT and report privilege).
  2635.     ■  FILES.BBS has now a peer relation with the directory in stead of
  2636.        being subordinate, in Downsort terms of course.  Filenames and
  2637.        their description in FILES.BBS for which there is no corresponding
  2638.        file in the download directory, are now NOT ignored anymore.  In
  2639.        stead the file is reported as 'offline' (on the columns for
  2640.        file-date and -size).  You may replace the word 'offline' with an
  2641.        alternative text.
  2642.     ■  Bug repaired that caused some files to be treated as orphan under
  2643.        certain rare circumstances.  And a correction of an error in
  2644.        'end-of-line' test/search on several places.
  2645.     ■  As already 'promised' in 5.1, the Area-summary in ALL-list is now
  2646.        in order of AREA.DAT.
  2647.     ■  Reorganised the documentation to obtain a more logical sequence of
  2648.        subjects.  Due to the growing number of options of Downsort, it
  2649.        became more and more difficult to see the trees through the wood.
  2650.        I added a number of paragraphs, especially for new users.  It can
  2651.        be useful for YOU too!
  2652.  
  2653.  
  2654.  
  2655.     8.9 VERSION 5.1
  2656.  
  2657.     ■  Since the ORPhan report is optional (changed with version 5.0),
  2658.        orphan entries could and now will be removed from internal storage
  2659.        during the information collection phase of Downsort, but only when
  2660.        no orphan-list is requested!  This is especially useful for the
  2661.        situation where a single large directory contains the files of
  2662.        several area's, and whereby the file descriptions are contained in
  2663.        different FILES.BBS files.  Normally this will result in reporting
  2664.        lots of duplicate orphans (according to the definition of 'orphan'
  2665.        in Downsort!).  With this change memory utilisation is lower and
  2666.        sorting faster.
  2667.     ■  Another change of this kind: area's with a privilege exceeding any
  2668.        reporting privilege are not scanned anymore.  Apart from lower
  2669.        memory utilisation, this might be useful for CDROM and slow
  2670.        disk(ette) systems.
  2671.     ■  The maximum number of Top-, Sub- and Bottom-Title lines has been
  2672.        extended to 20.
  2673.     ■  In addition all lists may now include a 'logo'-file with a new -I
  2674.        parameter on the individual report request specification (see
  2675.        sample Downsort.CFG).  The file will be copied into the list
  2676.        without any editing or translation.  It will be positioned directly
  2677.        behind the block-title and before the subtitle (if any).  For
  2678.        example: you may include your BBS-logo or a picture of your system
  2679.        configuration, or anything else you want to tell the
  2680.        file-requestors of FILES, ALLFILES and/or NEWFILES.  The IPF-list
  2681.        may also include IPF tags, with artwork, etc.  It may even include
  2682.  
  2683.  
  2684.                                         Appendix A.  History of changes  40
  2685.  
  2686.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2687.  
  2688.  
  2689.  
  2690.        other files itself!  For FILES.BBS the contents of this
  2691.        Include-file will immediately follow the 'standard' header.
  2692.     ■  All block-fonts have now a new special character <`> (reversed
  2693.        quote), which will be 'printed' as blank (space) with halfthe width
  2694.        of a normal character.  This is useful for fine-alignment (e.g.
  2695.        manually centering) the BLOCK-title.
  2696.     ■  The chapter on 'titles and headers' has been rewritten to clarify
  2697.        the use of all title-options, please read it!.
  2698.     ■  In the SUMMARY of ALL- and IPF-lists the areas themselves are not
  2699.        sorted anymore, but presented in sequence of AREAS.CTL
  2700.        specification.  This is based on the assumption that the file
  2701.        area's are in some kind of 'natural' order in AREAS.CTL (or maybe
  2702.        it is time to do that now!).
  2703.     ■  Descriptions in FILES.BBS are now (again) aligned on column 14 of
  2704.        the FILES.bbs file records.
  2705.     ■  IPF-list again a little more user-friendly (linking of area's).
  2706.     ■  A number of improvements have been applied to the executiontime
  2707.        messages (when running in VERBOSE mode).
  2708.  
  2709.  
  2710.  
  2711.     8.10 VERSION 5.0
  2712.  
  2713.     ■  Improved IPF-formatting: more colorful, builtin word-wrapping of
  2714.        VIEW used for file descriptions (better VIEWable under OS/2 1.3!).
  2715.        It should now also compile without errors/warnings.  Compiling
  2716.        (with IPFC) takes significantly longer however!
  2717.     ■  The IPF-list of large filearea's (>200 files) split into parts of
  2718.        200 files to prevent files being left unlisted.
  2719.     ■  Top-level title in FileLists shows file-count and byte-count as
  2720.        available within the privilege of the list.  Thus it indicates what
  2721.        is really AVAILable to the user!  Area-count omitted in lists which
  2722.        are not area-oriented.
  2723.     ■  ORPHAN report made OPTIONAL (must be specified to get it!).
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.                                         Appendix A.  History of changes  41
  2748.  
  2749.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2750.  
  2751.  
  2752.  
  2753.     APPENDIX B.  WORLD-WIDE USE OF DOWNSORT
  2754.  
  2755.     PC-Square may be considered as the home-base of Downsort.  The most
  2756.     recent version is always available there (file-requests honoured
  2757.     between 07:00 and 24:00 local time).
  2758.  
  2759.     PC-Square               Marcel Stikkelman     Zoetermeer, Netherlands
  2760.     2:512/4                                       31-79-424107
  2761.  
  2762.     Among many others, the following SYSOPs have reported running Downsort
  2763.     to make file collection lists for their users, and have a recent version
  2764.     available for download or file request.
  2765.  
  2766.     OS/2 TASK               Rene Carlsen          Skagen, Denmark
  2767.     2:230/910                                     45-98-451070
  2768.  
  2769.     Paradigmus Maximus      John Taylor           London, UK
  2770.     2:253/68                                      44-81-566-5393
  2771.  
  2772.     Ursus Fremens Rexx      Colin Adams           Preston, UK
  2773.     2:255/121                                     44-772-828975
  2774.  
  2775.     Chat                    Lody Caenen           Koog aan de Zaan, Netherlands
  2776.     2:280/801                                     31-75-704045
  2777.  
  2778.     Runnin' with the Devil  Stefano Sonzogni      Treviglio BG, Italy
  2779.     2:331/205                                     39-363-303567
  2780.  
  2781.     Castillo Centro         Santiago Crespo       Madrid, Spain
  2782.     2:341/24                                      34-1-5477210
  2783.  
  2784.     Fernwood                Emmitt Dove           Branford CT, USA
  2785.     1:141/109                                     1-203-483-0348
  2786.  
  2787.     The Planet Earth        Joel Lambert          Bridgeport CT, USA
  2788.     1:141/455                                     1-203-335-7742
  2789.  
  2790.     OS/2 Shareware          Pete Norloff          Fairfax VA, USA
  2791.     1:109/347                                     1-703-385-4325
  2792.  
  2793.     Singing Bear            John Tarbox           Wilmington DE, USA
  2794.     1:150/130                                     1-302-984-2238
  2795.  
  2796.     La Jungle BBS           Stephane Seguin       Quebec, Canada
  2797.     1:163/116                                     1-819-595-4917
  2798.  
  2799.     The Choice BBS          Mark Woolworth        Las Vegas NV, USA
  2800.     1:209/710                                     1-702-253-6527
  2801.  
  2802.     3M Australia            Graham Stair          Pymble, NSW Australia
  2803.     3:711/409                                     61-2-498-9184
  2804.  
  2805.     Serendipity Inc         Poe Lim               Cowra, NSW Australia
  2806.     3:623/630                                     61-63-41-1859
  2807.  
  2808.  
  2809.  
  2810.                                 Appendix B.  World-wide use of Downsort  42
  2811.  
  2812.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2813.  
  2814.  
  2815.  
  2816.     I have received reports from others.  Too many for this list, which is
  2817.     just meant to point to a system in your neighbourhood(?).  You may
  2818.     either logon to one of these boards, or perform a file-request of
  2819.     'FILES' or 'ALLFILES' to get an impression of Downsort's capabilities.
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.                                 Appendix B.  World-wide use of Downsort  43
  2874.  
  2875.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2876.  
  2877.  
  2878.  
  2879.     APPENDIX C.  SAMPLE LISTS
  2880.  
  2881.     Below follow a number of samples of list layouts and contents.  Not
  2882.     shown are the BBS-, and IPF-lists, since these are screen- rather than
  2883.     paper-oriented, with their specific formatting and color settings.
  2884.  
  2885.     The dates and sizes in these lists have been manipulated!
  2886.  
  2887.  
  2888.     10.1 ALL-LIST
  2889.  
  2890.  
  2891.     ═══════════════════════════════════════════════════════════════════════════════
  2892.      █▀▀▀▀▀▀   █  ║ OS/2 - Fernwood - New Acquisitions
  2893.      █▄▄▄▄▄   ▄█  ║ Available: 143 files (0.0 MB)
  2894.      ██       ██  ║ Privilege: Disgrace
  2895.      ██       ██  ║ Newest: XLIST233.ZIP  3-22-91  (avail:  7-26-91)
  2896.     ───────────────────────────────────────────────────────────────────────────────
  2897.     Filename      Size   Date    Description
  2898.     ──────────── ───── ───────── ──────────────────────────────────────────────────
  2899.     AAFONTS.ZIP     1K  3-22-91  Text from IBM regarding Anti-aliased Fonts.
  2900.     AFP_120.LZH     1K  3-22-91  Areafix 1.2 for OS/2.  Permits systems that do
  2901.                                  echomail with yours to change their complement of
  2902.                                  areas independently.
  2903.  
  2904.  
  2905.  
  2906.     10.2 GBL-LIST
  2907.  
  2908.  
  2909.     (Sun Jan 05 15:05) Available: 508 files (0 MB)
  2910.                        Maximum privilege shown: Sysop
  2911.                        Newest: BIGBRO.ZIP  3-22-91 (avail:  7-26-91)
  2912.                        Date flag: new on this system since: * = 1 week, + = 1 month
  2913.  
  2914.     Filename       Area    Size   Date    Description
  2915.     ──────────── ──────── ───── ───────── ─────────────────────────────────────────
  2916.     2COLDIR.ZIP        F3    1K  3-22-91  DoubleDir for OS/2
  2917.     2MONITOR.ZIP       F4    1K  3-22-91  Source and .EXE for running 2 monitors.
  2918.  
  2919.  
  2920.  
  2921.     10.3 NEW-LIST
  2922.  
  2923.  
  2924.     (Sun Jan 05 16:14) Last 10 months newest of a total of 508 files (0 MB)
  2925.                        Maximum privilege shown: Sysop
  2926.                        Newest: BIGBRO.ZIP dd  3-22-91 (avail:  7-26-91)
  2927.                        Date flag: new on this system since: * = 1 week, + = 1 month
  2928.  
  2929.     Filename       Area    Size   Date    Description
  2930.     ──────────── ──────── ───── ───────── ─────────────────────────────────────────
  2931.     2COLDIR.ZIP        F3    1K  3-22-91  DoubleDir for OS/2
  2932.     2MONITOR.ZIP       F4    1K  3-22-91  Source and .EXE for running 2 monitors.
  2933.     8514.PAT           F4    1K  3-22-91  Patch to get 32x32 icons on 8514/a
  2934.  
  2935.  
  2936.                                               Appendix C.  Sample Lists  44
  2937.  
  2938.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.     10.4 EMI-LIST
  2946.  
  2947.  
  2948.     (Tue Jan 14 21:55) Last 44 weeks newest emissions
  2949.  
  2950.     --Filename-- --Date--  -Time-  -Bytes-  ---Description---
  2951.     DUMMY.DAT    10-11-91   9:45p       31  Dummy file for Downsort tests +
  2952.                  continuation line
  2953.     PSOS2.ZIP     3-22-91  11:46p        2  View OS/2 Information on PM like
  2954.                  Threads & Process, Memory used, and more.
  2955.  
  2956.  
  2957.  
  2958.     10.5 FILES.BBS
  2959.  
  2960.  
  2961.     - █▀▀▀▀▀▀   █  ║ OS/2 - Fernwood - New Acquisitions
  2962.     - █▄▄▄▄▄   ▄█  ║ Available: 143 files (0.0 MB)
  2963.     - ██       ██  ║ Privilege: Disgrace
  2964.     - ██       ██  ║ Newest: XLIST233.ZIP  3-22-91 (avail:  7-26-91)
  2965.     -──────────────────────────────────────────────────────────────────────────────
  2966.     -Filename      Size    Date     Description
  2967.     -─────────── ─────── ───────── ────────────────────────────────────────────────
  2968.     AAFONTS.ZIP   Text from IBM regarding Anti-aliased Fonts.
  2969.     AFP_120.LZH   Areafix 1.2 for OS/2.  Permits systems that do echomail . . . .
  2970.  
  2971.     Note: File date and size are provided dynamically by Maximus CBCS!
  2972.  
  2973.  
  2974.     10.6 OKFILE
  2975.  
  2976.  
  2977.  
  2978.     10.6.1 SHORT FORMAT (DEFAULT)
  2979.  
  2980.     @files G:\File\File01\allfiles.zip
  2981.     @avail G:\File\File01\allfiles.zip
  2982.     @newfiles G:\File\File01\newfiles.zip
  2983.     G:\File\Fernwood\*.*
  2984.     G:\File\Max\*.*
  2985.  
  2986.  
  2987.  
  2988.     10.6.2 LONG FORMAT (-L)
  2989.  
  2990.     @files G:\File\File01\allfiles.zip
  2991.     @avail G:\File\File01\allfiles.zip
  2992.     @newfiles G:\File\File01\newfiles.zip
  2993.     @DWNSRT55.ZIP G:\File\Fernwood\DWNSRT55.ZIP
  2994.     @DWNSRT56.ZIP G:\File\Fernwood\DWNSRT56.ZIP
  2995.     @MAXSRT10.ZIP G:\File\Max\MAXSRT10.ZIP
  2996.     @MAXSRT11.ZIP G:\File\Max\MAXSRT11.ZIP
  2997.  
  2998.  
  2999.                                               Appendix C.  Sample Lists  45
  3000.  
  3001.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.     10.7 ORPHAN LIST
  3009.  
  3010.  
  3011.     ═══════════════════════════════════════════════════════════════════════════════
  3012.       Area    Filename      Date    FilePath
  3013.     ──────── ──────────── ───────── ───────────────────────────────────────────────
  3014.           F1 123R3UPD.ZIP  3-22-91  G:\File\Fernwood\
  3015.           F1 4019DRVR.ZIP  3-22-91  G:\File\Fernwood\
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.                                               Appendix C.  Sample Lists  46
  3063.  
  3064.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3065.  
  3066.  
  3067.  
  3068.     APPENDIX D.  SAMPLE CONFIGURATION FILE
  3069.  
  3070.     ;
  3071.     ;      ██▐███   █▐███  ██   ██ ██▐███ ██▐████  █▐███  ██▐███  ██▐████
  3072.     ;      ██   ██ ██   ██ ██   ██ ██  ██ ██      ██   ██ ██   ██   ▐██
  3073.     ;      ██   ██ ██   ██ ██ █ ██ ██  ██ ██▐████ ██   ██ ██▐███    ▐██
  3074.     ;      ██   ██ ██   ██ ██ █ ██ ██  ██      ██ ██   ██ ██ █      ▐██
  3075.     ;      ██▐███   █▐███   █▐███  ██  ██ ██▐████  █▐███  ██  ██    ▐██
  3076.     ;                                                                  (font 2)
  3077.     ;
  3078.     ;
  3079.     ; ▄▀▀▀▄ ▄▀▀▀▄ █▄  █ █▀▀▀▀ ▀█▀ ▄▀▀▀▄ █   █ █▀▀▀▄ ▄▀▀▀▄ ▀▀█▀▀ ▀█▀ ▄▀▀▀▄ █▄  █
  3080.     ; █     █   █ █▀█▄█ █▄▄    █  █  ▄▄ █   █ █▄▄▄▀ █▄▄▄█   █    █  █   █ █ ▀▄█
  3081.     ; ▀▄▄▄▀ ▀▄▄▄▀ █  ▀█ █     ▄█▄ ▀▄▄▄▀ ▀▄▄▄▀ █ ▀▄▄ █   █   █   ▄█▄ ▀▄▄▄▀ █   █
  3082.     ;                                                                  (font 1)
  3083.     ;
  3084.     ;
  3085.     ;                   █▀▀▀▀▀▀   █     █       █▀▀▀▀▀▀
  3086.     ;                   █▄▄▄▄▄▄   █▄    █▄      █▄▄▄▄▄▄
  3087.     ;                   ██        ██    ██      ██
  3088.     ;                   ██        ██    ██▄▄▄▄▄ ██▄▄▄▄▄
  3089.     ;                                                                  (font 3)
  3090.     ;                                            (font 4 is reverse video of 3)
  3091.     ;
  3092.     ;  ┌──────────────────────────────────────────────────────────────────────┐
  3093.     ;  │       Sample Configuration File for DOWNSORT by Rob Hamerling        │
  3094.     ;  └──────────────────────────────────────────────────────────────────────┘
  3095.     ;
  3096.     ;  Downsort allows you to make many lists in almost any combination in a
  3097.     ;  single run, especially for experienced jugglers with Maximus' key/locks!
  3098.     ;
  3099.     ;  In some occasions you might need a separate configuration file.
  3100.     ;  Downsort can be invoked with a commandline parameter specifying another
  3101.     ;  than the default configuration filename, for example:
  3102.     ;
  3103.     ;         DOWNSORT @AGROUP01.CFG
  3104.     ;
  3105.     ;  (the '@' prefix denotes that a configuration filespec is following)
  3106.     ;
  3107.     ;
  3108.     ;  Rules for parameter specifications in a configuration file:
  3109.     ;  ===========================================================
  3110.     ;   - Leading blanks are skipped.
  3111.     ;   - Lines with '%', '*' or ';' as first non-blank character are
  3112.     ;     considered to contain comments only and are skipped.
  3113.     ;   - Empty lines and lines with a valid keyword but without any
  3114.     ;     parameters, are also considered to be comment lines and are skipped
  3115.     ;   - Comments on parameter specification lines are not allowed.
  3116.     ;   - All parameters for a specific keyword should be on a single line.
  3117.     ;   - Of mutually exclusive values only the last will take effect.
  3118.     ;   - An asterisk (*) as parametervalue denotes default-value.
  3119.     ;   - Invalid or not-recognised parameters may be ignored without notice.
  3120.     ;
  3121.     ;  ───────────────────────────────────────────────────────────────────────
  3122.     ;  First the data (file-) collection specifications:
  3123.  
  3124.  
  3125.                                  Appendix D.  Sample Configuration File  47
  3126.  
  3127.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3128.  
  3129.  
  3130.  
  3131.     ;  ───────────────────────────────────────────────────────────────────────
  3132.     ;
  3133.     ; AreaDat:     Complete file-specification of your 'AREA.DAT' file.
  3134.     ; -------      AREA.DAT is built by MAXIMUS' SILT(P) with -a or -x option.
  3135.     ;              The path is normally specified in MAX.CTL with the option
  3136.     ;              AreaDat in Session Section. With the AreaDat you may
  3137.     ;              specify any file that has the SILT(P)-format.
  3138.  
  3139.       AreaDat      area.dat
  3140.     * AreaDat      d:\lody\max\area.dat
  3141.  
  3142.     ; AreaINclude  Select areas to be INCLUDED in the reports.
  3143.     ; AreaEXclude  Select areas to be EXCLUDED from the reports.
  3144.     ; -----------  Normally (by default) ALL area's will be included,
  3145.     ; 5.9          unless you use one or both of these keywords.
  3146.     ;              Specify 1..8 character strings to indicate which areas have
  3147.     ;              to be INcluded or EXcluded explicitly. The strings are used
  3148.     ;              as PREFIX: all areanames starting with the same characters
  3149.     ;              will be IN- or EXcluded. The selection is case-INsensitive.
  3150.     ; 5.9          You would normally use one of both keywords. However they
  3151.     ; 5.9          can be used simultaneously. But since the strings are used
  3152.     ; 5.9          as prefix this gives only meaningful results if the EXclude
  3153.     ; 5.9          strings are more selective than the INclude strings
  3154.     ; 5.9          (EXclude applies in that case only to INcluded area's!).
  3155.     ; 5.9          You may specify multiple strings on a line (separate the
  3156.     ; 5.9          strings with one or more blanks), and as many lines as
  3157.     ; 5.9          needed.
  3158.     ; 5.9          Example: Suppose your fileareas are named HC000 to HC999.
  3159.     ; 5.9          Then the specification below would select the files from
  3160.     ; 5.9          areas HC000 to HC039, but NOT those ending with a '9'.
  3161.  
  3162.     * AreaINclude  hc00 hc01 hc02 hc03
  3163.     * AreaEXclude  hc009 hc019 hc029 hc039
  3164.  
  3165.     ; FileEXclude  Select FILES to be EXCLUDED from the reports.
  3166.     ; -----------  Normally (by default) all files in all (selected) areas
  3167.     ; 5.9          will be included, unless you use this keyword.
  3168.     ; 5.9          Specify 8.3 filename.ext type of strings, wildcards are
  3169.     ; 5.9          allowed and honored, quotes are not needed.
  3170.     ; 5.9          The selection is case-INsensitive.
  3171.     ; 5.9          You may specify multiple filespecs on a line: separate
  3172.     ; 5.9          strings with one or more blanks and as many lines as needed.
  3173.     ; 5.9  ===>>   The first line contains the previously hardcoded excludes of
  3174.     ; 5.9  ===>>   Downsort versions before 5.9, it is strongly recommended to
  3175.     ; 5.9  ===>>   keep the first line active!
  3176.  
  3177.       FileExclude  FILES.*  *.BAK  SYSTEM*.?BS  DIR.?BS
  3178.       FileExclude  00INDEX.*  WILDCAT.TXT
  3179.  
  3180.     ;  ───────────────────────────────────────────────────────────────────────
  3181.     ;  Above parameters involve the data collection (selection) process,
  3182.     ;  below follow the report specifications.
  3183.     ;  First the global parameters that apply (mostly) to all reports:
  3184.     ;  ───────────────────────────────────────────────────────────────────────
  3185.  
  3186.  
  3187.  
  3188.                                  Appendix D.  Sample Configuration File  48
  3189.  
  3190.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3191.  
  3192.  
  3193.  
  3194.     ; AreaOrder    Order in which areas have to be sorted.
  3195.     ;              Selection can be: K[eep]    - Keep order of AREA.DAT
  3196.     ;                                A[lpha]   - Alphabetic order of areaname
  3197.     ;                                G[roup]   - Group order
  3198.     ;                                I[nclude] - order of areaINclude (above)
  3199.     ;              Specify one of these orders (first letter is sufficient).
  3200.     ;              'Group'-order is a special sorting sequence for area names
  3201.     ;              consisting of a group of letters followed by digits.
  3202.     ;              See the documentation for details.
  3203.     ;              Default: Group-order (also with invalid specifications)
  3204.  
  3205.       AreaOrder    GROUP
  3206.  
  3207.     ;  Title:      Short string that will be displayed in BLOCK-characters
  3208.     ;  -----       on top of all FileLists (except BBS-list).
  3209.     ;              Not more than 20 characters are accepted as input.
  3210.     ;              If Title isn't specified, it will be DOWNSORT by default.
  3211.     ; 5.9          The following characters are supported in block-fonts:
  3212.     ; 5.9              UPPER case  A..Z
  3213.     ; 5.9              LOWER case  a..z  (but will be presented in UPPER case)
  3214.     ; 5.9              Digits 0..9
  3215.     ; 5.9              _  *  |  .  [  ]  (  )  /  \  -  and space
  3216.     ;              Not-supported characters are displayed as blank.
  3217.     ;              The '~'-character (tilde) represents a full width space,
  3218.     ;              the '`'-character (reverse quote) a half width space.
  3219.  
  3220.       Title        `DownSort
  3221.  
  3222.     ; TitleFont    NOT SUPPORTED ANYMORE:  use individual specification on
  3223.     ; 5.9          xxxFileList line.
  3224.  
  3225.     ;  PreTitle    Lines to be displayed immediately before the BLOCK-title.
  3226.     ;  --------    The lines will be copied asis, however leading blanks are
  3227.     ;              skipped, no wrapping or truncation will be applied for
  3228.     ;              'long' lines, '~' (tilde) characters are translated to
  3229.     ;              blanks. You may specify 20 PreTitle lines, excess is
  3230.     ;              ignored. Empty PreTitle lines are ignored and not counted.
  3231.     ;              There is no default PreTitle.
  3232.     ;              To create empty lines in your header specify a PreTitle
  3233.     ;              with a tilde.
  3234.  
  3235.       PreTitle     ~
  3236.       PreTitle     ~~~~~~~<═════:═════ p r e - t i t l e ═════:═════>
  3237.       PreTitle     ~
  3238.  
  3239.     ;  SubTitle    Lines to be displayed immediately below the BLOCK-title.
  3240.     ;  --------    Maximum 20 SubTitles are accepted, and exactly the
  3241.     ;              same rules apply as for PreTitle.
  3242.     ;
  3243.  
  3244.       SubTitle     ~
  3245.       SubTitle     ~~~~~~~<═════&═════ s u b - t i t l e ═════&═════>
  3246.       SubTitle     ~  Overview of downloadable files on this magnificent Board
  3247.       SubTitle     ~     Node number 9.999/99, modemspeeds: V.99/V.99bis
  3248.       SubTitle     ~~~~~~~<═════════════════════════════════════════>
  3249.  
  3250.  
  3251.                                  Appendix D.  Sample Configuration File  49
  3252.  
  3253.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3254.  
  3255.  
  3256.  
  3257.       SubTitle     ~
  3258.  
  3259.     ;  BottomLine  Lines to be displayed at the end of the filelist.
  3260.     ;  ----------  Maximum 20 BottomLines are accepted, and exactly the
  3261.     ;              same rules apply as for PreTitle and Subtitle.
  3262.     ;
  3263.  
  3264.       BottomLine   ~
  3265.       BottomLine   ~~~~~~~<═══════ b o t t o m : t i t l e ═════════>
  3266.       BottomLine   ~
  3267.       BottomLine   ~~~~~~~<═══ How do you like DOWNSORT, folks? ════>
  3268.       BottomLine   ~
  3269.  
  3270.     ; MaxNewFiles  NOT SUPPORTED anymore. Specify maximum entries to be listed
  3271.     ; 5.9          for each lists individually on the appropriate xxxFileList
  3272.     ; 5.9          line.
  3273.  
  3274.     ; NonDupEXT    Suppress reporting as 'duplicate' if 2 files with equal
  3275.     ; ---------    filenames but unequal extensions are defined as 'pair'.
  3276.     ;              The example specification below has the effect that files of
  3277.     ;              any pair "xyz.SDA" and "xyz.SDN"  ("xyz": any filename) will
  3278.     ;              not be listed in DupFileList.
  3279.     ;               -  Files with equal filename AND equal extension will
  3280.     ;                  still be reported as duplicate even when the extension
  3281.     ;                  is one of a 'NonDupEXT' pair!
  3282.     ;               -  Multiple extensions must be specified in as many pairs
  3283.     ;                  as can be formed (3 extension 3 pairs; 4 ext. 6 pairs;
  3284.     ;                  etc, e.g: for Nodelists:  DAT EXT  DAT IDX  EXT IDX).
  3285.     ; 5.9           You may specify multiple extension-pairs on a line
  3286.     ; 5.9           (separate the extensions with blanks), and as many lines
  3287.     ; 5.9           as needed.
  3288.     ;               Default: no suppression
  3289.  
  3290.       NonDupEXT    SDN SDA
  3291.  
  3292.     ; OrphanDesc   Description text of Orphan files.
  3293.     ; NotFoundDesc Description text of files without description in FILES.BBS.
  3294.     ; ------------ The description will replace the default hard-coded text.
  3295.     ;              Up to 45 characters may be specified.
  3296.     ;              The '~' (tilde) character will not be translated here!
  3297.  
  3298.       OrphanDesc   ~~~~~ !!!! Orphelin !!!! ~~~~~
  3299.       NotFoundDesc +++ Ce fichier défie toute description! +++
  3300.  
  3301.  
  3302.     ; OfflineDesc  When a filespecification is found in FILES.BBS but not
  3303.     ; -----------  in the corresponding download directory, this text replaces
  3304.     ;              the filesize and date (right aligned).
  3305.     ;              Up to 14 characters are accepted.
  3306.  
  3307.       OfflineDesc  -- archived --
  3308.  
  3309.     ; AVAstrip     You may wish to strip off AVATAR graphics characters from
  3310.     ; --------     the contents of your FILES.BBS files.
  3311.     ;              Specify 'No' to deactivate stripping (default is 'Yes').
  3312.  
  3313.  
  3314.                                  Appendix D.  Sample Configuration File  50
  3315.  
  3316.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3317.  
  3318.  
  3319.  
  3320.     ;              ==> Works ONLY for COMMENT LINES in ALL- and IPF-lists, and
  3321.     ;              remember: comments are only listed with KEEPSEQ (no sort).
  3322.  
  3323.       AVAstrip     Yes
  3324.  
  3325.     ; ──────────────────────────────────────────────────────────────────────
  3326.     ; Above were the parameters with a global effect: applicable to all
  3327.     ; lists or to the execution mode of DOWNSORT.
  3328.     ; Below follow list-specific parameters, which might override some of
  3329.     ; the settings of the global parameters.
  3330.     ; Keep this sequence: first global, then specific parameters!
  3331.     ; ──────────────────────────────────────────────────────────────────────
  3332.     ;
  3333.     ; xxxFileList:  Create a File lists of type 'xxx' (1 list per keyword)
  3334.     ;
  3335.     ; xxx ───┐      ┌─ Twit
  3336.     ;              ├─ Disgrace          ┌─ FileName of the list
  3337.     ;   ┌── ORP     ├─ Limited           │  (without extension,
  3338.     ;   ┌── BBS     ├─ Normal            │  maximum 8 characters)
  3339.     ;   ┌── NEW     ├─ Worthy            │
  3340.     ;   ┌── ALL     ├─ Privil            │  ┌─ Additional options for
  3341.     ;   ┌── GBL     ├─ Fafored           │  │ each list individually:
  3342.     ;   ┌── DUP     ├─ Extra             │  │ -A     Alphabetic sort (name)
  3343.     ;   ┌── IPF     ├─ Clerk             │  │ -Cn    Cont.line indentation
  3344.     ;   ┌── IP2     ├─ Assistsysop       │  │ -D     Date sort (descending)
  3345.     ;   ┌── OK      ├─ Sysop             │  │ -F#    Font for titles (0..4)
  3346.     ;   ┌── EMI     ├─ Hidden            │  │ -G     Group sort NEW files
  3347.     ;   │           │                    │  │ -If    Imbed filespec
  3348.     ;   │           │                    │  │ -K     Keep FILES.BBS seq
  3349.     ;   │           │  ┌── userkeys      │  │ -L     Long line/list type
  3350.     ;   │           │  │   1..8          │  │ -T     Truncate file descript.
  3351.     ;   │           │  │   A..X          │  │ -W     Wrap file descriptions
  3352.     ;   │           │  │                 │  │ -X     eXclude priv. in headers
  3353.     ;   │           │  │       ┌─────────┘  │ nnn[P] entries limit: number
  3354.     ;   │           │  │       │            │        (P=Days|Weeks|Months)
  3355.     ;                                   
  3356.     ;  ═══─═══════  ═/════ ════════  ════════════════════════════════
  3357.     ;  xxxFileList  p/keys FileName  Option-1 Option-2 . . . Option-n
  3358.     ;
  3359.     ;  If just xxxFileList is specified, the Level by default will be SYSOP
  3360.     ;                                    and the filename will be DOWNSORT.
  3361.     ; 5.9  A single privilege letter (or the complete word) can be specified
  3362.     ; 5.9  ans for each privilege a separate list-file will be generated with
  3363.     ;      the following extension:
  3364.     ;         NewFileList:   N~p
  3365.     ;         AllFileList:   A~p
  3366.     ;         IpfFileList:   I~p
  3367.     ;         GblFileList:   G~p
  3368.     ;         OKFileList:    O~p
  3369.     ;         EmiFileList:   E~p
  3370.     ;      where 'p' is the (first) privilege character (of the word).
  3371.     ;
  3372.     ; 5.9  Behind the privilege indicator, optionally a slash followed by a
  3373.     ; 5.9  set of 'userkeys' may be specified. This will EXTEND the particular
  3374.     ; 5.9  list with files in areas with the corresponding locks.
  3375.  
  3376.  
  3377.                                  Appendix D.  Sample Configuration File  51
  3378.  
  3379.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3380.  
  3381.  
  3382.  
  3383.     ; 5.9  These specifications in xxxFileList mimic a Maximus user class.
  3384.     ; 5.9  WARNING: Older versions of Downsort included locked area's, but
  3385.     ; 5.9           now these area's will be skipped, unless all keys are
  3386.     ; 5.9           specified on the xxxFileList line!
  3387.     ; 5.9  See for an explanation of 'locks' and 'keys' the MAXIMUS docs.
  3388.     ;
  3389.     ;  The default filename (DOWNSORT) for each list can be overridden
  3390.     ;  with the [optional] third parameter on the xxxFileList line.
  3391.     ;
  3392.     ;  The following parameters may [optionally] be specified (any sequence):
  3393.     ;
  3394.     ;     -A   Selects Alphabetic sort on filename
  3395.     ;     -D   Selects sort on Date/Time of the files
  3396.     ; 5.9 -G   Selects sort on filename in area-groups
  3397.     ; 5.9      (NEW- and ORP-FileLists only, in other files synonym of -A)
  3398.     ;     -K   Keep sequence of files in FILES.BBS
  3399.     ;          (ALL- and IPF-lists, and newly generated FILES.BBS files).
  3400.     ;
  3401.     ;     -T   Causes Truncation of long descriptions (to about 50 characters)
  3402.     ;          so that each file-entry takes not more than a single line.
  3403.     ;     -W   Causes Wrapping of long descriptions: the report will contain
  3404.     ;          as many lines as needed for the complete file description.
  3405.     ;
  3406.     ;     -Cn  Continuation Indentation of description: relative position
  3407.     ;          of description on second and following lines if WRAPPED
  3408.     ;          descriptions are used. 'n' will normally be the width of
  3409.     ;          a download counter field.
  3410.     ;          May be specified negative for left-indentation (e.d. -C-16)!
  3411.     ;
  3412.     ;     -X   eXclude privilege indications the list-headers.
  3413.     ;
  3414.     ;     -L   Long list format for some selected list types:
  3415.     ;           - OK-file: explicit filenames in stead of wildcards (PATH\*.*)
  3416.     ;           - FILFilePath: see below
  3417.     ;
  3418.     ;     -If  Imbed userfile (f = file-spec) just behind the block-title.
  3419.     ;          The file is included without any translation, so beware of
  3420.     ;          special characters and effects like formatting (word-wrap) in
  3421.     ;          the IPF- and IP2-list!
  3422.     ;          NOTEs: - does not apply to DUP- and ORP-FileLists
  3423.     ;                 - BBSFileList imbeds DOWNSORT.HDR and DOWNSORT.TRL
  3424.     ;
  3425.     ;     -F#  ListTitle font. Choose for 'n': 0, 1, 2, 3 or 4 (default is 3).
  3426.     ;          Valid numbers:   0 .. no block title at all!
  3427.     ;                           1 .. Simple font             (5x6 pattern)
  3428.     ;                           2 .. Pseudo-Stencil Font     (7x10 pattern)
  3429.     ;                           3 .. ROBoComputer Font       (7x8 pattern)
  3430.     ;                           4 .. Reversed Video RoboComp (7x8 pattern)
  3431.     ;          See some samples of the fonts in the top of this file.
  3432.     ; 5.9      WARNING: Fonts 2 and 4 may give 'truncated' characters with
  3433.     ; 5.9               short areanames in some lists.
  3434.     ;
  3435.     ;   nnn[P] Limit the number of file-entries to a maximum of 'nnn'.
  3436.     ;          If followed by Period-indicator ('D', 'W' or 'M') the list is
  3437.     ;          limited not by number, but by file-AGE in Days, Weeks or Months.
  3438.  
  3439.  
  3440.                                  Appendix D.  Sample Configuration File  52
  3441.  
  3442.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3443.  
  3444.  
  3445.  
  3446.     ;          NOTEs: - the Period-letter does not apply to IPF-lists
  3447.     ;                 - 'nnn' denotes maximum number of files on a VIEW-page.
  3448.     ; 5.9             - ALL-lists can only be limited by period (not number).
  3449.     ;
  3450.     ;
  3451.     ;  NOTE: - For ORP-fileList specify '*' as privilege parameter
  3452.  
  3453.       AllFileList  */*    Down_AL1        -k -W          -c0  -IDownsort.Inc
  3454.     * AllFileList  */2    Down_AL2    2m  -a -w  -f4  -x
  3455.       BBSFileList  s      Down_Bbs    3w  -a -w          -C6
  3456.     * DupFileList  s      Down_Dup
  3457.     * GblFileList  */*    Down_Gbl        -d -w          -c0  -IDownsort.Inc
  3458.     * IpfFileList  s      Down_Ipf  200   -a
  3459.     * Ip2FileList  s      Down_Ip2  200   -a
  3460.       NewFileList  s/*    Down_N1     3w  -a -w
  3461.     * NewFileList  s/2    Down_N2     2m  -g -w  -f2  -x
  3462.     * EmiFileList  s      Down_Emi   15d  -a -w               -IDownsort.inc
  3463.     * OKFileList   s      Down_OKE                            -IDownsort.Mag
  3464.       OrpFileList  *      Down_Orp        -g
  3465.  
  3466.     ;  NOTE: The IPF-list has the format of an INPUT-file for the
  3467.     ;        Information Presentation Facility Compiler (IPFC).
  3468.     ;        It should be compiled as follows:
  3469.     ;             IPFC  DOWN_IPF.I~P  /INF
  3470.     ;        This will produce a file called DOWN_IPF.INF, which is ready
  3471.     ;        to be viewed with the command:
  3472.     ;             VIEW  DOWN_IPF
  3473.     ;        See the OS/2 Toolkit documentation for details of IPFC.
  3474.     ;        IPFC is not distributed with the DOWNSORT package!
  3475.  
  3476.     ; ======================================================================
  3477.     ; FILFilePath  Specifications for the "FILES.BBS"-type of output.
  3478.     ; -----------  - First parameter is privilege selection flag. Specify '*'
  3479.     ;                to get all files, even the newly uploaded ones.
  3480.     ;              - Second parameter is [optional] specification of
  3481.     ;                destination directory of newly generated Files.BBS files.
  3482.     ;                Use the format:  drive:\directory\
  3483.     ;                If destination path is specified, the output filename will
  3484.     ;                be "FILES.ac", extension will be the first 3 characters of
  3485.     ;                areaname. However when 'long' areanames are present,
  3486.     ;                (more than 3 characters), all output-files will be called
  3487.     ;                "areaname.BBS".
  3488.     ;                If not specified the MAXIMUS path specification will be
  3489.     ;                used (ListFile parameter if used in Maximus' AREA.CTL
  3490.     ;                otherwise the Download directory).
  3491.     ;              - Many but not all flags as defined for the other lists
  3492.     ;                apply to the FILES.BBS-output of Downsort, for example:
  3493.     ;                 - TITLE is not applicable to FILES.BBS
  3494.     ;                 - file-description will be kept on a single line, not
  3495.     ;                   wrapped or truncated, and up to 2000 characters.
  3496.     ;                 - Entries can be sorted, but then you will loose your
  3497.     ;                   comments: -K (Keep Sequence and Comments) is default.
  3498.     ;                 - -L (LONG) means here: include file size and file date,
  3499.     ;                    (which should be used only once!).
  3500.     ;                 - Any Avatar codes will be kept unchanged.
  3501.  
  3502.  
  3503.                                  Appendix D.  Sample Configuration File  53
  3504.  
  3505.     Maximus Download File Sort and List Utility (OS/2 and DOS)
  3506.  
  3507.  
  3508.  
  3509.  
  3510.       FILFilePath  s  filesbbs\      -k  -idownsort.inc
  3511.  
  3512.     ;  ------------------------------------------------------------------------
  3513.     ;
  3514.     ; End of sample Downsort.Cfg as provided with the orginal Downsort package.
  3515.     ;
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.                                  Appendix D.  Sample Configuration File  54
  3567.