home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO030C.ZIP / CBRIDG11.ZIP / CBRIDG.DOC next >
Text File  |  1991-07-25  |  60KB  |  2,378 lines
  1. CBRIDGE: IBM PC Conference Bridge
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.              ---------------------------------
  24.              CBRIDGE: IBM PC Conference Bridge
  25.              ---------------------------------
  26.              Communications Accessory
  27.              ---------------------------------
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.     CBRIDGE is distributed freely and may be copied by anyone for any
  36.     number of machines.  The author offers CBRIDGE as "shareware".  If
  37.     the program is found to be useful or entertaining, a registration
  38.     of $59.00 is requested.  If response warrants, CBRIDGE will be
  39.     enhanced and extended.    The author may be reached at:
  40.  
  41.  
  42.                  CABER Software
  43.                  R. (Scott) McGinnis
  44.                  P.O. Box 3607 Mdse Mart
  45.                  Chicago, IL 60654-0607
  46.  
  47.                  PLINK, GEnie id: TARTAN
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 1.1: 880705
  61.  
  62. CBRIDGE: IBM PC Conference Bridge
  63.  
  64.  
  65.  
  66.     CBRIDGE version 1.1 is copyright 1988 CABER Software (R.  Scott
  67.     McGinnis).  All rights are reserved world wide, excepting redistri-
  68.     bution under the ShareWare concept.  CBRIDGE is distributed freely
  69.     and may be copied by anyone for any number of machines, under the
  70.     ShareWare concept.
  71.  
  72.  
  73.     CBRIDGE is distributed as ShareWare.  You may use CBRIDGE without
  74.     charge for the purposes of evaluating it's usefulness to your
  75.     purposes.  It is suggested that this evaluation period be limited to
  76.     a few days of actual use.  If you find CBRIDGE to be worth continued
  77.     use, then you are asked to pay for it.    The payment is called a
  78.     "registration fee".  Complete the included registration form and
  79.     mail it with your payment.
  80.  
  81.  
  82.     Registration of CBRIDGE includes the communications program COM-AND,
  83.     all published accessory programs (which currently are PC-VCO,
  84.     CCHESS, and CCOLOR), and several utilities (unPACKIT and unSTUFIT).
  85.     COM-AND, accessories and utilities are published separately.  One
  86.     registration covers any and all of these programs.
  87.  
  88.  
  89.     By registering your copy of CBRIDGE (or any ShareWare product), you
  90.     are promoting and supporting the convenient distribution method and
  91.     free evaluation policy that brought you this copy of CBRIDGE.
  92.  
  93.  
  94.     If you have received this copy from a Users' Group, "Software
  95.     Library" or "SIG", and have paid a small fee (usually $3 to $10),
  96.     you have NOT acquired a registration or continued right to use
  97.     CBRIDGE.  This fee was for the convenience of obtaining the diskette
  98.     with CBRIDGE on it.  The fee does NOT apply to the registration fee.
  99.  
  100.  
  101.     You may NOT distribute CBRIDGE or it's documentation in connection
  102.     with ANY commercial venture, product, publication or service without
  103.     written approval.  CBRIDGE may not be disassembled or modified
  104.     without express written consent.
  105.  
  106.  
  107.     CBRIDGE is supplied "as-is" with no warranties expressed or implied.
  108.     Neither CABER software nor the author will be liable for any damages
  109.     or lost revenues incurred through the use of this program or any of
  110.     its accessories and utilities beyond the registration price paid.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120. Version 1.1; 880705
  121.  
  122. CBRIDGE: IBM PC Conference Bridge
  123.  
  124.  
  125.                  Table of Contents
  126.                  -----------------
  127.  
  128. I.    Introduction  .............................................. page 1
  129.  
  130. II.    Running the program  ....................................... page 2
  131.  
  132. III.    CBRIDGE Display  ........................................... page 5
  133.  
  134. IV.    Services supported ......................................... page 6
  135.  
  136. V.    CBRIDGE Commands using COM-AND ............................. page 10
  137.  
  138. VI.    CBRIDGE Commands Standalone ................................ page 12
  139.  
  140. VII.    CBRIDGE Main Menu .......................................... page 13
  141.  
  142. VIII.    Beginning a Game ........................................... page 15
  143.  
  144. IX.    Bidding .................................................... page 17
  145.  
  146. X.    Game in Progress ........................................... page 18
  147.  
  148. XI.    Saving and restoring a Game ................................ page 20
  149.  
  150. XII.    Ending a Game .............................................. page 21
  151.  
  152. XIII.    Program Configuration (Alt-S, and Alt-P) ................... page 22
  153.  
  154. XIV.    Program Requirements ....................................... page 26
  155.  
  156. XV.    Program and Author Information    ............................ page 27
  157.  
  158.  
  159.  
  160.                 Appendices
  161.                 ----------
  162.  
  163.  
  164. A.    Switches and Parameters .................................... page 28
  165.  
  166. B.    Files ...................................................... page 30
  167.  
  168. C.    Messages ................................................... page 31
  169.  
  170. D.    Save file format ........................................... page 34
  171.  
  172. E.    Beta Release ............................................... page 36
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181. Version 1.1: 880705
  182.  
  183. CBRIDGE: IBM PC Conference Bridge                     Page   1
  184.  
  185.  
  186. I.    Introduction
  187.  
  188.  
  189.     A. What is CBRIDGE?
  190.  
  191.  
  192.        CBRIDGE for the IBM PC is an accessory program, intended to be
  193.        used with a 'base' communications program.  CBRIDGE is integrated
  194.        into the comm program 'COM-AND'.  However, CBRIDGE may be used
  195.        with any comm program supporting a 'DOS gateway' that does not
  196.        break an established comm link (drop DTR).
  197.  
  198.  
  199.        CBRIDGE, used with network conferencing services such as People-
  200.        Link's PARTY, CompuServe's CB and GEnie's RTC conferencing,
  201.        provides a way to play bridge with other people and 'see' the
  202.        game in progress.
  203.  
  204.  
  205.     B. This program
  206.  
  207.  
  208.        CBRIDGE Version 1.1 executes on MDA or Hercules monochrome
  209.        adapters, CGA hi-res color or black and white, or EGA adapters.
  210.        A Microsoft Mouse is supported, if one is available.
  211.  
  212.  
  213.        CBRIDGE may be copied freely and distributed to anyone for any
  214.        number of machines.    The author offers CBRIDGE as "shareware".  If
  215.        the program is found to be useful or entertaining, a registration
  216.        is asked.  CBRIDGE will be extended and enhanced if response
  217.        warrants.
  218.  
  219.  
  220.     C. This document
  221.  
  222.  
  223.        This document describes the features of CBRIDGE.   It will not
  224.        attempt to describe all the features of COM-AND (which are
  225.        available within CBRIDGE if used), or any other communications
  226.        program used.  From time-to-time the assumption will be made
  227.        that COM-AND is used as the communications program, to high-
  228.        light the interaction between CBRIDGE and COM-AND.
  229.  
  230.  
  231.        Please do not take it that COM-AND is the only comm program
  232.        possible to use.  Refer to the documentation provided with your
  233.        favorite comm program for a full discussion of its function and
  234.        features.  They won't be available in PC-VCO, however.
  235.  
  236.  
  237.        Appendices here will provide details for very interested readers.
  238.  
  239.  
  240.  
  241.  
  242. Version 1.1: 880705
  243.  
  244. CBRIDGE: IBM PC Conference Bridge                     Page   2
  245.  
  246.  
  247. II.    Running the program
  248.  
  249.  
  250.     CBRIDGE is an accessory program, and may be entered in one of three
  251.     ways: (1) it may be invoked through the accessory menu of the comm
  252.     program COM-AND, (2) CBRIDGE may be loaded itself (in which case it
  253.     will need to be able to load COM-AND) and (3) it may be loaded
  254.     'piggyback' (intended for use with the DOS gateway of other
  255.     communications programs.  Each method is useful and will be
  256.     discussed separately.
  257.  
  258.  
  259.     A. Loading through COM-AND
  260.  
  261.  
  262.        COM-AND is invoked at the DOS prompt with the command:
  263.  
  264.        ------------------------------------------------------
  265.        "d>" COM-AND <options>
  266.  
  267.        Where "d>" is the DOS prompt, and
  268.          <options> is (<parm> (<parm> ...))
  269.          where <parm> is either a switch or a parameter
  270.  
  271.        Refer to Appendix A of the COM-AND document for a discussion
  272.        of switches and parameters.
  273.        ------------------------------------------------------
  274.  
  275.  
  276.        Once COM-AND has been loaded, the usual sequence would be to dial
  277.        a network service using COM-AND's dialing directory or script
  278.        language.  When connection has been established, logon achieved,
  279.        and a conference area entered, then CBRIDGE may be selected using
  280.        the F1 Accessories menu.
  281.  
  282.  
  283.        COM-AND defines an 'accessory' as:
  284.  
  285.        o       A name which is displayed in the menu (as you like)
  286.        o       A subdirectory for use during the accessory (optional)
  287.        o       A script file to be performed (optional)
  288.        o       A program to be loaded - along with parameters (optional)
  289.  
  290.        COM-AND was supplied with several accessory menu entries, one set
  291.        to load CBRIDGE, to serve as an example.  Once loaded, CBRIDGE is
  292.        an independent program, using the comm link established by
  293.        COM-AND, and also many of the COM-AND functions.  CBRIDGE is
  294.        'integrated' into COM-AND.
  295.  
  296.  
  297.        Note that settings (echo/blank line suppression/logging etc) made
  298.        in COM-AND carry over to the accessory when it is loaded, and
  299.        settings made in the accessory carry over to COM-AND when the
  300.        accessory terminates.
  301.  
  302.  
  303. Version 1.1: 880705
  304.  
  305. CBRIDGE: IBM PC Conference Bridge                     Page   3
  306.  
  307.  
  308. II.    Running the program (continued)
  309.  
  310.  
  311.     B. Loading CBRIDGE directly
  312.  
  313.  
  314.        CBRIDGE may be invoked at the DOS prompt with the command:
  315.  
  316.        ------------------------------------------------------
  317.        "d>" CBRIDGE <options>
  318.  
  319.        Where "d>" is the DOS prompt, and
  320.          <options> is (<parm> (<parm> ...))
  321.          where <parm> is either a switch or a parameter
  322.  
  323.        Refer to Appendix A of this document for a full description of
  324.        switches and parameters.
  325.        ------------------------------------------------------
  326.  
  327.  
  328.        When CBRIDGE is run from the DOS prompt without the '/P' switch,
  329.        it looks for the COM-AND program on the current subdirectory (or
  330.        in the subdirectory indicated by a 'COM-AND=' environment
  331.        variable).  CBRIDGE will not run (without the '/P' switch) unless
  332.        it can find COM-AND.  CBRIDGE loads COM-AND and execution proceeds
  333.        on the CRT (COM-AND side) of the program.
  334.  
  335.  
  336.        Again, the usual sequence would be to dial a network service
  337.        using COM-AND's dialing directory or script language.  When
  338.        connection has been established, logon achieved, and a conference
  339.        area entered, then switch to the gaming side with the F1 key.
  340.  
  341.  
  342.        Loaded this way, the F1 key simply serves as a hot key to switch
  343.        between the two sides of the program (CBRIDGE and COM-AND).    No
  344.        menu of additional accessories is available.  All other features
  345.        of COM-AND are available, however.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364. Version 1.1: 880705
  365.  
  366. CBRIDGE: IBM PC Conference Bridge                     Page   4
  367.  
  368.  
  369. II.    Running the program (continued)
  370.  
  371.  
  372.     C. Loading CBRIDGE Piggyback
  373.  
  374.  
  375.        CBRIDGE may be run piggyback as follows:
  376.  
  377.        ------------------------------------------------------
  378.        "d>" CBRIDGE /P COMx <speed> <other options>
  379.  
  380.        where COMx = COM1, COM2, COM3 or COM4 and
  381.           <speed> = 300, 1200, 2400, 4800, 9600
  382.  
  383.        Refer to Appendix A of this document for a full description
  384.        of other options.
  385.        ------------------------------------------------------
  386.  
  387.        For example:
  388.  
  389.            C> CBRIDGE /P COM1 2400
  390.  
  391.  
  392.        Used in this manner, CBRIDGE 'picks-up' a comm line already
  393.        opened and in use by another program.  The 'COMx' and '<speed>'
  394.        parameters are not strictly necessary; however, their use is
  395.        recommended unless you ALWAYS use the same comm port and line-
  396.        speed on all systems where ever you go.
  397.  
  398.  
  399.        Note that Alt-X terminates CBRIDGE and simply returns you to
  400.        DOS when CBRIDGE is loaded piggyback.  Alt-X terminates both
  401.        CBRIDGE and COM-AND when the program set is run without /P.
  402.  
  403.  
  404.        Once back at the DOS prompt, you must return to the comm program
  405.        you originally gatewayed - type 'EXIT' at the DOS prompt if your
  406.        gateway was originally to COMMAND.COM.  Refer to the documenta-
  407.        tion provided with your comm program on the appropriate means of
  408.        returning from a gateway.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425. Version 1.1: 880705
  426.  
  427. CBRIDGE: IBM PC Conference Bridge                     Page   5
  428.  
  429.  
  430. III.    CBRIDGE Display
  431.  
  432.  
  433.     When the screen is painted, it is divided into several areas.  The
  434.     top line carries the program version and release number, and the
  435.     Main Menu.  Below the Main Menu is a graphic representation of a
  436.     Bridge table.  Below is a scrolling region of lines for text.
  437.     A status line (and keyboard buffer) reside on the last line.
  438.  
  439.  
  440.     To begin a game you must have an friends waiting.  You select 'Set
  441.     players' on the Commands pulldown.  You will be queried for your
  442.     position and the IDs of the other players.  Your CBRIDGE program and
  443.     the ones you identified then talk to each other, agreeing over the
  444.     particulars.
  445.  
  446.  
  447.     In conversation, when a speaker is identified (through the ID or
  448.     handle - see following) to be a player in your game, inter-program
  449.     messages are parsed from received lines of text.  Card play and game
  450.     commands are displayed as they happen on-line.
  451.  
  452.  
  453.     CBRIDGE breaks the game of bridge into several discrete states.  The
  454.     states are: (1) no game, (2) waiting for all players to start, (3)
  455.     ready to deal cards, (4) bidding, (5) card play (game on) and (6)
  456.     the dummy hand (watching or kibitzing).  CBRIDGE starts out in the
  457.     'no game' state.  After you select 'set players' from the Commands
  458.     pulldown, CBRIDGE moves into 'waiting' state.  You'll see the game
  459.     state at the top left hand of the screen.
  460.  
  461.  
  462.     When all players have selected 'set players', CBRIDGE is 'ready to
  463.     deal'.  When one player has selected 'Deal' from the Commands
  464.     pulldown, and a hand of 13 cards has been dealt (you see your hand
  465.     on the table - each player sees their own hand), CBRIDGE moves into
  466.     the 'Bidding' state.
  467.  
  468.  
  469.     When bidding is complete, the result of the bidding is displayed at
  470.     the right side of the table (declarer and contract), and CBRIDGE
  471.     moves to 'Game on' state.  After the dummy has exposed its hand
  472.     (when this happens, all players see the dummy hand), the dummy moves
  473.     into 'dummy hand' state.
  474.  
  475.  
  476.     Each of these states will discussed in greater detail below.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486. Version 1.1: 880705
  487.  
  488. CBRIDGE: IBM PC Conference Bridge                     Page   6
  489.  
  490.  
  491. IV.    Services supported
  492.  
  493.  
  494.     CBRIDGE is encoded to work with several network services and multi-
  495.     user systems.  CBRIDGE parses every incoming line for an ID.
  496.     CBRIDGE's parser is 'automatic', in that you don't have to tell it
  497.     which system to parse.
  498.  
  499.  
  500.     The ID (or handle) parse begins after a carriage return from the
  501.     network.  When an ID of one your game's players is identified,
  502.     bridge commands are parsed, if present.  The text is displayed if no
  503.     command is parsed - of course, you can tak to people on-line during
  504.     the game in the usual manner.  If no ID (or no CBRIDGE command) is
  505.     identified the text is displayed.  Blank lines (extra carriage
  506.     returns issued by the network) are not displayed by CBRIDGE because
  507.     of the limited text area (7 lines on a CGA).
  508.  
  509.  
  510.     CBRIDGE internal commands (such as card play) exchanged amongst
  511.     the player's programs are not displayed as text of a conversation.
  512.     CBRIDGE does not know if a text line is empty or not until the
  513.     entire line is received.  CBRIDGE erases an empty text line (visible
  514.     as an ID followed by no text or followed by just a CBRIDGE command)
  515.     and reuses the line when end-of-line (carriage return) is received.
  516.  
  517.  
  518.     The CBRIDGE parser is only designed to deal with text issued within
  519.     the conversational area of one of the systems.    The parser is
  520.     self-adjusting ...  all of the supported formats will be taken as
  521.     conversation.  [The automatic nature of the parser DOES produce some
  522.     false hits now and then.  They do not interfere with CBRIDGE at all
  523.     in normal usage.]
  524.  
  525.  
  526.     The game side is not altogether appropriate for other uses, such
  527.     as reading your mail.  For other uses, switch to the CRT side (F1)
  528.     if you used COM-AND.
  529.  
  530.  
  531.     The following pages describe templates for IDs and handles as dis-
  532.     played on various systems (handles are assumed names which replace
  533.     or add to an ID).  I have also included some notes on each system
  534.     and its use with CBRIDGE.
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547. Version 1.1: 880705
  548.  
  549. CBRIDGE: IBM PC Conference Bridge                     Page   7
  550.  
  551.  
  552. IV.    Services supported (continued)
  553.  
  554.  
  555.     A. PLINK IDs and handles:
  556.  
  557.           "(" <ID> ") "          an initial "*" identifies handles
  558.  
  559.        Example:  (TARTAN) This is how a line would look on PLINK
  560.  
  561.  
  562.        PLINK does not report (to all in conference) when a customer
  563.        exits.
  564.  
  565.        CBRIDGE is best used with echo off (the system doesn't echo what
  566.        you type).  You turn echo off with the command /NOECHO.  The key-
  567.        board buffer (controls pull-down) allows you to see your typing
  568.        locally if you need.
  569.  
  570.  
  571.     B. GEnie IDs and handles:
  572.  
  573.           "<" [Handle] <ID> "> "
  574.  
  575.        Example:  <[Scott] TARTAN> This is how a line would look on GEnie
  576.  
  577.  
  578.        GEnie reports to all present the exit or termination of another
  579.        customer.  CBRIDGE version 1.1 does not use the report.
  580.  
  581.        CBRIDGE is best used with echo off (the system doesn't echo what
  582.        you type).  GEnie does not normally echo entered characters.  If
  583.        you are echoing characters locally (alt-E) turn it off.  Use the
  584.        keyboard buffer to see your typing.
  585.  
  586.  
  587.     C. SOURCE IDs and aliases:
  588.  
  589.            <ID/alias> ": "    -or-   [nn] <ID/alias> ": "
  590.  
  591.        Example:  [22] TARTAN:  This is how a line would look on SOURCE
  592.  
  593.  
  594.        The SOURCE reports to all attending the exit or termination of
  595.        another customer.  CBRIDGE version 1.1 does not use the report.
  596.  
  597.        CBRIDGE is best used with echo off (the system doesn't echo what
  598.        you type).  The SOURCE allows you to turn off echo by exiting the
  599.        SIG (entering command mode), setting half duplex (-> TERM -HALF)
  600.        and re-entering the SIG.
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608. Version 1.1: 880705
  609.  
  610. CBRIDGE: IBM PC Conference Bridge                     Page   8
  611.  
  612.  
  613. IV.    Services supported (continued)
  614.  
  615.  
  616.     D. CIS handles:
  617.  
  618.           "(" <Band> , <ID> ") "
  619.                where <Band> ::= (A!B)(N!NN)","
  620.  
  621.        Example:  (A1,TARTAN) This is how a line would look on CIS
  622.  
  623.  
  624.        CIS does not report (to all in conference) when a customer exits.
  625.  
  626.        CBRIDGE is best used with echo off (the system doesn't echo what
  627.        you type).  You turn echo off with the command /NOECHO.  The key-
  628.        board buffer (controls pull-down) allows you to see your typing
  629.        locally if you need.
  630.  
  631.  
  632.     E. Delphi IDs and handles:
  633.  
  634.           <ID> "> "     where an initial "." identifies handles
  635.  
  636.        Example:  TARTAN> This is how a line would look on Delphi
  637.  
  638.  
  639.        Delphi does not report (to all in conference) when a customer
  640.        exits.
  641.  
  642.        CBRIDGE is best used with echo off (the system doesn't echo what
  643.        you type).  I recommend requesting help from an experienced
  644.        Delphi user to do this.
  645.  
  646.  
  647.     F. TBBS IDs:
  648.  
  649.           "(" <node> ":" <ID> ") "
  650.  
  651.        Example:  (9:  Scott McGinnis) This is how tbbs looks
  652.  
  653.  
  654.        TBBS does not report (to all in conference) when a customer
  655.        exits.
  656.  
  657.        TBBS is still new to me; TBBS BBS's are multiuser (up to 16 lines
  658.        to a BBS), and provide a very comfortable conferencing facility.
  659.        I haven't discovered yet how to turn local echo off.  CBRIDGE is
  660.        best used with echo off - if there is no such facility, I am sure
  661.        one will be added, just to keep the reading easy.
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669. Version 1.1: 880705
  670.  
  671. CBRIDGE: IBM PC Conference Bridge                     Page   9
  672.  
  673.  
  674. IV.    Services supported (continued)
  675.  
  676.  
  677.     G. PROTOCALL IDs and handles:
  678.  
  679.            "<" nn.nn <ID> ">"
  680.  
  681.        Example:  <04.21 TARTAN> This is how PROTOCALL looked
  682.  
  683.  
  684.        PROTOCALL reported to all attending the exit or termination of
  685.        another customer and various materializations and dematerializ-
  686.        ations.  CBRIDGE version 1.1 does not use the report.
  687.  
  688.        CBRIDGE is best used with echo off (the system doesn't echo what
  689.        you type).  You toggle echo off with the command /ECHO.  The
  690.        keyboard buffer (controls pull-down) allows you to see your
  691.        typing locally if you need.
  692.  
  693.        I know PROTOCALL has gone.  The parser still parses for it,
  694.        however.  Who knows what'll come?
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Version 1.1: 880705
  731.  
  732. CBRIDGE: IBM PC Conference Bridge                     Page  10
  733.  
  734.  
  735. V.    CBRIDGE Commands using COM-AND
  736.  
  737.  
  738.     When CBRIDGE is loaded with COM-AND the following Alt'd keys are
  739.     available:
  740.  
  741.     F1    Switch between text (CRT) and graphic modes.  The switch
  742.         is not allowed if a game is in progress.
  743.  
  744.     F10    Help screen.  All currently implemented commands are
  745.         summarized on this screen.  Any command may be executed
  746.         directly while this screen is displayed.
  747.  
  748.     Alt-F10 DOS Gateway.  If there is sufficient memory available, and
  749.         if the environment variable "COMSPEC" identifies a valid
  750.         .COM or .EXE file, CBRIDGE will load the program and execute
  751.         it.  This normally is used to load a second copy of
  752.         COMMAND.COM for full access to DOS while a communication
  753.         session is in progress.
  754.  
  755.     Ctl-End Send a Break.  This sends a true 'break' signal.
  756.  
  757.     Alt-B    Redisplay (backscreen).  The speed of the display may be
  758.         controlled using Cntl-PgDn (slower) or Cntl-PgUp (faster).
  759.  
  760.     Alt-C    Clear the screen.
  761.  
  762.     Alt-D    Dialing directory.  The Dialing directory and file is
  763.         identical to that used by Procomm (version 2.x), to allow
  764.         files to be shared between the two programs.
  765.  
  766.     Alt-E    Toggle echo (full/half duplex).  This function is also
  767.         invoked through the dialing directory (echo on).
  768.  
  769.     Alt-F    File directory.  A mask is required - just as DOS DIR
  770.         command.
  771.  
  772.     Alt-G    Toggle blank line suppression.    CBRIDGE will suppress blank
  773.         lines on the CRT side if you wish.  This can be made a
  774.         program default through the Alt-O options menu.
  775.  
  776.     Alt-H    Hang-up.  Hang-up the phone.
  777.  
  778.     Alt-I    Program information.  Author information.  Propaganda.
  779.  
  780.     Alt-L    Toggle CGA/EGA modes (if you have an EGA).
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791. Version 1.1: 880705
  792.  
  793. CBRIDGE: IBM PC Conference Bridge                     Page  11
  794.  
  795.  
  796. V.    CBRIDGE Commands using COM-AND (continued)
  797.  
  798.  
  799.     Alt-M    Define a macro for Alt-0 through Alt-9.  The Macro defin-
  800.         ition file is identical to that used by Procomm (version
  801.         2.x), allowing Macros to be shared between the two.
  802.  
  803.         Note: Although this menu can be used from either COM-AND or
  804.         accessory, macros are defined through COM-AND and changes
  805.         will be made on the COM-AND side.
  806.  
  807.     Alt-O    Options.  Set controlling flags for COM-AND.
  808.  
  809.         Note: Although this menu can be used from either COM-AND or
  810.         accessory, it really only effects COM-AND settings.
  811.  
  812.     Alt-P    Comm Parameters.  Set baud rate, parity, number of data
  813.         and stop bits for use when COM-AND is initially loaded.
  814.         These settings are overridden by run-time switches.
  815.         Whatever the current setting, the dialing directory
  816.         overrides when it is used.
  817.  
  818.         Note: Although this menu can be used from either COM-AND or
  819.         accessory, it really only effects COM-AND settings.  Each
  820.         accessory has an Alt-P function as well accessible only when
  821.         the accessory is loaded with the '/P' switch.
  822.  
  823.     Alt-R    Redial the last number dialed.    The program will redial the
  824.         last number dialed number until the function is terminated
  825.         (with ESC), or connection is made.
  826.  
  827.     Alt-S    Setup.    Define initial program values, such as Modem initial-
  828.         ization, the Modem Hangup sequence, and file names.
  829.  
  830.         Note: Although this menu can be used from either COM-AND or
  831.         accessory, it really only effects COM-AND settings.  Each
  832.         accessory has an Alt-S function as well which may or may not
  833.         be accessible when COM-AND is loaded.
  834.  
  835.     Alt-T    Elapsed time.  The time the program was loaded, and the time
  836.         the last call (Alt-C or Alt-R) was placed are displayed.
  837.         The elapsed time since the latest time is also displayed.
  838.  
  839.     Alt-X    Exit the program.  The program may or may not hangup the
  840.         phone, depending on the modem.    Note: COM-AND is also
  841.         terminated, no matter how you loaded CBRIDGE and COM-AND.
  842.  
  843.     Alt-Z    Toggle parity mask.  The high bit mask is used only for text
  844.         received and displayed - it has no effect on XMODEM
  845.         transfers.
  846.  
  847.     Alt-0/9 Send a Macro.  A string of characters defined through the
  848.         Alt-M command described above is transmitted.
  849.  
  850.  
  851.  
  852. Version 1.1: 880705
  853.  
  854. CBRIDGE: IBM PC Conference Bridge                     Page  12
  855.  
  856.  
  857. VI.    CBRIDGE Commands Standalone
  858.  
  859.  
  860.     When CBRIDGE is loaded standalone (piggyback, /P) only the following
  861.     Alt'd keys are active:
  862.  
  863.     Alt-C    Screen Clear.  Clear the text area.
  864.  
  865.     Alt-L    Toggle CGA/EGA modes (if you have an EGA).
  866.  
  867.     Alt-S    Setup.    This menu allows setting a defaults used by CBRIDGE.
  868.         It is also available through the 'Controls' pull-down.
  869.  
  870.     Alt-P    Set Comm Parms.  This menu provides a way to change default
  871.         communications parameters used by CBRIDGE ONLY when it is run
  872.         piggyback.  It is therefore only available when CBRIDGE is
  873.         run piggyback.
  874.  
  875.     Alt-X    Exit the program.  In this case (piggyback) only CBRIDGE is
  876.         terminated.  You are returned to DOS.
  877.  
  878.  
  879.     When used in this manner, the pull-down menues are still available,
  880.     of course.  Transcripting is the only function obtained through a
  881.     pull-down that is inhibited when CBRIDGE is run piggyback.
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913. Version 1.1: 880705
  914.  
  915. CBRIDGE: IBM PC Conference Bridge                     Page  13
  916.  
  917.  
  918. VII.    CBRIDGE Main Menu
  919.  
  920.  
  921.     On the top line of the display in CBRIDGE there is a menu of key-
  922.     words.    A keyword is selected (with the cursor keys or a mouse),
  923.     and a submenu pulled-down (with the return or right mouse button).
  924.     Submenu items are selected (again, with the cursor keys or a mouse),
  925.     and executed (with the return, space bar, or left mouse button).
  926.  
  927.  
  928.     Top-line menu items are selected with the Cursor right/left keys or
  929.     right and left motion with the mouse.  When the cursor key is
  930.     depressed, the next menu item (in a circular manner) is highlighted.
  931.     The highlighted keyword is 'selected'.
  932.  
  933.  
  934.     A submenu is pulled-down with the Cursor-down key (or End, or PgDn,
  935.     or the left mouse button).  A submenu item is selected from a
  936.     pull-down when it is highlighted by pressing the Cursor-down/up keys
  937.     keys repetitively.  When the Cursor key is depressed, the next submenu
  938.     item (again in a circular manner) is highlighted.  The highlighted
  939.     keyword is 'selected'.
  940.  
  941.  
  942.     A selected submenu item is executed with a Carriage Return.  That's
  943.     the key with the silly arrow.  When a submenu item is executed, the
  944.     pull-down is released (it goes back up?).  Hitting the Space-bar or
  945.     the left mouse button will also execute the selected item.
  946.  
  947.  
  948.     A pull-down is released without executing any item with any of the
  949.     following keys:  ESC, Home, PgUp, or right mouse button.
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974. Version 1.1: 880705
  975.  
  976. CBRIDGE: IBM PC Conference Bridge                     Page  14
  977.  
  978.  
  979. VII.    CBRIDGE Main Menu (continued)
  980.  
  981.  
  982.     A.    Controls
  983.  
  984.         The 'Controls' pulldown allows you to select certain
  985.         control functions.  Controls are:
  986.  
  987.         .  Quiet mode may be set of or off
  988.         .  You may playback (and view) a saved conference
  989.            (this does not play a game).
  990.         .  Transcripting may be turned on and off (if you
  991.            loaded CBRIDGE with COM-AND).
  992.         .  Turn keyboard display on and off.
  993.         .  Turn transcript hold on and off.
  994.         .  Invoke CBRIDGE's Setup menu (Alt-S invokes COM-AND's
  995.            Setup menu if COM-AND is loaded).
  996.         .  Invoke CBRIDGE's Color menu (Alt-J invokes COM-AND's
  997.            Color menu if COM-AND is loaded).
  998.  
  999.  
  1000.     B.    Commands
  1001.  
  1002.         The 'Commands' pulldown allows you to issue commands to
  1003.         start and end games, and issue commands during your turn:
  1004.  
  1005.         .  Start a game (set players)
  1006.  
  1007.         .  Deal cards
  1008.         .  Declare the result of bidding (manual bidding enabled)
  1009.  
  1010.         .  Claim the remainder of tricks during game play
  1011.         .  Save the current game and terminate the current
  1012.            game in progress (only during turn).
  1013.  
  1014.         .  Declare a misdeal
  1015.         .  Require redeclaration
  1016.         .  Resend the last move (in case it got lost).
  1017.  
  1018.         .  Switch to CRT mode (even if game is in progress;
  1019.            (if a game is on, it will be terminated).
  1020.  
  1021.  
  1022.     C.    Setup
  1023.  
  1024.         The 'Setup' pulldown allows you to setup board pieces:
  1025.  
  1026.         .  Review bidding (if controlled bidding enabled)
  1027.         .  Review the last trick and current play
  1028.         .  Save the current play
  1029.         .  Restore a saved play
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035. Version 1.1: 880705
  1036.  
  1037. CBRIDGE: IBM PC Conference Bridge                     Page  15
  1038.  
  1039.  
  1040. VIII.    Beginning a Game
  1041.  
  1042.  
  1043.     Conceptually, the hardest part of CBRIDGE to visualize (or to put
  1044.     into words) is the beginning of a game.  The bullets below perhaps
  1045.     oversimplify the process, but make the process of beginning a
  1046.     Bridge game on-line clear (I hope).
  1047.  
  1048.  
  1049.     o    You will need access to a network supported by CBRIDGE
  1050.         (PLINK, GEnie, SOURCE, TBBS, PROTOCALL, CIS or Delphi)
  1051.         and an ID on that network.
  1052.  
  1053.     o    You will need to logon to the network of your choice and
  1054.         enter the/a conference area (a line, channel, room or what
  1055.         have you).
  1056.  
  1057.     o    You will need to have three other players present in the
  1058.         same line/channel/room.  The other players will need the
  1059.         CBRIDGE program as well.  Dealing cards cannot be performed
  1060.         in any reasonable time unless all use CBRIDGE.
  1061.  
  1062.     o    Each player will need to select 'Set players' from the
  1063.         'Commands' pulldown.  Each must specify their position and
  1064.         the ID (or handle or alias) of all the other players.
  1065.  
  1066.         Note:  all must agree on their position.  The game will not
  1067.         start until all 'set players' messages match.  CBRIDGE will
  1068.         tell you if it sees a mismatch.  When that happens, one or
  1069.         more players must perform 'set players' again.
  1070.  
  1071.         Note:  you cannot change your ID/handle during the game.
  1072.  
  1073.     o    A dealer is selected.  The dealer will use 'Deal' from the
  1074.         from the 'Commands' pulldown.  The dealing sequence begins
  1075.         and you see each card displayed in your area on the table.
  1076.         When the deal is complete, your hand is ordered and
  1077.         redisplayed.
  1078.  
  1079.     o    When the deal is complete, the bidding commences.
  1080.  
  1081.         If all players have selected 'controlled bidding' (the
  1082.         default), each player will be placed into a display showing
  1083.         the course of the bidding.  No communication with other
  1084.         players is possible during the bidding.  When it is your
  1085.         turn to bid, a second window will pop-up.  The dealer begins
  1086.         the bidding.  When the bidding is complete (three passes),
  1087.         all programs update the game display to reflect the declarer
  1088.         and contract.
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096. Version 1.1: 880705
  1097.  
  1098. CBRIDGE: IBM PC Conference Bridge                     Page  16
  1099.  
  1100.  
  1101. VIII.    Beginning a Game (continued)
  1102.  
  1103.  
  1104.     o    A note on manual bidding... an option
  1105.  
  1106.         If all players have selected 'manual bidding' (see below),
  1107.         bidding takes place through the text area, and CBRIDGE makes
  1108.         no attempt to record the bidding.  The result of the bidding
  1109.         must be 'declared'.  The declarer selects 'Declare' from the
  1110.         Commands pulldown, and all player's displays are updated.
  1111.  
  1112.  
  1113.     When all this has been accomplished (most of it should seem natural
  1114.     to those who spend much time on-line), the game is 'on', and the
  1115.     first player to play will be prompted.    The player 'to the left' of
  1116.     the declarer (determined through either manual or controlled
  1117.     bidding) must play a card.  When that card has been played, the
  1118.     dummy (opposite the declarer) reveals its hand for all to see, and
  1119.     the declarer plays the dummy hand from then on (in addition to the
  1120.     declarer's own.
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157. Version 1.1: 880705
  1158.  
  1159. CBRIDGE: IBM PC Conference Bridge                     Page  17
  1160.  
  1161.  
  1162. IX.    Bidding
  1163.  
  1164.  
  1165.     CBRIDGE defaults to a controlled bidding phase once the deal is
  1166.     complete.  Controlled bidding means that each player is 'locked
  1167.     out' from conversation until bidding is complete.  Controlled
  1168.     bidding also means that CBRIDGE can save the bidding, and
  1169.     replay it for inspection later.
  1170.  
  1171.  
  1172.     When the controlled bidding begins, a blank bidding history win-
  1173.     dow is opened over the text area.  The dealer is the first to be
  1174.     prompted for a call.  Bidding proceeds in clockwise order until:
  1175.  
  1176.     o    all four initial bid calls are passes (the deck is 'thrown
  1177.         in' and CBRIDGE reset to 'no game' state) or
  1178.  
  1179.     o    3 passes are called after a bid.  In this case, CBRIDGE
  1180.         determines the declarer and contract, updates the table
  1181.         display appropriately, and begins the game play sequence.
  1182.  
  1183.  
  1184.     CBRIDGE does not allow illegal bids during controlled bidding.    A
  1185.     legal bid during bidding is either a value (1-7) and a suit, or
  1186.     'PASS' 'DOUBLE' and 'REDOUBLE'.
  1187.  
  1188.  
  1189.     CBRIDGE has a limited display area for bidding (8 and 1/2 rounds).
  1190.     If bidding proceeds past its capacity, all players will be notified,
  1191.     and the bidding can continue in a conversational mode.    When this
  1192.     happens, the declarer must use the 'Commands' pulldown to establish
  1193.     the declarer and contract.
  1194.  
  1195.  
  1196.     Controlled bidding can be turned off (/M switch, or Controls pull-
  1197.     down).    However - all players must set their CBRIDGE program the
  1198.     same way (its not impossible otherwise, but painful).    Further,
  1199.     if the Controls pulldown is used to turn off controlled bidding
  1200.     (or 'turn on manual bidding' in its language), it may only be used
  1201.     when there is no game-play .
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218. Version 1.1: 880705
  1219.  
  1220. CBRIDGE: IBM PC Conference Bridge                     Page  18
  1221.  
  1222.  
  1223. X.    Game in progress
  1224.  
  1225.  
  1226.     Once the game has started, CBRIDGE supports the play by alternating
  1227.     play prompts, in a clockwise manner.  The winner of each trick
  1228.     begins the play for the next trick.  Initially, the player to the
  1229.     left of the declarer plays the first card.  After the first card is
  1230.     played, the dummy exposes its hand, and the game proceeds.
  1231.  
  1232.  
  1233.     At each player's turn, CBRIDGE will prompt for a card.  The player's
  1234.     hand is displayed above (played cards are highlighted.    Cards may
  1235.     selected in response to the prompt with a simple notation.  For
  1236.     example:  '2d' = 2 of diamonds.  The card number/name and suit are
  1237.     stated.  Ace is "A", King is "K", Queen is "Q", and Jack is "J".
  1238.     You can use the first letter of the suit, or the full name.
  1239.  
  1240.  
  1241.     When you are prompted for a card, you have a few other options as
  1242.     well as the obvious one of typing the card name.  You may use the
  1243.     mouse or the cursor keys (up and down arrows) to select the card
  1244.     from your hand, or you might enter one of the following:
  1245.  
  1246.         CLAIM                Declarer claims remainder
  1247.         MISDEAL             Declare a misdeal
  1248.         REDECLARE            Require redeclaration
  1249.         QUIT                Terminate the game
  1250.         Esc                Hit the escape key
  1251.  
  1252.  
  1253.     When you hit the 'escape' key, your cursor will re-appear in the
  1254.     scrolling text area and you may type to your friends (or anybody
  1255.     listening/watching).  When you enter a carriage return (or the Esc
  1256.     key again), you will be returned to the move prompt.
  1257.  
  1258.  
  1259.     You use the mouse to select a card from your hand as follows:
  1260.  
  1261.     o    Select the card (the selected card is highlighted, and
  1262.         you'll see the card name in the prompt area)
  1263.     o    Press the left mouse button to 'send' that card.
  1264.  
  1265.     Backspace will erase your entry (entered through the keyboard or the
  1266.     mouse).  When you type a carriage return (or left mouse button) your
  1267.     card is verified and sent to all players.
  1268.  
  1269.     Should line noise, or the inadvertent loss of your opponent (for
  1270.     example due to 'call waiting') interfere with the exchange of moves,
  1271.     you may resend your last move with the 'Commands' pulldown.
  1272.  
  1273.     Note:  CBRIDGE does not help you play a better game.  It only
  1274.     verifies that the card you selected is in your hand.
  1275.  
  1276.  
  1277.  
  1278.  
  1279. Version 1.1: 880705
  1280.  
  1281. CBRIDGE: IBM PC Conference Bridge                     Page  19
  1282.  
  1283.  
  1284. X.    Game in progress
  1285.  
  1286.  
  1287.     There are a few limitations imposed by CBRIDGE when a game is in
  1288.     progress.
  1289.  
  1290.     o    You cannot switch to the CRT side (COM-AND) without
  1291.         terminating the current game in progress.  While a game is
  1292.         in progress, the F1 key is inhibited.
  1293.  
  1294.     o    Should you encounter a program bug, or an emergency need
  1295.         to switch to the CRT side, you may do so.  The 'Commands'
  1296.         pulldown allows a switch to CRT side - however, it will
  1297.         terminate any current game in progress.
  1298.  
  1299.     o    You can playback received text (if you loaded CBRIDGE with
  1300.         COM-AND) with Alt-B only when it is not your turn.  You
  1301.         may review tricks and bidding at any time.
  1302.  
  1303.     o    Should your opponent loose a card (due to line noise or
  1304.         what have you), you may resend your last card using the
  1305.         'Commands' pulldown.  Select 'Resend last'.
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340. Version 1.1: 880705
  1341.  
  1342. CBRIDGE: IBM PC Conference Bridge                     Page  20
  1343.  
  1344.  
  1345. XI.    Saving and Restoring a Game
  1346.  
  1347.  
  1348.     You may save a game in progress at any time using the 'Save' option
  1349.     of the 'Setup' pull-down, or the 'Quit' option of the 'Commands'
  1350.     pulldown.  Both methods save the current game If there is a disk
  1351.     file of the name you select, it will be purged and the new game
  1352.     written over it.
  1353.  
  1354.  
  1355.     When a position is saved, the following items are recorded:
  1356.  
  1357.     o    Timestamp of the save
  1358.     o    Your hand and the dummy hand
  1359.     o    All current values (who's to play, who declared, the
  1360.         contract and so on)
  1361.     o    The log of tricks
  1362.     o    The log of bidding (if controlled bidding was selected)
  1363.  
  1364.  
  1365.     You may restore a saved position when no game is in progress, with
  1366.     the 'Restore game' option of the 'Setup' pulldown.  When you restore
  1367.     a saved position, you will see the board as it was when the save
  1368.     file was taken.  If each player present at the previous game is
  1369.     present now, and each performs 'restore game', the game could
  1370.     actually be continued.
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401. Version 1.1: 880705
  1402.  
  1403. CBRIDGE: IBM PC Conference Bridge                     Page  21
  1404.  
  1405.  
  1406. XII.    Ending a Game
  1407.  
  1408.  
  1409.     CBRIDGE terminates game play in many different fashions.  Please
  1410.     note that when a game is terminated, CBRIDGE does not terminate.
  1411.     You may start a new game, switch to the CRT side (if you loaded
  1412.     CBRIDGE with COM-AND), or just sit and puzzle.    Game termination
  1413.     refers only to CBRIDGE's tracking/display of a game.
  1414.  
  1415.  
  1416.     A.    All cards played
  1417.  
  1418.         When CBRIDGE sees that all cards have been played, the game
  1419.         is over.  The log of tricks can be reviewed (or saved and
  1420.         reviewed later) for scoring.
  1421.  
  1422.     B.    Claim
  1423.  
  1424.         The declarer may offer the defenders a quick end to the
  1425.         game.  Both defenders must accept the CLAIM offer (they
  1426.         will be prompted with pop-up menues) for the CLAIM to take
  1427.         effect.  If either refused, the declarer is notified.
  1428.  
  1429.     C.    QUIT
  1430.  
  1431.         CBRIDGE accepts the command EXIT at any prompt for play.
  1432.         You may also select QUIT from the Commands pulldown, or
  1433.         emergency switch to CRT (which includes a QUIT).  When this
  1434.         happens, all other game players are informed of the game's
  1435.         termination.
  1436.  
  1437.     D.    Misdeal
  1438.  
  1439.         CBRIDGE accepts the command MISDEAL at any prompt for play.
  1440.         You may also select it from the Commands pulldown.  This
  1441.         command terminates the current game in progress, and informs
  1442.         all other player's game programs.
  1443.  
  1444.     E.    Redeclare
  1445.  
  1446.         CBRIDGE accepts the command REDECLARE at any prompt for card
  1447.         play.  You may also select it from the Commands pulldown.
  1448.         This command returns all game programs to the 'Bidding'
  1449.         state.    A new declaration of contract must be entered using
  1450.         the Commands pulldown.
  1451.  
  1452.  
  1453.     You may save a game position after you have ended a game.  This
  1454.     allows you to save a game for later review when 'call waiting'
  1455.     knocks a player off-line.
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462. Version 1.1: 880705
  1463.  
  1464. CBRIDGE: IBM PC Conference Bridge                     Page  22
  1465.  
  1466.  
  1467. XIII.    Program Configuration (Alt-S, and Alt-P)
  1468.  
  1469.  
  1470.     A. Setup Screen (Alt-S)
  1471.  
  1472.        1. Files
  1473.  
  1474.           . Default Save file
  1475.  
  1476.         When you save a position, you will be asked for a file name.
  1477.         The file name specified here is used if you enter a blank
  1478.         save file name to this query.
  1479.  
  1480.           . Default Log
  1481.  
  1482.         This file name will be used when you request transcripting
  1483.         and enter a blank in response to the log file name query.
  1484.  
  1485.        2. Timings and Values
  1486.  
  1487.           . Break delay
  1488.  
  1489.         As noted above, the break delay is controlled through the
  1490.         Millisecond loop value.  This value "break delay"
  1491.         specifies the number of "milliseconds" the comm line is
  1492.         held when a break is issued (Cntl-END).
  1493.  
  1494.        3. Flags
  1495.  
  1496.           . Use BIOS for screen saves
  1497.  
  1498.         CBRIDGE executes with alpha screen, so it can use BIOS
  1499.         routines for screen saves.  BIOS is slower (menues pop-up
  1500.         and drop more slowly) than the default method, but some
  1501.         machines and some operating environments will require
  1502.         that you set this on (use /C in the run command).
  1503.  
  1504.           . Quiet mode
  1505.  
  1506.         You may not wish CBRIDGE to play a tune when you are being
  1507.         prompted.  You can turn the silly noise off with this switch
  1508.         (/Q in the run command will do the same).
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523. Version 1.1: 880705
  1524.  
  1525. CBRIDGE: IBM PC Conference Bridge                     Page  23
  1526.  
  1527.  
  1528. XIII.    Program Configuration (continued)
  1529.  
  1530.  
  1531.     A. Setup Screen (Alt-S) (continued)
  1532.  
  1533.        3. Flags (continued)
  1534.  
  1535.           . Initial advert
  1536.  
  1537.         Turn off the advert after you've seen it.  Just before you
  1538.         register...  This only effects standalone usage.
  1539.  
  1540.           . Exit Query
  1541.  
  1542.         Some people disdain the query "do you really and truly mean
  1543.         it" when they type Alt-X.  Some feel it mandatory.  CBRIDGE
  1544.         is distributed with exit query disabled.  You may enable it,
  1545.         if you're so inclined.  This only effects standalone usage.
  1546.  
  1547.  
  1548.        4. Save
  1549.  
  1550.           You may change values for one execution of CBRIDGE, or you
  1551.           may change them for all subsequent executions of CBRIDGE.  If
  1552.           you save values, the values you've saved will be used the
  1553.           next time you run CBRIDGE.
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584. Version 1.1: 880705
  1585.  
  1586. CBRIDGE: IBM PC Conference Bridge                     Page  24
  1587.  
  1588.  
  1589. XIII.    Program Configuration (continued)
  1590.  
  1591.  
  1592.     B. Communications Parameters (Alt-P)
  1593.  
  1594.        1. Rate + Parity + Data bits + Stop Bits
  1595.  
  1596.           Baud rate, parity, number of data bits and number of stop bits
  1597.           are specified in combination through the first 10 selections
  1598.           on the Alt-P window.  These selections are the only way you
  1599.           may specify baud rate.  Other parameters (parity, data bits,
  1600.           and stop bits) may be set individually (below).
  1601.  
  1602.           Do not change the current setting after you've connected to a
  1603.           service.    Make your setting here before you use CBRIDGE
  1604.           on-line.
  1605.  
  1606.        2. Parity, Data bits and Stop bits
  1607.  
  1608.           Individual settings for parity, number of data bits and number
  1609.           of stop bits comprise the next 7 items of this menu.  You also
  1610.           set these values when you create a dialing directory entry.
  1611.  
  1612.           Again - do not change the current setting after you've
  1613.           connected to a service.  The settings on this screen are
  1614.           effective only when CBRIDGE is run standalone.  Changing a
  1615.           setting here could disconnect you.
  1616.  
  1617.        3. COM ports
  1618.  
  1619.           The last four items on this menu are the candidates for COM
  1620.           ports.  Select the appropriate port for your modem.  This item
  1621.           is usually selected once, and then left alone.
  1622.  
  1623.        4. Save
  1624.  
  1625.           You save the current settings for the next execution of CBRIDGE
  1626.           through the "Save" selection.  Settings are saved to disk.
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645. Version 1.1: 880705
  1646.  
  1647. CBRIDGE: IBM PC Conference Bridge                     Page  25
  1648.  
  1649.  
  1650. XIII.    Program Configuration (continued)
  1651.  
  1652.  
  1653.     C. Colors (Alt-J)
  1654.  
  1655.        You may set foreground and background colors for
  1656.  
  1657.           (1) the CRT text area,
  1658.  
  1659.           (2) the status line, and
  1660.  
  1661.           (3) the main menu and important menus (queries are set to
  1662.           black on white for contrast).
  1663.  
  1664.  
  1665.        The background color for the table is not settable.
  1666.  
  1667.  
  1668.        The color names are those used in the IBM Technical reference;
  1669.        if you have different names for some of the color values, I
  1670.        apologize.  My wife and I have argued for years over 'beige'.
  1671.  
  1672.  
  1673.        Like other option menus, you can experiment with settings.
  1674.        Unless you save your settings, they are lost when the program
  1675.        terminates.
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706. Version 1.1: 880705
  1707.  
  1708. CBRIDGE: IBM PC Conference Bridge                     Page  26
  1709.  
  1710.  
  1711. XIV.    Program Requirements
  1712.  
  1713.  
  1714.     This program can only function on an IBM PC or DOS compatible
  1715.     machine.
  1716.  
  1717.  
  1718.     CBRIDGE supports MDA, CGA, EGA and Hercules adapters.  CBRIDGE uses
  1719.     a Microsoft Mouse if one is available (not well, but it'll certainly
  1720.     get better).
  1721.  
  1722.  
  1723.     CBRIDGE disk I/O is done through the 'Handle' oriented I/O routines
  1724.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  1725.  
  1726.  
  1727.     CBRIDGE (version 1.1) requires 82k for itself.    So you need 128.
  1728.     To take advantage of the DOS Gateway (use another comm program) or
  1729.     to use COM-AND, you'll need 384K.
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767. Version 1.1: 880705
  1768.  
  1769. CBRIDGE: IBM PC Conference Bridge                     Page  27
  1770.  
  1771.  
  1772. XV.    Program and Author Information
  1773.  
  1774.  
  1775.     This program was written using Microsoft Macro-Assembler.  The
  1776.     author likes assembler.  Assembly language is an entirely appro-
  1777.     priate vehicle for some of the program, and a not-inappropriate
  1778.     vehicle for the rest of it.  Everything, in moderation...
  1779.  
  1780.  
  1781.     The author of this program is R.  Scott McGinnis of Chicago,
  1782.     Illinois.  PLINK and GEnie ID:    TARTAN.  Comment and suggestions
  1783.     (and criticism in moderation) are welcomed:
  1784.  
  1785.              CABER Software
  1786.              R. (Scott) McGinnis
  1787.              P.O. Box 3607 Mdse Mart
  1788.              Chicago, IL 60654-0607
  1789.  
  1790.  
  1791.     I thank Dave Thomas of the Laptops RT on GEnie for advice and
  1792.     encouragement for this program.  It's been quite a while since I've
  1793.     played bridge, and Dave put up with alot of silly questions at the
  1794.     outset.  Dave has also thrown himself and his resources into the
  1795.     support of another of my program - Conference chess.
  1796.  
  1797.  
  1798.     I also thank Richard Winter, Tom Etheridge, and David Lorenc for
  1799.     preservering during beta tests.
  1800.  
  1801.  
  1802.     I want also to thank Elizabeth, my partner..  She supported me
  1803.     literally and figuratively in this effort.  Without her belief in me
  1804.     I'd have been arrested as a vagrant long ago.
  1805.  
  1806.  
  1807.     This program (Version 1.1) may be distributed freely with the caveat
  1808.     that the Author information displayed at program termination is not
  1809.     removed.  If the program is found entertaining or useful, a regis-
  1810.     tration of $50.00 is requested.  Should response warrant it, I will
  1811.     continue to develop and support this product.
  1812.  
  1813.  
  1814.     Most of the hardware names and software names in this document are
  1815.     trademarks or trade names of specific manufacturers.
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828. Version 1.1: 880705
  1829.  
  1830. CBRIDGE: IBM PC Conference Bridge                     Page  28
  1831.  
  1832.  
  1833. A.    Switches and parameters
  1834.  
  1835.  
  1836.     Program Switches:
  1837.  
  1838.     /C 'Compatible': BIOS is used for screen saves/restores, as required
  1839.         by certain machines and certain operating environments.
  1840.  
  1841.     /E 'EGA': An EGA, if available will be used for the display of a
  1842.         43 line screen.  The resolution of card pips is reduced, but
  1843.         for people who like to talk, its a great thing.
  1844.  
  1845.     /F 'Fast': Some systems (like PLINK) eat lines that are written too
  1846.         fast.  CBRIDGE sends a carriage return (to clear any typed text),
  1847.         delays 2 seconds, and then sends its command text.    Where this is
  1848.         not necessary, the /F switch will eliminate the delay.
  1849.  
  1850.     /M 'Manual bidding': This flag will turn off CBRIDGE's controlled
  1851.         bidding (allow manual bidding).  It is not recommended, as this
  1852.         allows violation of the rules of bidding.
  1853.  
  1854.     /P  'Piggyback':  CBRIDGE will open the COM port in such a manner as
  1855.         to retain another program's already opened line.  When CBRIDGE is
  1856.         exited, the previous state is restored.  This is for use with
  1857.         other communications programs having a DOS Gateway (e.g.
  1858.         PROCOMM).
  1859.  
  1860.     /X  'Debug mode': This switch enables certain resident debugging
  1861.         keys.  I do not recommend you use it.  The game cannot be used
  1862.         on-line with this switch.
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889. Version 1.1: 880705                           Appendices
  1890.  
  1891. CBRIDGE: IBM PC Conference Bridge                     Page  29
  1892.  
  1893.  
  1894. A.    Switches and Parameters (continued)
  1895.  
  1896.  
  1897.     Program parameters:
  1898.  
  1899.        COM1     CBRIDGE uses the COM1 port
  1900.        COM2     CBRIDGE uses the COM2 port
  1901.        COM3     CBRIDGE uses the COM3 port
  1902.        COM4     CBRIDGE uses the COM4 port
  1903.  
  1904.        300        CBRIDGE uses port at 300 baud
  1905.        1200     CBRIDGE uses port at 1200 baud
  1906.        2400     CBRIDGE uses port at 2400 baud
  1907.        4800     CBRIDGE uses port at 4800 baud
  1908.        9600     CBRIDGE uses port at 9600 baud
  1909.  
  1910.        EVEN     CBRIDGE uses port with even parity
  1911.        ODD        CBRIDGE uses port with odd parity
  1912.        NONE     CBRIDGE uses port with no parity
  1913.  
  1914.        DATA7    CBRIDGE transmits/receives 7 data bits
  1915.        DATA8    CBRIDGE transmits/receives 8 data bits
  1916.  
  1917.        STOP1    CBRIDGE uses and expects 1 stop bit
  1918.        STOP2    CBRIDGE uses and expects 2 stop bits
  1919.  
  1920.  
  1921.     Program switches require no delimiters.  Parameters when contiguous
  1922.     must be preceded by a blank.  For example:
  1923.  
  1924.     A> CBRIDGE 1200      Run the program for 1200 baud communications
  1925.     A> CBRIDGE /P1200     Piggyback, 1200 baud
  1926.     A> CBRIDGE /P 1200     Piggyback, 1200 baud
  1927.  
  1928.  
  1929.     Program defaults are:
  1930.  
  1931.     A> CBRIDGE COM2 300 EVEN DATA7 STOP1
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950. Version 1.1: 880705                           Appendices
  1951.  
  1952. CBRIDGE: IBM PC Conference Bridge                     Page  30
  1953.  
  1954.  
  1955. B.    Files
  1956.  
  1957.  
  1958.     Program files:    CBRIDGE expects the following files on the default
  1959.     drive (and subdirectory)
  1960.  
  1961.     CBRIDGE.DFT     Parameter save area (Alt-S, Alt-J and Alt-P)
  1962.  
  1963.  
  1964.     CBRIDGE will create this file if it is not found.  CBRIDGE will auto-
  1965.     matically update the .DFT file if the program version number is
  1966.     different from the .DFT file version number.  When CBRIDGE is loaded,
  1967.     the old file format will be loaded.  A new file will then be created
  1968.     to replace the old file.
  1969.  
  1970.  
  1971.     When a new major (e.g.    1.0, 2,0, ...) is released or when you move
  1972.     CBRIDGE from one machine to another the previous .DFT file probably
  1973.     should be purged (and recreated by CBRIDGE).
  1974.  
  1975.  
  1976.     CBRIDGE also uses (if available) the following files:
  1977.  
  1978.     CBRIDGE.SAV     Default save position file
  1979.     CBRIDGE.LOG     Default log file name
  1980.  
  1981.  
  1982.     Each of these file names may be changed through the ALT-S (Setup)
  1983.     Menu.  CBRIDGE currently implements the rule for file names:  If the
  1984.     given file name carries a drive spec (i.e.  C:) or path (sub-
  1985.     directory), the name is taken 'as is'.  If neither condition holds,
  1986.     the default drive and subdirectory are added to the file name.
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011. Version 1.1: 880705                           Appendices
  2012.  
  2013. CBRIDGE: IBM PC Conference Bridge                     Page  31
  2014.  
  2015.  
  2016. C.    Messages
  2017.  
  2018.  
  2019.     Only for the technically inclined, I've included here the actual
  2020.     messages CBRIDGE issues.  These messages are ASCII, and when received
  2021.     are expected to be prefaced by a parsable ID or handle.
  2022.  
  2023.  
  2024.     Set players: Transmitted when game is setting-up
  2025.  
  2026.         BRIDGE: START xxxxx
  2027.         =-----+------=-----
  2028.               !     !
  2029.               !     +------------>    5 bytes, literal ascii
  2030.               +----------------------> 14 bytes, literal ascii
  2031.  
  2032.     Game: Transmitted when one CBRIDGE has seen 3 START messages.
  2033.  
  2034.         BRIDGE: GAME  xxxxx
  2035.         =-----+------=-----
  2036.               !     !
  2037.               !     +------------>    5 bytes, literal ascii
  2038.               +----------------------> 14 bytes, literal ascii
  2039.  
  2040.     Deal: Transmitted between programs to deal cards (52x)
  2041.  
  2042.         BRIDGE: pppppnn<encrypted deck>
  2043.         =-----+=----=++=--------------=
  2044.               !   !  !!   !
  2045.               !   !  !!   +-----------> 18 byte encrypted deck
  2046.               !   !  ++--------------->  2 bytes: Deal #
  2047.               !   +------------------->  5 bytes: Recipient
  2048.               +----------------------->  8 bytes; literal ASCII
  2049.  
  2050.     Declare: Manual declaration of the end of bidding.
  2051.  
  2052.         BRIDGE: DECLARE nx
  2053.         =----+---------=--
  2054.              !        !+------------> 1 byte: Contract suit
  2055.              !        +-------------> 1 byte: Contract value
  2056.              +------------------------> 16 bytes, literal ascii
  2057.  
  2058.     Card play: Transmitted to play a card.
  2059.  
  2060.         BRIDGE: PLAY nnx
  2061.         =----+------=---
  2062.              !         !!+--------------> 1 byte: Suit of the card
  2063.              !         ++---------------> 2 bytes: value of the card
  2064.              +------------------------> 13 bytes, literal ascii
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072. Version 1.1: 880705                           Appendices
  2073.  
  2074. CBRIDGE: IBM PC Conference Bridge                     Page  32
  2075.  
  2076.  
  2077. C.    Messages (continued)
  2078.  
  2079.  
  2080.     EXIT game: Transmitted by current player to signal abrupt terminate.
  2081.  
  2082.         BRIDGE: EXIT
  2083.         =----+-----=
  2084.              !
  2085.              +----------------------> 12 bytes, literal ascii
  2086.  
  2087.     RESEND game: Transmitted automatically to request resend of last.
  2088.  
  2089.         BRIDGE: RESEND
  2090.         =----+-------=
  2091.              !
  2092.              +----------------------> 14 bytes, literal ascii
  2093.  
  2094.     CLAIM game: Transmitted by declarer to claim remaining tricks.    This
  2095.     message will be acknowledged by (1) OKCLAIM or (2) NOCLAIM
  2096.  
  2097.         BRIDGE: CLAIM
  2098.         =----+------=
  2099.              !
  2100.              +----------------------> 13 bytes, literal ascii
  2101.  
  2102.     OKCLAIM: Transmitted in response to CLAIM message to accept
  2103.  
  2104.         BRIDGE: OKCLAIM
  2105.         =----+--------=
  2106.              !
  2107.              +----------------------> 15 bytes, literal ascii
  2108.  
  2109.     NOCLAIM: Transmitted in response to CLAIM message to reject
  2110.  
  2111.         BRIDGE: NOCLAIM
  2112.         =----+--------=
  2113.              !
  2114.              +----------------------> 15 bytes, literal ascii
  2115.  
  2116.     MISDEAL: Transmitted to declare a misdeal
  2117.  
  2118.         BRIDGE: MISDEAL
  2119.         =----+--------=
  2120.              !
  2121.              +----------------------> 15 bytes, literal ascii
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133. Version 1.1: 880705                           Appendices
  2134.  
  2135. CBRIDGE: IBM PC Conference Bridge                     Page  33
  2136.  
  2137.  
  2138. C.    Messages (continued)
  2139.  
  2140.  
  2141.     Dummy: Transmitted by the dummy to reveal the dummy hand.
  2142.  
  2143.         BRIDGE: DUMMY 111222333444555666777888999000111222333
  2144.         =-----+------=--------------------------------------=
  2145.               !        !
  2146.               !        +---------> Dummy hand, unencrypted
  2147.               +----------------------> 14 bytes, literal ascii
  2148.  
  2149.     DEALER: Transmitted to declare the position of the dealer
  2150.  
  2151.         BRIDGE: DEALER
  2152.         =----+-------=
  2153.              !
  2154.              +-----------------------> 14 bytes, literal ascii
  2155.  
  2156.     BID: Transmitted to call a bid
  2157.  
  2158.         BRIDGE: BID xx
  2159.         =----+-----=-=
  2160.              !        !+---------------> 1 byte, Suit of bid (CHDSN)
  2161.              !        +----------------> 1 byte, Value of bid (1-7)
  2162.              !        +++--------------> Also: PAS/DBL/RDB (3 bytes)
  2163.              +-----------------------> 14 bytes, literal ascii
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194. Version 1.1: 880705                           Appendices
  2195.  
  2196. CBRIDGE: IBM PC Conference Bridge                     Page  34
  2197.  
  2198.  
  2199. D.    Save file structure:
  2200.  
  2201.     0     1     2      3    4     5     6      7    8
  2202.     +-----+-----+-----+-----+-----+-----+-----+-----+---//
  2203.     ! 'C' ! 'B' ! 'R' ! 'I' ! 'D' ! 'G' ! <ver-rev> !   ...
  2204.     +-----+-----+-----+-----+-----+-----+-----+-----+---//
  2205.  
  2206.           8     9      10    11    12    13      14   ...    18
  2207.       //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---//
  2208.           ! mm      ! '/' ! dd        ! '/' ! yyyy      ! ' ' !   ...
  2209.       //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---//
  2210.  
  2211.           18    19      20    21    22    23      24    25    26
  2212.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  2213.           ! hh      ! ':' ! mm        ! ':' ! ss        !   ...
  2214.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  2215.  
  2216.           26    27      28    29    30    31      32    33    34
  2217.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  2218.           ! BS  ! BV  ! BB    ! Our ! Dum ! Dec ! ToM ! WeD !   ...
  2219.       //--+-----+-----+-----+-----+-----+-----+-----+-----+---//
  2220.  
  2221.           35    36        38        40      41
  2222.       //--+-----+-----+-----+-----+-----+-----+---//
  2223.           ! Sta ! NS Score    ! EW Score  ! Tr# !   ...
  2224.       //--+-----+-----+-----+-----+-----+-----+---//
  2225.  
  2226.           41      61          81      101
  2227.       //--+----/ /----+----/ /----+----/ /----+---//
  2228.           ! Partner   ! Left dfndr! Right dfnd!   ...
  2229.       //--+----/ /----+----/ /----+----/ /----+---//
  2230.  
  2231.           101        114          127
  2232.       //--+-----+----/ /----+-----+----/ /----+---//
  2233.           ! Our hand    ! Dummy hand      !   ...
  2234.       //--+-----+----/ /----+-----+----/ /----+---//
  2235.  
  2236.           127      129          131      133
  2237.       //--+-----+-----+-----+-----+-----+-----+---//
  2238.           !  FL !  CL ! Log count ! Bid count !   ...
  2239.       //--+-----+-----+-----+-----+-----+-----+---//
  2240.  
  2241.           133     ...         ...      143
  2242.       //--+-----+-----+----/ /----+-----+-----+---//
  2243.           !  10 bytes of fill for later      !   ...
  2244.       //--+-----+-----+----/ /----+-----+-----+---//
  2245.  
  2246.           143              211              163
  2247.       //--+-----+-----+----/ /----+-----+-----+----/ /----+
  2248.           ! Bid Log for 8 1/2 rnds! Play Log for 4*13     !
  2249.       //--+-----+-----+----/ /----+-----+-----+----/ /----+
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255. Version 1.1: 880705                           Appendices
  2256.  
  2257. CBRIDGE: IBM PC Conference Bridge                     Page  35
  2258.  
  2259.  
  2260. D.    Save file structure (continued)
  2261.  
  2262.         <Ver-rev>    Binary, Version * 256 + Revision
  2263.         mm        ASCII, Month number (01-12)
  2264.         dd        ASCII, Day number (01-31)
  2265.         yyyy        ASCII, Year
  2266.         hh        ASCII, Hour number (00-23)
  2267.         mm        ASCII, Minute number (00-59)
  2268.         ss        ASCII, Second number (00-59)
  2269.  
  2270.         BS        Bid suit (c=0,d=1,h=2,s=3,nt=4)
  2271.         BV        Bid value (1-7)
  2272.         BB        Dealer position (S=0,W=1,N=2,E=3)
  2273.  
  2274.         Our        Our position (S=0,W=1,N=2,E=3)
  2275.         Dum        Dummy position (S=0,W=1,N=2,E=3)
  2276.         Dec        Declarer position (S=0,W=1,N=2,E=3)
  2277.         ToM        Position of current player (as above)
  2278.         WeD        We dealt (true if .ne. 0)
  2279.  
  2280.         Sta        Game status (0=no game, 1 = ready to start...)
  2281.         NS Score    Count of N/S won tricks
  2282.         EW Score    Count of E/W won tricks
  2283.         Tr#        Current trick number (0-13)
  2284.  
  2285.         Partner     ID of partner
  2286.         Left dfndr    ID of defender on the left
  2287.         Right dfndr    ID of defender on the right
  2288.  
  2289.         Our Hand    Our hand at the time of the save
  2290.         Dummy Hand    Dummy hand at the time of the save
  2291.  
  2292.         Log count    Binary, count of move log in bytes
  2293.         Bid count    Binary, count of bids in bit log in bytes
  2294.  
  2295.         FL        Position of first lead
  2296.         CL        Position of lead in current trick
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316. Version 1.1: 880705                           Appendices
  2317.  
  2318. CBRIDGE: IBM PC Conference Bridge                     Page  36
  2319.  
  2320.  
  2321. E.    Beta release
  2322.  
  2323.  
  2324.     Version 1.0 was a beta release, rather in the way of an experiment.
  2325.     It took the good offices of several dedicated souls (driven souls?)
  2326.     on GEnie to bring 1.1 to bed.  I'd like to thank Dave Thomas
  2327.     (MORTIMER, SYSOP of the Laptops roundtable), Richard Winter (TONK),
  2328.     Tom Etheridge (T.KEITH), and David Lorenc (DOCTOR-WHO) for
  2329.     preservering through 9 versions of CBRIDGE 1.0, and not for hunting
  2330.     me down and mudering me.
  2331.  
  2332.  
  2333.     This version (1.1), will still be 'rough' in some places, and still
  2334.     have a few warts.  It will only be completed if people downloading
  2335.     this and reviewing it find it of interest...  interesting enough to
  2336.     use it and to report back to me difficulties, problems and desires.
  2337.  
  2338.  
  2339.     There will be many oversights and errors of omission in this
  2340.     program.  As this is the second public release, I expect there'll
  2341.     turn up many cosmetic requests.  There will, of course be further
  2342.     functional additions possible, too.  In particular:
  2343.  
  2344.     o    A protocol for move exchange (receiver ACK's each MOVE)
  2345.         could be implemented if required...
  2346.     o    Playback of a saved game could be implemented
  2347.     o    A kibitz mode could be implemented
  2348.  
  2349.  
  2350.     Each of these matters are areas I would appreciate other's opinions.
  2351.     For example, a protocol for move exchanges would ensure that moves
  2352.     are received by the opponent, and ensure you are informed of a lost
  2353.     move.  However - what should be done at that point?  Experience may
  2354.     show that no such protocol is required - or experience may leave
  2355.     some very frustrated gamers.
  2356.  
  2357.  
  2358.     The comments and criticisms I receive will be used to guide the
  2359.     development of version 1.1 and further versions of this game.  When
  2360.     I feel that the program is satisfactory (to its users), I'll go on
  2361.     to produce other card related on-line games.
  2362.  
  2363.  
  2364.     Of course - if no one cares to register this, I'll drop it.
  2365.  
  2366.  
  2367.     Please address any comments and criticisms you have - and bug
  2368.     reports - to the ID TARTAN on either the GEnie or PLINK systems.
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377. Version 1.1: 880705                           Appendices
  2378.