home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / olu100.zip / OZLIBUPD.TXT < prev    next >
Text File  |  1993-05-23  |  6KB  |  169 lines
  1. OzLibUpd 1.0 - OzCIS Library Updater               Copyright (C) 1993 Todd Fiske
  2. ────────────────────────────────────────────────────────────────────────────────
  3.  
  4. -- overview
  5.  
  6. OzLibUpd is a very simple program which will turn ON or OFF, and/or show the
  7. status of, all of the fields related to updating long library scans in an OzCIS
  8. FORUMS.DB file, in all or selected forums.
  9.  
  10.  
  11. -- installation
  12.  
  13. Copy the program file OZLIBUPD.EXE either to your OzCIS subdirectory, or to a
  14. subdirectory on your path. This documentation file is plain ASCII text with a
  15. few high-order characters sprinkled in. You should be able to copy it directly
  16. to your printer.
  17.  
  18.  
  19. -- operation
  20.  
  21. OzLibUpd will only look for FORUMS.DB in the current subdirectory. The command
  22. line format is:
  23.  
  24.    ozlibupd ON|[OFF]|SHOW [FORUM=<list>] [>output.txt]
  25.  
  26. You must enter one of the three parameters. They have the following results:
  27.  
  28.    ON              Turns all "Scan Libs Long" and "Update" files ON and shows
  29.                    the results.
  30.  
  31.    OFF             Turns all "Scan Libs Long" and "Update" files OFF and shows
  32.                    the results.
  33.  
  34.    If ON is not specified, OFF will be assumed. When setting forums ON or OFF,
  35.    you will be asked to confirm continuing the operation. Pressing Y will
  36.    continue, and any other key will exit.
  37.  
  38.    SHOW            Only shows the current status of all parameters, and doesn't
  39.                    change anything.
  40.  
  41.    FORUM=<list>    Limits the program to working with the specified forums. The
  42.                    list should use the forum GO words, and should be in this
  43.                    format:
  44.  
  45.                       forum=forum1,forum2,forum3
  46.  
  47.    There should be no spaces in the list - you can name as many forums as will
  48.    fit on the command line. If a list is not specified, all forums will be
  49.    acted on.
  50.  
  51. The output of OzLibUpd can be sent to the printer or to a text file using the
  52. DOS redirection facilities.
  53.  
  54.    > device        Send the output to the named device, overwriting it if its a
  55.                    text file.
  56.  
  57.    >> device       Send the output to the named device, appending to it if its
  58.                    a text file.
  59.  
  60.    | program       Send the output into the named program which will use it as
  61.                    input - for example, to view the results in LIST:
  62.  
  63.                       ozlibupd show | list /s
  64.  
  65.  
  66. _66
  67.  
  68. OzLibUpd 1.0 - OzCIS Library Updater               Copyright (C) 1993 Todd Fiske
  69. ────────────────────────────────────────────────────────────────────────────────
  70.  
  71. -- output
  72.  
  73. OzLibUpd produces the following output from the SHOW command (truncated a bit
  74. to fit in the documentation):
  75.  
  76.    ┌────────────────────────────────────────────────────────────────────────┐
  77.    │ OzLibUpd 1.0                             Copyright (C) 1993 Todd Fiske │
  78.    │                                                                        │
  79.    │ input file : c:\oz\forums.db                                           │
  80.    │ forums     : all                                                       │
  81.    │                                                                        │
  82.    │ About to turn OFF the "Update Long Lib Scans" flags.                   │
  83.    │ Continue? (Y/N) Y                                                      │
  84.    │                                                                        │
  85.    │ Forum word *² Scn Upd Sections                                         │
  86.    │ ---------- -- --- --- -----------------------------------              │
  87.    │ DBASE      *  OFF OFF 3,4                                              │
  88.    │ BPASCAL    *  OFF OFF 4,5,7                                            │
  89.    │ IBMCOM     *  OFF OFF                                                  │
  90.    │ PCVENE     *  OFF OFF 6,11                                             │
  91.    │ PRACTICE      OFF OFF 1                                                │
  92.    │ HELPFORUM     OFF OFF 1                                                │
  93.    └────────────────────────────────────────────────────────────────────────┘
  94.  
  95. The columns of the listing are:
  96.    forum GO word
  97.    forum selected if * appears
  98.    second pass activity pending if ² appears
  99.    Scan Libs Long ON or OFF
  100.    Update Libs ON or OFF
  101.    list of selected libraries
  102.  
  103.  
  104. -- warnings
  105.  
  106. This program can result in a very expensive online session if you're not
  107. careful. It will tell OzCIS to update the long listing for EVERY section you
  108. have selected in EVERY forum in your FORUMS.DB file that is so enabled. Make
  109. sure this is what you want before going online.
  110.  
  111. OzLibUpd also toggles the internal SecPend flag per forum which signals OzCIS
  112. whether there is Second Pass work to be done. When using the OFF switch, the
  113. SecPend flag is turned OFF even if there is other work to be done. Since there
  114. are many different Second Pass activities, it is outside of the scope of this
  115. program to detect them all and leave the SecPend flag in the right condition.
  116. This is something you should be aware of yourself.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132. _132
  133.  
  134. OzLibUpd 1.0 - OzCIS Library Updater               Copyright (C) 1993 Todd Fiske
  135. ────────────────────────────────────────────────────────────────────────────────
  136.  
  137. -- disclaimer
  138.  
  139. This software does its job satisfactorily, but I won't be held responsible if
  140. something goes wrong. Make a back up of FORUMS.DB just in case. Consider
  141. yourself warned! <g>
  142.  
  143.  
  144. -- credits
  145.  
  146. OzLibUpd was written with The Semware Editor 1.0 (pre-release) by Semware,
  147. compiled with Turbo Pascal 7.0 by Borland, with additional support from the
  148. Topaz 4.0 libraries by Software Science. Of course, eternal gratitude goes to
  149. Steve Sneed for providing OzCIS to the world.
  150.  
  151.  
  152. -- "ware" category, distribution
  153.  
  154. OzLibUpd is free. If you are driven to provide compensation, I will not refuse
  155. it! Email, postcards, and other correspondence are always appreciated. Feel
  156. free to make copies to give to friends and/or associates, but please distribute
  157. with all files intact and unchanged. However, please do not charge any money
  158. for it, including disk-copying costs.
  159.  
  160.  
  161. -- contact
  162.  
  163. If you have any problems, comments, suggestions, criticism, flames, etc, I can
  164. be reached as follows:
  165.  
  166.    Todd Fiske
  167.    PO Box 9715-244                     CompuServe : 70451,1424
  168.    Portland ME 04104-2000              Delphi     : TFISKE
  169.