home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / BACKHS12.ZIP / BACKHOUS.DOC next >
Text File  |  1995-05-11  |  21KB  |  581 lines
  1. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  2. :                            Back-House Solitaire                              :
  3. :                                Version 1.2                                   :
  4. :                      (C)opyright 1994-95 BG Creations.                       :
  5. :                           Written By :  Jimi Gue                             :
  6. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  7. ----------
  8. Warranty :
  9. ----------
  10.  
  11.      I Jimi Gue, do not guarantee or warranty this product. The program
  12.   is presented "as is" without guarantee of results/performance, or
  13.   warranty of any kind. As the author, I cannot assume responsibility
  14.   for any outcome resulting from the use or misuse of this product. Total
  15.   responsibility is assumed by you. Therefore, I Jimi Gue, am not held
  16.   accountable for any incidental occurences, damages or otherwise caused
  17.   by the use or misuse of this program.
  18.  
  19. ---------------------
  20. Licensing Agreement :
  21. ---------------------
  22.  
  23.      By using this software you agree to the following terms:
  24.  
  25.      THIS IS COPYRIGHTED SOFTWARE!! Violating the following terms is strictly 
  26.   prohibited by FEDERAL LAW. By doing such, YOU are subject to any penalties 
  27.   and/or legal action that applies.
  28.  
  29.      This DEMO version of Back-House Solitaire is distributed under the
  30.   Shareware concept. There is a 30 day time period for evaluation of the 
  31.   door. When the 30 days are up, the game will not allow play and return 
  32.   the user to the BBS.  If you wish to further use this product, you are 
  33.   required to register.  Resetting or re-installing the game is a violation 
  34.   of the Shareware concept and of this license.
  35.  
  36.      This DEMO version of Back-House Solitaire may be distributed freely,
  37.   providing that the contents of the ZIP file are not altered, and the ZIP 
  38.   file is not renamed.
  39.  
  40.      When the game is registered, you will receive a licensed file,
  41.   BACKHOUS.REG, giving you the right to use the game on YOUR BBS System.
  42.   You may use the door on a single BBS only.  You may also use the door 
  43.   on a Multi-Node BBS or Network (requires Multi-Node version). Along with 
  44.   the REG file, you are required to accept certain responsibilities to 
  45.   protect and assure the safety of the program from unauthorized uses and/or 
  46.   reproduction. Only YOU may use the .REG File. 
  47.  
  48.      After registration, you do not own Back-House Solitaire.  You are only
  49.   licensed to use it appropriately.  BG Creations retains ALL rights to 
  50.   Back-House Solitaire and all associated files and materials.
  51.  
  52.      YOU ARE NOT PERMITTED TO:
  53.        Convert this software to another language.
  54.        Decompile, Disassemble, Rewrite, Lease, Re-sell,
  55.        Grant License or Sublicense this software.
  56.        
  57.      Failure to comply to the licensing agreement violates all rights to
  58.   further use this product (DEMO or REGISTERED).  Therefore your license to 
  59.   operate Back-House Solitaire will be revoked without refund and you face the 
  60.   possibilty of legal action. 
  61. ------------------------------------PAGE 1-------------------------------------
  62.  
  63.  
  64.      
  65. -----------------
  66. BBS's Supported :
  67. ----------------- 
  68.  
  69.     Spitfire         GAP BBS        PCBoard       WILDCAT!
  70.     Quick BBS        TRIBBS         RBBS          WWIV
  71.     Remote Access    Renegade       Telegard      VBBS
  72.     Synchronet       Ultra BBS      PowerBBS      PowerBoard
  73.     TAG BBS          
  74.  
  75. -----------------
  76. How To Register :
  77. -----------------
  78.  
  79.      1. Print the REGISTER.FRM file, answer the questions provided and
  80.         enclose the appropriate amount for your order.  Mail the printed
  81.         document and payment to the address found in the REGISTER.FRM file.         
  82.  
  83.      2. Call BG Creations BBS and select the Questionnaire option from
  84.         the Main Menu.  Answer the questions, check the correct method
  85.         of payment and delivery.  If you select Visa or MasterCard for
  86.         payment, then you may Download your order if you wish. I will 
  87.         try to have your order ready within a reasonable time period,
  88.         probably 24hrs.
  89.  
  90.      3. Call me voice at (304) 525-1136, and place your order.  The best
  91.         time to call is between 10am - 11pm EST.  If you don't get an answer, 
  92.         try method #2.
  93.  
  94. -----------------
  95. Payment Options :
  96. -----------------
  97.  
  98.      BG Creations will accept the following methods of payment in U.S. funds
  99.    only.
  100.  
  101.      1. Visa or Mastercard.   ** My account is being setup now. So I will
  102.                                  be taking Visa/MC Orders in 4 weeks tops.
  103.      2. Cashier's check.         
  104.                                  
  105.      3. Money order.  
  106.           
  107.      4. Personal check.
  108.  
  109.      5. COD (subject to additional charge)
  110.  
  111. ------------------
  112. Delivery Options :
  113. ------------------
  114.  
  115.      All orders will be shipped U.S. Mail unless otherwise specified.  Below
  116.    are the other methods of shipment.
  117.  
  118.      1. Download 
  119.  
  120.      2. UPS (subject to additional charge)
  121.  
  122.      All orders will be sent out promptly.  All of my latest doors will be
  123.    included with your order, in DEMO form. For more ordering information, see 
  124.    the REGISTER.FRM file.
  125.  
  126.  
  127. ------------------------------------PAGE 2-------------------------------------
  128.  
  129. ----------
  130. Features :
  131. ----------
  132.  
  133.    --> New routines that give the SYSOP (and myself) immense 
  134.        control over the door.
  135.  
  136.    --> Supports Comports 1 - 4 and Nonstandard IRQ'S (0-15)
  137.  
  138.    --> Locked DTE Rate Up To 115,200
  139.  
  140.    --> Requires no monitoring
  141.  
  142. ** --> Multinode Versions Available
  143.  
  144.    --> Desqview and Multi-tasking awareness
  145.  
  146.    --> Optional EMS usage with /E parameter.
  147.  
  148.    --> Auto Detecting ANSI Capabilities, No Need For ANSI.SYS
  149.  
  150.    --> Color/Monochrome Toggle
  151.  
  152. ** --> ANSI/ASCII Bulletin Generator  
  153.  
  154. ** --> Calendar For Missed Days
  155.  
  156.    --> Setup Program 
  157.  
  158.    --> Chat Mode 
  159.  
  160.    --> Dropped Carrier Detection
  161.  
  162.    --> 3 Minute Timeout Period
  163.  
  164.    --> Time Manipulation With Function Keys
  165.  
  166.    --> Force User To BBS With Function Keys
  167.  
  168.    --> Free Upgrades To Later Versions
  169.  
  170.    --> Full BBS/Voice Support
  171.  
  172.   ** Only Available With Registered Version
  173.  
  174.  
  175. ------------------------
  176. Files And Descriptions :
  177. ------------------------
  178.  
  179.    BACKHOUS.BAT    <-- Sample batch file
  180.  
  181.    BACKHOUS.EXE    <-- Executable File
  182.  
  183.    BACKHOUS.CFG    <-- Configuration File Written By SETUP.EXE
  184.  
  185.    BACKHOUS.DAT    <-- Contains User Information
  186.  
  187.    BACKHOUS.LOG    <-- Used By the Door, Date and Time It Was Last Used
  188.   
  189.    BACKHOUS.CMP    <-- Monthly And Record Champions Are Stored Here
  190.  
  191. ------------------------------------PAGE 3-------------------------------------
  192.  
  193. ----------------------------
  194. Files And Descriptions Cont:
  195. ----------------------------
  196.  
  197.    BACKHOUS.DOC    <-- This File
  198.  
  199.    BACKHOUS.HLP    <-- Instructions For Back-House Solitaire Used By The Door
  200.  
  201.    SETUP.EXE       <-- Configuration Program
  202.  
  203.    REGISTER.FRM    <-- Registration Form For Doors By BG Creations
  204.  
  205.    UPDATE.TXT      <-- When found, contains changes and/or bug notes
  206.  
  207.    HISTORY.TXT     <-- List Of Changes From Version To Version
  208.  
  209. --------------
  210. Installation :
  211. --------------  
  212.  
  213.    ------------- 
  214.    BACKHOUS.CFG :
  215.    -------------
  216.  
  217.      This is the configuration file the is needed to run Back-House Solitaire.
  218.    The contents of the file are as follows:
  219.  
  220.       5                          <-- # OF HANDS ALLOWED DAILY
  221.       5                          <-- # OF MAKE UP DAYS ALLOWED DAILY
  222.       C:\BBS\BULL1G.             <-- PATH & FILENAME TO ANSI BULLETIN
  223.       C:\BBS\BULL1.              <-- PATH & FILENAME TO ASCII BULLETIN
  224.       SYSOPFIRST Jimi            <-- SYSOP'S FIRST NAME
  225.       SYSOPLAST Gue              <-- SYSOP'S LAST NAME
  226.       BG Creations BBS           <-- BBS NAME
  227.       MONO                       <-- IF LOCAL VIDEO IS MONOCHROME
  228.       BBSTYPE RBBS               <-- TYPE OF BBS
  229.       COMPORT 1                  <-- IF YOUR DROP FILE DOES NOT SPECIFY A PORT
  230.       FOSSIL or XFOSSIL          <-- IF YOU ARE USING A FOSSIL DRIVER
  231.       LOCKBAUD 19200             <-- LOCKED BAUD RATE
  232.       PORT2 02E8 3               <-- COMPORT AND IRQ #
  233.       MAXTIME 45                 <-- MAXIMUM TIME ALLOWED FOR THE DOOR
  234.       STATUS ON                  <-- STATUS LINE OPTION ON/OFF
  235.       STATFORE 15                <-- STATUS LINE FOREGROUND COLOR
  236.       STATBACK 4                 <-- STATUS LINE BACKGROUND COLOR
  237.  
  238.    -----------
  239.    SETUP.EXE :
  240.    -----------
  241.  
  242.       To assure proper operation of Back-House Solitaire, you should run
  243.    the configuration program, SETUP.EXE. Listed below is a run-through of
  244.    the program. 
  245.  
  246.      --------------------------
  247.      Field #1 - Hands Per Day :
  248.      --------------------------
  249.  
  250.        Determines the number of hands allowed daily. This field may be a
  251.      number between 1 and 5.
  252.       
  253.  
  254. ------------------------------------PAGE 4-------------------------------------
  255.  
  256.   ----------------
  257.   SETUP.EXE Cont :
  258.   ----------------
  259.      ------------------------------
  260.      Field #2 - Make Up Days :
  261.      ------------------------------
  262.  
  263.        REGISTERED VERSION ONLY.
  264.  
  265.        If you have a registered version of BHS v1.2, then player's who miss
  266.      days, will be able to make them up. This field is for the number of make
  267.      up days you wish to allow daily. May be a number from 0 - 5.
  268.  
  269.      ---------------------------------------------
  270.      Field #3 - Path & Filename To ANSI Bulletin :
  271.      ---------------------------------------------
  272.  
  273.        REGISTERED VERSION ONLY.
  274.  
  275.        The door will create both ANSI and ASCII bulletins containing the top
  276.      ten scores. If you have a registered version of Back-House Solitaire, enter 
  277.      the full path and filename for the ANSI bulletin.
  278.  
  279.      ---------------------------------
  280.      Field #4 Path To ASCII Bulletin :
  281.      ---------------------------------
  282.  
  283.        REGISTERED VERSION ONLY.
  284.  
  285.        If you have a registered version of Back-House Solitaire, enter the full
  286.      path and filename for the ASCII bulletin.
  287.  
  288.      -------------------------------
  289.      Field #5 - Sysop's First Name :
  290.      -------------------------------
  291.      -------------------------------
  292.      Field #6 - Sysop's Last Name  :
  293.      -------------------------------
  294.      ---------------------
  295.      Field #7 - BBS Name :
  296.      ---------------------
  297.      ----------------------------
  298.      Field #8  Local Monochrome :
  299.      ----------------------------
  300.  
  301.         Specify MONO here if you have a monochrome monitor, and want the
  302.      door to operate in MONO mode. 
  303.  
  304.      -----------------------
  305.      Field #9  Type Of BBS :
  306.      -----------------------
  307.  
  308.         DS v1.2 supports the following BBS Types:
  309.  
  310.         CALLINFO (Wildcat 1.x, 2.x), DOORSYS, PCB12, PCB14, PCB15,
  311.         PHOENIX, QUICK, RBBS, SPITIFIRE, WWIV.
  312.  
  313.         The Majority of BBS support the Universal drop file, DOOR.SYS.
  314.  
  315.      ----------------------------
  316.      Field #10  Specify Comport :
  317.      ----------------------------
  318.  
  319.         If your BBS does not write the Comport to the Dropfile (PCB12).
  320.       then you need to specify it here. Ex: 1.
  321.  
  322. ------------------------------------PAGE 5--------------------------------------
  323.  
  324.  
  325.     ----------------
  326.     SETUP.EXE Cont :
  327.     ----------------
  328.  
  329.       ---------------------------
  330.       Field #11  Fossil Support : 
  331.       ---------------------------
  332.  
  333.          If you are using a standard FOSSIL Driver, specify FOSSIL on this
  334.        line. If you are using and extended FOSSIL (BNU or X00) then specify
  335.        XFOSSIL.
  336.  
  337.       ----------------------------
  338.       Field #12 Locked Baud Rate :  
  339.       ----------------------------
  340.   
  341.         If you have your serial port locked, specify the rate here. 
  342.  
  343.        Ex: LOCKBAUD 19200.
  344.  
  345.       -----------------------------
  346.       Field #13 Nonstandard IRQ's :
  347.       -----------------------------
  348.  
  349.         When using a nonstandard interrupt, enter the port address and IRQ #.
  350.  
  351.        Ex: PORT2 02F8 11.
  352.  
  353.  
  354.       -------------------
  355.       Field #14 MaxTime :
  356.       -------------------
  357.       -------------------------
  358.       Field #15 Status ON/OFF :
  359.       -------------------------
  360.       ----------------------------------
  361.       Field #16 Status Line Foreground :
  362.       ----------------------------------
  363.       ----------------------------------
  364.       Field #17 Status Line Background :
  365.       ----------------------------------
  366.  
  367. -------------------------
  368. Command Line Parameters :
  369. -------------------------
  370.  
  371.      This door has many auto-detecting features, but there are a few 
  372.    parameters that can be specified on the command line.  They are :
  373.  
  374.    /B:xxxx : Rate to lock the BPS at. You may also specify this in the
  375.              .CFG file. Ex: /B:19200
  376.  
  377.    /C:     : Comport Number. Ex: /C:1
  378.   
  379.    /E      : Use EMS if available. This will speed the execution of the
  380.              game slightly by using EMS for the overlay.
  381.  
  382.    /L      : Local mode, for running from Dos, never include this parameter
  383.              while running from your Bulletin Board System.  When specified,
  384.              you will be prompted to enter your name.
  385.  
  386.              Ex: Backhous Backhous.Cfg /L
  387.  
  388.  
  389. ------------------------------------PAGE 6-------------------------------------
  390.  
  391.  
  392. ------------------------------
  393. Command Line Parameters Cont :
  394. ------------------------------
  395.  
  396.    /N:     : Node number. Can be a value from 1 to 9.
  397.  
  398.    /P:     : Path to drop file. This is important if you are running a
  399.              Multi-node version of the game, since your drop files may
  400.              be in different directories. 
  401.  
  402.              Ex: /P:C:\RA\NODE1\
  403.  
  404.    /R     : Forces Local RIP. Since BHS 1.2 Doesn't utilize RIPScript, this
  405.             is for future expansion.
  406.  
  407.    /V     : No Local display. This will disable display on the local end
  408.             & and save a small amount of memory.
  409.  
  410.    /W     : Network is present. BHS 1.2 automatically detects Multi-tasking
  411.             programs such as Desqview & Windows, but if you use a Network,
  412.             specify this option to let the program know that file-sharing
  413.             and record-locking should be enabled.
  414.  
  415. ----------------------
  416. Running Multi-Node   :
  417. ----------------------
  418.  
  419.      To run Back-House Solitaire on a Network requires a Registered Multi-Node
  420.    version of the game.  This will enable the record locking capabilities.
  421.    Without a Multi-node REG file, the game will allow only one user in the
  422.    door at a time. If you are using a Non-standard IRQ or you are locking
  423.    the BPS on one node and not on another, you will have to specify a 
  424.    different .CFG file for each node when running Multi-Node. 
  425.          
  426.      If you have a BBS with 2 Nodes, the .CFG files for the door may look
  427.    like this :
  428.  
  429.  
  430.    NODE #1 - BACKHOUS.CF1        NODE #2 - BACKHOUS.CF2
  431.  
  432.    3                            3
  433.    5                            5
  434.    C:\RA\TXTFILES\BULL1A.       C:\RA\TXTFILES\BULL1A.
  435.    C:\RA\TXTFILES\BULL1.        C:\RA\TXTFILES\BULL1.
  436.    SYSOPFIRST Jimi              SYSOPFIRST Jimi
  437.    SYSOPLAST Gue                SYSOPLAST Gue
  438.    BG Creations BBS             BG Creations BBS
  439.    BBSTYPE RBBS                 BBSTYPE RBBS
  440.    XFOSSIL                      PORT1 03E8 11
  441.    LOCKBAUD 19200               MAXTIME 30
  442.    PORT2 02E8 10                STATUS ON
  443.    MAXTIME 30                   STATFORE 14
  444.    STATUS OFF                   STATBACK 1
  445.  
  446.      As you can see, you have alot of control over the node setup of the door.
  447.    If you aren't using Nonstandard IRQ's or a FOSSIL, then you only NEED one
  448.    .CFG file for the door the run. You WILL however need to specify the /P:
  449.    parameter to tell the door where the DROP-FILES are located.
  450.  
  451.      One other specification to running Multi-node is that SHARE needs to be
  452.    in memory before execution so file-sharing can be performed.  Since Multi-
  453.    User Bulletin Board Systems require share to be loaded anyway, this should 
  454.    be nothing new.
  455.  
  456.  
  457. ------------------------------------PAGE 6--------------------------------------
  458.  
  459.  
  460. --------------------------
  461. Running Multi-Node Cont. :
  462. --------------------------
  463.  
  464.  
  465.      If your BBS executes doors from the start-up batch file, then you may not
  466.    need to use different .CFG files. If you are not locking your baud rate on 
  467.    any node or the locked rate is the same, then you merely need to copy the 
  468.    drop file to the door directory before execution of the door. Of course
  469.    you run the risk of two nodes executing the door at EXACTLY the same time, 
  470.    but the chances are very slim.
  471.     
  472.    The Door Specs of a Spitfire BBS Batch file may look something like this.
  473.  
  474.    :DOOR_A
  475.     CD\BBS\BACKHOUS
  476.     BACKHOUS BACKHOUS.CFG /P:C:\BBS\NODE1
  477.     CD\BBS
  478.     GOTO LOOP
  479.  
  480.      I use RemoteAccess for my Bulletin Board System, and this is how I setup
  481.    the board for Multi-user play.  Different BBS's may not operate the way that
  482.    RA does, consult your BBS manual if you are not sure about how your BBS 
  483.    executes Doors.
  484.  
  485.      When RA is setup for Multi-Node, it uses separate NODE Directories, let's
  486.    say NODE1 and NODE2 are the directory names.  When a door is executed, RA
  487.    writes the drop file to proper directory and does whatever command you have 
  488.    specified in the Configuration Program.  For instance, in both NODE Dir's
  489.    I have a batch file, BACKHOUS.BAT, that the BBS executes. The batch files
  490.    looks like this:
  491.  
  492.     C:\RA\NODE1\BACKHOUS.BAT               C:\RA\NODE2\BACKHOUS.BAT
  493.     ----------------------                -----------------------
  494.      
  495.     ECHO OFF                              ECHO OFF
  496.     CD\RA\BACKHOUS                        CD\RA\BACKHOUS
  497.     BACKHOUS BACKHOUS.CFG /P:C:\RA\NODE1  BACKHOUS BACKHOUS.CF1 /P:C:\RA\NODE2
  498.     CD\RA\NODE1                           CD\RA\NODE2
  499.  
  500. -------------------
  501. Notes Of Interest :
  502. -------------------
  503.  
  504.      The only particular problem with this door is the Stripping of the
  505.    Club character.  If the user's telecommunications program has the 
  506.    Compuserve B file transfer option on, it will strip ASCII Code 3, which is 
  507.    the Club.  If any users are having problems in this area, please notify 
  508.    them to toggle Compuserve B file transfers.
  509.  
  510. ------------
  511. Support    :
  512. ------------
  513.  
  514.      It is my policy to give any help possible when experiencing difficulties
  515.    while using my doors.  Such as: Setup, Execution, or any Bugs (hopefully 
  516.    there are no Bugs!).  If you are having problems in any of these or other
  517.    areas, I will do my best to assist you in any way as quickly as possible.
  518.    I can be contacted in the following ways:
  519.  
  520.  
  521. ------------------------------------PAGE 7-------------------------------------
  522.  
  523.  
  524.                       ----------------------------------    
  525.  
  526.                                ----------------
  527.                                BG Creations BBS
  528.                                ----------------
  529.  
  530.                          (304)525-3233 24hrs - 14,400
  531.                               
  532.                                 FIDO 1:262/40
  533.                             Voice - (304)525-1136
  534.  
  535.                                 or by mail...
  536.  
  537.  
  538.                                  BG Creations
  539.                              3928 Riverside Drive
  540.                              Huntington, WV 25705
  541.                                
  542.                       ----------------------------------         
  543.  
  544.  
  545.  
  546. --------------
  547. Distributing :
  548. --------------
  549.  
  550.      I will encourage the distribution of any of my doors in DEMO form only.
  551.    This means the distributing of Registered REG files is STRICTLY PROHIBITED
  552.    by law.  The REG Files are not to be distributed, copied, altered etc. in 
  553.    ANY FORM.
  554.  
  555.  
  556. ------------------
  557. Acknowledgements :
  558. ------------------
  559.  
  560.      First and foremost I would like to GOD for giving me the knowledge of
  561.    programming and perserverence. 
  562.  
  563.      I thank Rusty Johnson for his immense help and patience.  Rusty has saved 
  564.    me much time and helped me to avoid many problems with the contribution of 
  565.    his knowledge. Thanks again Rusty.
  566.  
  567.      Thanks to Louis Arseneau of N.T.P.A. BBS for finding the BUG in the
  568.    Non-standard IRQ usage, notifying me of it and helping me test the new
  569.    version.
  570.  
  571.  
  572.                 DDPLUS         - For reference and code segments
  573.                 REMOTE ACCESS  - Wantree Development & Andrew Milner
  574.                 GAP            - GAP Development Company
  575.                 WILDCAT        - Mustang Software
  576.                 PCBOARD        - Clark Development
  577.                 SPITFIRE       - Buffalo Creek Software
  578.                 QUICKBBS       - The QuickBBS Group
  579.  
  580.  
  581. ------------------------------------PAGE 8-------------------------------------