home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SCANV241.ZIP / SCANVERT.DOC < prev    next >
Encoding:
Text File  |  1993-06-06  |  8.2 KB  |  164 lines
  1.                         Sysop Information for
  2.  
  3.                             SCANVERT.EXE
  4.  
  5.  
  6. Legal Stuff:
  7.  
  8.      I  have  no interest in making a buck for something that I did  more  to  
  9. practice  my Turbo Pascal programming (it's been years since I have done  any 
  10. TP programs),  than anything else.   So while I keep the source codes and the 
  11. rights  to  this  software,  the executable file is released  to  the  public 
  12. domain.   In  no event shall I be held responsible for any loses  or  damages 
  13. resulting from the use of this utility.  It works at various test sites,  and 
  14. if you have doubts then you should not use it.
  15.  
  16.  
  17. History:
  18.  
  19.       This   utility   was   done at the request of a few  RA   sysops   that 
  20. complained  that there was not a decent archive converter for RA 2.00's  Scan  
  21. set   up  line.   So I undertook the task of creating  this  little  program. 
  22. While  RA can unarc and scan uploads on it's own and tell you if the  archive 
  23. is good,  by checking the returned errorlevels,  it can not convert the files 
  24. to a different archive type,  hence this utility comes in.  Now,   in version 
  25. 2,  I have invested some 30 programming and testing  hours  in  the  quest to 
  26. make  it  solid,  idiot  proof,   and versatile,  while trying to accommodate 
  27. the many requests for features.
  28.  
  29.  
  30. Setup:
  31.  
  32.      Make  sure  that the RA environmental variable is  set.   It  must point 
  33. to the main RA directory, ie.:   SET RA=D:\RA.   Scanvert will not run if the 
  34. RA variable is not set.
  35.  
  36.      In  RACONFIG,  under OPTION|FILES|UPLOAD SCAN enter the following on the 
  37. command line for the scan utility:
  38.  
  39. c:\ra\scanvert.exe @ [C] [B1] [N*N] [Fc:\utils\BBSAD.TXT] *M
  40.  
  41. []=Optional
  42.  
  43. This is my actual command line:
  44.  
  45. d:\ra\scanvert.exe @ C B3 N*N Fc:\banner.txt *M
  46.  
  47.      The   path  must be edited to reflect the actual location of  your  copy 
  48. of SCANVERT.EXE, and it can reside anywhere you wish.
  49.  
  50.      The '@'is the first parameter and is translated by RA to the full 
  51. path  and  filename  of the file to process.  That parameter MUST  always  be 
  52. number  one!.  It  is the only required parameter and scanvert will  not  run 
  53. without it.
  54.  
  55. All the other parameter can be in any order and you only need to supply those 
  56. you wish to turn on.
  57.  
  58. The  'C'  parameter  determines wether SCANVERT will convert the file   being 
  59. processed  to  the  format specified in the FILES.RA set  up for  the  upload 
  60. location  where the file resides.  If omitted it will default to not  convert 
  61. the  file.  Scanvert  will get all compression  and  decompression info  from  
  62. the   OPTION|FILES|ARCHIVERS  section in RACONFIG.   Below is  my  setup.   I 
  63. recommend  you use the same  ones,  as they have been tested  here.  However, 
  64. should  you  find  a better set  up for any archiver,   please let  me  know.  
  65. Scanvert  is limited by RA's  maximum  of 10 archivers.   You must still  set 
  66. the   decompression  portion of all archivers in the RACONFIG,   weather  you 
  67. convert them or not,  otherwise,  Scanvert will not find the info it needs to 
  68. decompress and test the files.
  69.  
  70.   EXT       Unpack Command                   Pack Command
  71.  
  72.   ARJ     ARJ.EXE x -y @                   ARJ.EXE a -r -jm @
  73.   ZIP     PKUNZIP.EXE -d -o @              PKZIP.EXE -rp -a -ex @
  74.   LZH     LHA.EXE e /x1m1 @                LHA.EXE a /r2x1 @
  75.   PAK     PAK.EXE e @                      PAK.EXE a @
  76.   SDN     PAK.EXE e @                      PAK.EXE a @
  77.   ZOO     ZOO.EXE e @                      ZOO.EXE a @
  78.   ARC     PKUNPAK.EXE @                    PKPAK.EXE @
  79.   HYP     HYPER.EXE -x @                   HYPER.EXE -a @
  80.   DWC     DWC.EXE e @                      DWC.EXE az @
  81.   SQZ     SQZ.EXE X @                      SQZ.EXE A /SP1 @
  82.  
  83.      If   found,   the GIFTEST.EXE program will automatically be used to test  
  84. GIF   files.   It is included in this archive as  a  courtesy.   To register, 
  85. contact Dave Navarro.
  86.  
  87.      Scan.exe  from McAfee associates will be used for virus  testing. If you 
  88. run  under  a network,  remove scan.exe from the path and place in  the  path 
  89. Netscan.exe and SCANVERT will detect and use that instead.
  90.  
  91.      The 'B'  is followed by a message board to post messages  to you  to let
  92. you  know  of any activity.   Must have a valid message  base number or 0  to 
  93. disable.  If  omitted  it  will default to no message  posting.  If  enabled,  
  94. SCANVERT  will  write a message to the  SYSOP informing  him/her of any  file 
  95. uploaded,   wether it  passed testing  and the original and  final filesizes.  
  96. In any  case,   wether message base logging is enabled or disabled,  a log is 
  97. kept  by scanvert in  the  main  RA directory so the sysop has a more durable  
  98. means  of keeping tack of transactions.
  99.  
  100.      The 'N' parameter indicates the node number, you *MUST* pass this if you
  101. run a multinode system!. If omitted (1 node) it will create a single log file.
  102. On multinode system, it is MANDATORY that this parameter be passed. Otherwise
  103. you will eventually be out of luck and start two copies on different nodes and
  104. the files will  get scrambled  because SCANVERT will default to a single work
  105. directory.  Scanvert now  creates one directory for each line to prevent such
  106. problems. The directory names are: \SCANVERT.NN, where NN is the current node
  107. number.
  108.  
  109.      The 'F' parameter is optional,   and if present must point to the BBS Ad 
  110. file  a  lot  of  sysops  like to put in archives or could  be  a  text  file 
  111. indicating the file has been virus scanned, etc.
  112.  
  113.      The   *M is EXTREMELY IMPORTANT!,   as SCAN.EXE and some  archivers  use  
  114. lots  of memory and problems including lost files could show up if you forget 
  115. to swap RA out of memory.
  116.  
  117.      Extended  description importing  is enabled in raconfig's filebase setup
  118. portion. (MANAGER|FILEAREAS|[AREANAME]|LONGDESC) . If  Long  Descriptions are
  119. enabled,  SCANVERT will detect this and import any such descriptions found in
  120. the archive to the  RA filebase.  Supported are FILE_ID.DIZ and DESC.SDN.  If
  121. omitted,  Scanvert  will  ignore  this  files. Since these files are  in a 40
  122. column  format and authors sometimes encase the text in  a high ASCII box,  I
  123. have  tried  to make this  routine as smart as possible.  It will remove  all
  124. characters that do not fall in the 32-126 ASCII range. Also, duplicate spaces
  125. are removed. The goal is to make a description free of tabs, carriage returns,
  126. line  feeds  and  high  ASCII  characters  and  let  RA properly display  the
  127. description  at runtime.  Any of those characters  removed  by scanvert  will
  128. interfere with the way RA formats the description causing really ugly output.
  129.  
  130.      You   must   also   set  RA to take proper action if   a   file   fails.
  131. SCANVERT   will  not move or delete any files that fail.   RA must  take care 
  132. of  that.  If you set RA to move the files and neglect to make that area  you  
  133. set  in there,  RA will try to move them  and  delete  them instead.
  134.  
  135.      As  of version 2.2α the extended logging is enabled.  So I don't have to 
  136. clutter  the command line anymore than what it already is,  I have made  this 
  137. configurable  thru the SCANVERT environmental variable.  If the variable does 
  138. not  exist,  or  if it is set to NORMAL,  normal logging is used.  If set  to 
  139. DEBUG, all kinds of meaningless (to you,  not to me)  stuff is written to the 
  140. log. If you have problems, this is the mode to use and then whenever you send 
  141. me  netmail about a problem,  you can enclose the log and it should make it a 
  142. lot easier for me to connect with it. The last option is NONE, in which case, 
  143. only major errors will be logged to the SCANVERT.LOG
  144.  
  145. To set the variable enter the following line in your AUTOEXEC.BAT file:
  146.  
  147. Set SCANVERT=DEBUG (or whatever level of logging you prefer)
  148.  
  149.      My  thanks to Ernie Jillson (1:135/58)  and Ariel Vera  (1:135/316)  for 
  150. their questions and encouragement and the all important testing.
  151.  
  152. Serge Sozonoff for his help and code to handle the Novell networks.
  153.  
  154. Turbo Power Software for their excellent swapping units.
  155.  
  156. MC Soft, Inc and John C. Parlin for their excellent JPDOOR units.
  157.  
  158.         Questions and suggestions can be sent to:
  159.  
  160.                         Paul Schencke
  161.                         1:135/58.340@fidonet
  162.                         72066,2443@Compuserve.com
  163.  
  164.