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