home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / thdpro_6.zip / THDTERM3.ZIP / THDTERM.DOC next >
Text File  |  1993-05-06  |  8KB  |  152 lines
  1.                    THD ProScan's Terminal Assistant Version 3
  2.                   --------------------------------------------
  3.  
  4. Messages from a user stating the need for an interface for people who wished 
  5. to use THD ProScan with their terminal program, sparked me to create this 
  6. simple program.
  7.      This program was outwardly inspired by THDPRO TERMINAL EXTENSION. A 
  8. program created for the same basic purpose as this one.
  9.      Keep in mind that this program is really only a glorified batch file. 
  10. Most (if not all) of what it does could easily be done in a batch file. It 
  11. is being provided for those who don't have the time or knowledge to create a 
  12. batch file that performs this task.
  13.  
  14. WHAT'S NEW IN VERSION 3?
  15. ------------------------
  16.      Version 3 is a minor upgrade which takes care of version 2's nasty 
  17. habit of deleting entire directories if the user were to configure the 
  18. source and destination directories the same. The reason being that THDTERM2
  19. "moved" the file and if the file was found IN the destination directory then 
  20. the original was deleted. In a case where the two directories were the 
  21. same.. this would result in the deleting of all the files.
  22.      The other addition to this version allows the testing of a directory 
  23. other than the one configured as the source. To use this feature one must 
  24. run THDTERM.EXE /S C:\PATH\TO\SOURCE.
  25.      Where "C:\PATH\TO\SOURCE" represents the directory to be tested. When 
  26. this option is used... ONLY the failed files will be moved to your 
  27. previously configured "FAILED" directory. All passed files will be left 
  28. where they are.
  29.      On some occassions when used as above dos will change the position of 
  30. files in the directory. This action will could result in duplicate testing 
  31. of a file. So if you see "File 11 of 11 to be tested" in a directory 
  32. containing only 10 files it is due to dos's movement of files and is 
  33. perfectly normal.
  34.  
  35.  
  36. WHAT WILL I NEED?
  37. -----------------
  38.     You will need a configured copy of THD ProScan (preferably version 6).
  39. A directory for files which have not yet been tested (your usual download 
  40. directory is recommended). A directory for files which pass the test and 
  41. another directory for files that fail the test.
  42.      This Terminal assistant will run on any platform which currently 
  43. supports THD ProScan. It will require about 2k of memory above the 
  44. requirements for THD ProScan.
  45.  
  46.  
  47. WHAT DOES IT DO?
  48. ----------------
  49.      Quite simply, It runs THDPRO.EXE on every file in a given directory and 
  50. then moves each of the files to a directory depending on whether it passed 
  51. or failed the test by THDPRO.EXE.
  52.  
  53. WHAT PARAMETERS DOES IT TAKE?
  54. -----------------------------
  55.      The proper Syntax for THD ProScan's Terminal Assistant is quite simply 
  56. "THDTERM.EXE". After it has been configured this command will run the 
  57. program as explained below.
  58.      THDTERM.EXE accepts one of two parameters.
  59. "C"  or  "/S {PATH}".
  60.      The "C" parameter can be used to reconfigure a previously configured 
  61. file.
  62.      The /S parameter tells THDTERM3 that what follows is a directory other 
  63. than the one configured which you would like to test. In this case only 
  64. "failed" files will be moved (to the failed directory as defined in the 
  65. configuration). Passed files will be left as is.
  66.  
  67. CONFIGURATION
  68. -------------
  69.      The first time THDTERM.EXE is run it will automatically prompt you for 
  70. 4 things. (no parameters need to be supplied on the first run)
  71. You will be prompted for the following...
  72. Path to THDPRO.EXE
  73. Path to the directory containing the files to be tested.
  74. Path to the directory for passed files.
  75. Path to the directory for failed files.
  76.      ALL of these paths MUST exist prior to the configuration. As mentioned 
  77. above it can be reconfigured by running "THDTERM.EXE C".
  78.  
  79. HOW DOES IT WORK?
  80. -----------------
  81.      THDTERM.EXE counts the files in the directory to be tested and then 
  82. runs THDPRO.EXE on each of the files. IF THD ProScan passes the file, it is 
  83. moved to the directory for "PASSED" files.
  84.      IF THD ProScan fails the file, THD Terminal Assistant will check to see 
  85. if THD ProScan moved the file, If not it will be moved to the directory for 
  86. "FAILED" files.
  87.      It then moves to the next file. At the beginning of testing of each 
  88. file, you will be informed of the number of files to be tested and the 
  89. number of the file about to be tested (ie. "Testing file 4 of 8").
  90.      This program was made to work specifically with THD ProScan Version 5 
  91. or later. The reason being that it also informs THD ProScan NOT to send 
  92. output to the comport (this will only work with version 5 or higher). While 
  93. it will work with previous versions, the remote output will NOT be 
  94. suppressed on those earlier versions.
  95.  
  96. GENERAL INFORMATION
  97. -------------------
  98.      This is an excellent tool for sysops as well as users. For a sysop, it 
  99. will allow them to use THD ProScan Version 5+ with their fossil active 
  100. without attempting to send output over the modem. Thus making it the perfect 
  101. tool for a sysop to test his/her downloads.
  102.      Compressing the executeable is recommended for space purposes and has no
  103. adverse affect on the operation. However, Note that it must be configured
  104. before it is compressed and that it cannot be configured or reconfigured in
  105. it's compressed state.
  106.      For users in general it provides the same security that many sysops 
  107. have become accustomed to.
  108.      Needless to say, THDPRO.EXE will need to be configured properly before 
  109. this program will be of any use.
  110.      Reasons for failure are not reported by this program, but all such 
  111. instances should be accounted for in your THDPRO.LOG created by THD ProScan.
  112.      With the exception of possible runtime errors, this program will ALWAYS 
  113. exit with errorlevel "0". The only indicators left by this program will be 
  114. the presence of the tested files in the Pass or fail directory. In keeping 
  115. with the tradition of THD ProScan, this program will NOT delete files for 
  116. any reason. Files are left for you to do with as you choose.
  117.  
  118. DISCLAIMER
  119. ----------
  120.      This progam was concieved,written and tested in less than 24 hours. 
  121. While I do believe it to be stable, I cannot guarantee that it will not do 
  122. damage. In over 100 tests on my system throughout the various stages of 
  123. programming, not a single file was corrupted or lost.
  124.      This program is provided for convenience and comes with absolutely no 
  125. warranty of any sort. If you find it convenient and wish to offer 
  126. suggestions to improve or expand it, all such comments are welcome in the 
  127. BBS support base on TELENET CANADA (TNCNET).
  128.      Address all such comments to David Muir.
  129.  
  130. COPYRIGHT
  131. ---------
  132.                 This  program  and  all of  its  associated  names,
  133.      files, logos and makeup are Copyright 1993 PainSoft.
  134.                 No duplication in whole or in part is allowed. With
  135.      the  exception of  duplication  of the entire  archived set of
  136.      files for distribution to those in need of it's services. None
  137.      of the copyrighted  material may be changed in any way, except
  138.      by the  author.  Changes made  by the " original / unmodified"
  139.      installation  program will be  considered to have been made by
  140.      the author for the purpose of this copyright. The files may be
  141.      rearchived in  ANY fashion which  requires them to be restored
  142.      to their  original condition  before use. ( Portions Copyright
  143.      Borland International)The executable files may be "compressed"
  144.      to save space but may not be  distributed in this  "compressed
  145.      format". The Author accepts no responsibility  for the actions
  146.      of this program. It is FREEWARE  and NO charge may be made for
  147.      it's distribution.  It is NOT a commercial product and as such
  148.      the  ONLY  acceptable charge for it will be  "actual, physical
  149.      cost of duplication". I do not profit  from it  monetarily and
  150.      any attempt of other persons to do  so shall be  considered an
  151.      infringement of my copyright.
  152.