home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / DEMO510.ZIP / MAINGEN.INS / README.DOC < prev    next >
Text File  |  1999-01-25  |  65KB  |  1,443 lines
  1.  
  2.                       
  3.       -----------------------------------------------------------------
  4.      /                                                                 \
  5.     /                  Searchlight BBS Changes Summary                  \
  6.    /                                                                     \
  7.   |          Copyright (c) 1988-1999  Searchlight Software, Inc.          |
  8.   |   Portions Copyright (c) 1994-1999  TeleGrafix Communications, Inc.   |
  9.   |                          All Rights Reserved                          |
  10.    \                                                                     /
  11.     \                        Version 5.1ß Rev.2                         /
  12.      \                                                                 /
  13.       -----------------------------------------------------------------
  14.  
  15.                               January 25, 1999
  16.  
  17.  
  18.      -------------------------------------------------------------------
  19.      YOU SHOULD READ THROUGH THIS FILE, OR AT LEAST SKIM THE HIGHLIGHTS.
  20.      THERE IS VERY IMPORTANT INFORMATION IN HERE ABOUT SEARCHLIGHT v5.1!
  21.      -------------------------------------------------------------------
  22.  
  23.  
  24.  ---------------------------------------------------------------------------
  25. | TABLE OF CONTENTS                                                         |
  26.  ---------------------------------------------------------------------------
  27.  
  28. 1.0 ..... Introduction
  29.   1.1 ... Important New Information
  30.   1.3 ... Using DOS Version Under Windows
  31.   1.4 ... Version number changes
  32.  
  33. 2.0 ..... Summary of Changes in 5.1 (UPDATED 01/25/1999)
  34.  
  35. 3.0 ..... Windows vs. DOS
  36.   3.1 ... Windows 95/NT and Utility Programs
  37.   3.2 ... Startup
  38.   3.3 ... Clipboard
  39.  
  40. 4.0 ..... Searchlight and Telnet
  41.   4.1 ... Setting Up Telnet
  42.   4.2 ... Using Telnet
  43.   4.3 ... Telnet and RIP
  44.   4.4 ... Telnet and Doors
  45.   4.5 ... Troubleshooting
  46.  
  47. 5.0 ..... Miscellaneous Issues
  48.   5.1 ... Events
  49.   5.2 ... RIP File Browser
  50.   5.3 ... Qmodem Pro Problem
  51.   5.4 ... File Directories
  52.   5.5 ... Default Search Strings
  53.   5.6 ... Default File List Format
  54.   5.7 ... Default Directory Search
  55.   5.8 ... Files System Commands
  56.   5.9 ... Upgrading from Version 1.x
  57.  
  58. 6.0 ..... RIPscrip Graphics and Version 5.1
  59.   6.1 ... Creating Your Own RIP Graphics
  60.  
  61. 7.0 ..... Acknowledgements
  62.  
  63. 8.0 ..... Run-Time Error Messages (NEW 01/25/1999)
  64.   8.1 ... DOS Error Messages
  65.   8.2 ... I/O Error Messages
  66.   8.3 ... Critical Error Messages
  67.   8.4 ... Fatal Error Messages
  68.  
  69. 9.0 ..... Sales and Support
  70.  
  71.  
  72.  ---------------------------------------------------------------------------
  73. | 1.0 - INTRODUCTION                                                        |
  74.  ---------------------------------------------------------------------------
  75.  
  76. Probably one of the biggest changes to Searchlight BBS in version 5.1 is the
  77. takeover of Searchlight by TeleGrafix Communications, Inc. - the inventors of
  78. RIPscrip graphics.  The crew over at Searchlight Software have decided that
  79. they would like to go off and do other things.  Not wanting the product to
  80. die, they have allowed us [TeleGrafix] to carry on their torch.  We wish the
  81. Searchlight crew the very best for whatever they choose to do in the future.
  82. Our hats off to you all for creating a great product.
  83.  
  84.  
  85. -------------------------------
  86. 1.1 - Important New Information
  87. -------------------------------
  88.  
  89. For registered users of 5.02 and earlier editions of Searchlight - the serial
  90. number/registration system for Searchlight has been completely re-done! Sorry
  91. to have to spring this on everybody, but anybody who has a 10 or 11-digit
  92. registration code provided by Searchlight Software will have to obtain a new
  93. serial number from TeleGrafix.  I can already hear the >groans< of
  94. displeasure out there.  The new system though will work out better for
  95. everyone though.
  96.  
  97. Let me take a minute to explain.  Like the older Searchlight scheme, your new
  98. 16-digit TeleGrafix serial number will determine the node count of your BBS.
  99. Searchlight's method only allowed for 1-line, 3-line, 10-line or
  100. unlimited-line scenarios.  If someone had a 3-line license, and wanted to add
  101. one more line, they'd have to buy "up to" the 10-line license - thus spending
  102. money for what he doesn't need (e.g., 6 extra lines).  With TeleGrafix's
  103. system, you can buy only what you need.  What's even better, you could
  104. upgrade your line count anytime, 24-hours a day.  All you need is a web
  105. browser, and a credit card.  You can still buy lines with a check if you mail
  106. it in, etc.
  107.  
  108. What's more, the new version 5.1 of Searchlight is both a demo edition, and
  109. the fully registered edition all in one.  If you don't run the REGISTER
  110. program, or key in your new 16-digit serial number during install, then the
  111. software will act as a demo copy - letting you play with up to 2 nodes, and
  112. up to 3 user accounts (SYSOP and GUEST count as two of those - but you can
  113. always delete GUEST if you want). That's it.  Enough to let you determine if
  114. you want to purchase Searchlight, but not enough to run a real system.  Once
  115. you buy a copy and get your serial number, just run REGISTER and voila, the
  116. software becomes fully unlocked. This means - no more diskettes that have to
  117. be shipped out.  You can just download your copy at any time, and be up and
  118. running in minutes, not days. And think of this - no more patch files!
  119.  
  120.  
  121. -------------------------------------
  122. 1.3 - Using DOS Version Under Windows
  123. -------------------------------------
  124.  
  125. We do not recommend using the DOS edition of Searchlight under Windows (i.e.,
  126. SLBBS.EXE).  You should use the Windows 95/NT version included with this
  127. package (i.e., SLBBS32.EXE).
  128.  
  129. If you do try to use the DOS version under Windows, you must make sure that
  130. Windows is configured to use EMS memory.  Without this, the software will
  131. crash and possibly cause Windows to become unstable.
  132.  
  133. See Section 3.1 below for information on configuring Windows to utilize EMS
  134. memory.
  135.  
  136. NOTE: You do not have to do this for the Windows version of Searchlight.
  137.  
  138.  
  139. ----------------------------
  140. 1.4 - Version Number Changes
  141. ----------------------------
  142.  
  143. With beta versions starting on 01/22/1999, the version number system reported
  144. on the main console (new feature) has changed.  The information displayed in
  145. the title of the screen will vary depending on what "build" of Searchlight
  146. is being run.
  147.  
  148. If a release is being worked on that has the same version number, but is to
  149. be released to the public after the main version was put out, a "Rev.#" will
  150. be added after the version number where "#" is the new release number for
  151. that version.  In this case, we're working on v5.1 Rev.2.
  152.  
  153. Furthermore, if the version being put out is a Beta edition, the symbol 'ß'
  154. will be added to the version number (e.g., v5.1ß Rev.2).  Also, for alpha and
  155. beta editions, a legend will be added identifying the date of the build along
  156. with the build number for the day (e.g., "v5.1ß Rev.2 01/22/1999.1" indicates
  157. that the version is v5.1ß, revision 2 created on 01/22/1999, and it is the
  158. first version released on that day.  If more than one beta editions are
  159. released to testers on the same day, the number after the date will be
  160. incremented (e.g., "v5.1ß Rev.2 01/22/1999.2" for the second build for the
  161. day.
  162.  
  163.  
  164.  ---------------------------------------------------------------------------
  165. | 2.0 - SUMMARY OF CHANGES IN 5.1                                           |
  166.  ---------------------------------------------------------------------------
  167.  
  168. v5.1ß Rev.2 01/25/1999.1
  169. ------------------------
  170.  
  171. - 01/25/1999: Enhanced the installation program a little bit.  Option C from
  172.   the main menu has traditionally created a default set of Searchlight data
  173.   files (i.e., .SL2 files).  Now when you choose this option, the
  174.   installation program allows you to go through a couple brief questions to
  175.   help configure the system more closely to your particular needs.  The
  176.   questions are simple and straightforward.  If you don't want to go through
  177.   the questionaire, you can simply accept the default settings and let
  178.   install do the rest -- it's up to you though to go into the configuration
  179.   program and custom tailor things yourself.
  180.  
  181.  
  182. v5.1ß Rev.2 01/22/1999.1
  183. ------------------------
  184.  
  185. - 01/22/1999: Found a bug that had been eluding detection.  There was a
  186.   bug in SLBBS.EXE that was causing the BBS to crash with a message "Runtime
  187.   error 000" whenever a caller was online and the SysOp shelled to DOS with
  188.   ALT-D.  This could also quite easily have explained reports of sporadic
  189.   crashes with the same error in the File Library.  Sorry about not finding
  190.   this one sooner.  It took a very long time to reproduce the problem 
  191.   "in-house".  Once we did, we found it pretty quickly.  Thanks to Paul
  192.   Casey and Craig Johnson for their patience in trying to track this one
  193.   down in the field.
  194.  
  195. - 01/22/1999: Made a couple minor changes to the main console.  The title
  196.   of the "call waiting" screen now knows if BBS is in the system name, and
  197.   no longer tacks " BBS" onto the end if it's already there.  Secondly,
  198.   the phrase " (Searchlight vXXX) is added to easily identify the version
  199.   that is being run.  For beta editions, additional information is added to
  200.   describe the date that the version was created and the build number on
  201.   that day.
  202.  
  203.  
  204. v5.1ß Rev.2 01/21/1999.1
  205. ------------------------
  206.  
  207. - 01/21/1999: Fixed a bug with the main console windowing procedures
  208.   introduced on 01/11/1999.1 where in some cases, a blank line appeared in
  209.   the border of some windows.
  210.  
  211.  
  212. v5.1ß Rev.2 01/11/1999.1
  213. ------------------------
  214.  
  215. - 01/11/1999: Fixed a minor display glitch in the DOS-based main console.  In
  216.   prior versions of v5.x, the lower-right corner of the main console window
  217.   was being displayed in the upper-left corner -- most annoying.
  218.  
  219. - 01/11/1999: Fixed a bug in local RIP mode.  If you login as a Sysop, and
  220.   you say that you don't want to be visible, the invisibility status of your
  221.   login session is now properly maintained and recognized on the status line.
  222.  
  223. - 01/11/1999: Fixed a bug in the CONFIG program.  The option to change a
  224.   user's name in earlier versions could screw up the Last 75 Callers log.
  225.   The caller log database doesn't store the actual name of the last
  226.   callers, but rather, their user database record number.  The act of
  227.   renaming a user will inevitably change the user's record number.  So, if
  228.   a new user logs on, they will probably have their user record stored in
  229.   the location of the old "renamed" user's location.  This would make the
  230.   last caller log show the new user in place of the renamed user in the
  231.   call log.  Now, CONFIG properly goes through the last caller log and
  232.   changes the references to the renamed user appropriately.
  233.  
  234.  
  235. 5.1 Rev.1 01/16/1998.1
  236. ----------------------
  237.  
  238. - 09/29/1998: Fixed a minor bug with the new message scan function.  If you
  239.   are a Sysop who is invisible (via ALT-I on the main console), when you
  240.   read new messages, you will no longer have to scan them again the next
  241.   time you logon.  I don't know if this was considered a feature before or
  242.   not, but sure appears to be something undesired so it's been considered a
  243.   bug and fixed.
  244.  
  245. - 09/28/1998: Fixed a small problem with memory consumption.  Earlier beta
  246.   editions of Searchlight required a little bit more memory (conventional)
  247.   than 5.02 and earlier releases.  Consequently, some testers were getting
  248.   crashes when performing quoting (^KG) in the message editor.  This was
  249.   fixed by their increasing their conventional memory size by approximately
  250.   10K.  Since then, we have managed to reduce the memory requirements of
  251.   Searchlight BBS pretty close to what they used to be.
  252.  
  253.   If you get an error 203, you've run out of memory.  Free up more memory
  254.   and try the system again.  In the case of Searchlight, a couple of K can
  255.   make all the difference in the world.
  256.  
  257. - 09/28/1998: If you login as "invisible", Searchlight now properly activates
  258.   the "I" indicator on the status line to indicate that you're invisible.
  259.  
  260. - 09/28/1998: Updated status line in RIP local console for the new status
  261.   line displays.
  262.  
  263. - 09/28/1998: When you logoff as an invisible person, you are no longer
  264.   prompted to enter a quote.  If you left a quote, people would know you
  265.   were on the system - thus defeating the invisibility feature.  The last
  266.   user's quote remains untouched.
  267.  
  268. - 09/26/1998: Fixed a bug introduced in previous beta of 9/25/1998 where the
  269.   arrow keys (among others) would not function correctly in any version of
  270.   Searchlight (i.e., DOS or Windows).  Sorry folks - silly mistake.
  271.  
  272. - 09/26/1998: Fixed a final bug with logoff quotes (phew).  If a user simply
  273.   hits <ENTER> when asked for a quote, it now resets the last user's quote
  274.   to "None".
  275.  
  276. - 09/26/1998: Fixed the install.  It seemingly locked up, but actually it
  277.   was wanting to overwrite a file, and was asking "Are you sure [Y/n]?", but
  278.   the display was hidden so nobody could know.
  279.  
  280. - Could not duplicate the "Reply quoting crash bug in RIP mode".  I suspect
  281.   it had to do with the arrow key bug above (it could have done nasty things
  282.   all over the place).
  283.  
  284. - 09/25/1998: Fixed a bug in the Sysop chat module.  If the cursor hits the
  285.   end of the line, and no spaces were present in the line between columns 55
  286.   and 80, then when the line should normally word wrap, it would simply be
  287.   erased from column 55 to the end of the line.  Now version 5.1 properly
  288.   word wraps (i.e., breaks) the line in an appropriate place (in this case,
  289.   column 55).
  290.  
  291. - 09/25/1998: Fixed a rather important bug in the Windows version of
  292.   Searchlight.  In the Windows edition, none of the ALT-key commands
  293.   normally available on the main console would work (e.g., ALT-X, ALT-H,
  294.   etc.)  Now they work.  This apparently has been a bug in the code since
  295.   5.0 was released initially.
  296.  
  297. - 09/25/1998: The Windows version of Searchlight now automatically
  298.   maximizes its window (thus eliminating those pesky scroll bars).
  299.  
  300. - 09/24/1998: Added a slight safety factor to the Options/Info command.
  301.   If a user decides to go in there and change his password, Searchlight will
  302.   no longer allow the user to switch to a totally idiotic password.  Of the
  303.   passwords not allowed are the user's NAME or ALIAS, as well as passwords
  304.   like "GOD", "ASDF", "ABC", ".", "-" and others.  Also, a user is not
  305.   allowed to set a blank password.  Only the SysOp can make these kinds of
  306.   changes via the 2-Sysop/Options/Info command.  If this new change proves
  307.   to be a serious inconvenience for SysOps, let us know at
  308.   support@telegrafix.com and we'll make this a configuration option in
  309.   CONFIG.EXE and WSLBBS.EXE.
  310.  
  311.   This change required a new text string to be added to the DEFAULT.LNG
  312.   file.  It is message 1600!  Be sure to rebuild any customized string
  313.   libraries.  Sorry 'bout this folks, but hey, it's only a single message :)
  314.  
  315. - 09/24/1998: Added two new status line displays to the main console.  The
  316.   first one, displays the user's name, alias (if applicable) and their
  317.   location.  The second displays their security profile (i.e., their
  318.   security attributes, and their security levels).
  319.  
  320. - 09/24/1998: Minor change to the 2-Sysop/Option/Access command.  When the
  321.   credits field is highlighted, it now displays the allowable credit limits
  322.   from the values (0-32768).  Earlier editions allowed a negative number of
  323.   credits which didn't make much sense.
  324.  
  325. - 09/24/1998: Fixed something that could be considered a bug.  In this
  326.   programmer's mind, it was a very serious one.  At the login prompt, the
  327.   user used to be able to hit <ENTER> indefinitely, thus tying up the BBS
  328.   ad infinitum.  This is no longer the case.  A <ENTER> is now considered
  329.   to be an invalid logon attemp, of which there are only four before the
  330.   offensive user gets the boot.
  331.  
  332. - 09/24/1998: Minor glitch with logoff quotes.  If on a multinode system,
  333.   one node has logoff quotes enabled, and another disabled - a user logging
  334.   off of the "disabled" system should clear the last logoff quote, not leave
  335.   it pending.  In earlier versions, it was left pending and the last user
  336.   from the "disabled" system could appear as the user who left the last
  337.   logoff quote.
  338.  
  339. - 09/23/1998: Fixed a bug with new user signup found during beta.  It was
  340.   discovered that a user couldn't sign up as a new account due to a bug
  341.   introduced just prior to beta testing.  This is now fixed.
  342.  
  343. - A bug was found with the new \%Q last user's quote message macro.  In
  344.   earlier beta editions of 5.1, it was claimed that this macro would bomb
  345.   the BBS when used in a conference/email message.  Thanks to the diligent
  346.   work of Paul Casey and Craig Johnson, it was determined that if the last
  347.   quote was longer than 50 bytes, it would crash.  This was a bug that
  348.   has existed for a very long time, but until the last user quote macro
  349.   was added, there was no way to know that the bug was there.  It is now
  350.   fixed.
  351.  
  352. - It was reported that the last user's quote wasn't being properly reset
  353.   by the next caller.  This should be resolved.
  354.  
  355. - Fixed a small bug with user quotes.  The last quote that the user entered
  356.   was being erased by the very next incoming caller - immediately after it
  357.   was displayed on the greeting screen.  It should remain valid until the
  358.   next person logs off of the system.
  359.  
  360. - Added the ability to change the system's console colors.  There is a new
  361.   menu option in the "General Config" menu of CONFIG called "Console Colors".
  362.   In WSLBBS, there's a new tab in the node properties page that offers the
  363.   same configuration changes to the console colors.
  364.  
  365. - Modified the default console colors to something a little less harsh, and
  366.   to colors that won't burn the monitor as quickly.
  367.  
  368. - Fixed a year-2000 bug in the Sysop editor under the security section.  The
  369.   user expiration date wouldn't permit you to enter dates beyond Jan-31 2001.
  370.   This was a bug discovered after 5.02 was released, but fixed before
  371.   TeleGrafix took over Searchlight.
  372.  
  373. - Discovered a number of undocumented Message Macros that weren't defined in
  374.   the user manual.  These were present in v5.02, but nobody but Searchlight
  375.   new about them:
  376.  
  377.           \%D ... Current File Directory (mis-documented as \SB)
  378.           \%E ... External port number
  379.           \%H ... Current Confierence (mis-documented as \FD)
  380.           \%J ... User's alias name with spaces replaced by underbars
  381.           \%R ... Effective baud rate
  382.           \%X ... Login-ID of current user
  383.           \%Y ... Login-ID of current user with spaces replaced by underbars
  384.           \%I ... Current user's alias name
  385.  
  386. - Added some new Message Macros thanks to Craig Johnson:
  387.  
  388.           \%Z ... Today's date in long format (e.g., "May 5, 1998")
  389.           \%V ... Current time (e.g., "11:24 am" - obeys 12/24-hour setting)
  390.           \%W ... Current date (e.g., "08/12/1998" - obeys USA/Euro setting)
  391.           \%? ... Date of current user's last logon
  392.           \%# ... Total number of calls to the system to date
  393.           \%Q ... Last caller's quote (or "Disabled" or "None")
  394.           \%& ... Total number of calls the current user has made
  395.           \%$ ... Last caller's name
  396.           \%@ ... Last caller's alias
  397.  
  398. - Fixed a bug with two of the documented Message Macros.  As per the manual,
  399.   the \SB and \FD macros were supposed to be available to display the
  400.   current conference and file directory, but in reality, they only worked in
  401.   RIPscrip mode.  Now they work in ANSI mode as well.
  402.  
  403. - Fixed a bug with the message macro "\%L".  This variable was always leaving
  404.   its answer in 24-hour format regardless of the current 12/24-hour setting
  405.   in CONFIG.  This option now displays in 12-hour format if requested to do
  406.   so.
  407.  
  408.   NOTE: Anybody using this in menus might need to do a tiny bit of
  409.         reformatting of your menus if the length of the value was important.
  410.  
  411. - Fixed an error in the manual that had been there for quite some time.  In
  412.   Appendix G of the Internal Command Reference chapter, command #190 --
  413.   Sysop Function was incorrectly documenting the available parameters.  The
  414.   parameters do not require slashes (/) before them.  Putting them in just
  415.   makes the command not work correctly.  The documentation has been
  416.   corrected.  Here is the correct parameter listing:
  417.  
  418.             A   Adjust user options
  419.             V   Validate user
  420.             I   View/change user info
  421.             P   View/change user preferences
  422.             S   View user stats
  423.             C   View/change user access levels
  424.             R   Read user's mail
  425.             E   Send mail as a particular user
  426.             L   List user's mail
  427.             N   View user's new mail
  428.             F   Find message in user's mailbox
  429.             Q   Inquire function
  430.             G   Mail purge function
  431.  
  432. - Documentation is now available electronically in two formats.  For people
  433.   with access to a Microsoft Windows machine with a printer, there's a
  434.   Windows manual that can be used to view and print high-quality, manual
  435.   style pages.  For those with dot matrix printers, or not using Windows,
  436.   the manual is also provided in a print-ready ASCII format.
  437.  
  438. - Updated the default screen colors for new and demo installations.  This
  439.   should not affect users with existing Searchlight installations.  This was
  440.   done to provide first-time Searchlight users with a brighter first
  441.   experience; the original colors were dark and  dim and gloomy in this
  442.   programmer's humble opinion.
  443.  
  444.  
  445.  ---------------------------------------------------------------------------
  446. | 3.0 - WINDOWS VS. DOS                                                     |
  447.  ---------------------------------------------------------------------------
  448.  
  449. This version of Searchlight includes separate executables for Windows
  450. and DOS.  To start the DOS version of Searchlight, type SLBBS.  To start
  451. the Windows version, type WSLBBS or SLBBS32.  See your manual for more
  452. information.  The Windows version requires Windows 95 or NT.
  453.  
  454. If you run the Windows version of Searchlight, pay particular attention
  455. to how you install Door programs.  Some old DOS door programs will not
  456. function under the Windows version of Searchlight.  Use the following
  457. guidelines:
  458.  
  459.   1) For door programs that use Searchlight's BIOS or DirectVideo support,
  460.      no changes are required.  These programs will run essentially the same
  461.      was as they do under previous versions of Searchlight.
  462.  
  463.   2) The recommended method of running any other door program is to use
  464.      Searchlight's FOSSIL emulation feature.  Configure the door program
  465.      to use a FOSSIL driver and set the Communications Support option in
  466.      Searchlight to 'Fossil'.  This is preferable to using other Fossil
  467.      drivers or direct communications with a COM port.
  468.  
  469.   3) If a Door program has built-in DigiBoard support, set the door
  470.      program up as a FOSSIL application, even if you are using a DigiBoard.
  471.      DOS programs that have DigiBoard support rely on DOS DigiBoard
  472.      drivers, which aren't available in Windows.  (Do not attempt to load
  473.      the DOS DigiBoard driver under Windows; install their Windows driver
  474.      instead).
  475.  
  476.   4) If a Door program has no other option except direct COM port access,
  477.      you may or may not be able to use that door under Windows.  In
  478.      particular, Windows NT users will find that Door programs are blocked
  479.      from independently opening a COM port while Searchlight is running
  480.      on the same port.  Such Door programs are best avoided.  Most modern
  481.      door programs have Fossil support.
  482.  
  483.   5) The 'REBOOT' method of program termination is not supported under
  484.      Windows.  For door programs that are set to REBOOT, the Terminate
  485.      method is used instead.
  486.  
  487. We recommend using Direct Video mode rather than BIOS mode when running
  488. command prompts or utility programs that do not specifically require BIOS
  489. mode.  The command interpreter in Windows 95 does not support all the BIOS
  490. video functions when running in a window, hence some programs might not
  491. provide correct screen displays in this mode.
  492.  
  493.  
  494. ----------------------------------------
  495. 3.1 - Windows 95/NT and Utility Programs
  496. ----------------------------------------
  497.  
  498. We strongly recommend that if you're running under Windows, that you use the
  499. 32-bit Windows executables (e.g., SLBBS32 and WSLBBS).  If you need to use
  500. any of the utility programs like NETMAIL or SLMAIL, you'll need to enable
  501. EMS memory support under Windows.
  502.  
  503. For Windows 95, edit your CONFIG.SYS file and add the following lines to
  504. the file:
  505.  
  506.           DEVICE=C:\Windows\himem.sys
  507.           DEVICE=C:\Windows\emm386.exe
  508.  
  509. This will provide EMS memory to programs running in DOS mode, like
  510. Searchlight's utility programs.
  511.  
  512.  
  513. -------------
  514. 3.2 - Startup
  515. -------------
  516.  
  517. If you start the Windows version of Searchlight from a batch file or from a
  518. DOS-based front end mailer program, you should use the MS-DOS START command
  519. with a /W switch to prevent Searchlight from starting as an independent
  520. background task.  For example:
  521.  
  522.      START /W SLBBS32 <BaudRate> <TimeLimit> /C
  523.  
  524. In most cases, you will want to do this so that your mailer does not
  525. resume operation until Searchlight has exited.
  526.  
  527.  
  528. ---------------
  529. 3.3 - Clipboard
  530. ---------------
  531.  
  532. The Windows version of Searchlight makes intelligent use of the Windows
  533. clipboard for cut-and-paste operations.  Although you can still use the
  534. cut and paste icons on the console toolbar for crude cutting and
  535. pasting, Searchlight offers several new ways for moving data to and from
  536. other Windows applications:
  537.  
  538.   - To paste text from the clipboard into Searchlight, press CTRL-V instead
  539.     of using the "Paste" icon in the console toolbar.  This will allow you
  540.     to paste large portions of text into the message editor much faster than
  541.     you can using the icon.  This is also an intelligent paste; if you try
  542.     to paste a large block of text into a small input field (like the
  543.     subject of a message), Searchlight takes as much text as will fit and
  544.     then discontinues the paste operation.
  545.  
  546.   - In the message editor, you can also access the Paste function by typing
  547.     ESC and then selecting "Paste" from the menu.
  548.  
  549.   - There are several ways to copy text from Searchlight to the clipboard.
  550.     If you want to copy a message or an entire message thread to the
  551.     clipboard, read the message (or any message in the thread) and select
  552.     Other/Forward/Message/Clipboard (or Other/Forward/Thread/Clipboard).
  553.     The text is copied to the clipboard, and you can paste it into another
  554.     Windows program such as a word processor.
  555.  
  556.   - To copy any other kind of listing or screen display to the clipboard,
  557.     press ALT-P.  This command opens a clipboard log; you'll see the "L" on
  558.     the status line turn from lowercase to capital.  Provide whatever
  559.     commands are needed to generate the list or output you're interested in,
  560.     and then press ALT-P again to close the log and copy the text to the
  561.     clipboard.  You can now paste the clipboard log into another Windows
  562.     application.  Notice that you can use this procedure to copy listings
  563.     that are larger than the physical screen size.
  564.  
  565.   - If you want to copy a small portion of text that's visible on the
  566.     screen, you can also use the Copy icon in the toolbar (the square
  567.     outline icon).  Click the icon, then highlight the desired text with
  568.     your mouse, and press Enter to copy it to the clipboard.  This procedure
  569.     is limited to the amount of text that fits on the physical screen.
  570.  
  571. Note:  Copy and paste operations only work during a local login and are
  572.        designed primarily for moving data between Searchlight and other
  573.        Windows applications.  Remote callers do not have access to clipboard
  574.        operations.
  575.  
  576.  
  577.  ---------------------------------------------------------------------------
  578. | 4.0 - SEARCHLIGHT AND TELNET                                              |
  579.  ---------------------------------------------------------------------------
  580.  
  581. The Windows version of Searchlight BBS lets you perform Telnet hosting on a
  582. Windows 95 or Windows NT platform. The telnet feature allows telnet clients
  583. on the internet (or on any TCP/IP network) to connect to your Searchlight
  584. BBS system using the telnet protocol, rather than via modems.  (Note that
  585. Searchlight is a telnet host, rather than a client. It gives you the
  586. capability to create a telnet service on the internet, not the ability for
  587. your callers to access outbound telnet services through your BBS).
  588.  
  589.  
  590. -----------------------
  591. 4.1 - Setting Up Telnet
  592. -----------------------
  593.  
  594. To enable the telnet feature, you need to be running Searchlight BBS on a
  595. computer with TCP/IP networking installed. It is recommended that you enable
  596. telnet only if your computer has a permanent, reliable connection to the
  597. internet and a static IP address. It is possible to use telnet if your
  598. internet connection is via a modem with a dynamic address, but it is
  599. generally impractical to do so since users need to know your IP address or
  600. computer name in order to connect with your system.
  601.  
  602. To enable telnet connections, run the WSLBBS configuration program and edit
  603. the properties for your first node by double-clicking on the node number.
  604.  
  605. If you run a multiuser BBS, telnet can be enabled or disabled individually
  606. for each node, so make sure you make the telnet settings for all node(s)
  607. which you desire to be accessible via telnet.
  608.  
  609. On the Communications tab, find the option labeled "Accept Telnet
  610. connections?" and toggle it to Yes. In the following field, "Telnet IP
  611. address", enter the IP address on which you wish to receive telnet
  612. connections.
  613.  
  614. IMPORTANT NOTE:  For Telnet to function properly, you must shut off the
  615.                  default modem configuration of Searchlight by setting the
  616.                  "COM Port Number" to "0".  If you do not do this,
  617.                  Searchlight will not accept Telnet connections!
  618.  
  619. If your computer runs Windows 95, you have only one IP address, which you
  620. can find by examining your TCP/IP protocol properties (right-click on the
  621. Network Neighborhood icon, then select Properties, then double-click on
  622. TCP/IP in the list). An IP address is four numbers separated by periods; for
  623. example, "207.54.137.11".
  624.  
  625. If you run Windows NT, your computer may have more than one IP address. In
  626. this case, enter the IP address on which you desire to receive telnet
  627. connections for that node.
  628.  
  629. There is no limit to the number of Searchlight nodes that may be configured
  630. to accept telnet connections from the same IP address, so if you run a
  631. multiuser BBS, you can configure two or more nodes on one computer with the
  632. same IP address. (If you run Windows NT, it is possible to have multiple
  633. nodes answering on different addresses, but this is seldom necessary).
  634.  
  635. If your internet connection is through a dialup SLIP/PPP service which
  636. issues a different IP address each time you connect (called Dynamic IP
  637. addressing), you can leave the IP address field blank. If the field is left
  638. blank, then Searchlight will automatically connect to whatever IP address is
  639. available at the time it is launched. (Note that if your dialup connection
  640. is dropped and reestablished with a new IP address while Searchlight is
  641. running, telnet connections may not work until you exit and restart
  642. Searchlight).
  643.  
  644. If you configure a node to accept a telnet connection, you should disable
  645. that node from accepting modem connections. To do that, enter a 0 for the
  646. Com Port Number on the Communications setup tab.
  647.  
  648.  
  649. ------------------
  650. 4.2 - Using Telnet
  651. ------------------
  652.  
  653. Once your BBS is configured to accept telnet sessions and the appropriate
  654. node(s) are launched, you can connect to your BBS via any telnet client by
  655. typing your host system's IP address or computer name (if you computer is
  656. registered on a domain name sever). Once connected, you use Searchlight just
  657. as you would use it via a modem connection.
  658.  
  659. There are several issues you should be aware of when using Searchlight BBS
  660. via telnet. The TCP/IP protocol over which telnet rides is packet-oriented;
  661. that means information is transmitted in blocks. As a result, you may notice
  662. that screens tend to display in blocks rather than as a continuous stream of
  663. data; you may also notice short delays between when you type a letter or
  664. command and when the results of your typing are visible. This is normal
  665. behavior for telnet operations.
  666.  
  667. Telnet performance may be limited by the capabilities of the telnet client
  668. you use. Some telnet clients do not provide the same level of ANSI graphics
  669. support as leading terminal programs. For example, the default telnet client
  670. included with Windows 95 supports ANSI, but does not support color codes or
  671. high ASCII characters. If you wish to use ANSI mode with a telnet client,
  672. remember to set the screen size (buffer size) to 24 lines. If you encounter
  673. a lot of display problems on a telnet client in ANSI mode, try switching to
  674. non-ANSI mode. Be sure to set your telnet client to ôfull duplexö mode, if a
  675. setting is available.
  676.  
  677. Some telnet clients (such as the Windows 95 default client) do not support
  678. file transfers, and are thus incapable of uploading or downloading files.
  679. For best results, try to use a more advanced telnet communications package.
  680. Newer  versions of Windows 95 HyperTerminal support telnet operations and
  681. file transfers, and work well with Searchlight BBS. There are a number of
  682. other shareware telnet clients that can be used with Searchlight, as well as
  683. a number of commercial communications packages (Procomm, Qmodem, etc.)
  684.  
  685.  
  686. --------------------
  687. 4.3 - Telnet and RIP
  688. --------------------
  689.  
  690. RIP graphics are available via telnet if you use a RIP-compatible telnet
  691. client. The best way to use RIP over a telnet connection is to run
  692. TeleGrafixÆ RIP telnet client. For more information about the RIP telnet
  693. client, check the TeleGrafix home page at http://www.telegrafix.com.
  694.  
  695. In some cases, you can telnet to a Searchlight BBS with an older RIPterm
  696. program indirectly (by dialing a Unix host or other type of host that has
  697. outbound telnet features). In many cases, RIP graphics will be available via
  698. this route, but file transfers may not work due to the 7-bit nature of many
  699. telnet connections.
  700.  
  701.  
  702. ----------------------
  703. 4.4 - Telnet and Doors
  704. ----------------------
  705.  
  706. Door programs that rely on Searchlight's BIOS or Direct Video communications
  707. support can be used with a telnet connection and will normally not require
  708. any modifications.
  709.  
  710. For best results with other types of doors, set the Communications Support
  711. option in Searchlight to "Fossil", and configure the door program such that
  712. it uses Fossil driver function calls for communication.
  713.  
  714. Doors that install their own serial communications drivers or which attempt
  715. to write directly to a serial port will not work with telnet connections.
  716.  
  717.  
  718. ---------------------
  719. 4.5 - Troubleshooting
  720. ---------------------
  721.  
  722. If you configure Searchlight for telnet support but you cannot connect,
  723. check to make sure that the IP address you entered in the configuration
  724. screen is correct. You must know your computerÆs IP address or registered
  725. computer name in order to connect to Searchlight via telnet. Contact your
  726. network administrator or internet service provider if you are not sure.
  727.  
  728. If you connect to Searchlight but you see two characters for every key you
  729. type, your telnet client is probably set for "echo mode" or "half duplex"
  730. mode. Most clients have a configuration screen in which you can disable this
  731. mode.
  732.  
  733. Many clients also have a "line entry" mode. If you see nothing until you
  734. press Enter, your client may be in line mode. Line mode wonÆt work properly
  735. with Searchlight BBS. Again, you should be able to disable this mode via a
  736. configuration screen on your client.
  737.  
  738. If file transfers fail, or if screens with high ASCII characters donÆt look
  739. correct, your client may be set to 7-bit mode. Searchlight works best in
  740. 8-bit mode. Most clients can support 8-bit mode, but a few cannot.
  741.  
  742. If ANSI displays look correct except for the last line, check to make sure
  743. your client is set to display 24 lines rather than 25 lines or some other
  744. number of lines.
  745.  
  746. If you are trying to use Searchlight with an older telnet client, or with a
  747. unix-based client, you may be able to obtain best results by selecting the
  748. Monochrome or None graphics options when you connect.
  749.  
  750.  
  751.  ---------------------------------------------------------------------------
  752. | 5.0 - MISCELLANEOUS ISSUES                                                |
  753.  ---------------------------------------------------------------------------
  754.  
  755. This section attempts to document miscellaneous issues that didn't make it
  756. into the manual before production.
  757.  
  758.  
  759. ------------
  760. 5.1 - Events
  761. ------------
  762.  
  763. When Searchlight 5.0 for Windows executes an event, it enables its FOSSIL
  764. driver emulation feature. That means events can call FOSSIL driver functions
  765. for communications. If you are running an event that requires communications
  766. (such as a UUCP poll), configure your software so that it communicates via
  767. FOSSIL driver. (If you are running FXUUCICO, place the command "driver:
  768. fossil" in your UUCICO.CFG file).
  769.  
  770.  
  771. ----------------------
  772. 5.2 - RIP File Browser
  773. ----------------------
  774.  
  775. The Files, New and Zippy command support a parameter, /R, which allows these
  776. commands to work in RIP mode the same way they work in ANSI mode (ie. the
  777. commands do not invoke the file browser).
  778.  
  779. The Files command asks "Search all directories? Y/N". You can override this
  780. with an /A or /N switch: /A searches all directories without asking, and /N
  781. searches only the current directory without asking. You can add this switch
  782. if you prefer the file browser to start with a list of files in the current
  783. directory instead of a list of directories.
  784.  
  785. File tagging is quicker if you click on the first column of the display.
  786.  
  787. Files, New and Zippy commands can take as a menu name as a parameter by
  788. specifying "/M<Menuname>". When provided, this menu is scanned to determine
  789. whether commands like Upload, Copy, Xproto, etc. appear in the browse window
  790. (if the commands are on the specified menu, they are included).
  791.  
  792.  
  793. ------------------------
  794. 5.3 - Qmodem Pro Problem
  795. ------------------------
  796.  
  797. Qmodem Pro for Windows contains a bug with certain 256 color VGA drivers
  798. that causes reverse-video highlight bars to appear as solid white bars.
  799. This bug affects Searchlight's file and message browser features. If you
  800. experience this problem, try running Qmodem with a different VGA driver.
  801.  
  802.  
  803. ----------------------
  804. 5.4 - File Directories
  805. ----------------------
  806.  
  807. Searchlight 5.0 requires that there be at least 1 file directory available
  808. at all times. If you are installing Searchlight for the first time, the
  809. INSTALL program will create a directory called 'UPLOADS'. If you are
  810. upgrading, make sure your installation includes at least 1 available
  811. directory at all times and for all access levels.
  812.  
  813.  
  814. ----------------------------
  815. 5.5 - Default Search Strings
  816. ----------------------------
  817.  
  818. The Files command (internal command 300) and Zippy command (internal 305)
  819. may be provided with a default filename or wildcard (for command #300) or
  820. default search string (for command #305) by placing the desired text on the
  821. parameter line below the command in the menu structure. For example:
  822.  
  823.      11. Command Number (1) ............ 305
  824.      12. Command Parameters (1) ........ JONES
  825.  
  826. This command would perform a Zippy search using the search key "JONES". The
  827. user is not prompted to enter a search key in this case.
  828.  
  829. The files command (#300) can also be provided with a parameter which is
  830. either a filename or a wildcard. A filename with no wildcard characters
  831. provides a list of the current directory from that filename onward. A
  832. wildcard provides a list of filenames which match the wildcard (ie. *.ZIP or
  833. ABF??.TXT).
  834.  
  835.  
  836. ------------------------------
  837. 5.6 - Default File List Format
  838. ------------------------------
  839.  
  840. Internal commands 300 and 305 can be made to skip the "Display Long File
  841. Descriptions?" prompt by adding a parameter to the command which defines the
  842. desired behavior:
  843.  
  844.      /L   Forces long file descriptions
  845.      /S   Forces short file descriptions
  846.      /P   Forces the Yes/No prompt to appear
  847.  
  848. Using /L, /S or /P overrides the user's default setting.
  849.  
  850. Example:
  851.  
  852.      11. Command Number (1) ............    305
  853.      12. Command Parameters (1) ........ JONES /L
  854.  
  855. This command does a Zippy scan using the search key "JONES" and always
  856. displays long file descriptions.
  857.  
  858.  
  859. ------------------------------
  860. 5.7 - Default Directory Search
  861. ------------------------------
  862.  
  863. The "Search All Directories?" question can be eliminated from internal
  864. commands 300 and 305 by using the following parameters:
  865.  
  866.      /A   Search all directories
  867.      /N   Do not search all directories (search current directory only)
  868.  
  869. Example:
  870.  
  871.      11. Command Number (1) ............    305
  872.      12. Command Parameters (1) ........ JONES /L /N
  873.  
  874. This command does a Zippy search on the keyword "JONES", always displays
  875. long descriptions, and searches only the current directory. All three user
  876. prompts (search key, display long descriptions, search all directories) are
  877. eliminated; therefore the listing appears immediately when this command is
  878. executed.
  879.  
  880. The "Default Directory Search" and "Default File List Format" switches (used
  881. with commands 300 & 305) now also work with the New Files command (command
  882. number 303).
  883.  
  884.  
  885. ---------------------------
  886. 5.8 - Files System Commands
  887. ---------------------------
  888.  
  889. In older versions of Searchlight BBS, the file oriented commands were
  890. distributed as a separate executable program, FILES.EXE. One of the
  891. limitations of that design was the fact that an explicit command (internal
  892. command 153) was needed to load the files program, and only files system
  893. commands - those with command numbers 300 and above - could be used on file
  894. menus. For example, in Searchlight 2.25, it was impossible to put a Download
  895. command on the same line as a command to send mail to the Sysop.
  896.  
  897. Searchlight 3.0 and later combines file commands and main commands into one
  898. program, eliminating this limitation. If you used previous versions of
  899. Searchlight, you may notice that there is no longer a FILES.EXE program
  900. distributed with Searchlight; instead, all files functions are contained in
  901. the main program, BBS.EXE.
  902.  
  903. As a result, menus in Searchlight 5.0 can contain any internal commands.
  904. File commands, like the commands to list directories, download files, etc.
  905. may be freely placed on any menu wherever they are desired. No special
  906. command is needed to start the files program before executing a files
  907. command, and no special command is needed to exit the files program.
  908.  
  909. However, Searchlight 5.0 still supports the old command sequences (command
  910. 153 to enter the files area, and command 330 to exit the files area).
  911. Instead of loading a new program, Searchlight 5.0 emulates the actions of
  912. the old FILES.EXE program. Therefore, all existing menus are compatible with
  913. Searchlight 5.0, and no changes to your menus are required unless you want
  914. to take advantage of the new capability to have files and regular commands
  915. on the same menu.
  916.  
  917. If you do decide to create combined menus, a few notes are in order:
  918.  
  919.      * Searchlight's internal command 153 performs a few special actions:
  920.        it checks to see if a custom directory list for the current
  921.        conference exists, and loads it if available. It also changes the
  922.        area name that appears at the top-right hand corner of the screen to
  923.        the current directory name, and tells the menu display programs to
  924.        search for help files ending in ".FH" instead of ".MH" if help is
  925.        requested. If you load a files-oriented menu directly, without
  926.        executing command 153, the commands will still work, but you should
  927.        be aware that the above actions will not take place. (You can load
  928.        conference lists yourself using the new internal command 201,
  929.        outlined in your manual).
  930.  
  931.      * Should you execute an internal command 153 which loads a particular
  932.        *.DIR file with a list of available directories for the current
  933.        conference, be aware that this directory list remains in memory as
  934.        the list of available directories until another 153 command is
  935.        executed. This is important if you use internal command 153 in some
  936.        places but not in others.
  937.  
  938.      * Command 330 (return from files area) performs the following actions
  939.        in Searchlight 5.0: it changes the help file suffix back to ".MH",
  940.        sets the on screen area name back to the current conference name,
  941.        and returns to the menu where the previous command 153 was executed.
  942.        Use this command only if you used command 153 to enter a files menu
  943.        (otherwise, just return to the previous menu with internal command
  944.        number 1).
  945.  
  946.  
  947. --------------------------------
  948. 5.9 - Upgrading from Version 1.x
  949. --------------------------------
  950.  
  951. If you have any version of Searchlight older than 2.15 and you want to
  952. retain your messages and users after upgrading, you need our 1.x upgrade
  953. utility. You can download the upgrade program free of charge from
  954. Searchlight's Web site (http://www.searchlight.com/bbs) or BBS
  955. (540-678-4053).
  956.  
  957.  
  958.  
  959.  ---------------------------------------------------------------------------
  960. | 6.0 - RIPSCRIP GRAPHICS AND VERSION 5.1                                   |
  961.  ---------------------------------------------------------------------------
  962.  
  963. Version 5.1 supports RIPscrip 2.x graphics for remote callers.  The DOS
  964. edition of the software has RIPscrip 1.54 display capability for the main
  965. console.  This means that the sysop will see RIP 1.54 style graphics on the
  966. main system.  At the current time however, if the sysop is viewing a caller
  967. who is accessing the system via RIPscrip 2.0 graphics, the sysop may not see
  968. the same images due to major differences between RIPscrip 2.x and versions
  969. 1.54.
  970.  
  971. Future versions may enhance the main console RIPscrip support to support
  972. RIPscrip 2, and even higher.
  973.  
  974. The Windows edition of Searchlight does not currently support RIPscrip
  975. display on the main console.  This will be changing in future editions of
  976. Searchlight.
  977.  
  978.  
  979. 6.1 - Creating Your Own RIP Graphics
  980. ------------------------------------
  981.  
  982. You can create your own RIPscrip graphics for your system by using RIPaint
  983. from TeleGrafix Communications, Inc.  You may download a demo copy of this
  984. drawing package from http://www.telegrafix.com.
  985.  
  986.  
  987.  
  988.  ---------------------------------------------------------------------------
  989. | 7.0 - ACKNOWLEDGEMENTS                                                    |
  990.  ---------------------------------------------------------------------------
  991.  
  992. We would like to take the time to acknowledge the assistance of our
  993. Searchlight Beta testers.  In particular, Paul Casey and Craig Johnson for
  994. their in-depth crash testing (literally), and for their abilities to kick
  995. the tires on this buggy.  Sure, we blew a few tires along the way, but
  996. without your help and support, it might have gone out on the road with bald
  997. tires.  Our hats off to you guys, you did a great job!!
  998.  
  999.  
  1000.  ---------------------------------------------------------------------------
  1001. | 8.0 - RUN-TIME ERROR MESSAGES                                             |
  1002.  ---------------------------------------------------------------------------
  1003.  
  1004. Under normal operations, Searchlight should run for a long time, and should
  1005. not crash.  If however, something goes wrong for whatever reason, it is
  1006. helpful to know what the error messages you might see are.
  1007.  
  1008. If Searchlight (or one of the utility programs) crashes, you will most likely
  1009. see a message similar to the following:
  1010.  
  1011.      Runtime error XXX at YYYY:ZZZZ
  1012.  
  1013. The important information is the run-time error number (i.e., XXX).  This
  1014. will tell you what type of error was encountered.  The value YYYY:ZZZZ is
  1015. the location in memory Searchlight was currently executing when the error
  1016. occurred.  The memory location YYYY:ZZZZ could be useful to TeleGrafix
  1017. Technical Support.  If you report a run-time error to TeleGrafix after
  1018. coming to the conclusion that there's a bug in the software, please provide
  1019. the complete run-time error message, and if possible, describe the situation
  1020. that caused the error to occur.
  1021.  
  1022. The folowing sub-sections describe the various run-time errors that can
  1023. conceivably occur with Searchlight, and describes any helpful information
  1024. that might illustrate what could cause it.
  1025.  
  1026.  
  1027. 8.1 - DOS Error Messages
  1028. ------------------------
  1029.  
  1030. DOS error messages generally describe a situation that are often caused by
  1031. an incorrectly configured Searchlight system, or problems with the DOS
  1032. configuration on the computer.  These are the possible DOS errors that can
  1033. be reported by Searchlight:
  1034.  
  1035.      000 ... Insufficient memory
  1036.  
  1037.              This error should never occur under normal situations.  It has
  1038.              been observed in beta editions of v5.1.  If you receive this
  1039.              error, please report it to TeleGrafix.
  1040.  
  1041.  
  1042.      001 ... Invalid function number
  1043.  
  1044.              Searchlight made an invalid operating system request.  This
  1045.              could happen if you are running Searchlight with an old version
  1046.              of DOS.  Searchlight requires DOS v3.3 or later.  If this error
  1047.              persists, contact TeleGrafix.
  1048.  
  1049.  
  1050.      002 ... File not found
  1051.  
  1052.              This error is self explanatory.  A file that Searchlight
  1053.              required wasn't found where it should be.  Check your 
  1054.              file directory settings in the configuration program.
  1055.  
  1056.  
  1057.      003 ... Path not found
  1058.  
  1059.              A directory defined in the Searchlight configuration program
  1060.              is probably not defined correctly.  Double-check them and try
  1061.              again.
  1062.  
  1063.  
  1064.      004 ... Too many open files
  1065.  
  1066.              The FILES= statement in your CONFIG.SYS file is not high
  1067.              enough.  We recommend that you have a statement of at least
  1068.              FILES=40 in your CONFIG.SYS file.  If you run disk-intensive
  1069.              door programs like database doors, you may need to increase
  1070.              this value.
  1071.  
  1072.  
  1073.      005 ... File access denied
  1074.  
  1075.              This should only occur on networked drives where SHARE or
  1076.              some other suitable file sharing mechanism is installed.
  1077.              Check your file access rights, or check with your network
  1078.              administrator.  This could also occur under rare occasions
  1079.              when more than one Searchlight node is trying to access the
  1080.              same file.  For example, if you're performing a mass update
  1081.              on your Searchlight data files, this error might occur.  When
  1082.              performing system maintenance, it's usually a good idea to
  1083.              shutdown all nodes on your Searchlight system.  This can also
  1084.              occur if files are mistakenly set as "Read-only", or if a
  1085.              directory exists with the name of a file that Searchlight
  1086.              wants to read.
  1087.  
  1088.  
  1089.      006 ... Invalid file handle
  1090.  
  1091.              This error should never occur under normal circumstances.
  1092.              Generally it means that memory is corrupted and the computer
  1093.              must be rebooted.  If you get this error often, check to make
  1094.              sure that you don't have some kind of memory resident program
  1095.              or device driver that is causing your system to become
  1096.              unstable.  After eliminating all operating system causes, 
  1097.              contact TeleGrafix to report the trouble.
  1098.  
  1099.  
  1100.      012 ... Invalid file access code
  1101.  
  1102.              This generally means that there is an error in Searchlight's
  1103.              program code.  Please report this error to TeleGrafix if you
  1104.              receive it.
  1105.  
  1106.  
  1107.      015 ... Invalid drive number
  1108.  
  1109.              This shouldn't occur under normal circumstances.  This could
  1110.              conceivably happen if you're running Searchlight and one of
  1111.              your drives (e.g., hard drives, CD-ROMs, ZIP/JAZZ drives, etc.)
  1112.              somehow go "off-line".
  1113.  
  1114.  
  1115.      016 ... Cannot remove current directory
  1116.  
  1117.              This error should never occur.
  1118.  
  1119.  
  1120.      017 ... Cannot rename across drives
  1121.  
  1122.              This error should never occur.
  1123.  
  1124.  
  1125. 8.2 - I/O Error Messages
  1126. ------------------------
  1127.  
  1128. I/O errors are problems that occur while trying to read or write to files on
  1129. the hard drive.  Searchlight tried to catch these problems internally and
  1130. handle the situation as appropriate.  Generally the occurrence of one of the
  1131. errors could indicate a Searchlight bug (i.e., that Searchlight didn't
  1132. detect the problem), but almost always indicates a serious problem on the
  1133. BBS computer that caused the error in the first place.
  1134.  
  1135. NOTE: If you get one of these errors, check to make sure that there's
  1136.       nothing wrong with your DOS file system (i.e., insufficient disk
  1137.       space, bad sectors, etc.)  99% of the time these are the causes of
  1138.       the problem!
  1139.  
  1140.      100 ... Disk read error
  1141.  
  1142.              This generally means that Searchlight tried to read past the
  1143.              end of a file.  It could also mean that your hard drive has
  1144.              developed errors and should be scanned by some suitable
  1145.              utility program like Norton Utilities, or SCANDISK.
  1146.  
  1147.  
  1148.      101 ... Disk write error
  1149.  
  1150.              This generally means that your hard drive has become full.  It
  1151.              could also mean that your hard drive has developed errors and
  1152.              should be scanned by some suitable utility program like Norton
  1153.              Utilies, or SCANDISK.
  1154.  
  1155.       
  1156.      102 ... Drive not assigned
  1157.  
  1158.              This error should never occur.  If it does, please contact
  1159.              TeleGrafix.
  1160.  
  1161.  
  1162.      103 ... File not open
  1163.  
  1164.              This error means that a file couldn't be opened successfully.
  1165.              The most common causes for this error are incorrect directory
  1166.              settings in the Searchlight Configuration program.  Check all
  1167.              settings and try again.  Under worst-case situations, you might
  1168.              need to re-create your Searchlight configuration files with
  1169.              Install.  If the problem persists, contact TeleGrafix.
  1170.  
  1171.  
  1172.      104 ... File not open for input
  1173.  
  1174.              This error should not occur.  If it does, contact TeleGrafix.
  1175.  
  1176.  
  1177.      105 ... File not open for output
  1178.  
  1179.              This error should not occur.  If it does, contact TeleGrafix.
  1180.  
  1181.  
  1182.      106 ... Invalid numeric format
  1183.  
  1184.              This error should not occur.  If it does, contact TeleGrafix.
  1185.  
  1186.  
  1187. 8.3 - Critical Error Messages
  1188. -----------------------------
  1189.  
  1190. Critical errors are low-level operating system errors.  They often indicate
  1191. something is wrong with the computer, not necessarily a problem with
  1192. Searchlight itself.  If you receive one of these messages, you should check
  1193. your computer to make sure everything is alright.
  1194.  
  1195.      150 ... Disk is write-protected
  1196.  
  1197.              This error typically occurs with floppy drives, CD-ROMs,
  1198.              ZIP/JAZZ drives and removable hard drives when the disk is
  1199.              set to be write protected.  If it occurs on a hard drive,
  1200.              something is seriously wrong.
  1201.  
  1202.  
  1203.      151 ... Unknown unit
  1204.  
  1205.              This error should never occur.  If it does, contact TeleGrafix.
  1206.  
  1207.  
  1208.      152 ... Drive not ready
  1209.  
  1210.              This error typically occurs with floppy drives, CD-ROMs,
  1211.              ZIP/JAZZ drives and removable hard drives when no disk is
  1212.              installed in the drive.  If it occurs on a hard drive,
  1213.              something is seriously wrong.
  1214.  
  1215.  
  1216.      153 ... Unknown command
  1217.  
  1218.              This error should never occur.  If it does, contact TeleGrafix.
  1219.  
  1220.  
  1221.      154 ... CRC error in data
  1222.  
  1223.              This error should never occur.  If it does, contact TeleGrafix.
  1224.  
  1225.  
  1226.      155 ... Bad drive request structure length
  1227.  
  1228.              This error should never occur.  If it does, contact TeleGrafix.
  1229.  
  1230.  
  1231.      156 ... Disk seek error
  1232.  
  1233.              This error could indicate that there is an equipment failure on
  1234.              one of your disk drives.  If it's a removable drive, the disk
  1235.              itself could be faulty, or it could indicate a bad drive.
  1236.  
  1237.  
  1238.      157 ... Unknown media type
  1239.  
  1240.              This typically indicates that the disk drive being accessed
  1241.              isn't formatted properly, or that the drive is configured
  1242.              incorrectly.
  1243.  
  1244.  
  1245.      158 ... Sector not found
  1246.  
  1247.              This error usually occurs on a drive that has developed bad
  1248.              sectors, or on drives that aren't formatted.  It can sometimes
  1249.              happen on drives where the cable is partially or completely
  1250.              removed.  Check the drive, disk(ettes), and connections before
  1251.              trying again.
  1252.  
  1253.  
  1254.      159 ... Printer out of paper
  1255.  
  1256.              This error should never occur.  Searchlight does not access the
  1257.              printer in any way.
  1258.  
  1259.  
  1260.      160 ... Device write fault
  1261.  
  1262.              Something went seriously wrong while trying to write data to
  1263.              a disk drive.  This could indicate that the drive has developed
  1264.              bad sectors.  Diagnose the problem with the drive with Norton
  1265.              Utilities or SCANDISK.
  1266.  
  1267.  
  1268.      161 ... Device read fault
  1269.  
  1270.              Something went seriously wrong while trying to read data from
  1271.              a disk drive.  This could indicate that the drive has developed
  1272.              bad sectors.  Diagnose the problem with the drive with Norton
  1273.              Utilities or SCANDISK.
  1274.  
  1275.      162 ... Hardware failure
  1276.  
  1277.              This error indicates something has seriously gone wrong with
  1278.              your computer.  This could indicate just about anything.  In
  1279.              either event, you should consult a computer technician.
  1280.  
  1281.  
  1282. 8.4 - Fatal Error Messages
  1283. --------------------------
  1284.  
  1285. A fatal error is a condition that Searchlight cannot handle.  They generally
  1286. indicate a serious situation that caused Searchlight to fail, and exit back
  1287. to the operating system.
  1288.  
  1289. These errors could occur for a variety of reasons.
  1290.  
  1291.      200 ... Division by zero
  1292.  
  1293.              This error could under two situations:
  1294.  
  1295.                a) If this error occurs immediately when you try to run one
  1296.                   of the Searchlight programs from DOS, it indicates that
  1297.                   the program can't run on your computer.  The reasons are
  1298.                   rather technical, but in a nutshell it means that your
  1299.                   computer is too fast for the software.  TeleGrafix
  1300.                   discovered this problem early in v5.1 beta testing when
  1301.                   customers tried running Searchlight on 200 MHz or faster
  1302.                   Pentiums.  The manufacturer of the development tools
  1303.                   TeleGrafix uses for Searchlight has made some fixes for
  1304.                   this, which have been incorporated in beta editions of
  1305.                   Searchlight v5.1.  It is unclear if this error could
  1306.                   happen for VERY fast machines (ones which haven't been
  1307.                   created yet).  If you get this message, please contact
  1308.                   TeleGrafix.
  1309.  
  1310.                   NOTE: This error does not occur for the Windows versions
  1311.                         of Searchlight (i.e., only MS-DOS versions).
  1312.  
  1313.                b) If this error occurs after the software has been running
  1314.                   for a while, it probably indicates a bug in Searchlight.
  1315.                   Please contact TeleGrafix and report the circumstances
  1316.                   under which this error occurred.
  1317.  
  1318.  
  1319.      201 ... Range check error
  1320.  
  1321.              Searchlight tried to access an invalid data object, or tried
  1322.              to assign a number to a variable that couldn't hold the value.
  1323.              TeleGrafix tests Searchlight "in-house" with Range Checking
  1324.              turned on to "trap" programming errors.  It is turned off for
  1325.              "official releases".  If you receive this error message with
  1326.              an official release of Searchlight, please contact TeleGrafix.
  1327.  
  1328.  
  1329.      202 ... Stack overflow error
  1330.  
  1331.              This error generally represents a serious programming error in
  1332.              Searchlight.  It could also be caused by corrupted system
  1333.              memory.  If you receive this message, please contact
  1334.              TeleGrafix.
  1335.  
  1336.  
  1337.      203 ... Heap overflow error
  1338.  
  1339.              This message indicates that your system ran out of conventional
  1340.              memory.  Try freeing up some additional memory.  If this
  1341.              problem persists when you have over 500K of memory, contact
  1342.              TeleGrafix.
  1343.  
  1344.  
  1345.      204 ... Invalid pointer operation
  1346.  
  1347.              This message could indicate a programming error, or corrupted
  1348.              system memory.  If the problem is reliably reproduceable, 
  1349.              please contact TeleGrafix to report the possibility of a bug
  1350.              in Searchlight.
  1351.  
  1352.  
  1353.      205 ... Floating point overflow
  1354.  
  1355.              This indicates that Searchlight tried to compute a number that
  1356.              was too large to store by Searchlight.  This should not occur
  1357.              in practice, but if it does, contact TeleGrafix.
  1358.  
  1359.  
  1360.      206 ... Floating point underflow
  1361.  
  1362.              This error should never occur.  If it does, contact TeleGrafix.
  1363.  
  1364.  
  1365.      207 ... Invalid floating point operation
  1366.  
  1367.              This indicates that Searchlight attempted to perform an illegal
  1368.              mathematical operation.  If you receive this message, please
  1369.              contact TeleGrafix.
  1370.  
  1371.  
  1372.      208 ... Overlay manager not installed
  1373.  
  1374.              Searchlight is a large program -- much larger than could
  1375.              normally be stored in 640K.  With this in mind, Searchlight
  1376.              loads some of its program code into EMS memory, or loads it
  1377.              from the disk drive when it is needed.  If this message occurs,
  1378.              something went wrong with the built-in overlay manager in
  1379.              Searchlight.  Contact TeleGrafix to help isolate the problem
  1380.              with your configuration.
  1381.  
  1382.  
  1383.      209 ... Overlay file read error
  1384.  
  1385.              This error occurs when there was an error reading the overlay
  1386.              file from the disk (i.e., a file with a .OVR extension).  This
  1387.              could mean a corrupted overlay file, or errors on your hard
  1388.              disk drive.  Try testing your drive for errors with Norton
  1389.              Utilities, or SCANDISK.  If no errors are reported, try
  1390.              re-installing Searchlight.  If all else fails, contact
  1391.              TeleGrafix.
  1392.  
  1393.  
  1394.      210 ... Object not intialized
  1395.  
  1396.              This error should never occur.  If it does, contact TeleGrafix.
  1397.  
  1398.  
  1399.      211 ... Call to abstract method
  1400.  
  1401.              This error should never occur.  If it does, contact TeleGrafix.
  1402.  
  1403.  
  1404.      212 ... Stream registration error
  1405.  
  1406.              This error should never occur.  If it does, contact TeleGrafix.
  1407.  
  1408.  
  1409.      213 ... Collection index out of range
  1410.  
  1411.              This error should never occur.  If it does, contact TeleGrafix.
  1412.  
  1413.  
  1414.      214 ... Collection overflow error
  1415.  
  1416.              This error should never occur.  If it does, contact TeleGrafix.
  1417.  
  1418.  
  1419.  ---------------------------------------------------------------------------
  1420. | 9.0 - SALES AND SUPPORT                                                   |
  1421.  ---------------------------------------------------------------------------
  1422.  
  1423. TeleGrafix may be reached during normal business hours Monday through Friday,
  1424. east coast time at the following numbers:
  1425.  
  1426.      Support:  (540) 678-4050
  1427.        Sales:  (540) 678-4051
  1428.          Fax:  (540) 678-4052
  1429.          BBS:  (540) 678-4053
  1430.  
  1431. Or over the Internet at:
  1432.  
  1433.         Web:  http://www.telegrafix.com
  1434.         FTP:  ftp.telegrafix.com
  1435.      Telnet:  telnet.telegrafix.com
  1436.       Email:  info@telegrafix.com
  1437.               sales@telegrafix.com
  1438.  
  1439.  
  1440. -----------------------------------------------------------------------------
  1441.                                     # # #
  1442. -----------------------------------------------------------------------------
  1443.