home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SPORTS11.ZIP / SPORTS.DOC < prev    next >
Encoding:
Text File  |  1995-07-16  |  15.4 KB  |  329 lines
  1.  
  2.  █▀▀ █▀█ █▀█ █▀█  ▀█▀ █▀▀
  3.  ▀▀█ █▀▀ █ █ █▀▀█  █  ▀▀█
  4.  ▀▀▀ ▀   ▀▀▀ ▀  ▀  ▀  ▀▀▀                         Sports Information Viewer
  5.  ══════════─D══─I══─R══─E══─C══─T══════════════════════════════════════════
  6.  
  7.  Copyright Mulitboard Communications Centre, 1995
  8.  All rights reserved.
  9.  
  10.  
  11. ╓───────────────────────────────────────────────────────────────────────────╖
  12. ║ What is it?                                                               ║
  13. ╙───────────────────────────────────────────────────────────────────────────╜
  14.  
  15.     A great door to display the incoming SPORT packets via PlanetConnect.
  16.     This door sets up in minutes, and saves valuble hard drive space, by
  17.     creating a tighter and faster database system.  It also allows users
  18.     to select sport conferences, and download the updated articles, as
  19.     well as searching the databases for keywords, and tagging messages
  20.     for later download!
  21.  
  22.  
  23. ╓───────────────────────────────────────────────────────────────────────────╖
  24. ║ Why databases as opposed to DAT files?                                    ║
  25. ╙───────────────────────────────────────────────────────────────────────────╜
  26.  
  27.     Why the databases?  Each file on a PC based system takes up at least
  28.     one cluster on the hard disk, regardless of its size.  On most drives
  29.     of 250 megabytes or more, each one of these clusters is 8 kilobytes.
  30.     With gigabyte and larger drives, 32 kilobytes.  Seeing as all of
  31.     the files are small, they end up wasting a lot of space in these
  32.     clusters.
  33.  
  34.     For example:
  35.  
  36.     A  1k file would occupy 32k on your hard drive. (97% waste)
  37.     A 33k file would occupy 64k on your hard drive. (49% waste)
  38.  
  39.     As you can see, it does get better as the files get larger, however
  40.     with the bulk of the files being tiny, you can expect the files to
  41.     take up about 2-8 times the amount of space they appear to be using.
  42.  
  43.     One other problem, is that when this service becomes busier, you
  44.     will most likely have thousands and thousands of articles in your
  45.     data directory.  The problem with this, is that DOS becomes
  46.     extreamly slow in searching directories for files, once there are
  47.     more than 512 files in it.
  48.  
  49.     With SportsDirect, you will usually have less than 200 files in
  50.     your data directory, and the files will be packed back to back
  51.     meaning no wasted space at the end of each file, and extreamly
  52.     quick response time when displaying articles...  not to mention
  53.     the ease on your hard drives, and reduced network flow.
  54.  
  55.  
  56. ╓───────────────────────────────────────────────────────────────────────────╖
  57. ║ Configuration                                                             ║
  58. ╙───────────────────────────────────────────────────────────────────────────╜
  59.  
  60.     Sports door is very easy to install.
  61.  
  62.       1) First, unpack the contents of the archive into a directory
  63.       2) Second, edit the SPORTS.CFG file to reflect your current
  64.          setup, making sure that the path names, and directories
  65.          are correct and exist.
  66.  
  67.     SPORTS.CFG
  68.  
  69.          Line   1 = Sysop name
  70.          Line   2 = BBS Name
  71.          Line   3 = Maximum number of keyword matches allowed (0-10000)
  72.                     If set too high, a user could keyword search the word
  73.                     'THE', then tag all matched articles, causing your
  74.                     system to create megs and megs of files, although
  75.                     harmless, it could cause your system to run low
  76.                     on disk space for other tasks.  This is simply a
  77.                     saftey measure - a setting of 50 to 200 is suggested.
  78.          Line   4 = Should it update news automatically when a user
  79.                     enters the door? (YES/NO)
  80.          Line   5 = Serial number
  81.          Line   6 = Registration number
  82.          Line   7 = Path to data files     (where it should store its data)
  83.          Line   8 = Path to incoming files (where the SPORT.* packets are)
  84.          Line   9 = Command line to extract data files
  85.          Line  10 = Command line to pack using ZIP
  86.          Line  11 = Command line to pack using ARJ
  87.          Line  12 = Command line to pack using LHZ
  88.          Line  13 = Command line to pack using ARC
  89.          Line  14 = Command line to send via ymodem
  90.          Line  15 = Command line to send via zmodem
  91.  
  92.     The command lines can have 'metastrings' in them - (strings replaced
  93.     by values as needed)  This saves you from having dozens of seperate
  94.     configuration files.  The strings that can be expanded are:
  95.  
  96.          *P = Current port       eg:  c:\path\dsz.exe port *P sz
  97.          *B = Current baud       eg:  c:\path\dsz.exe est *B sz
  98.          *L = Locked baud        eg:  c:\path\dsz.exe est *L sb
  99.          *N = Node number        eg:  c:\path\node*N\dsz.bat
  100.          *F = Filename           eg:  c:\path\arj a *F *.*
  101.  
  102.     NOTE: That if for a command line *F is not specified, it's simply
  103.           added to the end (which is normal for most programs, and
  104.           the default settings)
  105.  
  106.     In addition, you can edit/modify four files to suit your needs.  (or
  107.     completely remove them if you wish)  The files are...
  108.  
  109.     NEWUSER.ANS - ANSI  screen displayed the first time a user enters the door
  110.     NEWUSER.ASC - ASCII screen displayed the first time a user enters the door
  111.     WELCOME.ANS - ANSI  screen displayed everytime the door is run
  112.     WELCOME.ASC - ASCII screen displayed everytime the door is run
  113.  
  114.  
  115. ╓───────────────────────────────────────────────────────────────────────────╖
  116. ║ SD.EXE - The program                                                      ║
  117. ╙───────────────────────────────────────────────────────────────────────────╜
  118.  
  119.     SportsDirect can be run from anywhere on your system.  It will change
  120.     to the required directory automatically, so no need to change paths
  121.     before running it.
  122.  
  123.     You should run it with the full path and file name of the DOOR.SYS
  124.     drop file on the command line to run it remotely.  Locally it can
  125.     be tested and run by typing "SD" without any parameters.
  126.  
  127.     For example:
  128.  
  129.     SD c:\bbs\door.sys               - get information from DOOR.SYS
  130.     SD                               - run in local mode
  131.  
  132.     This by defaults runs with a Fossil driver, however if you wish
  133.     to use the internal communications routines, simply add a /I
  134.     parameter on the end of the command line, or /I:PORT,IRQ for
  135.     non-standard ports (Where PORT is the hex value of the port address
  136.     and IRQ is the decimal interrupt of the active port)
  137.  
  138.     Three examples would be:
  139.  
  140.     SD c:\bbs\door.sys /I             - For a standard com port
  141.     SD c:\bbs\door.sys /I:3E8,5       - For a port at 3E8, Irq 5
  142.     SD c:\bbs\door.sys /I:3E8,5,19200 - Same as above, but open at 19200
  143.  
  144.     Please note that the XMS/EMS/DISK swapping is disabled if you
  145.     are using the internal communications routines.  For some reason
  146.     the modem routines don't like the swapping routines.  If you do
  147.     not have enough memory left after shelling, look for a program
  148.     called SHROOM.ZIP that does a memory swap by itself, those
  149.     routines seem to work fine with SportsDirect.
  150.  
  151.     Now, SportsDirect can also use the DORINFOx.DEF style drop files,
  152.     however it is suggested that you use the DOOR.SYS if possible, as
  153.     it passes the node number in it, and allows for better multinode
  154.     operation, and file saftey.
  155.  
  156.     SD also has the external maintenance built into it.  Typing "SD ?"
  157.     or "SD HELP" will bring up a quick reference screen.
  158.  
  159.     REPACK   Repack the sports article databases
  160.              - this removes articles marked as deleted from the databases
  161.  
  162.     UPDATE   Update the sports databases without loading the door
  163.              - this performs the extracting of the SPORT packets, and
  164.                inserting of the DAT files into the databases
  165.  
  166.     SCAN     Scan article tables, and remove entries that are missing data
  167.              - this will remove entries that are not available due to
  168.                not having the article online
  169.  
  170.     CLEAN    Search tables and delete inactive articles
  171.              - this will delete articles from the database that are not
  172.                referenced by any of the indexes (ie abandoned or unlinked
  173.                articles)
  174.  
  175.     EXTRACT  Extract the databases back to the original *.DAT files
  176.              - this is good for testing, or if you wish to deinstall
  177.                SportsDirect
  178.  
  179.  
  180. ╓───────────────────────────────────────────────────────────────────────────╖
  181. ║ License and Disclaimer                                                    ║
  182. ╙───────────────────────────────────────────────────────────────────────────╜
  183.  
  184.     "SportsDirect" (also known as "SD") is NOT free. It is being marketed
  185.     under the "try before you buy" or shareware concept. You are entitled
  186.     to use SD for  a period up to  forty-five (45) days,  after which you
  187.     MUST register or stop using the program.
  188.  
  189.     Registration entitles you to use SportsDirect as well as any future
  190.     versions of this program that may or may not be released, subject to
  191.     any additional licensing conditions which may be attached.
  192.  
  193.     Registration  will also  allow  you  to create your  own  customized
  194.     colors, remove the unregistered notice as well as any other features
  195.     that may be included for public release.  It will also help to cont-
  196.     inue to develop this program. (not to mention, maintain the legality
  197.     of this agreement)
  198.  
  199.     By running any of the  executable programs included,  you agree that
  200.     Pete Rocca,  Multiboard Communications Centre  nor any affiliates of
  201.     the above mentioned are responsible for any damage ever experienced,
  202.     however so created. If you cannot agree to this, then your privilege
  203.     to use any of these programs  is revoked  and it becomes illegal for
  204.     you to execute any programs included with this documentation.
  205.  
  206.     You may freely  copy and  distribute the shareware  version of SD as
  207.     long as its original archived contents  are not modified in any way.
  208.     You may NOT  distribute any  registration keys  without the  express
  209.     written  consent of Pete Rocca  of Multiboard Communications Centre.
  210.     You may  not use a registration key that  is not  licensed to you by
  211.     Pete Rocca, or any of the registration sites appointed by Pete Rocca
  212.  
  213.     It is illegal to edit, alter, hack, reverse engineer and / or modify
  214.     any components of the SD archive in any manner.
  215.  
  216.     If dispute of any issues on legal grounds said above, then governing
  217.     law of Ontario, Canada will rule.
  218.  
  219.  
  220. ╓───────────────────────────────────────────────────────────────────────────╖
  221. ║ Support                                                                   ║
  222. ╙───────────────────────────────────────────────────────────────────────────╜
  223.  
  224.    If you have any questions or comments, you  can netmail me at FidoNet
  225.    address 1:2401/305 (CM,VFC,V32,V42), please poll back for replies, or
  226.    request that your reply be routed back.  Also, you can email us for a
  227.    quicker response at "support@mbcc.com" 
  228.  
  229.    You can also find us on the net:
  230.  
  231.    www:  www.uti.com/mcc
  232.    ftp:  ra.uti.com/sys/bbs/bbs/mcc
  233.    ftp:  ra.fileshop.com/pub/ra/mcc
  234.  
  235.  
  236. ╓───────────────────────────────────────────────────────────────────────────╖
  237. ║ Error Messages                                                            ║
  238. ╙───────────────────────────────────────────────────────────────────────────╜
  239.  
  240.     Below is a table that references the possible  error messages values
  241.     that you may see.
  242.  
  243.        ═════╤════════════════════════════════════════════════════════
  244.        Code │ Section = Swapping routines
  245.        ═════╪════════════════════════════════════════════════════════
  246.         0-x │ Every program has its own return codes.  Consult its
  247.             │ documentation regarding the (x) return code.
  248.  
  249.        ═════╤════════════════════════════════════════════════════════
  250.        Code │ Section = Swapping routines
  251.        ═════╪════════════════════════════════════════════════════════
  252.         1-1 │ No space for swapping
  253.         1-2 │ Program is too low in memory
  254.         4-0 │ Error allocating environment
  255.         5-0 │ Error calling swap
  256.         5-1 │ Could not return from swap
  257.         5-2 │ Could not swap out
  258.         6-x │ Error caused during redirection
  259.  
  260.        ═════╤════════════════════════════════════════════════════════
  261.        Code │ Section = Program being called
  262.        ═════╪════════════════════════════════════════════════════════
  263.         2-0 │ Not found (try specifying the full path to the program)
  264.         2-1 │ Invalid drive
  265.         2-2 │ Invalid path
  266.         2-3 │ Invalid name
  267.         2-4 │ Invalid drive letter
  268.         2-5 │ Path too long
  269.         2-6 │ Drive not ready
  270.  
  271.        ═════╤════════════════════════════════════════════════════════
  272.        Code │ Section = Dos error codes
  273.        ═════╪════════════════════════════════════════════════════════
  274.         3-2 │ File not found
  275.         3-3 │ Path not found
  276.         3-5 │ Access denied
  277.         3-6 │ Invalid handle
  278.         3-8 │ Not enough memory
  279.  
  280.  
  281. ╓───────────────────────────────────────────────────────────────────────────╖
  282. ║ Common questions and answers                                              ║
  283. ╙───────────────────────────────────────────────────────────────────────────╜
  284.  
  285.    Q) How do you setup DSZ to work on non standard com ports?  It keeps
  286.       locking or getting CRC errors during the transfer?!
  287.    A) You need to run SportsDirect in a batch file, and set the DSZPORT
  288.       enviroment variable before running SD.EXE
  289.  
  290.       ex/
  291.            set DSZPORT=3e8,5
  292.            SD.EXE c:\bbs\door.sys /I:3e8,5
  293.  
  294.       Also remember to remove the 'port *P' setting from your transfer
  295.       command lines...
  296.  
  297.    Q) ARJ is a memory hog, it seems that I don't have enough memory
  298.       to run it when using the internal com routines..
  299.    A) If you cannot use a fossil driver, then you will have to make
  300.       the ARJ command line a batch file, that calls an external memory
  301.       swapper, then the proper ARJ command line. (like SHROOM.ZIP)
  302.  
  303.  
  304. ╓───────────────────────────────────────────────────────────────────────────╖
  305. ║ Acknowledgments                                                           ║
  306. ╙───────────────────────────────────────────────────────────────────────────╜
  307.  
  308.     This program has been tested on  MS-DOS 3.3 through 6.22,  DESQview
  309.     2.40 through 2.63, DESQview/X 1.2 and 2.0, Windows 3.1 to 4.0 beta,
  310.     WindowsNT 3.x, OS/2 2.0 through OS/2 2.99 beta, and Novell DOS 7.0.
  311.     Other  operating  environments should work fine,  but they have not
  312.     been fully tested.  Requires at least DOS 3.3 and SHARE.EXE loaded.
  313.  
  314.     PKZIP/PKUNZIP, Copyright PKWARE; ARJ, Copyright Robert K Jung; LZH/
  315.     LHA, Copyright Haruyasu Yoshizaki;  X00, Copyright Ray Gwinn;  BNU,
  316.     Copyright David Nugent & Unique Computing; DESQview, Copyrighted by
  317.     Quarterdeck Software;  MS-DOS, MS-Windows, Copyrighted by Microsoft
  318.     Corporation; OS/2, Copyright International Business Machines Corp.,
  319.     Thanks to the  public domain swapping  utilities that required very
  320.     little in the way of tweaking, by Thomas Wagner.   DSZ Copyright by
  321.     Omen Technology INC.  SportsDirect and SD copyrighted by Multiboard
  322.     Communications Centre and Pete Rocca.
  323.  
  324.     Thanks to you,  the user,  for actually reading to the  end  of the
  325.     documentation, and remember, please register, it's cheap!
  326.  
  327.     Pete Rocca
  328.     Multiboard Communications Centre
  329.