home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / dwnsrt62.zip / DOWNSORT.CFG < prev    next >
Text File  |  1995-11-05  |  27KB  |  499 lines
  1. ;
  2. ;      ██▐███   █▐███  ██   ██ ██▐███ ██▐████  █▐███  ██▐███  ██▐████
  3. ;      ██   ██ ██   ██ ██   ██ ██  ██ ██      ██   ██ ██   ██   ▐██
  4. ;      ██   ██ ██   ██ ██ █ ██ ██  ██ ██▐████ ██   ██ ██▐███    ▐██
  5. ;      ██   ██ ██   ██ ██ █ ██ ██  ██      ██ ██   ██ ██ █      ▐██
  6. ;      ██▐███   █▐███   █▐███  ██  ██ ██▐████  █▐███  ██  ██    ▐██
  7. ;                                                                  (font 2)
  8. ;
  9. ;
  10. ; ▄▀▀▀▄ ▄▀▀▀▄ █▄  █ █▀▀▀▀ ▀█▀ ▄▀▀▀▄ █   █ █▀▀▀▄ ▄▀▀▀▄ ▀▀█▀▀ ▀█▀ ▄▀▀▀▄ █▄  █
  11. ; █     █   █ █▀█▄█ █▄▄    █  █  ▄▄ █   █ █▄▄▄▀ █▄▄▄█   █    █  █   █ █ ▀▄█
  12. ; ▀▄▄▄▀ ▀▄▄▄▀ █  ▀█ █     ▄█▄ ▀▄▄▄▀ ▀▄▄▄▀ █ ▀▄▄ █   █   █   ▄█▄ ▀▄▄▄▀ █   █
  13. ;                                                                  (font 1)
  14. ;
  15. ;
  16. ;                   █▀▀▀▀▀▀   █     █       █▀▀▀▀▀▀
  17. ;                   █▄▄▄▄▄▄   █▄    █▄      █▄▄▄▄▄▄
  18. ;                   ██        ██    ██      ██
  19. ;                   ██        ██    ██▄▄▄▄▄ ██▄▄▄▄▄
  20. ;                                                                  (font 3)
  21. ;                                            (font 4 is reverse video of 3)
  22. ;
  23. ;
  24. ;  ┌╦══╦┐    ┌╦  ╦┐ ┌╦══╦┐ ┌╦═╦═╦┐ ┌╦══╦┐ ┌╦══╦┐ ┌╦    ┌╦╦╦┐ ┌╦══╦┐ ┌╦══╦┐
  25. ;  │╠═╦╩┘ ┌┐ │╠══╣│ │╠══╣│ │║ ║ ║│ │╠═    │╠═╦╩┘ │║      ║   │║  ║│ │║ ═╦┐
  26. ;  └╩ ╚═┘ └┘ └╩  ╩┘ └╩  ╩┘ └╩   ╩┘ └╩══╩┘ └╩ ╚═┘ └╩═╩┘ └╩╩╩┘ └╩  ╩┘ └╩══╩┘
  27. ;                                                                  (font 5)
  28. ;
  29. ;  ┌──────────────────────────────────────────────────────────────────────┐
  30. ;  │       Sample Configuration File for DOWNSORT by Rob Hamerling        │
  31. ;  └──────────────────────────────────────────────────────────────────────┘
  32. ;
  33. ;  Downsort is designed to make many lists in almost any combination
  34. ;  in a single run with several areagroup selections.
  35. ;
  36. ;  Downsort can be invoked with a commandline parameter specifying another
  37. ;  than the default configuration filename ('Downsort.Cfg'), for example:
  38. ;
  39. ;         DOWNSORT @SPECIAL.CFG
  40. ;
  41. ;  (the '@' prefix denotes that a configuration filespec is following)
  42. ;
  43. ;
  44. ;  Rules for parameter specifications in the a configuration file:
  45. ;  ===========================================================
  46. ;   - Leading blanks and empty lines are skipped.
  47. ;   - Lines with '%', '*' or ';' as first non-blank character are
  48. ;     considered to contain comments only and are skipped.
  49. ;   - Lines with a valid keyword but without any parameters, are
  50. ;     considered to be comment lines and are skipped.
  51. ;   - All parameters for a specific keyword should be on a single line.
  52. ;   - Of mutually exclusive values only the last will take effect.
  53. ;   - Invalid or not-recognised parameters may be ignored without notice.
  54.  
  55. ;  ───────────────────────────────────────────────────────────────────────
  56. ;6.2 RegName  The name for which you registered, enclosed in double quotes.
  57. ;6.2 ------   Unregistered use of Downsort is allowed up to 30 days.
  58. ;6.2          See the file 'Register.Txt' for how to register.
  59.  
  60. RegName     "Rob Hamerling"
  61.  
  62. ;  ───────────────────────────────────────────────────────────────────────
  63. ;  First the specifications for the data collection phase
  64. ;  ───────────────────────────────────────────────────────────────────────
  65. ;
  66. ; Farea:       Complete file-specification of your 'FAREA.DAT' file.
  67. ; -----        FAREA.DAT is built by MAX's SILT[P] (-a, -af or -x option).
  68.  
  69.   FareaDat     d:\maximus\farea.dat
  70. ; FareaDat     d:\c\falist\farea.dat
  71.  
  72. ; FileEXclude  Select FILES to be excluded from ALL(!) lists.
  73. ; -----------  By default all files in all (selected) areas will be
  74. ;              included, unless you use this keyword.
  75. ;              Specify 8.3 filename.ext type of strings, wildcards are
  76. ;              allowed and honored, don't use quotes.
  77. ;              The selection is case-insensitive and is independent of area.
  78. ;              You may specify multiple filespecs on a line, separated
  79. ;              by one or more blanks, and as many lines as needed.
  80.  
  81.   FileExclude  FILES.*    *.BAK        SYSTEM*.?BS   DIR.?BS
  82.   FileExclude  00INDEX.*  WILDCAT.TXT  DESCRIPT.ION  TEST
  83.  
  84.  
  85. ; AreaGroup    Defines a logical name for a group of fileareas.
  86. ; ---------    AreaGroups are used to build lists for groups of fileareas.
  87. ;              With AreaINclude and or AreaEXclude keywords following this
  88. ;              AreaGroup keyword, the collection of areas for this group
  89. ;              is defined. The groups are independent: areas may be member
  90. ;              of more than one group, other areas may not be in any group.
  91. ;              A new AreaGroup keyword closes the previous.
  92. ;6.2           During data collection only the required areas are scanned.
  93. ;6.2           WARNING: If at least one list doesn't specify an areagroup,
  94. ;6.2                    file info of ALL area's is collected, which may
  95. ;6.2                    significantly downgrade the performance of Downsort,
  96. ;6.2                    especially when CDROM drives are involved!
  97. ;6.2           NOTE: Areagroups are only meaningful in combination with a
  98. ;6.2                 '-S' specification on an xxxFileList line (see below)!
  99.  
  100. ; AreaINclude  Select areas to be INCLUDED in the group.
  101. ; AreaEXclude  Select areas to be EXCLUDED from the group.
  102. ; -----------  Character strings define which filedivisions and/or
  103. ;6.2           fileareas have to be INcluded in or EXcluded from the group.
  104. ;6.2           The strings are used as PREFIX. All areanames that start with
  105. ;6.2           the specified string are considered 'matching' the
  106. ;6.2           specification. The FULLY QUALIFIED areanames (including
  107. ;6.2           Division prefixes!) are considered.
  108. ;6.2           You may specify multiple strings on a line, separated by one
  109. ;6.2           or more blanks, and as many lines as needed. AreaINclude
  110. ;6.2           and AreaEXclude keywords may appear in any sequence, in
  111. ;6.2           Downsort.cfg. All comparisons are case-INsensitive.
  112.  
  113. ;              The following rules determine which areas will be member of
  114. ;              an AreaGroup:
  115. ;6.2           - If only areaINclude is specified for a group, then ONLY
  116. ;6.2             the areas of which the name matches with any areaINclude
  117. ;6.2             string will be member of this group.
  118. ;6.2           - If only areaEXclude is used for a group then ALL(!) areas
  119. ;6.2             will be included EXCEPT those areas of which the name
  120. ;6.2             matches with any areaEXclude string.
  121. ;6.2           - If both areaINclude and areaEXclude are specified for a
  122. ;6.2             group, then all areaINcludes precede any areaEXclude.
  123. ;6.2           - If neither areaINclude nor areaEXclude is specified
  124. ;6.2             then the group is empty.
  125.  
  126. ;              Hints for the use of AreaGroups:
  127. ;6.2           - If you don't use areaINclude, you probably want to
  128. ;6.2             areaEXclude 'Sysop', 'Upload', 'Inbound', etc.
  129. ;6.2             More genarally: remember to areaEXclude those areas that
  130. ;6.2             you normally won't show to all of your users!
  131. ;              - You would normally use one of both keywords. Using them
  132. ;                both is only meaningful if the areaEXclude strings are
  133. ;                more restrictive (longer) then the areaINclude strings.
  134. ;                See for an example the AreaGroup 'HOB' below:
  135. ;                Suppose you have fileareas named HC000 to HC999
  136. ;                in a filedivision Hob (denoting the HOBBES CDROM),
  137. ;                then the group HOB would select the files from
  138. ;                areas HC000 to HC039, but NOT those ending with a '9'.
  139.  
  140.   AreaGroup  OS2
  141.      AreaINclude  OS2. FW.
  142.   AreaGroup  nonOS2
  143.      AreaEXclude  OS2. FW. SYSOP. UPLOAD INBOUND
  144.   AreaGroup  HOB
  145.      AreaINclude  Hob.hc00  Hob.hc01  Hob.hc02  Hob.hc03
  146.      AreaEXclude  Hob.hc009 Hob.hc019 Hob.hc029 Hob.hc039
  147.  
  148.  
  149. ;  ───────────────────────────────────────────────────────────────────────
  150. ;  Above parameters involve the data collection (selection) process,
  151. ;  below follow the report specifications.
  152. ;  Firstly the common parameters that apply to all lists (if applicable).
  153. ;  ───────────────────────────────────────────────────────────────────────
  154. ;  Title:      Short string that will be displayed in BLOCK-characters
  155. ;6.2 ---       on top of NEW, TOP, IPF, IPN, GBL and ALL, but not in
  156. ;6.2           BBS, ORP, DUP, USR and FILES.BBS.
  157. ;              An unlimited number of 'Title'-lines may be specified.
  158. ;              If Title isn't specified, no blocktitles will appear.
  159. ;              The following characters are supported in block-fonts:
  160. ;                  UPPER case  A..Z
  161. ;                  LOWER case  a..z  (but will be presented in UPPER case)
  162. ;                  Digits 0..9
  163. ;6.2               _  *  |  .  :  [  ]  (  )  /  \  -  and space
  164. ;              Not-supported characters are displayed as blank.
  165. ;              The '`'-character (reverse quote) is translated into a half
  166. ;              width space, the '~'-character into a full width space.
  167.  
  168.   Title        ~DownSort~
  169.   Title        ~~~from~~~~
  170.   Title        ~Holland~~
  171.  
  172. ;  PreTitle    Lines to be displayed immediately before the BLOCK-title.
  173. ;  --------    The lines will be copied as is. However leading blanks will
  174. ;              be skipped, no wrapping or truncation will be applied for
  175. ;              'long' lines. '~' (tilde) characters are translated to
  176. ;              blanks. You may specify an unlimited number of PreTitle lines.
  177. ;              Empty PreTitle lines are ignored. There is no default PreTitle.
  178. ;              To create empty lines in your header specify a PreTitle
  179. ;              with a tilde.
  180.  
  181.   PreTitle     ~
  182.   PreTitle     ~~~~~~~<═════:═════ p r e - t i t l e ═════:═════>
  183.   PreTitle     ~
  184.  
  185. ;  SubTitle    Lines to be displayed below the BLOCK-title.
  186. ;  --------    Exactly the same rules apply as for PreTitle.
  187. ;              If an include file is specified on the xxxFileList line, then
  188. ;              this is inserted between block title and subtitle!
  189.  
  190.   SubTitle     ~
  191.   SubTitle     ~~~~~~~<═════&═════ s u b - t i t l e ═════&═════>
  192.   SubTitle     ~  Overview of downloadable files on this magnificent Board
  193.   SubTitle     ~     Node number 9.999/99, modemspeeds: V.99/V.99bis
  194.   SubTitle     ~~~~~~~<═════════════════════════════════════════>
  195.   SubTitle     ~
  196.  
  197. ;  BottomLine  Lines to be displayed at the end of the filelist.
  198. ;  ----------  Exactly the same rules apply as for PreTitle and Subtitle.
  199. ;
  200.  
  201.   BottomLine   ~
  202.   BottomLine   ~~~~~~~<═══════ b o t t o m : t i t l e ═════════>
  203.   BottomLine   ~
  204.   BottomLine   ~~~~~~~<═══ How do you like DOWNSORT, folks? ════>
  205.   BottomLine   ~
  206.  
  207. ; DupNameSize  Indicates the number of characters of the fileNAME that are
  208. ; -----------  maximally to be compared to consider a name 'duplicate'.
  209. ;              Allows version numbers to be detected, for example:
  210. ;              with "DupNameSize 6" DWNSRT61.ZIP and DWNSRT62.ZIP will
  211. ;              appear as duplicates in the DupFileList report.
  212. ;              Default: 8
  213.  
  214.   DupNameSize  8
  215.  
  216. ; NonDupEXT    Suppress reporting as 'duplicate' if 2 files with equal
  217. ; ---------    filenames but unequal extensions are defined as 'pair'.
  218. ;              The example specification below has the effect that files of
  219. ;              any pair "xyz.SDA" and "xyz.SDN"  ("xyz": any filename) will
  220. ;              not be listed in DupFileList.
  221. ;               -  Files with equal filename AND equal extension will
  222. ;                  still be reported as duplicate even when the extension
  223. ;                  is one of a 'NonDupEXT' pair!
  224. ;               -  Multiple extensions must be specified in as many pairs
  225. ;                  as can be formed (3 extension 3 pairs; 4 ext. 6 pairs;
  226. ;                  etc, e.g: for Nodelists:  DAT EXT  DAT IDX  EXT IDX).
  227. ;              You may specify multiple extension-pairs on a line
  228. ;              (separate the extensions with blanks), and as many lines
  229. ;              as needed.
  230. ;              Default: no suppression
  231.  
  232.   NonDupEXT    SDN SDA
  233.  
  234. ; OrphanDesc   Description text of 'orphan' (file without entry in FILES.BBS)
  235. ; NotFoundDesc Description text of files without description in FILES.BBS.
  236. ; ------------ The description will replace the default hard-coded text.
  237. ;              Up to 45 characters may be specified.
  238. ;              The '~' (tilde) character will not be translated here!
  239.  
  240.   OrphanDesc   ~~~~~   Orphelin!!!!   ~~~~~
  241.   NotFoundDesc ~~~ Ce fichier défie toute description!
  242.  
  243.  
  244. ; OfflineDesc  When a filespecification is found in FILES.BBS but the file
  245. ; -----------  is not found in the corresponding download directory, this
  246. ;              text replaces the filesize and date (right aligned).
  247. ;              Up to 14 characters are accepted.
  248.  
  249.   OfflineDesc  -- archived --
  250.  
  251. ; AVAstrip     You may wish to strip off AVATAR graphics characters from
  252. ; --------     the contents of your FILES.BBS files.
  253. ;              Specify 'No' to deactivate stripping (default is 'Yes').
  254. ;              ==> Works ONLY for COMMENT LINES in ALL- and IPF-lists, and
  255. ;              remember: comments are only listed with KEEPSEQ (no sort).
  256.  
  257.   AVAstrip     Yes
  258.  
  259. ; AreaOrder    Order in which areas have to be sorted in the lists.
  260. ;              Selection can be: A[lpha]   - Alphabetic order of areaname
  261. ;6.2                             G[roup]   - Group (FileDivision) order
  262. ;                                I[nclude] - order of areaINclude
  263. ;                                K[eep]    - Keep order of FAREA.DAT
  264. ;              Specify one of these type (first letter is sufficient).
  265. ;6.2           Where areanames are involved in sorts, the sequence will be
  266. ;6.2           according to AreaOrder. With 'Group' the areas will be sorted
  267. ;6.2           alphabetically in sequence of the fully qualified areaname,
  268. ;6.2           (including division prefixes), with 'Alpha' areas will be
  269. ;6.2           in sequence of the unqualified areaname (ignoring divisions).
  270. ;6.2           'Group' and 'Keep' will make division boundaries visible.
  271. ;6.2           Note: 'Include' uses the AreaInclude specifications, which
  272. ;6.2           are prefixes. Areas matching the same AreaInclude string
  273. ;6.2           will be sorted in 'Keep' sequence.
  274. ;              Default: Group
  275.  
  276.   AreaOrder    Group
  277.  
  278. ; ──────────────────────────────────────────────────────────────────────
  279. ; Above were the parameters common to most lists.
  280. ; Below follow list-specific parameters, which might override some of
  281. ; the settings of the common parameters.
  282. ; Keep this sequence: first common, then specific parameters!
  283. ; ──────────────────────────────────────────────────────────────────────
  284. ;
  285. ; xxxFileList:  Create a File lists of type 'xxx' (1 list per keyword)
  286. ;
  287. ;  xxx ───┐          ┌── Specification of output
  288. ;                   │
  289. ;    ┌── BBS         │        ┌── Additional options for
  290. ;    ┌── ALL         │        │   each list individually:
  291. ;    ┌── GBL         │        │
  292. ;    ┌── NEW         │        │ -A     Alphabetic sort on filename
  293. ;    ┌── IPF         │        │ -Cn    Continuation-line indent
  294. ;6.2 ┌── IPN         │        │ -D     Date sort (descending)
  295. ;6.2 ┌── TOP         │        │ -F#    Font number for BLOCK title (1..5)
  296. ;    ┌── USR         │        │ -G     Group (division) sort
  297. ;    ┌── ORP         │        │ -If    Imbed filespec
  298. ;    ┌── OK          │        │ -K     Keep original FILES.BBS sequence
  299. ;    ┌── DUP         │        │ -L     Long line type (+filesize+date)
  300. ;    │               │        │ -O     Orphans to be reported / adopted
  301. ;    │               │        │ -R     Remove 'not-found' file descriptions
  302. ;    │               │        │ -Sg    Select areagroup 'g'
  303. ;    │               │        │ -T     Truncate file descriptions
  304. ;    │               │        │ -Um    USRmodel logical name selection
  305. ;    │               │        │ -W     Wrap file descriptions
  306. ;    │               │        │ -X     eXclude display of ACS in headers
  307. ;    │               │        │ nnn[P] entries limit: number or period
  308. ;    │               │        │        ('P' = Days | Weeks | Months)
  309. ;                           
  310. ;   ═══─═══════  ════════  ════════════════════════════════
  311. ;   xxxFileList  PathSpec  Option-1 Option-2 . . . Option-n
  312. ;
  313. ;6.2   Maximus' PRIVILEGE and USERLOCK/KEYS are NOT SUPPORTED anymore.
  314. ;
  315. ;6.2   The output 'PathSpec' for each list MUST be specified.
  316. ;
  317. ;  The following options may be specified (in any sequence):
  318. ;     -A   Sort files Alphabetically on filename
  319. ;     -D   Sort files on Date/time of the files
  320. ;     -G   Sort files on Group (division) name
  321. ;     -K   Keep sequence of files as they appear in FILES.BBS.
  322. ;          Note: not all sorts apply to all list types (but most do)
  323. ;
  324. ;     -Cn  Continuation Indentation of description: relative position
  325. ;          of description on second and following lines if wrapped
  326. ;          descriptions are used. 'n' will normally be the width of
  327. ;          a download counter field.
  328. ;          May be specified negative for left-indentation (e.d. -C-16)!
  329. ;
  330. ;6.2  -F#  BLOCK title font. Choose for '#' a number from 1 to 5.
  331. ;          Valid numbers:   1 .. Simple font             (5x6 pattern)
  332. ;                           2 .. Pseudo-Stencil Font     (7x10 pattern)
  333. ;                           3 .. ROBoComputer Font       (7x8 pattern)
  334. ;                           4 .. Reversed Video RoboComp (7x8 pattern)
  335. ;6.2                        5 .. Wide open font          (7x6 pattern)
  336. ;          See some samples of the fonts in the top of this file.
  337. ;6.2       Default font is 3, which is hard coded in some parts of the lists.
  338. ;6.2       By specification of '-F' or 'F0', you may suppress block titles
  339. ;6.2       (maybe also on places where you still want 'm, experiment!).
  340. ;
  341. ;     -If  Imbed userfile ('f' is file-spec) immediately following the
  342. ;          block-title (if any). The contents of the file is included without
  343. ;          any translation, so beware of special characters and effects like
  344. ;6.2       formatting (word-wrap) especially in the IPF- and IPN-list!
  345. ;          NOTEs: - does not apply to lists of 'Sysop'-type (like DUP and ORP)
  346. ;                 - BBSFileList imbeds always DOWNSORT.HDR and DOWNSORT.TRL
  347. ;
  348. ;     -L   Long list format for some selected list types:
  349. ;           - FILFilePath: see (almost) at the end of this file.
  350. ;
  351. ;6.2  -O   Orphans to be reported in xxxFileList or adopted in FILES.BBS.
  352. ;6.2       Orphans are files in the download directory that have no entry
  353. ;6.2       in the corresponding FILES.BBS. The entries will get the
  354. ;6.2       'OrphanDesc' and will be reported in any xxxFileList when the
  355. ;6.2       flag -O is specified. But it has effect only when also an
  356. ;6.2       ORPFileList is requested!
  357. ;6.2       Default: orphans will NOT be listed or adopted.
  358. ;
  359. ;     -R   Remove 'offline' file-entries.
  360. ;          'Offline' files have an entry in Files.Bbs, but are not in the
  361. ;          download directory of this area.
  362. ;          These files will be listed with 'offline' in the size/date field.
  363. ;          When you specify '-R' the file will not appear in the list, and
  364. ;          when specified on xxxFilePath, it will be removed from Files.Bbs.
  365. ;6.2       Default: list and do not remove 'offline' file entries.
  366. ;
  367. ;     -Sg  Select AreaGroup for the list ('g' should be a name defined with
  368. ;          AreaGroup keyword). The list will only contain areas of the
  369. ;6.2       of the specified group.
  370. ;6.2       If the specified group is not defined the list will be empty.
  371. ;6.2       If no group is selected the list will contain ALL areas.
  372. ;          Default: All areas will be included.
  373. ;
  374. ;     -T   Causes Truncation of long descriptions (to about 50 characters)
  375. ;          so that each file-entry takes not more than a single line.
  376. ;     -W   Causes Wrapping of long descriptions: the report will contain
  377. ;          as many lines as needed for the complete file description.
  378. ;
  379. ;     -Um  USRmodel-name to be selected for USRFileList.
  380. ;          'm' should be the name of one of the specified USRmodel statements.
  381. ;6.2       Default: nothing (no list generated)
  382. ;
  383. ;6.2  -X   eXclude ACS reporting the list-headers.
  384. ;
  385. ;   nnn[P] Limit the number of file-entries to a maximum of 'nnn'.
  386. ;          If followed by Period-indicator ('D', 'W' or 'M') the list is
  387. ;          limited not by number, but by file-AGE in Days, Weeks or Months.
  388. ;          NOTEs: - the Period-letter does not apply to IPF-lists
  389. ;                 - 'nnn' denotes maximum number of files on a VIEW-page.
  390. ;                 - ALL-lists can only be limited by period (not number).
  391.  
  392.   AllFileList  list\Allfiles.all      -a -W -f5              -IDownsort.Inc
  393.   AllFileList  list\Allfiles.new   2m -a -w -f5 -x           -IDownsort.Inc
  394.   AllFileList  list\Allfiles.hob      -k -W         -sHOB    -IDownsort.Inc
  395.   AllFileList  list\Allfiles.dos      -k -W         -snonOS2 -IDownsort.Inc
  396.   BBSFileList  list\Bulletin.bbs   3w -d -w     -x
  397.   GblFileList  list\GblFiles.psq      -a -w   -c6            -IDownsort.Inc
  398.   IpfFileList  list\Allfiles.Ipf  200 -k -w         -sOS2
  399.   IpnFileList  list\Newfiles.Ipf   6w -g    -f1     -sOS2
  400.   NewFileList  list\Newfiles.psq   2m -g -w -f2 -x
  401.   TopFileList  list\TOPfiles.psq   30 -a -w
  402.   DupFileList  list\Dupfiles.psq
  403.   OKFileList   list\Okfile.psq                               -iDownsort.mag
  404.   OrpFileList  list\Orphans.psq       -g
  405.  
  406. ;  NOTE: The IPF-list has the format of an INPUT-file for the
  407. ;        Information Presentation Facility Compiler (IPFC).
  408. ;        It should be compiled with:  "IPFC  Allfiles.IPF  /INF"
  409. ;        This will produce a file called Allfiles.INF, which is ready
  410. ;        to be viewed with the command:   VIEW  Allfiles
  411. ;        Note: The IPFC compiler is not distributed with DOWNSORT,
  412. ;              but could be obtained for the IBM program development
  413. ;              toolkit for OS/2 2.0+, or is part of a compiler package.
  414.  
  415. ; ──────────────────────────────────────────────────────────────────────
  416. ; USRFileList   Builds a list of 'user format' lines with file information.
  417. ; -----------   It is designed to build batch-files for file maintenance.
  418. ;               The format of each line is a variable string. It is given a
  419. ;               name with the USRmodel keyword. The corresponding format is
  420. ;               the line immediately following he name (use no space-lines!).
  421. ;               The format-string may contain symbolic variables that will be
  422. ;               replaced by the actual value of file- or area-information
  423. ;               as follows:
  424. ;6.2             %$ - ACS (Access Control String) of area
  425. ;                %2 - duplicate file flag: '2' if duplicate file, '1' if not.
  426. ;6.2             %A - Areaname (fully qualified with division prefixes).
  427. ;                %C - file Creation date (fixed 8 characters)
  428. ;                %D - most recent of lastwrite and creation Date of file
  429. ;                %F - Filename.ext
  430. ;                %H - File-age in days
  431. ;                %N - Download count (from [nnn] in FILES.BBS file-desc)
  432. ;                %P - Path specification of the file's download directory
  433. ;                %S - file Size
  434. ;6.2             %U - Unqualified areaname (without division prefix)
  435. ;                %W - file lastWrite date
  436. ;                %Z - file lastAccess date
  437. ;               Notes: - unknown symbolic variables are copied asis.
  438. ;                      - to obtain '%' on the outputline specify: '%%'
  439. ;
  440. ;               A number of example statements as suggestions:
  441. ;               - The first USRmodel builds a batch file (REXX) to move
  442. ;                 Fernwood files from their original directory to a directory
  443. ;                 with areaname as the subdirectory-name of G:\Fernwood\.
  444. ;               - The second model will erase files older than 2 years but
  445. ;                 only when downloaded not more than 5 times
  446. ;               - The third model is a specification for a 'long' OKfile.
  447. ;               - The fourth model contains all symbolic variables
  448. ;                 supported by Downsort for USRFileList.
  449.  
  450.   USRmodel move
  451. move '%P%F G:\Fernwood\%U\'
  452.   USRmodel old
  453. if %H > 730 & %N < 5 then  erase '%P%F'   /* filedate: %D */
  454.   USRmodel ok
  455. @%F %P%F
  456.   USRmodel all
  457. %%$=%$ %%2=%2 %%A=%A %%C=%C %%D=%D %%F=%F %%H=%H %%N=%N %%P=%P %%S=%S %%U=%U %%W=%W %%Z=%Z
  458.  
  459.    USRFileList  list\usrlist1.cmd  -G  -UFW   -sOS2     -Idownsort.rex
  460.    USRFileList  list\usrlist2.cmd  -G  -Uold            -Idownsort.rex
  461.    USRFileList  list\usrlist3.OK   -a  -Uok
  462.    USRFileList  list\usrlist4.all  -G  -Uall  -sOS2
  463.  
  464. ; ──────────────────────────────────────────────────────────────────────
  465. ;  Below follow the specifications for manipulating/rebuilding FILES.BBS
  466. ; ──────────────────────────────────────────────────────────────────────
  467. ; FILFilePath  - First parameter is [optional] specification of
  468. ; -----------    destination directory of newly generated 'FILES.BBS' files.
  469. ;                Use the format:  drive:\path\
  470. ;                If 'pathspec' is specified the output-files will be called
  471. ;6.2             "areaname.BBS" (filedivision prefix removed). Long
  472. ;6.2             areanames will be truncated to the first 8 characters.
  473. ;                If not specified the MAXIMUS path specification will be
  474. ;                used (FileList parameter if used in Maximus' FAREA.CTL, or
  475. ;                otherwise the Download directory).
  476. ;              - Many but not all flags as defined for the other lists
  477. ;                apply to the FILES.BBS-output of Downsort, for example:
  478. ;6.2              - File-descriptions will be wrapped or truncated to
  479. ;6.2                lines with a maximum length of 1024 characters.
  480. ;6.2                Default: Wrap
  481. ;                 - Title specifications are ignored.
  482. ;                 - Entries can be sorted, but then you will loose your
  483. ;                   comments: -K (Keep sequence and comments) is default.
  484. ;                 - -L (LONG) means: include file size and file date.
  485. ;                   Do not run Downsort more than one time with this option!
  486. ;                 - Avatar codes will not be touched.
  487. ;              - When using group selection ('-Sg') and multiple FILFilePaths,
  488. ;                beware not to  overwrite previous output (e.g. define and
  489. ;                use mutually exclusive groups, such as the OS2 and nonOS2
  490. ;                example above).
  491.  
  492.    FILFilePath   list1\   -a    -R
  493.    FILFilePath            -a    -R
  494.  
  495. ;  ────────────────────────────────────────────────────────────────────────
  496. ;
  497. ; End of sample Downsort.Cfg as provided with the orginal Downsort package.
  498. ;
  499.