Share Gallery 1

home *** CD-ROM | disk | FTP | other *** search

/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO029C.ZIP / CCHESS12.ZIP / CCHESS.DOC next >

Wrap

Text File | 1991-07-25 | 53KB | 2,135 lines

CCHESS: IBM PC Conference Chess ---------------------------------- CCHESS: IBM PC Conference Chess ---------------------------------- Communications Accessory ---------------------------------- CCHESS is distributed freely and may be copied by anyone for any number of machines. The author offers CCHESS as "shareware". If the program is found to be useful or entertaining, a registration of $50.00 is requested. If response warrants, CCHESS will be enhanced and extended. The author may be reached at: CABER Software R. (Scott) McGinnis P.O. Box 3607 Mdse Mart Chicago, IL 60654-0607 PLINK, GEnie id: TARTAN Version 1.2: 880705 CCHESS: IBM PC Conference Chess CCHESS version 1.2 is copyright 1988 CABER Software (R. Scott McGinnis). All rights are reserved world wide, excepting redistri- bution under the ShareWare concept. CCHESS is distributed freely and may be copied by anyone for any number of machines, under the ShareWare concept. CCHESS is distributed as ShareWare. You may use CCHESS without charge for the purposes of evaluating it's usefulness to your purposes. It is suggested that this evaluation period be limited to a few days of actual use. If you find CCHESS to be worth continued use, then you are asked to pay for it. The payment is called a "registration fee". Complete the included registration form and mail it with your payment. Registration of CCHESS includes the communications program COM-AND, all published accessory programs (which currently are PC-VCO, CBRIDGE, and CCOLOR), and several utilities (unPACKIT and unSTUFIT). COM-AND, accessories and utilities are published separately. One registration covers any and all of these programs. By registering your copy of CCHESS (or any ShareWare product), you are promoting and supporting the convenient distribution method and free evaluation policy that brought you this copy of CCHESS. If you have received this copy from a Users' Group, "Software Library" or "SIG", and have paid a small fee (usually $3 to $10), you have NOT acquired a registration or continued right to use CCHESS. This fee was for the convenience of obtaining the diskette with CCHESS on it. The fee does NOT apply to the registration fee. You may NOT distribute CCHESS or it's documentation in connection with ANY commercial venture, product, publication or service without written approval. CCHESS may not be disassembled or modified without express written consent. CCHESS is supplied "as-is" with no warranties expressed or implied. Neither CABER software nor the author will be liable for any damages or lost revenues incurred through the use of this program or any of its accessories and utilities beyond the registration price paid. Version 1.2; 880705 CCHESS: IBM PC Conference Chess Table of Contents ----------------- I. Introduction .............................................. page 1 II. Running the program ....................................... page 2 III. CCHESS Display ............................................ page 5 IV. Services supported ......................................... page 6 V. CCHESS Commands using COM-AND .............................. page 10 VI. CCHESS Commands Standalone ................................. page 12 VII. CCHESS Main Menu ........................................... page 13 VIII. Beginning a Game ........................................... page 15 IX. Game in Progress ........................................... page 17 X. Saving and restoring a Game ................................ page 18 XI. Ending a Game .............................................. page 19 XII. Program Configuration (Alt-S, and Alt-P) ................... page 20 XIII. Program Requirements ....................................... page 23 XIV. Program and Author Information ............................ page 24 Appendices ---------- A. Switches and Parameters .................................... page 25 B. Files ...................................................... page 27 C. Messages ................................................... page 28 D. Save file format ........................................... page 31 E. Production Release ......................................... page 32 Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 1 I. Introduction A. What is CCHESS? CCHESS for the IBM PC is an accessory program, intended to be used with a 'base' communications program. CCHESS is integrated into the included program 'COM-AND'. However, CCHESS may be used with any comm program supporting a 'DOS gateway' that does not break an established comm link. CCHESS, used with network conferencing services such as People- Link's PARTY, CompuServe's CB and GEnie's RTC conferencing, provides a way to play chess with another person and 'see' the game in progress. B. This program CCHESS Version 1.2 executes in CGA hi-res graphics mode, or in Hercules graphics mode. A Microsoft Mouse is supported, if one is available. CCHESS may be copied freely and distributed to anyone for any number of machines. The author offers CCHESS as "shareware". If the program is found to be useful or entertaining, a registration is asked. CCHESS will be extended and enhanced if response warrants. C. This document This document describes the features of CCHESS. It will not attempt to describe all the features of COM-AND (which are available within CCHESS if used), or any other communications program used. From time-to-time the assumption will be made that COM-AND is used as the communications program, to high- light the interaction between CCHESS and COM-AND. Please do not take it that COM-AND is the only comm program possible to use. Refer to the documentation provided with your favorite comm program for a full discussion of its function and features. They won't be available in PC-VCO, however. Appendices here will provide details for very interested readers. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 2 II. Running the program CCHESS is an accessory program, and may be entered in one of three ways: (1) it may be invoked through the accessory menu of the comm program COM-AND, (2) CCHESS may be loaded itself (in which case it will need to be able to load COM-AND) and (3) it may be loaded 'piggyback' (intended for use with the DOS gateway of other communications programs. Each method is useful and will be discussed separately. A. Loading through COM-AND COM-AND is invoked at the DOS prompt with the command: ------------------------------------------------------ "d>" COM-AND <options> Where "d>" is the DOS prompt, and <options> is (<parm> (<parm> ...)) where <parm> is either a switch or a parameter Refer to Appendix A of the COM-AND document for a discussion of switches and parameters. ------------------------------------------------------ Once COM-AND has been loaded, the usual sequence would be to dial a network service using COM-AND's dialing directory or script language. When connection has been established, logon achieved, and a conference area entered, then CCHESS may be selected using the F1 Accessories menu. COM-AND defines an 'accessory' as: o A name which is displayed in the menu (as you like) o A subdirectory for use during the accessory (optional) o A script file to be performed (optional) o A program to be loaded - along with parameters (optional) COM-AND was supplied with several accessory menu entries set to load CCHESS, to serve as an example. Once loaded, CCHESS is an independent program, using the comm link established by COM-AND, and also many of the COM-AND functions. CCHESS is 'integrated' into COM-AND. Note that settings (echo/blank line suppression/logging etc) made in COM-AND carry over to the accessory when it is loaded, and settings made in the accessory carry over to COM-AND when the accessory terminates. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 3 II. Running the program (continued) B. Loading CCHESS directly CCHESS may be invoked at the DOS prompt with the command: ------------------------------------------------------ "d>" CCHESS <options> Where "d>" is the DOS prompt, and <options> is (<parm> (<parm> ...)) where <parm> is either a switch or a parameter Refer to Appendix A of this document for a full description of switches and parameters. ------------------------------------------------------ When CCHESS is run from the DOS prompt without the '/P' switch, it looks for the COM-AND program on the current subdirectory (or in the subdirectory indicated by a 'COM-AND=' environment variable). CCHESS will not run (without the '/P' switch) unless it can find COM-AND. CCHESS loads COM-AND and execution proceeds on the CRT (COM-AND side) of the program. Again, the usual sequence would be to dial a network service using COM-AND's dialing directory or script language. When connection has been established, logon achieved, and a conference area entered, then CCHESS may be invoked using the F1 key. Loaded this way, the F1 key simply serves to switch between the two sides of the program (CCHESS and COM-AND). No menu of additional accessories is available. All other features of COM-AND are available, however. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 4 II. Running the program (continued) C. Loading CCHESS Piggyback CCHESS may be run piggyback as follows: ------------------------------------------------------ "d>" CCHESS /P COMx <speed> <other options> where COMx = COM1, COM2, COM3 or COM4 and <speed> = 300, 1200, 2400, 4800, 9600 Refer to Appendix A of this document for a full description of other options. ------------------------------------------------------ For example: C> CCHESS /P COM1 2400 Used in this manner, CCHESS 'picks-up' a comm line already opened and in use by another program. The 'COMx' and '<speed>' parameters are not strictly necessary; however, their use is recommended unless you ALWAYS use the same comm port and line- speed on all systems where ever you go. Note that Alt-X terminates CCHESS and simply returns you to DOS when CCHESS is loaded piggyback. Alt-X terminates both CCHESS and COM-AND when the program set is run without /P. Once back at the DOS prompt, you must return to the comm program you originally gatewayed - type 'EXIT' at the DOS prompt if your gateway was originally to COMMAND.COM. Refer to the documenta- tion provided with your comm program on the appropriate means of returning from a gateway. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 5 III. CCHESS Display When the screen is placed into graphic mode, the screen is divided into several areas. The top line carries the program version and release number, and the Main menu. To the left of the screen is a graphic representation of a chessboard. On the right is a scrolling region of eight lines for text and a history of the game (if one is currently in progress). Initially the board is displayed from the point of view of the player of the white pieces, with all pieces in their starting position. You may setup a particular position with the 'Setup' pulldown. To begin a game you must have an opponent waiting. You select 'Start Game' on the Commands pulldown. You will be queried for board position and other details. You will be asked to identify the ID of your opponent. Your CCHESS program and your opponent's then talk to each other, agreeing over the particulars. Your opponent will be given a chance to refuse the set-up as you have it. If your opponent accepts the setup, the game begins. In conversation, when a speaker is identified (through the ID or handle - see following) to be your opponent, moves are parsed from received lines of text. Moves and game commands are displayed as they happen on-line. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 6 IV. Services supported CCHESS is encoded to work with several network services and multi- user systems. CCHESS parses every incoming line for an ID. CCHESS's parser is 'automatic', in that you don't have to tell it which system to parse. The ID (or handle) parse begins after a carriage return from the network. When the ID of your opponent is identified, chess commands are parsed. The text is displayed if no command is parsed. If no ID is identified the text is displayed. Blank lines (extra carriage returns issued by the network) are not displayed by CCHESS because of the limited text area (7 lines on a CGA). CCHESS internal commands (such as moves) exchanged amongst opponents are not displayed as text of a conversation. CCHESS does not know if a text line is empty or not until the entire line is received. CCHESS erases an empty text line (visible as an ID followed by no text or followed by just a CCHESS command) and reuses the line when end-of-line (carriage return) is received. The CCHESS parser is only designed to deal with text issued within the conversational area of one of the systems. The parser is self-adjusting ... all of the supported formats will be taken as conversation. [The automatic nature of the parser DOES produce some false hits now and then. These do not interfere with CCHESS at all in normal usage.] The graphic side is not altogether appropriate for other uses, such as reading your mail. For other uses, switch to the alpha side (F1 if you used COM-AND). The following pages describe templates for IDs and handles as dis- played on various systems (handles are assumed names which replace or add to an ID). I have also included some notes on each system and its use with CCHESS. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 7 IV. Services supported (continued) A. PLINK IDs and handles: "(" <ID> ") " an initial "*" identifies handles Example: (TARTAN) This is how a line would look on PLINK PLINK does not report (to all in conference) when a customer exits. CCHESS is best used with echo off (the system doesn't echo what you type). You turn echo off with the command /NOECHO. The key- board buffer (controls pull-down) allows you to see your typing locally if you need. B. GEnie IDs and handles: "<" [Handle] <ID> "> " Example: <[Scott] TARTAN> This is how a line would look on GEnie GEnie reports to all present the exit or termination of another customer. CCHESS Version 1.2 does not use the report. CCHESS is best used with echo off (the system doesn't echo what you type). GEnie does not normally echo entered characters. If you are echoing characters locally (alt-E) turn it off. Use the keyboard buffer to see your typing. C. SOURCE IDs and aliases: <ID/alias> ": " -or- [nn] <ID/alias> ": " Example: [22] TARTAN: This is how a line would look on SOURCE The SOURCE reports to all attending the exit or termination of another customer. CCHESS Version 1.2 does not use the report. CCHESS is best used with echo off (the system doesn't echo what you type). The SOURCE allows you to turn off echo by exiting the SIG (entering command mode), setting half duplex (-> TERM -HALF) and re-entering the SIG. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 8 IV. Services supported (continued) D. CIS handles: "(" <Band> , <ID> ") " where <Band> ::= (A!B)(N!NN)"," Example: (A1,TARTAN) This is how a line would look on CIS CIS does not report (to all in conference) when a customer exits. CCHESS is best used with echo off (the system doesn't echo what you type). You turn echo off with the command /NOECHO. The key- board buffer (controls pull-down) allows you to see your typing locally if you need. E. Delphi IDs and handles: <ID> "> " where an initial "." identifies handles Example: TARTAN> This is how a line would look on Delphi Delphi does not report (to all in conference) when a customer exits. CCHESS is best used with echo off (the system doesn't echo what you type). I recommend requesting help from an experienced Delphi user to do this. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 9 IV. Services supported (continued) F. TBBS IDs: "(" <node> ":" <ID> ") " Example: (9: Scott McGinnis) This is how tbbs looks TBBS does not report (to all in conference) when a customer exits. TBBS is still new to me; TBBS BBS's are multiuser (up to 16 lines to a BBS), and provide a very comfortable conferencing facility. I haven't discovered yet how to turn local echo off. CCHESS is best used with echo off - if there is no such facility, I am sure one will be added, just to keep the reading easy. G. PROTOCALL IDs and handles: "<" nn.nn <ID> ">" Example: <04.21 TARTAN> This is how PROTOCALL looks PROTOCALL reports to all attending the exit or termination of another customer and various materializations and dematerializ- ations. CCHESS Version 1.2 does not use the report. CCHESS is best used with echo off (the system doesn't echo what you type). You toggle echo off with the command /ECHO. The key- board buffer (controls pull-down) allows you to see your typing locally if you need. I fully realize PROTOCALL is no more. But the parser still parses its format. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 10 V. CCHESS Commands using COM-AND When CCHESS is loaded with COM-AND the following Alt'd keys are available: F1 Switch between text (CRT) and graphic modes. The switch is not allowed if a game is in progress. F10 Help screen. All currently implemented commands are summarized on this screen. Any command may be executed directly while this screen is displayed. Alt-F10 DOS Gateway. If there is sufficient memory available, and if the environment variable "COMSPEC" identifies a valid .COM or .EXE file, CCHESS will load the program and execute it. This normally is used to load a second copy of COMMAND.COM for full access to DOS while a communication session is in progress. Ctl-End Send a Break. This sends a true 'break' signal. Alt-B Redisplay (backscreen). The speed of the display may be controlled using Cntl-PgDn (slower) or Cntl-PgUp (faster). Alt-C Clear the screen. Alt-D Dialing directory. The Dialing directory and file is identical to that used by Procomm (version 2.x), to allow files to be shared between the two programs. Alt-E Toggle echo (full/half duplex). This function is also invoked through the dialing directory (echo on). Alt-F File directory. A mask is required - just as DOS DIR command. Alt-G Toggle blank line suppression. CCHESS will suppress blank lines on the CRT side if you wish. This can be made a program default through the Alt-O options menu. Alt-H Hang-up. Hang-up the phone. Alt-I Program information. Author information. Propaganda. Alt-L Toggle CGA/EGA modes (if you have an EGA). Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 11 V. CCHESS Commands using COM-AND (continued) Alt-M Define a macro for Alt-0 through Alt-9. The Macro defin- ition file is identical to that used by Procomm (version 2.x), allowing Macros to be shared between the two. Note: Although this menu can be used from either COM-AND or accessory, macros are defined through COM-AND and changes will be made on the COM-AND side. Alt-O Options. Set controlling flags for COM-AND. Note: Although this menu can be used from either COM-AND or accessory, it really only effects COM-AND settings. Alt-P Comm Parameters. Set baud rate, parity, number of data and stop bits for use when COM-AND is initially loaded. These settings are overridden by run-time switches. Whatever the current setting, the dialing directory overrides when it is used. Note: Although this menu can be used from either COM-AND or accessory, it really only effects COM-AND settings. Each accessory has an Alt-P function as well accessible only when the accessory is loaded with the '/P' switch. Alt-R Redial the last number dialed. The program will redial the last number dialed number until the function is terminated (with ESC), or connection is made. Alt-S Setup. Define initial program values, such as Modem initial- ization, the Modem Hangup sequence, and file names. Note: Although this menu can be used from either COM-AND or accessory, it really only effects COM-AND settings. Each accessory has an Alt-S function as well which may or may not be accessible when COM-AND is loaded. Alt-T Elapsed time. The time the program was loaded, and the time the last call (Alt-C or Alt-R) was placed are displayed. The elapsed time since the latest time is also displayed. Alt-X Exit the program. The program may or may not hangup the phone, depending on the modem. Note: COM-AND is also terminated, no matter how you loaded CCHESS and COM-AND. Alt-Z Toggle parity mask. The high bit mask is used only for text received and displayed - it has no effect on XMODEM transfers. Alt-0/9 Send a Macro. A string of characters defined through the Alt-M command described above is transmitted. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 12 VI. CCHESS Commands Standalone When CCHESS is loaded standalone (piggyback, /P) only the following Alt'd keys are active: Alt-C Screen Clear. Clear the text area. Alt-L Toggle CGA/EGA modes (if you have an EGA). Alt-S Setup. This menu allows setting a defaults used by CCHESS. It is also available through the 'Controls' pull-down. Alt-P Set Comm Parms. This menu provides a way to change default communications parameters used by CCHESS ONLY when it is run piggyback. It is therefore only available when CCHESS is run piggyback. Alt-X Exit the program. In this case (piggyback) only CCHESS is terminated. You are returned to DOS. When used in this manner, the pull-down menues are still available, of course. Transcripting is the only function obtained through a pull-down that is inhibited when CCHESS is run piggyback. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 13 VII. CCHESS Main Menu On the top line of the display in CCHESS there is a menu of key- words. A keyword is selected (with the cursor keys or a mouse), and a submenu pulled-down (with the return or right mouse button). Submenu items are selected (again, with the cursor keys or a mouse), and executed (with the return, space bar, or left mouse button). Top-line menu items are selected with the Cursor right/left keys or right and left motion with the mouse. When the cursor key is depressed, the next menu item (in a circular manner) is highlighted. The highlighted keyword is 'selected'. A submenu is pulled-down with the Cursor-down key (or End, or PgDn, or the left mouse button). A submenu item is selected from a pull-down when it is highlighted by pressing the Cursor-down/up keys keys repetitively. When the Cursor key is depressed, the next submenu item (again in a circular manner) is highlighted. The highlighted keyword is 'selected'. A selected submenu item is executed with a Carriage Return. That's the key with the silly arrow. When a submenu item is executed, the pull-down is released (it goes back up?). Hitting the Space-bar or the left mouse button will also execute the selected item. A pull-down is released without executing any item with any of the following keys: ESC, Home, PgUp, or right mouse button. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 14 VII. CCHESS Main Menu (continued) A. Controls The 'Controls' pulldown allows you to select certain control functions. Controls are: . The board legend may be turned on and off . The board may be viewed from either Black's or White's side . You may playback (and view) a saved conference (this does not play a game). . Transcripting may be turned on and off (if you loaded CCHESS with COM-AND). . Turn keyboard display on and off. . Turn transcript hold on and off. . Invoke CCHESS's Setup menu (Alt-S invokes COM-AND's Setup menu if COM-AND is loaded). B. Commands The 'Commands' pulldown allows you to issue commands to start and end games, and issue commands during your turn: . Wait for a certain opponent (who will 'start'). . Start a game (when you have an opponent): .. Start a new game .. Restart from a saved position .. Start a game, setting pieces by hand . Save the current game and terminate the current game in progress (only during turn). . Resign the current game in progress (during turn). . Offer your opponent a draw (during turn). . Reject the last move transmitted (during turn). . Resend the last move (in case it got lost). . Switch to CRT mode (even if game is in progress; (if a game is on, it will be terminated). C. Setup The 'Setup' pulldown allows you to setup board pieces: . Reset the board to its initial state. . Manually place individual pieces. . Save the current position. . Restore a saved position. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 15 VIII. Beginning a Game Conceptually, the hardest part of CCHESS to visualize (or to put into words) is the beginning of a game. The bullets below perhaps oversimplify the process, but make the process of beginning a chess game on-line clear (I hope). o You will need access to a network supported by CCHESS (PLINK, GEnie, SOURCE, TBBS, PROTOCALL, CIS or Delphi) and an ID on that network. o You will need to logon to the network of your choice and enter the/a conference area (a line, channel, room or what have you). o You will need to be on the graphics side (CCHESS). You will need to set-up the board (using the 'Setup' pulldown). o You will need to have an opponent present in the same line/channel/room. Your opponent will need the CCHESS program as well, or a well developed visual imagination, and accurate typing skills (not recommended). o Your opponent will need to select 'Await opponent' from the 'Controls' pulldown. Your opponent must specify your ID (or handle or alias) as you will have it for the game. [Note: you cannot change your ID/handle during the game.] o You then select 'Start Game' from the 'Controls' pulldown. You will be queried as to: . The board - is it setup correctly? . Are you going to play White or Black? . What is the ID of your opponent? o At this point, you will see a notice telling you that the two programs (yours and your opponent's) are talking. Your opponent will be shown the board, and be asked to accept the game. o If your opponent accepts the board as shown, the game is on, and whoever plays White will be prompted for a move. If your opponent rejects the board, you will be informed, and have another chance to setup the board and 'Start game'. When all this has been accomplished (most of it should seem natural to those who spend much time on-line), the game is 'on', and the first player to move will be prompted for a move. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 16 VIII. Beginning a Game (continued) Moves are prompted in the lower right hand corner (of the CGA screen, and above the text area on a Hercules screen). A move is entered as "<from> <to>" using standard notation. For example: Our move: E2E4 would be King's pawn on 2 moved to King's Pawn on 4 for White, as White's first move. Turning on the board legend makes the standard notation easy to use (for those of us raised "P-K4"). When you are prompted for a move, you have a few other options as well as the obvious one of entering <from> <to> square designations. You can use the mouse to select the <from> and <to> squares, or you might enter one of the following: o-o Short castle o-o-o Long castle REJECT Refuse the last move DRAW Offer a draw SAVE SAVE the current position RESIGN Exit the game EXIT Terminate the game Esc Hit the escape key When you hit the 'escape' key, your cursor will re-appear in the scrolling text area and you may type to your opponent (or anybody listening/watching). When you enter a carriage return (or the Esc key again), you will be returned to the move prompt. You use the mouse to select <from> and <to> squares as follows: o Select the <from> square with the mouse. o Press the left mouse button to 'keep' that square. o Select the <to> square you wish with the mouse. o Press the left mouse button to 'keep' that square and send the move to your opponent. Backspace will erase your entry (entered through the keyboard or the mouse). When you type a carriage return (or a second left mouse button if you're using one), your move is verified and sent to your opponent. [Note: CCHESS does not verify moves per se (it does not help you play a better game, or avoid errors). CCHESS only verifies that there is a piece of your color on the <from> square.] Should line noise, or the inadvertent loss of your opponent (for example due to 'call waiting') interfere with the exchange of moves, you may resend your last move with the 'Commands' pulldown. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 17 IX. Game in progress Once the game has started, CCHESS supports the play by alternating move prompts, first white then black, and so on. There are a few limitations imposed by CCHESS when a game is in progress. o You cannot switch to the CRT side (COM-AND) without terminating the current game in progress. While a game is in progress, the F1 key is inhibited. o Should you encounter a program bug, or an emergency need to switch to the CRT side, you may do so. The 'Commands' pulldown allows a switch to CRT side - however, it will terminate any current game in progress. o You can playback received text (if you loaded CCHESS with COM-AND) with Alt-B only when it is not your turn. You will see transmitted and received CCHESS commands in the playback, but CCHESS does not act upon them. o Should your opponent loose a move (due to line noise or what have you), you may resend your last move using the 'Commands' pulldown. Select 'Resend move'. o You may reject your opponent's last move. You may type the command 'REJECT' at your move prompt, or you may select 'Reject move' from the 'Controls' pulldown. However, no more than one move may be rejected at a time... you may not reject the move prior to your opponent's REJECT. o Certain commands (EXIT/DRAW/RESIGN/REJECT) may only be performed during your 'turn'. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 18 X. Saving and Restoring a Game You may save a game in progress at any time using the 'SAVE' command entered at the move prompt (as described above), or the 'Save' option of the 'Setup' pull-down, or the 'Save and exit' option of the 'Commands' pulldown. All three methods save the current game (or board position if there isn't a game in progress) in a disk file. If there is a disk file of the name you select, it will be purged and the new position written over it. When a position is saved, the following items are recorded: o Timestamp of the save o The current board position o The current 'to move' value (if any) o The game history (if any) You may restore a saved position when no game is in progress, with the 'Restore position' option of the 'Setup' pulldown. When you restore a saved position, you will see the board as it was when the save file was taken. You will not see the 'to move' value unless you use the restored position to start a game ('START by hand'). You may also restore a saved position when you initiate a game. When you choose this option ('Restart saved game' of the 'Controls' pulldown), the game as it was when the save took place is restored. You will see the move log as it was when the save was taken (your opponent will not, of course). You may select either color to play from this point. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 19 XI. Ending a Game CCHESS offers several options for terminating a game in progress. Please note that when a game is terminated, CCHESS does not terminate. You may start a new game, switch to the CRT side (if you loaded CCHESS with COM-AND), or just sit and puzzle. Game termination refers only to CCHESS's tracking/display of a game. A. Draw You may offer your opponent a draw only on your turn. When you offer a draw, your opponent will be queried for accept- ance. If you opponent accepts the offer, the game is done. If your opponent rejects the offer the game must continue. B. Save and Exit You may save the current position and exit the game at any time. When you execute this option, your opponent will be informed of the fact, and your opponent's game terminated as well. C. Resign You may resign a game in progress when it is your move. Your game is terminated, as is your opponent's. You may save a game position after you have ended a game. This allows you to save a game for later restart when 'call waiting' knocks your opponent off-line. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 20 XII. Program Configuration (Alt-S, and Alt-P) A. Setup Screen (Alt-S) 1. Files . Default Save file When you save a position, you will be asked for a file name. The file name specified here is used if you enter a blank save file name to this query. . Default Log This file name will be used when you request transcripting and enter a blank in response to the log file name query. 2. Timings and Values . Millisecond loop The millisecond loop value gives the number of LOOP instruc- tions required to wait for one millisecond. This type of timing function is used in CCHESS in several places: 1) to to pace displays such as playback, and 2) for tone generation. 260 is suggested for 4.77 Mhz clocks. 432 is recommended for 8Mhz clocks. CCHESS will attempt to calculate the correct value if you set it smaller than 10. . Break delay As noted above, the break delay is controlled through the Millisecond loop value. This value "break delay" specifies the number of "milliseconds" the comm line is held when a break is issued (Cntl-END). . Text Lines You may set the size of the scrolling region for text. Dedicated gamers will want less text, and more game history. Buffs will want more talk and less game... Note that this doesn't take effect until the next use of CCHESS. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 21 XII. Program Configuration (continued) A. Setup Screen (Alt-S) (continued) 3. Flags . Initial advert Turn off the advert after you've seen it. Just before you register... This only effects standalone usage. . Exit Query Some people disdain the query "do you really and truly mean it" when they type Alt-X. Some feel it mandatory. CCHESS is distributed with exit query disabled. You may enable it, if you're so inclined. This only effects standalone usage. 4. Save You may change values for one execution of CCHESS, or you may change them for all subsequent executions of CCHESS. If you save values, the values you've saved will be used the next time you run CCHESS. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 22 XII. Program Configuration (continued) B. Communications Parameters (Alt-P) 1. Rate + Parity + Data bits + Stop Bits Baud rate, parity, number of data bits and number of stop bits are specified in combination through the first 10 selections on the Alt-P window. These selections are the only way you may specify baud rate. Other parameters (parity, data bits, and stop bits) may be set individually (below). Do not change the current setting after you've connected to a service. Make your setting here before you use CCHESS on-line. 2. Parity, Data bits and Stop bits Individual settings for parity, number of data bits and number of stop bits comprise the next 7 items of this menu. You also set these values when you create a dialing directory entry. Again - do not change the current setting after you've connected to a service. The settings on this screen are effective only when CCHESS is run standalone. Changing a setting here could disconnect you. 3. COM ports The last four items on this menu are the candidates for COM ports. Select the appropriate port for your modem. This item is usually selected once, and then left alone. 4. Save You save the current settings for the next execution of CCHESS through the "Save" selection. Settings are saved to disk. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 23 XIII. Program Requirements This program can only function on an IBM PC or DOS compatible machine. CCHESS does direct to screen buffer fetches and stores; so compatibility is an important issue. CCHESS supports CGA and Hercules. CCHESS uses a Microsoft Mouse if one is available (not well, but it'll certainly get better). CCHESS disk I/O is done through the 'Handle' oriented I/O routines added to DOS 2.0. Therefore DOS 2.0 is a minimum requirement. CCHESS (Version 1.2) requires 95K for itself. So you need 192. To take advantage of the DOS Gateway (use another comm program) or to use COM-AND, you'll need 384K. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 24 XIV. Program and Author Information This program was written using Microsoft Macro-Assembler. The author likes assembler. Assembly language is an entirely appro- priate vehicle for some of the program, and a not-inappropriate vehicle for the rest of it. Everything, in moderation... The author of this program is R. Scott McGinnis of Chicago, Illinois. PLINK and GEnie ID: TARTAN. Comment and suggestions (and criticism in moderation) are welcomed: CABER Software R. (Scott) McGinnis P.O. Box 3607 Mdse Mart Chicago, IL 60654-0607 For this program, I wish to thank my wife Elizabeth. She supported me whole-heartedly in this effort. Without her belief in me I'd probably be prospecting somewhere in the desert, talking to mules. This program (Version 1.2) may be distributed freely with the caveat that the Author information displayed at program termination is not removed. If the program is found entertaining or useful, a regis- tration of $50.00 is requested. Should response warrant it, I will continue to develop and support this product. Most of the hardware names and software names in this document are trademarks or trade names of specific manufacturers. Version 1.2: 880705 CCHESS: IBM PC Conference Chess Page 25 A. Switches and parameters Program Switches: /C 'CGA only': You may specify a CGA display only with this switch. EGA and Hercules displays are inhibited. The default for CCHESS is to automatically adjust to Hercules or CGA. /G 'Force Hercules': You may force Hercules mode even if PC-VCO doesn't think you have a Hercules board. However - use this switch cautiously. /H 'Hercules': You may specify a Hercules admissible with this switch. This is the default. /E 'EGA': CCHESS ignores the availablility of an EGA adaptor unless you use this switch (EGA may be toggled within CCHESS with Alt-L). CCHESS does not display a 'square' chess board with EGA, but EGA does give considerably more room for text. /P 'Piggyback': CCHESS will open the COM port in such a manner as to retain another program's already opened line. When CCHESS is exited, the previous state is restored. This is for use with other communications programs having a DOS Gateway (e.g. PROCOMM). /X 'Debug mode': This switch enables certain resident debugging keys. I do not recommend you use it. I document it only for the VERY curious. Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 26 A. Switches and Parameters (continued) Program parameters: COM1 CCHESS uses the COM1 port COM2 CCHESS uses the COM2 port COM3 CCHESS uses the COM3 port COM4 CCHESS uses the COM4 port 300 CCHESS uses port at 300 baud 1200 CCHESS uses port at 1200 baud 2400 CCHESS uses port at 2400 baud 4800 CCHESS uses port at 4800 baud 9600 CCHESS uses port at 9600 baud EVEN CCHESS uses port with even parity ODD CCHESS uses port with odd parity NONE CCHESS uses port with no parity DATA7 CCHESS transmits/receives 7 data bits DATA8 CCHESS transmits/receives 8 data bits STOP1 CCHESS uses and expects 1 stop bit STOP2 CCHESS uses and expects 2 stop bits Program switches require no delimiters. Parameters when contiguous must be preceded by a blank. For example: A> CCHESS 1200 Run the program for 1200 baud communications A> CCHESS /P1200 Piggyback, 1200 baud A> CCHESS /P 1200 Piggyback, 1200 baud Program defaults are: A> CCHESS COM2 300 EVEN DATA7 STOP1 Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 27 B. Files Program files: CCHESS expects the following files on the default drive (and subdirectory) CCHESS.DFT Parameter save area (Alt-S and Alt-P) CCHESS will create this file if it is not found. CCHESS will auto- matically update the .DFT file if the program version number is different from the .DFT file version number. When CCHESS is loaded, the old file format will be loaded. A new file will then be created to replace the old file. When a new major (e.g. 1.0, 1.0, ...) is released or when you move CCHESS from one machine to another the previous .DFT file probably should be purged (and recreated by CCHESS). CCHESS also uses (if available) the following files: CCHESS.SAV Default save position file CCHESS.LOG Default log file name Each of these file names may be changed through the ALT-S (Setup) Menu. CCHESS currently implements the rule for file names: If the given file name carries a drive spec (i.e. C:) or path (sub- directory), the name is taken 'as is'. If neither condition holds, the default drive and subdirectory are added to the file name. Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 28 C. Messages Only for the technically inclined, I've included here the actual messages CCHESS issues. These messages are ASCII, and when received are expected to be prefaced by a parsable ID or handle. AWAIT opponent: Transmitted when game is set to 'await opponent'. CHESS: WAITING =-----+------= ! +----------------------> 15 bytes, literal ascii START Game: Transmitted by initiator of a game. The receiver must be 'awaiting opponent'. The transmitter awaits either (1) ACCEPT or (2) REJECT messages from the receiver. CHESS: START xyz<board><chksum> =-----+----=-+++=--+--==--+---= ! !!! ! ! ! !!! ! +----> 2 byte checksum, bin-ascii ! !!! ! ! !!! +-----------> 64 byte board, bin-ascii ! !!! ! !!+--------------> 1 byte: Value 1/2 Unused ! !! ! !+---------------> 1 byte: Value 1/2 We are B/W ! ! ! +----------------> 1 byte: Value 1/2 Who first ! +-----------------------> 13 bytes; literal ASCII ACCEPT game: Transmitted by receiver to initiator to accept START. CHESS: GAME =----+----= ! +----------------------> 12 bytes, literal ascii REJECT game: Transmitted by receiver to initiator to reject START. CHESS: REJECT =----+------= ! +----------------------> 14 bytes, literal ascii Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 29 C. Messages (continued) EXIT game: Transmitted by current player to signal abrupt terminate. CHESS: EXIT =----+----= ! +----------------------> 12 bytes, literal ascii RESIGN game: Transmitted by current player to resign game. CHESS: RESIGN =----+------= ! +----------------------> 14 bytes, literal ascii DRAW game: Transmitted by current player to offer a draw. This message will be acknowledged by (1) OKDRAW or (2) NODRAW CHESS: DRAW =----+----= ! +----------------------> 12 bytes, literal ascii OKDRAW: Transmitted in response to DRAW message to accept CHESS: OKDRAW =----+------= ! +----------------------> 14 bytes, literal ascii NODRAW: Transmitted in response to DRAW message to reject CHESS: NODRAW =----+------= ! +----------------------> 14 bytes, literal ascii Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 30 C. Messages (continued) MOVE command: Transmitted by current player to indicate move. This message rejected ad hoc by REJECT MOVE CHESS: MOVE xxyy =-----+---=-=+=+ ! ! ! ! ! +-------------> 'to' square, <alpha><numeric> ! ! ! +---------------> 'from' square, <alpha><numeric> ! +----------------------> 12 bytes, literal ascii REJECT move: Transmitted during turn after 1st move CHESS: REJECT =----+------= ! +----------------------> 14 bytes, literal ascii Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 31 D. Save file structure: 0 1 2 3 4 5 6 7 8 +-----+-----+-----+-----+-----+-----+-----+-----+---// ! 'C' ! 'C' ! 'H' ! 'E' ! 'S' ! 'S' ! <ver-rev> ! ... +-----+-----+-----+-----+-----+-----+-----+-----+---// 8 9 10 11 12 13 14 ... 18 //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---// ! mm ! '/' ! dd ! '/' ! yyyy ! ' ' ! ... //--+-----+-----+-----+-----+-----+-----+----/ /----+-----+---// 18 19 20 21 22 23 24 25 26 //--+-----+-----+-----+-----+-----+-----+-----+-----+---// ! hh ! ':' ! mm ! ':' ! ss ! ... //--+-----+-----+-----+-----+-----+-----+-----+-----+---// 26 ... 76 //--+-----+-----+-----+----/ /----+-----+-----+-----+---// ! Col ! ToM ! 48 bytes reserved for future use ! ... //--+-----+-----+-----+----/ /----+-----+-----+-----+---// 76 78 80 202 204 //--+-----+-----+-----+-----+----/ /----+-----+------ ! Square 0 ! Square 1 ! ... ! Square 63 ! //--+-----+-----+-----+-----+----/ /----+-----+-----+ 204 206 208 ... //--+-----+-----+-----+-----+-----------+----/ /----- ! Log count ! White 1 ! Black 1 ! White 2 ... //--+-----+-----+-----+-----+-----------+----/ /----+ <Ver-rev> Binary, Version * 256 + Revision mm ASCII, Month number (01-12) dd ASCII, Day number (01-31) yyyy ASCII, Year hh ASCII, Hour number (00-23) mm ASCII, Minute number (00-59) ss ASCII, Second number (00-59) Col Color of saving player (0 = white) ToM Color of player to move (0 = white) Square <n> Binary, represents piece on square n White 1 Binary, <from square #> <to square #> Log count Binary, count of move log in bytes Version 1.2: 880705 Appendices CCHESS: IBM PC Conference Chess Page 32 E. Production release This version, 1.2, is not a beta release. Beta testing of CCHESS has proven it as a useful conference accessory. I thank Dave Thomas of the GEnie Laptop RT for making a place for beta testing of this program. This program will be extended ONLY if people downloading this and reviewing it find it of interest... interesting enough to use it and to report back to me difficulties and problems... and interesting enough to register. There are may be oversights and errors of omission in this program. As this is the third public release, I expect there'll be cosmetic requests as well as functional requests. Previous releases of CCHESS were labelled beta releases. This version is not. In the following weeks (months) I may address the following matters: o Coronation (Piece promotion) o REJECT more than one layer of moves o A protocol for move exchange (receiver ACK's each MOVE). o A chess clock. o Playback of a saved game. Each of these matters are areas I would appreciate other's opinions. For example, a protocol for move exchanges would ensure that moves are received by the opponent, and ensure you are informed of a lost move. However - what should be done at that point? Experience may show that no such protocol is required - or experience may leave some very frustrated gamers. The comments and criticisms I receive will be used to guide the development of the next version and further versions of this game. When I feel that the program is satisfactory (to its users), I'll go on to produce a version of CHECKERS and a version of BACKGAMMON for on-line use. Please address any comments and criticisms you have - and bug reports to the ID TARTAN on either the GEnie or PLINK systems. Version 1.2: 880705 Appendices