home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / AICON506.ZIP / SYSOP.DOC < prev   
Text File  |  1996-12-01  |  14KB  |  321 lines
  1. =============================================================================
  2.  
  3.                                   AutoIcon
  4.                                     -or-
  5.                              "Icon't See You"
  6.                          »REGISTERED VERSION ONLY«
  7.             (C) 1993-1997 Todd Carlton - Some Place Else BBS
  8.  
  9. =============================================================================
  10.  
  11. =============================================================================
  12.                          >>>>>DISCLAIMER<<<<<
  13. =============================================================================
  14.  
  15. This door is guarenteed only to take up space on your hard drive. The person
  16. setting up and the person running this door are solely responsible for any
  17. circumstances this door may become involved in. Also, the person running
  18. this door is responsible for any information this door broadcasts. Please
  19. respect electronic publishing copyright laws.
  20.  
  21. This door has been tested and re-tested on many BBSes. When set up properly,
  22. it works. When registered, it works even better.
  23.  
  24. This door is SHAREWARE. You are granted a one time, 30 day license to run it
  25. for evaluation purposes. At the end of your one time 30 day evaluation you
  26. must either remove the active copy from your hard drive completely, or mail
  27. in your registration with $15 U.S. for a non-expirable license and registration
  28. code.
  29.  
  30. Registration will qualify you to download new and updated versions of this
  31. door from the Author's source board SOME PLACE ELSE BBS. Future/custom
  32. versions may only be made available to registered SYSOPs.
  33.  
  34. =============================================================================
  35.                           >>>>>THE DOOR<<<<<
  36. =============================================================================
  37.  
  38. SOME PLACE ELSE BBS, my BBS, has built it's reputation on my ability to find
  39. freshly released, quality doors from places people have never heard of!  8-)
  40. It seems like EVERYBODY is writing BBS doors now.
  41.  
  42. "Remote Imaging Protocol" or "Rest In Peace" ANSI...either way, RIPScript
  43. is clearly the next evolution of telecommunications.
  44.  
  45. For those of us SYSOPs who are not artists, RIPScript also supports sets
  46. of pictures called Icons. These pictures don't actually display over the
  47. modem, but must actually reside on the caller's hard drive.
  48.  
  49. RIPScript is new, and libraries of icons are springing up nationwide!
  50. SYSOPs change their icons frequently as new and improved ones appear. The
  51. problem is directing the callers to the download areas and convincing them
  52. to download the icons every time they change.
  53.  
  54. The solution? AutoIcon! When the caller is placed inside the AutoIcon door
  55. their terminal is polled for a Rip Identification. If the caller is NOT a
  56. RIP user, the door sends them a FORCED FILE (if active) and exits quietly.
  57. The forced file deature is a great way to make sure the caller gets a
  58. BBS rules file, application, or archive of files that you want EVERY caller
  59. to receive. AutoIcon also logs it's activity, so callers WON'T get the
  60. forced file EVERY TIME they enter the door. If they DO have a RIP compatable
  61. terminal, the door checks their ICON directory for the proper icons, and
  62. assists them in obatining, and in most cases, auto-installing the icons.
  63.  
  64.                                    Page 1
  65.              AutoIcon (C)1993-1997 Geoffrey Todd Carlton
  66. -
  67. =============================================================================
  68.                        >>>>>THE CONFIG FILE<<<<<
  69. =============================================================================
  70. In this archive, you should find a sample AUTOICON.CFG  You may edit it to
  71. reflect your system's configuration.
  72.  
  73. The .CFG file is a 10 line ASCII text file.
  74.  
  75.  Line 1: Complete Path To Dropfile, Including Dropfile Name
  76.          Ex: C:\BBS\TRIBBS.SYS
  77.  
  78.  Line 2: The Name Of The BBS As It Will Appear On The Registration Form
  79.          Ex: SOME PLACE ELSE BBS
  80.  
  81.  Line 3: Registering Sysop's First Name
  82.          Ex: Todd
  83.  
  84.  Line 4: Registering Sysop's Last Name
  85.          Ex: Carlton
  86.  
  87.  Line 5: Path Name To Directory With (.ICN) Icons
  88.          Ex: C:\TRIBBS\DISPLAY\
  89.  
  90.  Line 6: Path And File Name For .ZIPed Icon Library
  91.          Ex: C:\TRIBBS\DISPLAY\SPE_ICON.ZIP
  92.  
  93.  Line 7: Path And File Name For .ARJed Icon Library
  94.          Ex: C:\TRIBBS\DISPLAY\SPE_ICON.ARJ
  95.  
  96.  Line 8: Action Based On Caller Log (0, 1, 2, or 3)
  97.          Ex: 2
  98.  
  99.  
  100.      0 = Exit Door Without Any Output To Callers Who Are In The Log
  101.          Used if you force callers into the door at logon. This way they
  102.          Don't have to wait while all icons are rechecked
  103.      1 = Force Icon Check Every Time - Used When AutoIcon is An Optional Door
  104.      2 = Ask Callers Who Have Been In Since The Last Icon Change If They'd
  105.          Like To Check Their Icons Anyway. This is The Polite And Recommended
  106.          Option To Use In Case Caller Is At A Friends House Or Has Changed
  107.          Terminals, or any unforeseen things has happened to their icons.
  108.      3 = » REGISTERED VERSION ONLY « Operates 100% invisible to caller.
  109.          No prompts, no displays... just sends forced file (if turned on)
  110.          and missing icons.
  111.  
  112.  Line 9: Path And File Name For FORCED FILE or NONE
  113.          Ex: NONE
  114.  
  115.  Line 10:Registration Code
  116.          Ex: 00000
  117.  
  118. Valid Dropfiles:
  119. ----------------
  120.  CALLINFO.BBS                  <- For Wildcat! systems (prior to v3.0)
  121.  DOOR.SYS                      <- For systems that support DOOR.SYS
  122.  DORINFOx.DEF                  <- For QBBS/RBBS/RA. Replace x with Node #.
  123.  PCBOARD.SYS                   <- For PCBoard systems using PCBOARD.SYS only
  124.                                   (Door also accesses the USERS file.)
  125.  SFDOORS.DAT                   <- For Spitfire systems.
  126.  TRIBBS.SYS                    <- For TriBBS systems.
  127.  USERS.SYS                     <- For PCBoard systems using USERS.SYS
  128.  USERINFO.DAT                  <- For Wildcat! 3.x+ systems.
  129.  
  130.                                    Page 2
  131.                 AutoIcon (C)1993-1997 Geoffrey Todd Carlton
  132. -
  133.  
  134.  
  135. *BBSes That use GTUSER.BBS require 2 additional "Standard" lines in their
  136.  .CFG file. They should be inserted between line 4 and line 5.
  137.  
  138. *New Line 5: COM Port
  139.          Ex: 2
  140.  
  141. *New Line 6: Node Number
  142.          Ex: 1
  143.  
  144. =============================================================================
  145.                       >>>>> RUNNING AutoIcon <<<<<
  146. =============================================================================
  147. The command line to run AutoIcon allows you the flexability of multiple
  148. config files! Simply run:
  149.  
  150. AUTOICN (CONFIGNAME)             This also works for RIP DoorGames that
  151.                                  don't offer internal Icon Downloading.
  152. - or in most cases -
  153.  
  154. AUTOICN AUTOICN.CFG
  155.  
  156. Multi-Line BBSes, try:
  157. AUTOICN NODE1.CFG
  158. AUTOICN NODE2.CFG
  159. etc...
  160.  
  161. FOSSIL DRIVER SUPPORT
  162. =====================
  163. Carlton Doors support the use of Fossil drivers. To tell the door to use the
  164. Fossil driver instead of the standard COM ports, just put /FD on the command
  165. line when running the door. For example:
  166.  
  167.      AutoIcon AutoIcon.CFG /FD
  168.  
  169. indicates that a Fossil driver is present and should be used. If no Fossil
  170. driver is detected, the door will print a message to that effect and exit.
  171.  
  172.  
  173. NON-STANDARD INTERRUPTS
  174. =======================
  175. Carlton doors supports COM 1-4 with standard IRQ's - COM1/COM3 = IRQ4
  176. and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  177. number after the configuration filename. Let's assume you're running
  178. DoorMania and you want to use COM1 and IRQ5. The command line
  179. passed to your Door would be:
  180.  
  181.     AutoIcon AutoIcon.CFG /5  or
  182.     AutoIcon AutoIcon.CFG /%IRQ%  (using environment variables)
  183.  
  184. The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 that
  185. is normally used with COM1. !! No /# parameter is needed for standard IRQ's !!
  186.  
  187. There have been reports of conflicts when using non-standard IRQ's on
  188. Novell/Netware systems. Since Novell also uses the / character, things
  189. somethings act screwy. The * (asterisk) may be used instead of the /
  190. in case of a conflict. In other words, /%IRQ% and *%IRQ% (/5 and *5 in the
  191. example above) will both work and are interchangeable.
  192.  
  193. Using Non-Standard COM Ports/IRQ's, Carlton doors support COMs 1 thru 15,
  194. and any valid IRQ that your modem is operating on.
  195.  
  196.                                    Page 3
  197.                 AutoIcon (C)1993-1997 Geoffrey Todd Carlton
  198. -
  199.  
  200. ENVIRONMENT VARIABLES
  201. =====================
  202.  
  203. When specifying the location of the system file on line 1 of the doors .CFG
  204. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  205. and %wcnodeid%. Some examples:
  206.  
  207.  PCBoard: 
  208.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  209.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  210.  
  211.  Wildcat!:
  212.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  213.  
  214. Non-PCBoard systems may use the PCB environment variables by setting them
  215. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  216.  SET PCBDRIVE=C:
  217.  SET PCBDIR=\BBSDIR
  218.  SET PCBNODE=1
  219.  
  220. 486DX CPU's
  221. -----------
  222. The math coprocessor in 486DX CPUs cannot handle floating point math which
  223. all MicroSoft Basic's use. This can show up as an ERROR 5, a keyboard 
  224. timeout, etc.
  225.  
  226. Fortunately there is an easy fix for this problem. Simply place the following
  227. line in the AUTOEXEC.BAT file:
  228.  
  229. SET NO87=ON
  230.  
  231. This will inform the door to use a different timing routine.  If you are
  232. operating under DESQview/X, you must flag the MATH COPROCESSOR as being ON.
  233.  
  234. =============================================================================
  235.                   >>>>> AutoIcon LAST MINUTE ADDITION <<<<<
  236. =============================================================================
  237. If you change your Icons, You MUST delete your LOG file!! The log files name
  238. is based upon the .CFG file you call the door with.
  239.  
  240. If you use: AUTOICN AUTOICON.CFG the log file will be AUTOICON.LOG
  241. If you use: AUTOICN NAVGRID.CFG the log file will be NAVGRID.LOG
  242.  
  243. You may use different .CFG files to transfer icons for Doorgames.
  244. You MUST DELETE the correct .LOG file in order for AutoIcon to begin
  245. offering the new Icons to EVERYBODY again.
  246.  
  247. =============================================================================
  248.                     >>>>> AutoIcon REGISTRATION <<<<<
  249. =============================================================================
  250.  
  251. Registration is only $15 U.S.! The one-time registration cost will entitle
  252. you to operate all versions of AutoIcon (Past, present and future) as
  253. registered.
  254.  
  255. If your BBS is taken off-line permanently, your registration **IS NOT**
  256. TRANSFERRABLE. If you change the name of your BBS, the registration code
  257. will become invalid. Please contact me via FidoNet, or my Support BBS
  258. (Some Place Else BBS 817-794-0028) for a new code, at no additional cost.
  259.  
  260. That's it! Questions/Comments/Registrations all welcome! Print AutoIcon.REG
  261. for more information!
  262.                                    Page 4
  263.                 AutoIcon (C)1993-1997 Geoffrey Todd Carlton
  264. -
  265.  
  266.  
  267. =============
  268. COMMON ERRORS
  269. =============
  270.  
  271. I attempt to release my doors as "bug free" but (obviously) cannot fully
  272. test them under every possible circumstance and under every condition.
  273. before reporting a "bug", please try to make sure the problem isn't in
  274. your own set up or configuration. If AutoIcon encounters an error
  275. condition, an ASCII file named DFRAME.ERR will be generated. Inside of that
  276. file will be error codes. Below is a table to help you determine whether
  277. the error is your problem... or mine.  8-)
  278.  
  279. Codes flagged with a "*" are typically incorrect set-up or conditions
  280. caused by YOUR system, rather than my door. If you get an error that is
  281. not marked with a "*", please contact the support BBS. -Thanks
  282.  
  283.  
  284.  
  285.                             QuickBasic Error codes
  286.  ---------------------------------------------------------------------------
  287.  2   Syntax Error                       61*  Disk full
  288.  5   Illegal Function Call              62*  Input past end of File
  289.  6   Overflow                           63*  Bad record number
  290.  7*  Out of memory                      64*  Bad filename
  291. 11   Division by Zero                   67*  Too many files
  292. 13   type mismatch                      68*  Device unavailable
  293. 24*  Device Timeout                     69*  Comm-buffer overflow
  294. 25*  Device fault                       70*  Permission denied
  295. 52*  Bad filename or number             71*  Disk not ready
  296. 53*  File Not Found                     72*  Disk media error
  297. 55   File Already open                  74*  Rename across disk
  298. 57*  Device I/O error                   75*  Path/File access error
  299. 58*  File already exists                76*  Path not found
  300. 59   Bad Record length
  301.  
  302.      The most common error that you will see is #62.  This is usually caused
  303. by the CFG file not having enough lines. If the door seems to operate fine
  304. when run locally but the remote cannot receive or receives garbled info, check
  305. and make sure you are passing the correct IRQ to the door.  Com 1 and 2 are
  306. standard and as such you do not need to pass the IRQ to them.
  307.  
  308. If you are operating under DESQview, load DVANSI in every window.
  309.  
  310. Error #75 is usually an incorrect path and/or filename in the CFG file.
  311. Please check the filenames and paths in your CFG file(s).  They *MUST* be
  312. correct in order for the door to operate.
  313.  
  314. This door will run properly without a Fossil installed. If you ARE running
  315. a Fossil, you may want to use the /FD parameter, as you may experience
  316. better throughput.
  317.  
  318.                                    Page 5
  319.                 AutoIcon (C)1993-1997 Geoffrey Todd Carlton
  320. -
  321.