home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SBOX10.ZIP / SBOX10.DOC < prev    next >
Text File  |  1993-05-31  |  6KB  |  172 lines
  1.  
  2. The Switch Box v1.0
  3. Copyright (C) 1993 Jamey Hopkins
  4. All rights reserved.
  5.  
  6. 1.0 ABOUT THE SWITCH BOX
  7.  
  8.    The Switch Box is an automatic screen changer for BBS sysops and
  9.  offers the following features:
  10.  
  11.    o Random Selection          o Screens can be stored in a ZIP archive
  12.    o Series Selection          o Knows ANY user defined Holiday/Event!*
  13.    o Algorithm Selection       
  14.  
  15.  * Registered Versions
  16.  
  17. 2.0 SHAREWARE/DISCLAIMER
  18.  
  19.    This program is distributed on an "AS IS" basis. There
  20.  is no warranty of any kind as to its use, expressed or
  21.  implied.  Although this program has been tested on different
  22.  systems, there is no way of knowing how it will respond on
  23.  every system.  The author can not be held liable for any
  24.  damages, loss of data, loss of income, or adverse reactions
  25.  as a result of using this program.  USE AT YOUR OWN RISK ...
  26.  
  27. 3.0 INSTALLATION
  28.  
  29.  RUN SETUP
  30.    After installing The Switch Box in its own directory, enter setup
  31.  by typing "sbox".  From setup you may enter your name, registration
  32.  number, and toggle the selection methods that you would like to use.  
  33.  
  34.  BUILD A DATA FILE
  35.    Next you must build a data file for The Switch Box to get its
  36.  information from.  The setup for this file goes like this:
  37.  
  38.       LINE 1: Starting Screen Number (Just Enter "1" Here)
  39.               This line is used by the series selection method.
  40.       LINE 2: Output Path for Screen
  41.               Example: c:\wc30\disp\goodbye
  42.               NOTE: Do not place an extension on the filename!
  43.               Use just the filename.  A ".*" is appended during
  44.               runtime.  For example, the above path would become:
  45.               c:\wc30\disp\goodbye.* 
  46.       LINE 3: Screen filenames start here.  Up to 99 screens may
  47.               be used.  Again, do not include the screens extension.
  48.  
  49.    To avoid confusion, all data files should be saved with the
  50.  extension, ".DAT".   Also, since the data file is a simple text
  51.  file, you MUST use a plain ASCII text editor to build or edit the
  52.  data file.  
  53.  
  54.  A sample data file called goodbye.dat has been included.
  55.  
  56.  BUILDING AN ALTERNATE FILE
  57.  
  58.    The alternate file is similar to the data file, except all
  59.  it contains is the screen filenames that are to be used when
  60.  a holiday or special date is encountered.  The starting number
  61.  and output path for the screens are kept from the original data
  62.  file.  Up to 99 alternate filenames may be used.  Again, do not
  63.  include the file extensions.  Also, you MUST use an ASCII text
  64.  editor to build this file.  To avoid confusion be sure to save the
  65.  alternate file with an extension of ".alt".  Refer to the sample
  66.  files if you need help.
  67.  
  68. 4.0 HOLIDAY/SPECIAL EVENTS AND THE ALTERNATE FILE
  69.    
  70.    In order for The Switch Box to use alternate screens for special
  71.  holidays, you must tell it the month, day, and alternate file to get
  72.  its data from.
  73.  
  74.  The format is this: monthday altfile  
  75.  
  76.  Example: 1225 xmas.alt
  77.  
  78.    The above example would cause The Switch Box to select from the
  79.  screen filenames contained in xmas.alt file on Christmas.  Spiffy, eh?
  80.  
  81.    The alternate screens line can be placed anywhere in the original
  82.  data file, from LINE 3 down.  An example of how to use this has been
  83.  included in the sample data file called goodbye.dat.
  84.  
  85. 5.0 SCREEN ARCHIVES
  86.  
  87.    The Switch Box also allows for ALL screens to be stored in a
  88.  PKZIPed archive.  If The Switch Box can't find the selected screen(s)
  89.  in the current directory, it will try to extract them from the archive
  90.  name provided at runtime.  The benefit of this is that a lot of hard
  91.  drive space is saved if you use a lot of screens, not to mention less
  92.  clutter.  To build the screens archive simply take the desired
  93.  ANSI/ASCII/RIP screens that you will be using and compress them together
  94.  into a single archive name of your choice.  Leave this archive in the
  95.  directory with The Switch Box.  The archiver itself must be available
  96.  somewhere in the systems path during runtime.
  97.  
  98. 6.0 RUNNING THE SWITCH BOX
  99.  
  100.  The Switch Box accepts the following input:
  101.  
  102.  SBOX datafile screenarchive
  103.  
  104.  EXAMPLE: SBOX goodbye.dat
  105.  EXAMPLE: SBOX goodbye.dat screens.zip
  106.  
  107. 7.0 SELECTION METHODS 
  108.  
  109.  Definitions for the selections methods used in setup:
  110.  
  111.  RANDOM
  112.      Using this method The Switch Box will perform  the
  113.    classic random pick.
  114.  
  115.  SERIES
  116.      The Switch Box will start at the top of the list
  117.    and work it's way down.  Upon reaching the end,
  118.    it will start the process back over from the top.
  119.  
  120.  ALGORITHM
  121.      This is the more complex method.  What happens is
  122.    60% of the time the TOP 30% of the screens will be
  123.    used.  30% of the time the MIDDLE 60% will be
  124.    selected.  And finally,  10% of the time the LAST
  125.    10% of the screens will be used.   This method is
  126.    good when you want to display a certain set of screens
  127.    with an occasional change in screenery.   
  128.  
  129. 8.0 HINTS/SUGGESTIONS/COMMENTS
  130.  
  131.  o The Switch Box may be placed in a "postcall.bat" file
  132.    for screen changes after every call.
  133.  o The Switch Box may be run as an event for daily, semiweekly,
  134.    and weekly screen changes.
  135.  o When using display screens that take a long time to draw, 
  136.    choose the algorithm selection method and place the screens
  137.    name at the bottom of the list.  This way users won't have
  138.    to sit through a long draw all of the time, but will still get
  139.    to see the screen some of the time.
  140.  o NOTE: PKZIP/PKUNZIP is copyrighted and/or a registered trademark
  141.    of its respective owner.
  142.  o The UNREGISTERED version of The Switch Box does not support
  143.    the following holidays: New Years, Halloween, Christmas Eve,
  144.    and Christmas.
  145.  
  146. 9.0 SUPPORT
  147.  
  148.    If you run into some problems, or just want to check out my
  149.  system for some new software, feel free to call the support
  150.  BBS for Noetic Software listed below this line.
  151.  
  152.  The Immortal! BBS
  153.  602-814-8026 
  154.                    
  155. 10.0 REGISTRATION
  156.  
  157.     This program is released as SHAREWARE.  If you continue to
  158.   use it for more than 30 days, you MUST register it.  The
  159.   current registration fee is $10.00.  When registered you will
  160.   receive a key that can be inserted into the setup part of the
  161.   program.  Registered users also get extended access to the
  162.   support BBS.
  163.  
  164.   Send registrations in U.S. Funds ONLY to:     
  165.  
  166.     Jamey Hopkins
  167.     610 N. Alma School Rd Ste 18
  168.     Chandler, AZ 85224-3687
  169.  
  170. 8^)
  171.  
  172.