home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / RSTQS101.ZIP / RESETQS.DOC < prev    next >
Text File  |  1993-06-04  |  7KB  |  178 lines
  1.  
  2. RESETQS.EXE v1.01                   Copyright (C) 1993 Cam Castiglia
  3. ====================================================================
  4.  
  5. DESCRIPTION:
  6. ***********
  7.  
  8. RESETQS.EXE is a utility designed to lessen the frustration of OzCis
  9. users who make use of external programs for viewing and tagging OzCis'
  10. QuickScan files.  This program, when called by a batch file, will
  11. Reset the QuickScan "?" flags in the OzCis FORUMS.DB file in accordance
  12. with command string specified.
  13.  
  14. The program can also be run in Interactive Mode, presenting the user
  15. with each forum, in turn, allowing him/her to toggle QS flags to off
  16. and then save the resultant changes to the FORUMS.DB file.
  17.  
  18. The main program functions as follows:
  19.  
  20.   1)  Determine the directory containing the OzCis program files.
  21.  
  22.   2)  a. Open HOSTS.DB, ensure that it is not an OzCis v2 file.
  23.       b. Determine which HOST is currently flagged as active.
  24.       c. Read the Forums Path field in the active HOST entry to
  25.          determine location of the active FORUMS.DB file.
  26.  
  27.   3)  Read the forums database into an array.
  28.  
  29.   4)  If operating in Command Mode, process each forum entry in 
  30.       accordance with the RESETQS <command$>
  31.       
  32.       If operating in Interactive Mode, scan the forums for those
  33.       which have the QS flag set and prompt the user to change or
  34.       leave as is then prompt the user to save or abandon the changes
  35.       and take appropriate action.
  36.       
  37.       
  38. Note:  This program was designed to function with OzCis v1.2(a) files.
  39.        There are significant differences in the file structure of the
  40.        soon to be released OzCis v2.  For this reason, the program has
  41.        built-in safety features to keep it from running in a v2 
  42.        environment.
  43.        
  44.  
  45.  
  46. INSTALLATION:
  47. ************
  48.  
  49. Please - take a moment to make a copy of your current FORUMS.DB file and
  50. place it in a safe place, either on an external diskette or a drive -
  51. directory which is not accessible by OzCis.  It is extremely unlikely
  52. that you will ever experience data loss or a corrupted file through the
  53. use of this program, but you can't be too careful! <g>
  54.        
  55. Copy the decompressed file. RESETQS.EXE into the main OzCis directory.
  56. This is the same directory which contains the HOSTS.DB file.  This program
  57. will not function if it is not in the same directory as HOSTS.DB
  58.  
  59. If you will be using the program in Interactive Mode, set it up as an
  60. OzCis external:
  61.  
  62.         Title:    Reset QuickScan Flags
  63.         CmdLine:  C:\OZ\RESETQS.EXE      (change path as appropriate)
  64.         Use 2nd shell: N   Prompt at exit: N  Get Parameters: Y
  65.         
  66.         
  67.  
  68. USAGE:
  69. *****
  70.  
  71.  
  72. RESETQS has four operating modes, accesed through the command line:
  73.  
  74.     RESETQS [forumname, forumname, forumname ....] [/Q] [/?]
  75.     
  76.  
  77.  
  78. HELP MODE:        Entering RESETQS /? will present the basic Help screen
  79.                   with instructions for program usage.
  80.               
  81. INTERACTIVE MODE: Entering RESETQS without a command$ will start the program
  82.                   in Interactive Mode.  After the forums array has been
  83.                   prepared, you will be presented with the GO Word and 
  84.                   Forum Description for each forum which has it's QS flag
  85.                   turned on.  You are prompted to decide whether to toggle
  86.                   the flag to off and then presented the next forum for 
  87.                   similar action.  After all forums have been processed, you
  88.                   will be asked whether to Save or Abandon Changes.  If you
  89.                   choose the Save option, the FORUMS.DB will be updated to
  90.                   reflect the new flag settings.  The original file will be
  91.                   saved as FORUMS.SAV
  92.                   
  93. COMMAND MODE:     Enter RESETQS forumname, forumname, forumname .... 
  94.                   where 'forumname' is the 8 character (maximum) name
  95.                   which OzCis uses to identify a forums files.  You can
  96.                   enter as many forumnames as will fit on the command
  97.                   line, seperated by commas.  Running the program in this
  98.                   mode will present an information screen showing which
  99.                   forums are being acted upon and then prompt to Save or 
  100.                   Abandon changes as above.
  101.                   
  102. QUIET MODE:       Identical to COMMAND MODE, except add the /Q switch to
  103.                   the end of the command line.  Causes the program to
  104.                   suppress all screen output and DOES NOT PROMPT before
  105.                   saving the changes.  Perfect for use in batch files!
  106.                   
  107.                   Note that the /Q switch must be at the end of the
  108.                   command$.
  109.                                     
  110.  
  111.  
  112. OzCis Version 2:
  113. ***************
  114.  
  115. This program will not function with the upcoming v2.  If, when v2 has 
  116. been released, I feel that there is still a need for this type of utility, 
  117. I will make the necessary update and will post the new version to 
  118. Compuserve's IBMCOM forum, Library 12.
  119.  
  120.  
  121. REVISION HISTORY:
  122. ****************
  123.  
  124. Ver. 1.0   -  Original beta release
  125.  
  126. Ver. 1.01  -  Corrected bug in handling of "blank" Forums Path field in
  127.               HOSTS.DB record.
  128.               
  129.               Corrected bug in screen display of GoWords and Forum 
  130.               Descriptions.
  131.  
  132.               Revised RESETQS.DOC (this file).
  133.               
  134. NOTES:
  135. *****
  136.  
  137. I believe this program performs as described and have made every effort
  138. to ensure that it will not cause loss of data but you use it at your own
  139. risk. I cannot guarantee the fitness of this program for a particular 
  140. purpose nor will I be held liable for any damages arising from it's
  141. use or misuse.
  142.  
  143.  
  144. COST:
  145. ****
  146.  
  147. For as long as Steve Sneed chooses to make OzCis available free of charge
  148. for non-commercial use, I could not be comfortable with asking for payment
  149. for this small utility.  It is free to any user who has need of it.  I do,
  150. however, retain all copyrights, as applicable, to it's design, interface
  151. and function.
  152.  
  153.  
  154. TALK TO ME:
  155. **********
  156.  
  157. I can be reached at any time, for any reason, via CIS-MAIL, as follows:
  158.  
  159.                Cam Castiglia   [Compuserve 71334,2403]
  160.  
  161. and can often be found hanging around at IBMCOM Sec. 12
  162.     
  163.  
  164. THANKS:
  165. ******
  166.  
  167. Thanks to Tom Donnelly and Peter Zisson for acting as beta testers (read
  168. "guinea pigs") and for their ability to find the bugs which I had missed.
  169.  
  170. Thanks also to Steve Sneed, for his creation of OzCis, his willingness
  171. to share it with all of us, and his open-mindedness concerning this
  172. project.
  173.  
  174. It probably sounds corny, but thanks also to my wife, Carol, and son, David,
  175. for putting up with my love of computers, and the long hours which I spend
  176. at the keyboard.
  177.  
  178.