home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / qfb110.zip / QFB.INF (.txt) < prev    next >
OS/2 Help File  |  1996-08-15  |  29KB  |  877 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Readme First ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. QFB Readme First
  6.  
  7.  
  8. ΓòÉΓòÉΓòÉ 1.1. Files in the archive ΓòÉΓòÉΓòÉ
  9.  
  10.  
  11. Files in the original archive:
  12.  
  13. File_Id.Diz   The standard archive description
  14. Qfb.Exe     The executable
  15. Qfb.Inf     The Inf hypertextual Manual
  16. Readme.1st   This file
  17. Whatsnew.Txt  Changes and additions
  18. Qfb.Doc     The user's manual
  19.  
  20.               Dos Only
  21.  
  22. Dos4Gw.Exe   Dos Extender (major releases only)
  23.         If you have a maintenance release of the program,
  24.         the dos extender will not be included, to avoid
  25.         unnecessary distribution costs.
  26.  
  27.  
  28. The OS/2 Inf manual is provided with other versions too,
  29. since there are INF viewers under Dos. For example, the very
  30. nice viewer by Damir Ujcic: VIEW01.ZIP, available for F/R from
  31. 2:332/504@fidonet: it contains a text mode viewer in both OS/2
  32. and Dos versions.
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 1.2. Whatsnew ΓòÉΓòÉΓòÉ
  36.  
  37.               Whatsnew
  38.  
  39. If you are using an older version of the program, please read
  40. WhatsNew.Txt before using this version.
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 1.3. How to contact the author ΓòÉΓòÉΓòÉ
  44.  
  45.  
  46.           How to contact the author
  47.  
  48. If you have suggestions, bug reports, observations about the
  49. docs, please feel free to contact me at the following
  50. addresses:
  51.  
  52. Alberto Pasquale of 2:332/504@fidonet
  53.  
  54. alberto.pasquale@mo.nettuno.it
  55.  
  56. 2:332/504@fidonet +39-59-246112 ISDNC V34+ VFC V32T H16
  57. 2:332/524@fidonet +39-59-246113 ISDNC V34  VFC V32T H16 FAX
  58.  
  59. Alberto Pasquale, Viale Verdi 106, 41100 Modena, Italy
  60.  
  61. IMPORTANT: if you call crash and require an answer, please state
  62. whether you want it routed (might not be reliable) or ON HOLD
  63. (in which case an answer should be available in 48h maximum,
  64. apart from the holiday periods).
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 1.4. Support ECHO ΓòÉΓòÉΓòÉ
  68.  
  69.  
  70.              Support ECHO
  71.  
  72. I am originating an international support echo for all my
  73. programs. If you are interested, please ask your echo feeder to
  74. find a suitable link for the APWORKS area. In addition, I
  75. regularly read the international OS2BBS echo.
  76.  
  77.  
  78. ΓòÉΓòÉΓòÉ 1.5. TIC distribution ΓòÉΓòÉΓòÉ
  79.  
  80.  
  81.             TIC distribution
  82.  
  83. All my BBS related programs are distributed via a TIC file area.
  84. If you want to join, please ask your file feeder to find a
  85. suitable link for the APBBS (OS/2) and/or APBBSDOS (Dos/NT)
  86. area.
  87.  
  88. Beta versions are distributed without restrictions in
  89. APBBSBETA and APBBSDOSBETA respectively.
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 1.6. APWorks Programs and Support Areas ΓòÉΓòÉΓòÉ
  93.  
  94.  
  95.             Where to look for
  96.         APWorks Programs and Support Areas
  97.  
  98. In North America the APWORKS support echo should be easily
  99. available, since it is on the Zone 1 backbone.
  100.  
  101.  
  102. The following systems carry the ApWorks echo and file areas:
  103.  
  104.  
  105.               Author's
  106. APWORKS
  107.   Alberto Pasquale, Modena, Italy
  108.   alberto.pasquale@mo.nettuno.it
  109.   2:332/504@fidonet +39-59-246112 ISDNC V34+ VFC V32T H16
  110.   2:332/524@fidonet +39-59-246113 ISDNC V34  VFC V32T H16
  111.   File requests could be declined between 23:00 and 06:00 GMT.
  112.   Request APFILES for a (short) list of APWORKS files only.
  113.  
  114.  
  115.                Europe
  116.  
  117. ApWorks_Germany
  118.   Roland Schiradin, Eltville, Germany
  119.   degr9tr9@ibmmail.com
  120.   2:2454/169@fidonet
  121.  
  122. Cyberia/2
  123.   Harald Kamm, Bamberg, Germany
  124.   2:2490/3045@fidonet
  125.  
  126. McBears Cave
  127.   Jens Holm, Skanderborg, Denmark
  128.   2:238/888@fidonet
  129.  
  130. MufNet HQ
  131.   Paul Bergquist, Hollviken, Sweden
  132.   2:200/146@fidonet
  133.   paul.bergquist@moderat.se
  134.   paulb@sbbs.se
  135.  
  136. The BackRoom/2 BBS
  137.   Martin Davies, Cardiff, Wales, United Kingdom
  138.   gbear@backroom.baynet.co.uk
  139.   2:442/617@fidonet
  140.  
  141. Air Applewood
  142.   Vince Coen, Roydon, Harlow, Essex, United Kingdom
  143.   2:257/609@fidonet
  144.  
  145. PULSAR BBS
  146.   Branko Radojevic, Dubrovnik, Croatia
  147.   branko@pfdu.hr
  148.   sysop@pulsar.fido.hr
  149.   2:381/124@fidonet
  150.  
  151.  
  152.              North America
  153.  
  154. COMM Port OS/2
  155.   Bob Juge, Sugar Land, TX, USA
  156.   bob@juge.com
  157.   1:106/2000@fidonet
  158.  
  159. The CrossRoads
  160.   Dave Reed, Puyallup, WA, USA
  161.   dreed@aa.net
  162.   1:138/135@fidonet
  163.  
  164. Eclectic Lab 1
  165.   Mary-Anne Wise, New Westminster, BC, Canada
  166.   1:153/831@fidonet
  167.  
  168. Filebone:  MaxFDN
  169.   Available via Planet Connect, PageSat, Filebone,
  170.   paonline ftphub and the Filegate Project.
  171.  
  172.  
  173.               Australia
  174.  
  175. Tardis BBS
  176.   Malcolm Miles, North Balwyn, VIC, Australia
  177.   3:633/260@fidonet
  178.  
  179.  
  180. ΓòÉΓòÉΓòÉ 1.6.1. File Areas on the Internet ΓòÉΓòÉΓòÉ
  181.  
  182.           File Areas on the Internet
  183.  
  184.  
  185.                 UK
  186.  
  187. ftp.enterprise.net
  188.   /apworks
  189.  
  190. ftp.baynet.co.uk
  191.   /pub/apworks/os2
  192.   /pub/apworks/dos
  193.   /pub/apworks/beta
  194.  
  195.  
  196.                USA
  197.  
  198. ftp.juge.com
  199.  
  200. cmnsens.zoom.com
  201.   /pub/apworks/bbs
  202.   /pub/apworks/bbsdos
  203.   /pub/apworks/beta
  204.   /pub/apworks/dosbeta
  205.  
  206. ftp.oeonline.com
  207.   /pub/Maximus
  208.  
  209. ftp.wilmington.net
  210.   /bmtmicro
  211.   Only the public release versions of programs that can be
  212.   registered via Bmt Micro.
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 1.7. Latest Versions ΓòÉΓòÉΓòÉ
  216.  
  217.  
  218.             How to Request the
  219.         Latest Version of APWORKS Programs
  220.  
  221.  
  222. The following magics are honoured by APWORKS and some of the
  223. support sites:
  224.  
  225. Magic   Name     Description
  226.  
  227. APFILES  ApFiles.Lst    List of Programs by Alberto Pasquale
  228.  
  229. FASTLST  FLST???.RAR  OS/2 The ultimate v7 Nodelist processor.
  230.               Fully automated processing and
  231.               maintenance, no need for clumsy batch
  232.               files. Can report to Squish or *.MSG
  233.               areas, multitasking friendly, many
  234.               options.
  235.  
  236. FASTLSTD FLSTD???.RAR DOS
  237.  
  238. FASTLSTW FLSTW???.RAR NT
  239.  
  240. FASTLSTG          German Docs by Roland Schiradin
  241.               Available on 2:2454/169
  242.  
  243. NEF    NEF???.RAR  OS/2 TIC file distribution and
  244.               announcement for Binkley-style
  245.               outbound and *.MSG or Squish message
  246.               base, file-Areafix included with
  247.               FileBone support, full multitasking
  248.               aware (BSY, file sharing etc.),
  249.               exceptionally flexible Multi-Aka
  250.               support.
  251.  
  252. NEFD   NEFD???.RAR  DOS  32 bit only, w DOS4GW extender.
  253.  
  254. NEFW   NEFW???.RAR  NT
  255.  
  256. NEFG            German Docs by Roland Schiradin
  257.               Available on 2:2454/169
  258.  
  259. FLM    FLM???.RAR  OS/2 File List Manager for Maximus,
  260.               very flexible way of compiling
  261.               many different lists at a time.
  262.               Internal file base support
  263.               (no need for FBP).
  264.  
  265. FLMD   FLMD???.RAR  DOS  32 bit only, w DOS4GW extender.
  266.  
  267. FLMW   FLMW???.RAR  NT
  268.  
  269. NMFW   NMFW???.RAR  OS/2 Multi-Robot: netmail forward to
  270.               Sysop's point, Maximus user and file
  271.               management via netmail messages,
  272.               areafix for squish, point routing to
  273.               their boss if no phone number for
  274.               them in the nodelist, etc.
  275.  
  276. NMFWD   NMFWD???.RAR DOS  32 bit only, w DOS4GW extender.
  277.  
  278. NMFWW   NMFWW???.RAR NT
  279.  
  280. QFB    QFB???.RAR  OS/2 Substitute for FBP.EXE
  281.               Generates a separate file-request
  282.               index with no duplicates.
  283.  
  284. QFBD   QFBD???.RAR  DOS  32 bit only, w DOS4GW extender
  285.  
  286. QFBW   QFBW???.RAR  NT
  287.  
  288. QFBG            German Docs by Roland Schiradin
  289.               Available on 2:2454/169
  290.  
  291. SQPRV   SQPV???.RAR  OS/2 Local area (private/public) forward
  292.               to points for Squish. The (Co)SysOp
  293.               points can receive the whole area.
  294.  
  295. SQPRVD  SQPVD???.RAR DOS
  296.  
  297. -----   SQFM110.RAR  OS/2 Allows to change the "from address"
  298.               of PKTs before they are compressed.
  299.               To be used with Squish.
  300.               For example, it is useful to Hub
  301.               coordinators who want to continue
  302.               processing mail with their primary
  303.               address for current links while
  304.               processing with the administrative
  305.               address for their uplink BackBone.
  306.               FreeWare.
  307.  
  308. -----   SQFMW110.RAR NT
  309.  
  310. -----   SqSetAll.Rar OS/2 Sets renum limits in all Squish Areas
  311.               taking the parameters from
  312.               Squish.Cfg.
  313.  
  314. -----   SqSetDos.Rar DOS  Dos version.
  315.  
  316. -----   AdjFDate.Rar OS/2 Changes by +-N days the File Date.
  317.               Can choose between Creation and
  318.               Modification dates on HPFS.
  319.               Show and Touch options.
  320.  
  321. -----   AdjF_Dos.Rar DOS  Changes by +-N days the File Date.
  322.  
  323.  
  324. Current versions (Aug 15th 1996): NEF 2.37, FastLst 1.36,
  325. FLM 1.36, NMFWD 2.05, QFB 1.10, SQPrv 1.04.
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 1.8. Bug Reports ΓòÉΓòÉΓòÉ
  329.  
  330.  
  331.              Bug Reports
  332.  
  333. If you find out a real bug, I will do my best to fix it and make
  334. the new version available in a few days. To do that, I need your
  335. cooperation: when you find a strange behaviour, double check
  336. your configuration and the manual to be really sure it's not
  337. your fault, then study the conditions in which the bug appears
  338. and, in the end, send me your detailed report about the bug
  339. together with your config file and all the stuff necessary to
  340. replicate the problem. I can fix a bug only if I am enabled to
  341. reproduce it !
  342.  
  343.  
  344. ΓòÉΓòÉΓòÉ 1.9. Wish List ΓòÉΓòÉΓòÉ
  345.  
  346.             Wish List
  347.  
  348.  
  349. To help me provide a better and better program, please let
  350. me know your problems and your wishes about future versions.
  351.  
  352. Please let me know your opinion:
  353.  
  354. Alberto Pasquale 2:332/504@fidonet
  355. alberto.pasquale@mo.nettuno.it
  356.  
  357. BBS:   +39-59-246112 ISDNC V34+ VFC V32T H16
  358. BBS/FAX: +39-59-246113 ISDNC V34  VFC V32T H16 FAX
  359.  
  360. Viale Verdi 106
  361. 41100 Modena
  362. Italy
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ 2. Whatsnew ΓòÉΓòÉΓòÉ
  366.  
  367.                QFB
  368.  
  369.            Changes and Additions
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 2.1. 1.10 ΓòÉΓòÉΓòÉ
  373.  
  374.  
  375. 1.10  Aug 15 1996
  376.  
  377.    - Files.Bbs lines starting with an high ascii character
  378.     (>127) in the first column are now taken as comments.
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 2.2. 1.09 ΓòÉΓòÉΓòÉ
  382.  
  383.  
  384. 1.09  Jun 21 1996
  385.  
  386.    - Added -q switch.
  387.  
  388.    - Improved doc.
  389.  
  390.    - New NT version.
  391.  
  392.  
  393. ΓòÉΓòÉΓòÉ 2.3. 1.08 ΓòÉΓòÉΓòÉ
  394.  
  395.  
  396. 1.08  Mar 31 1996
  397.  
  398.    - The logic of the "-s" switch has changed: now ALL areas
  399.     except the "slow" ones are processed and the global
  400.     indexes are updated (not re-built) when this switch is
  401.     used.
  402.  
  403.     Previously the "-s" switch only caused slow areas to be
  404.     skipped, so that they were usually removed from the
  405.     global indexes.
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 2.4. 1.07 ΓòÉΓòÉΓòÉ
  409.  
  410.  
  411. 1.07  Feb 29 1996
  412.  
  413.    - Added "-d" switch to avoid multi-line descriptions in
  414.     FILES.DMP, the file where Maximus looks for the file
  415.     descriptions when using the filebase (Locate and NewFiles
  416.     commands).
  417.  
  418.     When multi-line description support is enabled, QFB
  419.     outputs the entire description string (line feeds
  420.     included) to the FILES.DMP, so that the Maximus Locate
  421.     and New Files commands respect the original formatting.
  422.  
  423.     Unfortunately there is a side-effect: the continuation
  424.     lines are aligned at left, and this is not appreciated by
  425.     some SysOps.
  426.  
  427.     When the "-d" switch is used, QFB changes the linefeeds
  428.     to spaces, so that the DMP description is made of a
  429.     long unique line: the original formatting is lost but the
  430.     description will be aligned and word-wrapped by Maximus
  431.     when the Locate or NewFiles commands are used.
  432.  
  433.    - To disable multi-line description support, you can now
  434.     use the "-c" switch alone. Previously you had to use
  435.     "-c-1" and that was not documented.
  436.  
  437.    - Added INF documentation.
  438.  
  439.  
  440. ΓòÉΓòÉΓòÉ 2.5. 1.06 ΓòÉΓòÉΓòÉ
  441.  
  442.  
  443. 1.06  Restricted Beta
  444.  
  445.    - OS/2: Problem with remote (LAN) directories fixed.
  446.     The C stat function had problems: substituted with
  447.     direct OS/2 API calls.
  448.  
  449.    - Improved multi-line support.
  450.  
  451.  
  452. ΓòÉΓòÉΓòÉ 2.6. 1.05 ΓòÉΓòÉΓòÉ
  453.  
  454.  
  455. 1.05 - Support for multi-line descriptions (see Qfb.Doc).
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 2.7. 1.04 ΓòÉΓòÉΓòÉ
  459.  
  460.  
  461. 1.04 - New "out of memory" handler and exit errorlevel.
  462.     Previously an out of memory error could result in
  463.     strange behaviour.
  464.  
  465.    - Some internal changes in the filebase routines to
  466.     improve consistency with Max 3.00
  467.  
  468.    - New ApWorks addresses and phone numbers
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 2.8. 1.03 ΓòÉΓòÉΓòÉ
  472.  
  473.  
  474. 1.03 - Update to support Max 3.00;
  475.     Max 2.0x is NOT supported.
  476.  
  477.    - The specification of a path in the files.bbs to include
  478.     a file that resides in a directory other than the
  479.     default "Download" is now allowed.
  480.  
  481.    - The specification of an alternate files.bbs in
  482.     "FileList" is now allowed with any extension (previously
  483.     the .BBS was required).
  484.  
  485.    - The files that are not found are now included in the
  486.     filebase and marked as "OFFLINE".
  487.  
  488.    - If an area is marked of "Type CD" and you do not specify
  489.     an alternate "FileList", the local DAT/DMP/IDX files are
  490.     not generated.
  491.  
  492.    - The DateAuto/DateManual/DateList are now fully supported
  493.     (previously DateAuto was assumed).
  494.  
  495.    - New -n switch to allow the update of the filebase by
  496.     compiling all the areas that have a files.bbs newer than
  497.     the files.idx. CD areas skipped.
  498.  
  499.    - QFB and other ApWorks programs that update the filebase
  500.     generate a "FileBase.Bsy" flag in the Maximus system
  501.     directory to avoid concurrent writes to the same
  502.     filebase. There is no need to manually delete this flag
  503.     in case of power failure or abnormal termination.
  504.  
  505.    - The command line syntax has been modified to be
  506.     consistent with that of the Max 3.00 FB/FBP.
  507.     Switches -x and -r not implemented.
  508.     Wildcards are more flexible (? and * in the OS/2 way).
  509.  
  510.  
  511. ΓòÉΓòÉΓòÉ 2.9. 1.02 ΓòÉΓòÉΓòÉ
  512.  
  513.  
  514. 1.02 - Fixed bug that caused some dupes not to be removed
  515.     from UniFiles.Idx.
  516.  
  517.    - Separate "/t /b" flags in FILES.BBS are now recognized.
  518.  
  519.  
  520. ΓòÉΓòÉΓòÉ 2.10. 1.01 ΓòÉΓòÉΓòÉ
  521.  
  522.  
  523. 1.01 - Now more CD-ROM / MO friendly.
  524.     QFB does not abort in case of path not found,
  525.     drive not ready, read only dir, write protected unit.
  526.     When QFB cannot write local DAT/DMP/IDX files it simply
  527.     skips: if you do not really need these files, you can
  528.     avoid copying files.bbs to a hard-disk directory.
  529.  
  530.    - More informative output.
  531.  
  532.    - New -g command line switch to avoid generation of local
  533.     DAT/DMP/IDX files.
  534.  
  535.  
  536. ΓòÉΓòÉΓòÉ 2.11. 1.00 ΓòÉΓòÉΓòÉ
  537.  
  538.  
  539. 1.00 - First public release.
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 3. About QFB ΓòÉΓòÉΓòÉ
  543.  
  544. **************************************************************
  545. *                               *
  546. *                               *
  547. *          *****  *******  ******          *
  548. *          **  **  **  *  **  **         *
  549. *          **  **  ** *   **  **         *
  550. *          **  **  ****   *****          *
  551. *          **  **  ** *   **  **         *
  552. *          **  **  **    **  **         *
  553. *          ***** * ****   ******          *
  554. *                               *
  555. *                               *
  556. *          A Quick File Base Builder         *
  557. *         v 1.10 for Maximus 3.xx (*)         *
  558. *                               *
  559. **************************************************************
  560. *                               *
  561. *     (C) Copyright 1995-1996 by Alberto Pasquale     *
  562. *                               *
  563. *       A L L  R I G H T S  R E S E R V E D      *
  564. *                               *
  565. *           F R E E W A R E             *
  566. *                               *
  567. **************************************************************
  568.  
  569.  
  570. * Maximus is a trademark of Lanius Corporation
  571.  
  572.  
  573.      (c) Copyright 1995-1996 by Alberto Pasquale
  574.  
  575.             F R E E W A R E
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ 4. License ΓòÉΓòÉΓòÉ
  579.  
  580.               LICENSE
  581.  
  582.  
  583. You may copy, distribute and use this program freely, provided
  584. you do not modify the original archive and Copyrights.
  585.  
  586.  
  587. ΓòÉΓòÉΓòÉ 5. Disclaimer ΓòÉΓòÉΓòÉ
  588.  
  589.               DISCLAIMER
  590.  
  591. You are entitled to use this freeware program "as is". No
  592. guarantee can be given on the performance of the program. The
  593. author will not be liable for any damage or loss related to the
  594. use of this program.
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 6. Overview ΓòÉΓòÉΓòÉ
  598.  
  599.               Overview
  600.  
  601.  
  602. QFB is a substitute for the FB (Dos) or FBP (OS/2) program by
  603. Scott J. Dudley for building a Maximus 3.xx file-base (Maximus
  604. is a trademark of Lanius Corporation).
  605.  
  606. Main characteristics:
  607.  
  608. - Generates UniFiles.Idx in addition to the standard
  609.  MaxFiles.Idx; UniFiles.Idx is an index file like MaxFiles.Idx
  610.  but with no duplicates (in the case of dupes, the file in the
  611.  first defined area is kept in the index).
  612.  
  613.  You can use UniFiles.Idx as a file-request index for your
  614.  mailer (e.g. BinkleyTerm (c) Bit Bucket Software)
  615.  
  616. - Support for multi-line descriptions.
  617.  
  618.  Usually the description of a file in the FILES.BBS is
  619.  contained in a single physical line: Maximus will word wrap
  620.  and align when displaying it to the user.
  621.  
  622.  The problems come when you import the multi-line file_id.diz
  623.  descriptions into the FILES.BBS in order to make Maximus show
  624.  them to the user keeping the original formatting.
  625.  
  626.  As a matter of facts, Maximus (partially) supports
  627.  "continuation" lines that begin with '|' or '+' (second or
  628.  greater column). However many people like using NO
  629.  continuation character: they add multi-line descriptions one
  630.  line after another, indenting the subsequent lines so that
  631.  Maximus shows them aligned (but it does not recognize them in
  632.  the case of hurl, kill etc.). File management programs are
  633.  then used to correctly manage the areas.
  634.  
  635.  QFB supports a user-defined continuation character and
  636.  position, which default to the space ' ' and 31 (columns)
  637.  respectively (see the -c command line switch).
  638.  
  639.  QFB adds continuation lines to the FILES.DMP without loosing
  640.  formatting. You can verify this by using the L)ocate or
  641.  N)ewfiles command of Maximus. FB/FBP, on the contrary,
  642.  concatenate all the lines together (when they area recognized
  643.  as continuation lines...).
  644.  
  645.  There is a side effect, though: The L)ocate and N)ewfiles
  646.  commands show the continuation lines aligned at left.
  647.  Since this behaviour is not appreciated by some SysOps, the
  648.  "-d" command line switch allows to output a unique-line
  649.  description to FILES.DMP: original formatting is lost (as with
  650.  FB/FBP) but the entire description is word-wrapped and aligned
  651.  by Maximus.
  652.  
  653. - Very fast update operation (when a list of areas is specified
  654.  on the command line or the -n switch is used).
  655.  
  656. - Fast operation even in the full-build.
  657.  
  658. - The -n switch allows to update the filebase by compiling only
  659.  modified areas, even if you do not have a list of area names
  660.  available.
  661.  
  662. - Area names can be specified using the '?' and '*' wildcards as
  663.  per the OS/2 rules. E.G. "*OS2*" includes all areas whose name
  664.  contains "OS2".
  665.  
  666. - Can be used with CD-ROMs with no need to copy the FILES.BBS to
  667.  a hard-disk directory, provided you don't really need the
  668.  DAT/DMP/IDX files for the area: the global indexes
  669.  (MaxFiles.Idx and UniFiles.Idx) will contain the data for
  670.  these areas so that File-Request, Global Download and Upload
  671.  Dupe Check will work anyway.
  672.  
  673. - Does not abort nor prompt user in the case of "drive not
  674.  ready" or "write protected" errors.
  675.  
  676. - Retries for many seconds in case of a sharing violation.
  677.  Please note that in the case of protracted inability to open a
  678.  DAT/DMP/IDX file for write, QFB could report a "Write
  679.  Protected" area instead of the sharing violation. It will
  680.  proceed anyway as if the unit were write protected.
  681.  
  682. - All ApWorks programs that access the FileBase use a
  683.  "FileBase.Bsy" flag in the Maximus system directory to avoid
  684.  concurrent writes to the same filebase. There is no problem in
  685.  the case the FileBase.Bsy flag is not deleted due to abnormal
  686.  terminations or power failures, so you do not need to delete
  687.  it in the startup.cmd/autoexec.bat as with other programs.
  688.  
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 7. Usage ΓòÉΓòÉΓòÉ
  692.  
  693.                  Usage
  694.  
  695.  
  696. The command line parameters are the same as with FB/FBP, with a
  697. few exceptions:
  698.  
  699. QFB [<switches>] [<area> ...]
  700.  
  701. If no command line parameter is given, the help is shown. If no
  702. <area> is given and the -n switch is not used, all areas are
  703. compiled.
  704.  
  705.  
  706.  -a
  707.     Compile all areas.
  708.  
  709.     This is the default, but the switch is needed when no
  710.     other switches are used (QFB shows help on an empty
  711.     command).
  712.  
  713.  
  714.  -c[<nn>[<c>|#<nnn>]]
  715.  
  716.     The default for continuation column/character is 31/' '.
  717.     That is, if a line that starts with 31 spaces is found
  718.     after a description line in the FILES.BBS, then it is
  719.     taken as a continuation line. Empty lines are also taken
  720.     as continuation lines, in order to allow correct
  721.     processing of file_id.diz descriptions that contain
  722.     blank lines.
  723.  
  724.     You can disable multi-line description support by using
  725.     "-c" alone.
  726.  
  727.     e.g.  -c  (disables multi-line support)
  728.  
  729.     You can override the number of blank columns required by
  730.     using "-c<nn>" where <nn> specifies the number of spaces
  731.     needed at the start of a line to consider it a
  732.     continuation line.
  733.  
  734.     e.g. -c34  (34 spaces required)
  735.  
  736.     If you want to use some special character (not the
  737.     simple space) as a continuation character, then you must
  738.     specify it in the -c switch after the <nn>. You can
  739.     either specify the character directly (<c>) or by its
  740.     ASCII code (#<nnn>). Please note that the '|'
  741.     (frequently used) is the symbol for pipe, so it CANNOT
  742.     be used on a command line: you must either specify its
  743.     ASCII code or prefix it with an escape character.
  744.  
  745.     e.g. -c29+   (the continuation lines start with '+')
  746.        -c29#124  (124 is the ASCII code for '|')
  747.        -c29^|   (OS/2 escape sequence for '|')
  748.  
  749.     Since the continuation lines usually have a space after
  750.     the continuation character, QFB skips it if present.
  751.  
  752.     Example:
  753.  
  754.     TEST.ZIP  This is a long description
  755.              | for the file test.zip
  756.              |
  757.              | Author: <author>
  758.              | Shareware US$30
  759.  
  760.     Note: the <nn> number of spaces is essential when the
  761.        continuation character is not specified (simple
  762.        space). On the contrary, it is not currently
  763.        really meaningful when the continuation character
  764.        is different from space (the only difference is
  765.        between 0 and >0).
  766.  
  767.        For example, if you use "-c29#124", QFB accepts as
  768.        continuation lines all those whose first non-space
  769.        character is '|', provided it is NOT in the first
  770.        column. To make QFB accept a continuation
  771.        character in the first column you must specify 0
  772.        as <nn> ("-c00#124").
  773.  
  774.  
  775.  -d
  776.     Output Unique-Line descriptions to FILES.DMP.
  777.  
  778.     Avoids multi-line descriptions in FILES.DMP, the file
  779.     where Maximus looks for the file descriptions when using
  780.     the filebase (L)ocate and N)ewfiles commands).
  781.  
  782.     When multi-line description support is used, QFB outputs
  783.     the entire description string (line feeds included) to
  784.     the FILES.DMP, so that the Maximus L)ocate and N)ewfiles
  785.     commands respect the original formatting.
  786.  
  787.     Unfortunately there is a side-effect: the continuation
  788.     lines are aligned at left, and this is not appreciated by
  789.     some SysOps.
  790.  
  791.     When this switch is used, QFB changes the linefeeds to
  792.     spaces, so that the DMP description is made of a long
  793.     unique line: the original formatting is lost but the
  794.     description will be aligned and word-wrapped by Maximus
  795.     when the L)ocate or N)ewfiles commands are used.
  796.  
  797.  
  798.  -f<file>
  799.     Use <file> as farea.dat.
  800.  
  801.     This overrides the information from Max.Prm.
  802.  
  803.  
  804.  -g
  805.     Compile global index only.
  806.  
  807.     The DAT/DMP/IDX files of each area are not generated.
  808.  
  809.     Do not use this switch if you are not really sure you do
  810.     not need these files.
  811.  
  812.  
  813.  -n
  814.     Compile areas with new Files.Bbs.
  815.  
  816.     All areas that have a Files.Bbs newer than the Files.Idx
  817.     will be compiled and the MaxFiles/UniFiles.idx updated;
  818.     areas marked as "Type CD" are skipped.
  819.  
  820.     This switch is meaningless when the -g switch has been
  821.     used (files.idx not generated).
  822.  
  823.  
  824.  -p<file>
  825.     Use <file> as the Maximus .prm file.
  826.  
  827.     Overrides the MAXIMUS environment var.
  828.     The .prm extension is added if no extension is given.
  829.  
  830.  
  831.  -q
  832.     Quiet mode.
  833.  
  834.     QFB reports errors only.
  835.  
  836.  
  837.  -s
  838.     Skip slow areas marked as "Type CD".
  839.     The indexes are updated after scanning all non-slow
  840.     areas.
  841.  
  842.  
  843.  -u
  844.     Scan upload paths.
  845.  
  846.     This switch is used by Maximus in RunFB.Cmd (.Bat for
  847.     DOS) when the update of upload areas is needed.
  848.  
  849.     The Upload paths for the listed areas are scanned
  850.     instead of the download ones, provided the upload path
  851.     is in a defined Maximus area.
  852.  
  853.  
  854. <area> can include wildcards ('?', '*') in the OS/2 way.
  855.  
  856.  
  857. Errorlevels:
  858.  
  859.  
  860. 7 Out of memory
  861. 6 Timeout waiting for a busy FileBase
  862. 5 FArea.Dat not found
  863. 4 Max.Prm not found: either MAXIMUS environment variable or
  864.  -p<file> command line switch must point to a valid Max 3.xx
  865.  PRM file.
  866. 3 Abnormal termination
  867. 2 Error
  868. 1 Help requested
  869. 0 OK
  870.  
  871.  
  872. IMPORTANT NOTE for the Dos version:
  873.     QFB is a 32 bit application: it requires the Dos4GW.Exe
  874.     dos extender in your path.
  875.  
  876.  
  877.