home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / THDPRO91.ZIP / THDTERM4.ZIP / THDTERM.DOC next >
Text File  |  1993-11-01  |  9KB  |  167 lines
  1.                    THD ProScan's Terminal Assistant Version 4
  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 4?
  15. ------------------------
  16.      Version 4 is a very minor upgrade. It contains only a single difference 
  17. from version 3. The difference is that you can now pass an optional comport 
  18. to THDTERM (to instruct it to send THDPRO.EXE's output to a comport other 
  19. than "0"). If you do not supply a comport, it will default to "0" as it 
  20. always has.
  21.      This modification was added so that users of FileDoor could use it to 
  22. run THDPRO.EXE in circumstances where FileDoor can supply a directory but 
  23. not a filename to be tested. These users can call THDTERM rather than THDPRO 
  24. while supplying it with the directory to test.
  25.      The comport is a digit from 0 to 8 and must be the last commandline 
  26. parameter passed to THDTERM.
  27.  
  28.  
  29. WHAT WILL I NEED?
  30. -----------------
  31.     You will need a configured copy of THD ProScan (preferably version 9).
  32. A directory for files which have not yet been tested (your usual download 
  33. directory is recommended). A directory for files which pass the test and 
  34. another directory for files that fail the test.
  35.      This Terminal assistant will run on any platform which currently 
  36. supports THD ProScan. It will require about 2k of memory above the 
  37. requirements for THD ProScan.
  38.  
  39.  
  40. WHAT DOES IT DO?
  41. ----------------
  42.      Quite simply, It runs THDPRO.EXE on every file in a given directory and 
  43. then moves each of the files to a directory depending on whether it passed 
  44. or failed the test by THDPRO.EXE.
  45.  
  46. WHAT PARAMETERS DOES IT TAKE?
  47. -----------------------------
  48.      The proper Syntax for THD ProScan's Terminal Assistant is quite simply 
  49. "THDTERM.EXE". After it has been configured this command will run the 
  50. program as explained below.
  51.      THDTERM.EXE accepts three parameters.
  52. "C"  or  "/S {PATH}" and {optional comport #}.
  53.      The "C" parameter can be used to reconfigure a previously configured 
  54. file.
  55.      The /S parameter tells THDTERM3 that what follows is a directory other 
  56. than the one configured which you would like to test. In this case only 
  57. "failed" files will be moved (to the failed directory as defined in the 
  58. configuration). Passed files will be left as is.
  59.      The comport number should only be sent when wishing to redirect 
  60. THDPRO.EXE's output to the supplied comport.
  61.  
  62.         THD ProScan's Terminal Assistant Version 4.0 and FileDoor
  63.         ---------------------------------------------------------
  64.  
  65.      THDTERM now accepts a comport as a parameter. As with THDPRO.EXE, the 
  66. comport must be the last parameter and must be a number between 0 and 8.
  67. If supplied with a comport, THDTERM will tell THDPRO.EXE to use that comport 
  68. instead of "0" which it uses by default.
  69.      This modification will allow Filedoor users to use THDTERM to run 
  70. THDPRO.EXE while still sending the remote output to the user. Those sysops 
  71. should have their exitafteruploads command as follows.
  72.  
  73. ExitAfterUpload1 C:\THDPRO\THDTERM.EXE /S $U $P $M $N
  74.  
  75.      I also recommend that the "exitmask" not be defined and that THDPRO.EXE 
  76. be expected to test ALL uploads.
  77.      Note... I do not use Filedoor myself and have based the above strictly 
  78. on the documentation for that program. Some modification may be necessary.
  79.  
  80.  
  81. CONFIGURATION
  82. -------------
  83.      The first time THDTERM.EXE is run it will automatically prompt you for 
  84. 4 things. (no parameters need to be supplied on the first run)
  85. You will be prompted for the following...
  86. Path to THDPRO.EXE
  87. Path to the directory containing the files to be tested.
  88. Path to the directory for passed files.
  89. Path to the directory for failed files.
  90.      ALL of these paths MUST exist prior to the configuration. As mentioned 
  91. above it can be reconfigured by running "THDTERM.EXE C".
  92.  
  93. HOW DOES IT WORK?
  94. -----------------
  95.      THDTERM.EXE counts the files in the directory to be tested and then 
  96. runs THDPRO.EXE on each of the files. IF THD ProScan passes the file, it is 
  97. moved to the directory for "PASSED" files.
  98.      IF THD ProScan fails the file, THD Terminal Assistant will check to see 
  99. if THD ProScan moved the file, If not it will be moved to the directory for 
  100. "FAILED" files.
  101.      It then moves to the next file. At the beginning of testing of each 
  102. file, you will be informed of the number of files to be tested and the 
  103. number of the file about to be tested (ie. "Testing file 4 of 8").
  104.      This program was made to work specifically with THD ProScan Version 5 
  105. or later. The reason being that it also informs THD ProScan NOT to send 
  106. output to the comport (unless the optional comport # is used which will only 
  107. work with version 5 or higher). While it will work with previous versions, 
  108. the remote output will NOT be suppressed (or redirected) on those earlier 
  109. versions.
  110.  
  111. GENERAL INFORMATION
  112. -------------------
  113.      This is an excellent tool for sysops as well as users. For a sysop, it 
  114. will allow them to use THD ProScan Version 5+ with their fossil active 
  115. without attempting to send output over the modem. Thus making it the perfect 
  116. tool for a sysop to test his/her downloads.
  117.      Compressing the executeable is recommended for space purposes and has no
  118. adverse affect on the operation. However, Note that it must be configured
  119. before it is compressed and that it cannot be configured or reconfigured in
  120. it's compressed state.
  121.      For users in general it provides the same security that many sysops 
  122. have become accustomed to.
  123.      Needless to say, THDPRO.EXE will need to be configured properly before 
  124. this program will be of any use.
  125.      Reasons for failure are not reported by this program, but all such 
  126. instances should be accounted for in your THDPRO.LOG created by THD ProScan.
  127.      With the exception of possible runtime errors, this program will ALWAYS 
  128. exit with errorlevel "0". The only indicators left by this program will be 
  129. the presence of the tested files in the Pass or fail directory. In keeping 
  130. with the tradition of THD ProScan, this program will NOT delete files for 
  131. any reason. Files are left for you to do with as you choose.
  132.  
  133. DISCLAIMER
  134. ----------
  135.      This progam was concieved,written and tested in less than 24 hours. 
  136. While I do believe it to be stable, I cannot guarantee that it will not do 
  137. damage. In over 100 tests on my system throughout the various stages of 
  138. programming, not a single file was corrupted or lost.
  139.      This program is provided for convenience and comes with absolutely no 
  140. warranty of any sort. If you find it convenient and wish to offer 
  141. suggestions to improve or expand it, all such comments are welcome in the 
  142. BBS support base on TELENET CANADA (TNCNET).
  143.      Address all such comments to David Muir.
  144.  
  145. COPYRIGHT
  146. ---------
  147.                 This  program  and  all of  its  associated  names,
  148.      files, logos and makeup are Copyright 1993 PainSoft.
  149.                 No duplication in whole or in part is allowed. With
  150.      the  exception of  duplication  of the entire  archived set of
  151.      files for distribution to those in need of it's services. None
  152.      of the copyrighted  material may be changed in any way, except
  153.      by the  author.  Changes made  by the " original / unmodified"
  154.      installation  program will be  considered to have been made by
  155.      the author for the purpose of this copyright. The files may be
  156.      rearchived in  ANY fashion which  requires them to be restored
  157.      to their  original condition  before use. ( Portions Copyright
  158.      Borland International)The executable files may be "compressed"
  159.      to save space but may not be  distributed in this  "compressed
  160.      format". The Author accepts no responsibility  for the actions
  161.      of this program. It is FREEWARE  and NO charge may be made for
  162.      it's distribution.  It is NOT a commercial product and as such
  163.      the  ONLY  acceptable charge for it will be  "actual, physical
  164.      cost of duplication". I do not profit  from it  monetarily and
  165.      any attempt of other persons to do  so shall be  considered an
  166.      infringement of my copyright.
  167.