home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / ULMAN15D.ZIP / ULMANAG.DOC < prev    next >
Text File  |  1993-09-20  |  22KB  |  480 lines
  1. To print this file, load it into a word processor or text editor such
  2. as DOS 5.0 or 6.0's EDIT.COM.
  3.  
  4. Upload Manager(C) 1.5d User's Guide
  5. -----------------------------------
  6. From Bayridge Software/Thomas F. Abraham
  7.  
  8.  
  9. "The Best Upload Tester for Searchlight(C) BBS's!"
  10.  
  11.  
  12. Documentation updated September 20, 1993.
  13.  
  14. All information contained herein is Copyright (C) 1993 by Bayridge Software
  15. and Thomas F. Abraham.  This document may not be changed in any form
  16. whatsoever.
  17.  
  18. INTRODUCTION
  19. ------------
  20. Thank you for trying out Upload Manager, the "Best Upload Tester for
  21. Searchlight BBS's!"  I have designed Upload Manager specifically for 
  22. Searchlight(tm) BBS software, supporting many advanced features possible 
  23. with it.  I am sure you will find Upload Manager to suit your needs, and 
  24. if for some reason it does not, or if you would just like to see more 
  25. features added, drop me a note on one of my two support BBS's.  (See the 
  26. end of this file for their numbers, etc.)
  27.  
  28.  
  29. UPLOAD MANAGER'S FILES
  30. ----------------------
  31. Well, let's get started.  The first step when you receive Upload Manager 
  32. is to create a directory with any name you choose (BAYRIDGE is recommended 
  33. but certainly not necessary).  Decompress the archive into this directory.  
  34. You should now have the following files:
  35.  
  36.  README.NOW           READ THIS FIRST
  37. *ULMANAG.EXE          Main Upload Manager executable file
  38.  ULCONFIG.EXE         Upload Manager configuration utility
  39. *ULSCRNFL.EXE         Used internally by Upload Manager
  40.  ULMANAG.DOC          This file
  41.  WHATISIT.DOC         Documentation on Upload Manager's features
  42.  REGISTER.DOC         Registration form
  43.  LICENSE.DOC          License information
  44.  WHATSNEW.DOC         What's new to this version
  45. *REJECT.DAT           Data file - more info later in this file
  46. *REMOVE.DAT           Data file - more info later in this file
  47. *COMMENT.DAT          Data file - more info later in this file
  48. *COMPRESS.DAT         Data file - more info later in this file
  49.  FILE_ID.DIZ          Description of archive
  50.  DESC.SDI             Short description of archive
  51.  
  52. Files marked with a * are REQUIRED for Upload Manager to run.
  53.  
  54.  
  55. NECESSARY EXTERNAL EXE'S
  56. ------------------------
  57. The following executable files are necessary for Upload Manager to be able
  58. to properly deal with all of the file formats it supports.  You must obtain 
  59. them on your own, but they are available on both of the support BBS's.  
  60. These programs are not from Bayridge Software, more info in the Legal 
  61. section of this file.
  62.  
  63.   PKZIP.EXE & PKUNZIP.EXE  PKZip compression util     2.04G   PKZ204G.EXE
  64.   PKPAK.EXE & PKUNPAK.EXE  ARC compression util       3.61    PK361.EXE
  65.   ARJ.EXE                  ARJ compression util       2.41    ARJ241.EXE
  66.   LHA.EXE                  LHA compression util       2.13    LHA213.EXE
  67.   PAK.EXE                  PAK compression util       2.51    PAK251.EXE
  68.   ZOO.EXE                  ZOO compression util       2.10    ZOO210.EXE
  69.   SQZ.EXE                  SQZ compression util       1.08.2  SQZ1082E.ZIP
  70.   TDCHECK.EXE              Teledisk TD0 testing util  2.13    TELED213.ZIP
  71.   RECOM.EXE                ZIP commenting util        1.05    RECOM105.ZIP
  72. # GIFTEST.EXE              GIF testing utility        4.00    GIFT40B5.ZIP
  73. ##SCAN.EXE or              Virus scanning util                SCANVxxx.ZIP
  74. ##NETSCAN.EXE or           Network virus scan util  
  75. ##NAV.EXE                  Norton Anti-Virus - Commercial - V2.0 or higher
  76.  
  77. #If you are not using a registered version of Upload Manager, you DO NOT need
  78.   GIFTEST.EXE.
  79. ##If you opt to scan files for viruses, you must have ONE of these three
  80.   programs.  If you are not doing virus scans, you DO NOT need any of them.
  81.  
  82. CONFIGURATION
  83. -------------
  84. Now it is time to configure Upload Manager for your system.  ULCONFIG.EXE
  85. is the configuration utility for Upload Manager.  It is designed to allow
  86. you to very quickly and easily make changes to your configuration of Upload
  87. Manager.  The built-in field editor allows you to do basic editing of the
  88. values without always retyping.  ULCONFIG.EXE should be located in the same
  89. directory as ULMANAG.EXE.  To begin configuration for the first time, just
  90. type ULCONFIG.  You will be asked if you are starting a new configuration.
  91. Answer (Y)es, and you will be launched into the Quick Setup mode.  This
  92. mode will take you automatically from one question to the next until you
  93. have completed all of the information.  There is no way to stop in the 
  94. middle -- you must complete all six pages.  If you accidentally type
  95. something wrong and you have already gone on to the next question, don't 
  96. panic.  Once you finish through page six, you can just run ULCONFIG again
  97. (and as many times after as you need to) and modify anything you wish.
  98. Following is an explanation of all of the options available to you.
  99.  
  100. ULCONFIG Page One - Directories/Drives
  101. --------------------------------------
  102. (1) Path for temporary files:  Enter the full drive & path to a directory 
  103.     that DOES NOT EXIST.  This directory will be created and removed by 
  104.     Upload Manager.
  105.  
  106. (2) - (8) Paths to various EXE's:  Enter the full drive & path where the
  107.     respective EXE's can be found, NOT including the filename.  If you do
  108.     not have one of the EXE's, enter NONE.  A file of that type will then
  109.     simply be skipped.
  110.  
  111.  
  112. ULCONFIG Page Two - More Directories/Drives
  113. -------------------------------------------
  114. (1) Path to virus scan utility:  Enter the full drive & path INCLUDING THE
  115.     FILENAME AND EXTENSION or type NONE.  You may choose to use one of three 
  116.     supported virus scanning utilities.  The choices are:  McAfee Scan
  117.     (SCAN.EXE), McAfee NetScan (NETSCAN.EXE), or Norton Anti-Virus (NAV.EXE).
  118.     DO NOT ENTER ANY PROGRAM OTHER THAN ONE OF THESE THREE.  UNPREDICTABLE 
  119.     RESULTS MAY OCCUR!  If you type NONE in this field, virus scanning will
  120.     be skipped.
  121.  
  122. (2) Command line parameters for virus scan utility:  The RECOMMENDED entry
  123.     for this field is NONE.  Upload Manager contains built-in defaults for
  124.     the three supported programs.  These defaults are used when you enter 
  125.     NONE here.  However, if you wish to enter your own parameters, you may
  126.     do so here.  DO NOT enter ANY directory information here, only program
  127.     options.
  128.  
  129. (3) - (5) Paths to various EXE's:  Enter the full drive & path where the
  130.     respective EXE's can be found, NOT including the filename.  If you do
  131.     not have one of the EXE's, enter NONE.  A file of that type will then
  132.     simply be skipped.
  133.  
  134. (6) Path for failed files:  Enter the full drive & path to an EXISTING
  135.     directory.  If you choose to Move files when they fail testing, they 
  136.     will be moved to this directory.
  137.  
  138. ULCONFIG Page Three - Options Setup
  139. -----------------------------------
  140. (1) Archive format conversion:  Choose the letter corresponding to the type
  141.     of compression you would like to convert any uploaded archives to, or 
  142.     choose H to leave the archives in their original format.  In the
  143.     UNREGISTERED version, you may only convert to ARJ format, regardless
  144.     of what you enter here.  If you don't want to convert to ARJ, you may
  145.     still enter H to skip conversion.
  146.  
  147. (2) Adding Auth. Verification:  If you have registered PKZIP with PKWare,
  148.     you have the option of adding Authenticity Verification to your archives.
  149.     If you would like to add Authenticity Verification, choose Y here.  IF
  150.     YOU DO NOT HAVE A REGISTERED VERSION OF PKZIP, DO NOT SAY YES HERE.
  151.     PKZIP WILL NOT function properly if this parameter is on and it is not
  152.     a registered version of PKZIP.
  153.  
  154. (3) ZIP & ARJ comments:  Choose A to remove all comments from ZIP and ARJ
  155.     archives, B to replace the comment with your own, or C to skip all
  156.     commenting.  In the directory with ULMANAG.EXE there is a file called
  157.     COMMENT.DAT.  This file contains the comment that will be added to the
  158.     archive if you choose option A.  *Leave one blank line at the beginning
  159.     of COMMENT.DAT before your actual comment begins.*
  160.  
  161. (4) Date testing:  When the dates of the files in an archive are checked,
  162.     Upload Manager counts how many file dates are earlier than the year you
  163.     will enter in (5).  In THIS field, enter the number of files that must
  164.     be earlier than the date in (5) to fail the entire archive.  If you do
  165.     not wish to do any date testing, enter a 0 (zero) here.
  166.  
  167. (5) Year for date testing:  Enter a four-digit year here.  If a file date is
  168.     earlier than this year, it will be added into the count described in (4).
  169.  
  170. (6) Adding a file:  If you would like to have a file added to each archive
  171.     (for instance an ad for your BBS), enter the filename here.  THIS FILE
  172.     MUST RESIDE IN THE SAME DIRECTORY AS ULMANAG.EXE.  If you do not wish to
  173.     add a file, enter NONE in this field.
  174.  
  175. (7) Delete or move:  If you choose A here, when an archive fails testing it
  176.     will simply be deleted.  If you would like to keep the archive when it
  177.     fails, choose B here.  If you choose B, the file will be moved to the
  178.     directory you specified on Page 2, Number 4.
  179.  
  180. (8) Display status line:  During processing Upload Manager will display a
  181.     status bar to show the caller what is happening.  If you do not wish to
  182.     have this status bar show up, choose N here.  Otherwise choose Y to use
  183.     the status bar.
  184.  
  185. ULCONFIG Page Four - Searchlight BBS Setup
  186. ------------------------------------------
  187. (1) Path to VALIDATE.EXE:  Enter the full drive & path to VALIDATE.EXE here.
  188.  
  189. (2) Path to SLMAIL.EXE:  Enter the full drive & path to SLMAIL.EXE here.
  190.  
  191. (3) Path to UPLIST.BBS:  Enter the full drive & path to UPLIST.BBS here.
  192.     This should be Searchlight's home directory for the node you are setting
  193.     up for.  If you have a single line system, enter the path to your BBS
  194.     directory where SLBBS.EXE resides.  If you are setting up for a second,
  195.     third, etc. node, enter the path to that node's CONFIG.SL2 file.
  196.  
  197. (4) Do you want reports:  If you would like to receive a report on the 
  198.     processing of each file in your mail, enter Y here.  If you do not wish
  199.     to receive this report in your mail, enter N here and skip (5) - (6).
  200.  
  201. (5) - (6) Send to user:  If you chose Y in (4) then enter in (5) the name
  202.     that you would like the report sent to.  If you log in to your BBS as
  203.     SYSOP, just enter SYSOP in (5) and you will receive the report in your
  204.     normal mailbox.  If you wish to have a second report sent to a different
  205.     user, you may enter that name in (6).  If you do not wish to send a 
  206.     second report, type NONE in (6).  SEPARATE MULTI-WORD NAMES WITH
  207.     UNDERSCORES.  If your name is Joe Sysop, you would enter JOE_SYSOP.
  208.  
  209. (7) If a virus is detected:  If a virus is detected in an upload, you have
  210.     the option of automatically changing the user's BBS access, Files access,
  211.     both, or you can opt to not change the user's access.  Choose A to change
  212.     the user's Files access, B to change BBS access, C to change both, or D
  213.     to not change the user's access.  This option is not functional in the
  214.     UNREGISTERED version, but you still need to choose one of the letters.
  215.  
  216. (8) - (9) Access level:  If you chose A, B, or C in (7), enter the access 
  217.     level to change the user's Files access to in (8), and the access level
  218.     to change the user's BBS access to in (9).  This should be a number
  219.     between 0 and 255 (inclusive).  These options are not functional in the
  220.     UNREGISTERED version.
  221.     
  222. (A) Replace long description:  Some archives include a file called DESC.SDI    
  223.     which contains a short description of the file.  This is usually from
  224.     the author of the program.  If you choose Y here, Upload Manager will
  225.     take the DESC.SDI description (if it exists) and place it into line one
  226.     of the long description.  IF YOU ARE USING ANY VERSION OF SEARCHLIGHT
  227.     GREATER THAN 3.0, YOU MUST CHOOSE (N)O HERE.
  228.  
  229. ULCONFIG Page Five - GIF Processing Setup
  230. -----------------------------------------
  231. NOTE: These features do not work in the UNREGISTERED version, but you must
  232.     enter the information anyway.
  233.  
  234. (1) Minimum resolution/colors:  Enter the minimum X resolution you wish to
  235.     accept, press Enter, enter the minimum Y resolution you wish to accept,
  236.     press Enter again, and enter the minimum number of colors you wish to
  237.     accept, then Enter once more.  If either the X or Y resolution of the
  238.     GIF falls below your minimum X or Y, or if the number of colors in the
  239.     GIF is below your minimum, the GIF will be failed.
  240.  
  241. (2) GIFLite'd GIF's:  If you do not wish to accept GIFLite'd GIF's, enter
  242.     N here, otherwise enter Y to accept GIFLite'd GIF's.
  243.  
  244.  
  245. ULCONFIG Page Six - Registration
  246. --------------------------------
  247. (1) Registration number/key:  Enter your registration number here, or enter
  248.     a 0 (zero) if you do not have a registration number.
  249.  
  250. (2) Serial number:  Enter your serial number here, or 0 (zero) if you do not
  251.     have a serial number.
  252.  
  253. (3) Name:  Enter your name in this field, SEPARATING EACH WORD WITH AN
  254.     UNDERSCORE.  If your name is John Doe, you would type JOHN_DOE.
  255.  
  256. (4) BBS Name:  Enter the name of your BBS in this field, again separating
  257.     each word with an underscore.  (My BBS = MY_BBS)
  258.  
  259. Your configuration is automatically saved after you finish the last entry
  260. in Quick Setup mode.  Whew, you made it!  Pretty simple, eh?  The next step 
  261. is to tell Searchlight about Upload Manager, and to get set up if you are 
  262. using more than one node.
  263.  
  264.  
  265. MULTI-NODE SYSTEMS
  266. ------------------
  267. If you are setting up Upload Manager on more than one node, you must make
  268. a separate directory FOR EACH NODE.  In each of these directories you must
  269. have a copy of all of the files marked with an asterisk (*) in the file list 
  270. near the top of this document.  (Minimum six files)  If you have set up
  271. Upload Manager for one node by this time, you can copy ULMANAG.CFG to each
  272. of the directories as well.  BUT, you MUST go into each node's directory
  273. and run ULCONFIG.  Change the name of the temporary directory in Number One
  274. on Page One.  THIS MUST BE DIFFERENT FOR EACH NODE.
  275.  
  276. THE FOUR .DAT FILES
  277. -------------------
  278. In the directory you put ULMANAG.EXE into, there are four .DAT files.  These
  279. are COMMENT.DAT, REJECT.DAT, REMOVE.DAT, and COMPRESS.DAT, and are all
  280. normal text files.
  281.  
  282. COMMENT.DAT
  283. -----------
  284. This contains the ZIP/ARJ comment that you want to have added to archives, if
  285. you have that option enabled.  There should be a blank line at the beginning
  286. of the file, before your comment begins.
  287.  
  288. REJECT.DAT
  289. ----------
  290. This file contains filenames that you do not wish to accept as uploads.  Here
  291. are some examples of how to use it.
  292.  
  293. To reject any file with a PCX extension (*.PCX), add  .PCX   to the file.
  294. To reject JOESFILE.ZIP, add  JOESFILE.ZIP  to the file.
  295. To reject JOES*.* add  JOES  to the file.
  296.  
  297. Here is a sample REJECT.DAT:
  298. .PCX
  299. JOESFILE.ZIP
  300. JOES
  301. END
  302.  
  303. Upload Manager searches for each of the strings in REJECT.DAT in the upload's
  304. filename.  Thus you do not need to use wildcards, because if you type in 
  305. .PCX, .PCX will be found in any filename that has .PCX as an extension.
  306.  
  307. IMPORTANT: The file MUST end with the string END, and do not use normal DOS
  308.  wildcards.
  309.  
  310. REMOVE.DAT
  311. ----------
  312. This file contains filenames that you wish to remove from archives.  For 
  313. instance, you may want to remove another BBS's text file ad from inside
  314. archives.
  315.  
  316. REMOVE.DAT follows the same conventions described in the REJECT.DAT section
  317. above.
  318.  
  319. IMPORTANT: The file MUST end with the string END.
  320.  
  321. COMPRESS.DAT
  322. ------------
  323. This file contains filenames that you wish to have automatically compressed.
  324. For instance, you may want to have .TXT files compressed before being added
  325. to your BBS.  This feature will not work if you have conversion disabled.
  326.  
  327. COMPRESS.DAT also follows the same conventions described in the REJECT.DAT
  328. section above.
  329.  
  330. IMPORTANT: The file MUST end with the string END.
  331.  
  332. SEARCHLIGHT SETUP
  333. -----------------
  334. Now that Upload Manager is configured it is time to install Upload Manager
  335. into Searchlight.
  336.  
  337. Setup for Searchlight is very simple.  Enter the Searchlight CONFIG utility 
  338. and go to the General Configuration > AutoDoors Setup > Upload AutoDoor setup 
  339. screen.
  340.  
  341. In the Command field, type: 
  342.  
  343. ULMANAG %G <path to uploads.bbs directory> %U
  344.  
  345. Replace <path to uploads.bbs directory> with the path on your hard drive to
  346. the uploads.bbs directory, INCLUDING the word UPLOADS.BBS!  For example, 
  347. when I run it locally on my system, I type:
  348.  
  349. ULMANAG C C:\BBS\UPLOADS.BBS TOM_ABRAHAM
  350.           ^^^^^^^^^^^^^^^^^^
  351. Don't use just the path TO uploads.bbs, include uploads.bbs in the command
  352. line.
  353.  
  354. Be sure to enter the correct path for the node you are setting up.  For 
  355. multi-node Searchlight systems, each node has its own directory, and each of 
  356. those directories contains an UPLOADS.BBS directory, so be sure to get the 
  357. right path for the right node.
  358.  
  359. In the Directory Path field, enter the path to the directory where 
  360. ULMANAG.EXE is located for the node you are setting up.
  361.  
  362. Set Communications Support to Standard, then set Write Protection and
  363. Termination Method to None.
  364.  
  365. That's all you need to do, and Upload Manager will work seamlessly with
  366. Searchlight.
  367.  
  368. SDN'S
  369. -----
  370. When Upload Manager is given an SDN (Shareware Distribution Network) file,
  371. no conversion will be done.  This is to protect the original integrity of
  372. the SDN file.
  373.  
  374. NoGate's PAK is used to create SDN files.  They are created by the original
  375. distributor with a special "security envelope", and if they are modified
  376. it will be detected when the file is extracted.  
  377.  
  378. Upload Manager will test the integrity/security of the files, but conversion
  379. and also virus scanning will be skipped, since it is unnecessary if the
  380. security envelope is in place.
  381.  
  382. NOTE: SDN has changed to the new ARJ 2.41 to create their SDN files, but I
  383.  was unable to find one in the new format, so only old SDN files are
  384.  supported at this time.  I will add this as soon as I get the information.
  385.  
  386. SELF-EXTRACTING ARCHIVES
  387. ------------------------
  388. Upload Manager can detect all types of PKZIP, ARJ and LHA self-extracting
  389. EXE archives.  They will be converted just as any other file would be, if
  390. you have conversion turned on.
  391.  
  392. UNRECOGNIZED FILES
  393. ------------------
  394. If Upload Manager cannot determine what a file is, it will simply be skipped.
  395. In the Searchlight mail report it clearly says SKIPPED.  IT IS THEN UP TO
  396. YOU TO CHECK OUT THE FILE and decide whether to delete it, etc.
  397.  
  398. OTHER ISSUES
  399. ------------
  400. A log of all errors and files/results is created in the same directory that
  401. ULMANAG.EXE is in.  It is called ULMANAG.LOG.
  402.  
  403. If you have conversion on, and, for example, you are converting to ARJ and
  404. someone uploads FIRST.ARJ and then FIRST.ZIP, FIRST.ZIP will be deleted 
  405. because the file it would be converted to, FIRST.ARJ, already exists.  On 
  406. the screen you will see Conversion FAILED and Final Result is DELETED.
  407.  
  408. I have found an incompatibility involving the NNANSI ANSI driver.  When you
  409. load it from DOS or AUTOEXEC.BAT you are supposed to follow it with CTTY CON.
  410. For some reason the CTTY causes a problem with Upload Manager's redirection
  411. of PKZIP, etc.  The solution to this is to load NNANSI from CONFIG.SYS since
  412. CTTY is not necessary that way.  There may be other problems when assigning
  413. control via CTTY.  I do not know any more about it than what you just read.
  414.  
  415. HMMM...
  416. -------
  417. Well, there is probably more I should say here, but I think most everything
  418. else is self-explanatory, and Upload Manager should just do its work quietly
  419. without your need to interfere.
  420.  
  421. If you have ANY problems getting it up and running, feel free to drop me a
  422. line at these BBS's using the name TOM ABRAHAM:
  423.  
  424. Support/Distribution Site #1:
  425. Magical Mystery BBS - (612)552-0311 - HST/V32bis
  426.    Fidonet 1:282/1012
  427.    SL_Net  250:205/0 or 250:205/335
  428.    EchoNet 50:5612/1012
  429.    SimNet  16:612/1012
  430. Upload Manager can be FREQ'ed from Magical Mystery using magic word ULMAN,
  431. GIFTest can be FREQ'ed from Magical Mystery using magic word GIFTEST,
  432. ReComment can be FREQ'ed from Magical Mystery using magic word RECOM,
  433. and TDCheck can be FREQ'ed from Magical Mystery using magic word TDCHECK.
  434.  
  435. Support/Distribution Site #2:
  436. The File Directory BBS - (612)942-5614 - 14.4k
  437.  
  438. *OR* you can contact me on the Internet: abra0063@gold.tc.umn.edu
  439.  
  440. Thanks, enjoy the program, and please register.
  441.  
  442.  
  443. Legal Stuff follows...
  444.  
  445. Acknowlegements/Legal Stuff
  446. ---------------------------
  447. - First, thanks to Mike Bertelson and Ted Sanft for testing Upload Manager(C)
  448.   and working to distribute it.
  449. - Upload Manager(C) was created entirely using Microsoft Visual C++ 1.0 from
  450.   Microsoft Corporation.  Thanks for a great compiler Microsoft!
  451. - Thanks to Whitney Software, Inc. for XSPAWN, a public domain replacement
  452.   for the C _spawn functions which allows you to swap out to EMS or disk.
  453.  
  454. Now, legalities:
  455. - Searchlight (c) BBS software (c) 1993 by Searchlight Software.
  456. - Scan (c) 1989-93 by McAfee & Associates.
  457. - PkPak, PkUnPak, PkZip (TM), and PkUnzip (TM) 1986-1993 by Phillip
  458.   W. Katz, PKWARE Inc.
  459. - LHa and LHarc (c) 1988-1989 by Haruyasu Yoshisaki.
  460. - Pak (c) 1988-1989 by NoGate Consulting.
  461. - Zoo (c) 1988 by Rahul Dhesi.
  462. - Arj (c) 1990-1993 by Robert K. Jung.
  463. - TeleDisk(c) & TDCheck(C) 1991 by Sydex.
  464. - GIF is a trademark of CompuServe.
  465. - GifTest(C) 1991 by Dave Navarro, Jr.
  466. - ReComment(C) 1990 by Michael C. Loewen
  467.  
  468. Registration and/or use of Upload Manager(C) does NOT exclude the user from
  469. registration of the software listed above.  Bayridge Software is in NO way
  470. affiliated with any of the people or companies listed above.  Use of any of
  471. these programs is under licensing agreements put forth by their respective
  472. manufacturers.
  473.  
  474.  
  475.  
  476.  
  477.  
  478. END OF DOCUMENTATION
  479.  
  480.