home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 7 Games / 07-Games.zip / pmics211.zip / manual.doc < prev    next >
Text File  |  1996-09-15  |  37KB  |  813 lines

  1. PMICS - The Internet Chess Client for OS/2 Warp
  2. Version 2.1.1      Released 15th September 1996
  3. Copyright (C)1996 Paul Mitchell/Mystic Software
  4.  
  5. USER MANUAL
  6. ------------------------------------------------------------------------------
  7.  
  8. See Also
  9. --------
  10. README        for final notes and information about this release
  11. HISTORY.DOC   for revision history
  12.  
  13.  
  14. Introduction
  15. ------------
  16. PMICS is a sophisticated interface for the numerous chess servers available on
  17. the internet. Using PMICS you can play chess, observe other games and chat to
  18. the inhabitants of these servers. PMICS is a native, 32-bit, multi-threaded
  19. application which makes full use of the incredible power of OS/2 Warp.
  20.  
  21. This file is a concise guide to using PMICS. It is a stopgap measure until
  22. the next release which will have a full on-line help capability. Please tell
  23. the author of any corrections or omissions.
  24.  
  25. For news, information and updates be sure to check out the web site dedicated
  26. to PMICS. The URL is http://www.tcom.co.uk/secondnature/pmics/
  27.  
  28.  
  29. System Requirements
  30. -------------------
  31. To run PMICS successfully, your system must have at least the following
  32. configuration...
  33.  
  34. o OS/2 Warp Version 3.0 or above (including Warp Connect and Merlin)
  35. o A TCP/IP connection to the internet, such as Internet Access Kit found
  36.   on the Warp BonusPak, or the TCP/IP support in Warp Connect
  37. o A mouse
  38. o A SuperVGA display with 256 or more colours
  39.  
  40.  
  41. Installation
  42. ------------
  43. Create a folder on your system and copy the file "pmics.exe" into it. You can
  44. then create a program object for PMICS in the usual fashion.
  45.  
  46.  
  47. Running PMICS
  48. -------------
  49. PMICS is normally run from a program object. You do not need to specify any
  50. command line parameters for normal use.
  51.  
  52. If you wish to automatically connect to a server when running PMICS, specify
  53. the tag name used to create the server in the configuration as the parameters
  54. in the program object. Using this feature, you can create multiple program
  55. objects each connecting to a different server.
  56.  
  57.  
  58. Quick Start
  59. -----------
  60. When you run PMICS, the main window appears. This consists of a main area
  61. with a scrollbar which displays text from a server. Above this is the main
  62. control toolbar. At the bottom of the window is the communication control
  63. area which contains two buttons and a command line.
  64.  
  65. You may run PMICS without an active internet connection, but your system
  66. should be connected to the internet before attempting to connect to a
  67. server. PMICS will not establish an internet link for you.
  68.  
  69. To connect to a server, click the "Login" button on the main toolbar. You
  70. will see a list of available servers appear. Select the server you wish to
  71. connect with and press the OK button.
  72.  
  73. You should see some messages appear in the text area. Normally you will see
  74. "Establishing connection with <server>" followed by "Connection established"
  75. and finally the welcome screen from the server.
  76.  
  77. PMICS should automatically log you in to the server. You are now ready to
  78. play, observe and chat!
  79.  
  80.  
  81. Observing Games
  82. ---------------
  83. You can easily observe other people's games using PMICS. First, locate the
  84. game (or games) you wish to observe. The player information window is
  85. useful for this since you can click on an active game then click the
  86. Observe button. You can also observe using server commands. Click the
  87. Games button on the main toolbar to list all the active games. Locate the
  88. game you are interested in, type 'obs <game number>' on the command line
  89. then press Enter.
  90.  
  91. If all went well, the game board will appear on the screen. See the section
  92. on game windows below for more information.
  93.  
  94.  
  95. Playing Games
  96. -------------
  97. Playing chess is equally simple with PMICS. There are two ways to do this -
  98. you can challenge another player, or accept a challenge from someone. You
  99. will only be able to receive challenges from others if you are 'open'. The
  100. Open button on the main toolbar will change your open status.
  101.  
  102. When someone challenges you to a match, a dialog will appear (with an
  103. appropriate sound if you have set this up). You can review the game
  104. parameters (time controls, game type) in this dialog then choose to accept,
  105. decline or ignore the challenge. If you accept, a game window will appear.
  106.  
  107. To challenge someone else to a match, you must first locate your "victim".
  108. Again, the player information window is useful here. Click on a player who
  109. is not currently involved in a game then click the Finger button. This will
  110. display information about that person including ratings and personal notes.
  111. When you have decided whom you would like to challenge, select that player
  112. then click the Challenge button. A dialog will appear allowing you to set
  113. the game parameters. Click the Issue button to send the challenge. If your
  114. chosen opponent accepts, the game window will appear.
  115.  
  116. See the section on game windows below for more information.
  117.  
  118.  
  119. Talking
  120. -------
  121. Chess servers are like clubs. You can sit back and listen to people talking,
  122. hold private conversations and make a complete nuisance of yourself (which
  123. is not recommended). There are several server commands which allow you to
  124. talk, depending on who and how many players you wish to address. PMICS also
  125. has a sophisticated windowing system which allows you to separate different
  126. kinds of chat into their own custom windows.
  127.  
  128. The main server commands for talking are listed below. Although it is better to
  129. use the PMICS talk windows, these can be typed on the command line to send
  130. one-off messages.
  131.  
  132. 'tell <user> <message>'
  133.    This sends a message to the named user. It will appear on their screen as
  134.    '<your name> tells you: <message>'. This type of conversation is private
  135.    and the user you address must be logged into the server.
  136.    
  137. 'tell <channel number> <message>'
  138.    The servers have channels, much like CB radio, dedicated to specific
  139.    topics. This form of tell sends a message to all users who are listening
  140.    to the channel. It will appear on their screens as
  141.    '<your name>(<number>): <message>'. A help file on the server called
  142.    'channel_list' contains the topics for each channel. If you require help
  143.    regarding the server, this is generally the topic of channel 1.
  144.    
  145. 'shout <message>'
  146.    This command sends a message to all users who are listening to shouts. It
  147.    appears on their screen as '<your name> shouts: <message>'. Most servers
  148.    limit the number of shouts you can send in a specific time period.
  149.    
  150. 'it <message>'
  151.    This is a derivative of the shout command. The difference is that your
  152.    message appears in the form '--> <your name> <message>'.
  153.    
  154. 'cshout <message>'
  155.    Another derivative of shout, this should be used only for topics related
  156.    to chess.
  157.    
  158. 'kib <message>'
  159.    Kibitz. If you are observing or playing a game, this command will send a
  160.    message to all the observers of the game *and* the players. This can be
  161.    very distracting to the players, so only use it if you are sure you are
  162.    allowed. If it's your own game, do as you wish.
  163.    
  164. 'whisper <message>'
  165.    This is similar to kibitzing except that the message goes only to the
  166.    observers and not to the players.
  167.  
  168.  
  169. A General Note About PMICS Windows
  170. ----------------------------------
  171. All the main windows in PMICS - including player information, game and talk
  172. windows - exhibit the same general characteristics. Their size and position
  173. is stored. You can change colours and fonts by dragging from the OS/2 colour
  174. and font palettes. In the main and talk windows, the displayed text will
  175. automatically wrap to the width of the window.
  176.  
  177. Experiment with them! Set the colours, fonts and positions just the way you
  178. like them. PMICS will remember.
  179.  
  180.  
  181. The Main Window
  182. ---------------
  183. The main PMICS window is where you control server activities, and where all
  184. server output is displayed (if not handled by a talk window - see later). It
  185. is the only window from which you should send server commands.
  186.  
  187. The main toolbar is the primary means of controlling PMICS. The buttons which
  188. appear depend on whether you are connected to a server or not. The following
  189. list describes each button and its use.
  190.  
  191. 'Settings' (chess board and spanner)
  192.    Displays the main PMICS settings notebook. From here you can customise
  193.    PMICS, add new servers, change sounds, colours etc.. See the section on
  194.    'Configuring PMICS' for more details.
  195.    
  196. 'Login' (computer with blue screen border)
  197.    Establishes a connection to a server. You will be warned if you are already
  198.    connected since PMICS can only maintain one connection at a time. A list of
  199.    the servers you have set up will appear. Select the one you wish to connect
  200.    to and press OK. PMICS will establish the connection and log you in. If you
  201.    have not set a handle or password for the server, you will be prompted for
  202.    them.
  203.  
  204. 'Refresh' (chess board with paintbrush)
  205.    In rare cases, the PMICS game board can get out of synchronisation with the
  206.    server. Pressing this button will attempt a refresh of the board. (Note:
  207.    I have not seen this happen before, but I have supplied it in case).
  208.    
  209. 'Open' (chess board with traffic light)
  210.    Determines whether you will accept match requests. If you wish to accept
  211.    challenges, click the button so that it is depressed and the traffic light
  212.    is green. To stop receiving challenges, click the button so that it is
  213.    raised and the traffic light is red. The state of this button is changed
  214.    then you login to a server depending on your configuration.
  215.    
  216. 'Auto-flag' (clock with indicator light)
  217.    Determines whether the flag will be automatically called when your opponent
  218.    runs out of time. To switch it on, click the button so that it is depressed
  219.    and the light turns on. To disable autoflag, click the button so that it is
  220.    raised and the light goes off. If autoflag is disabled, you can still
  221.    manually call the flag by pressing the 'Flag' button on the game window
  222.    toolbar.
  223.    
  224. 'Games' (chess board with red question mark)
  225.    Pressing this button will ask the server to list all the games currently
  226.    in progress.
  227.    
  228. 'Observers' (binoculars)
  229.    Pressing this button will ask the server to list all games which are being
  230.    observed, and who is observing them. Useful for seeing which games are
  231.    interesting.
  232.    
  233. 'Who' (face with red question mark)
  234.    Pressing this button will ask the server to list all the players currently
  235.    connected.
  236.    
  237. At the bottom of the main window is the communication control area. This has
  238. two buttons and a command line. You may enter server commands on the command
  239. line. Every command line has a command history. Use the up and down cursor
  240. keys to retrieve prior commands you have sent.
  241.  
  242. If the main window is not current and you need to send a command, press the
  243. F2 key to immediately place the cursor on the main command line. After you
  244. have finished sending commands, press F2 again to return to the previous
  245. window.
  246.  
  247. The buttons on the main communication control area are as follows...
  248.  
  249. 'New Talk Window' (window with star)
  250.    Pops up a menu allowing you to create new talk windows and to pop-up any
  251.    other windows you have defined. Windows which are currently displayed
  252.    will have a check next to them. See the section on 'Talk Windows' for
  253.    more details.
  254.    
  255. 'Text Copy Mode' (pencil)
  256.    Depressing this button allows you to copy from the text area. A cursor
  257.    appears in the text. Use the mouse or keyboard to select the text you
  258.    wish to copy. Click the pencil button again to return to normal. When
  259.    copy text mode is active, the text window will not scroll as messages
  260.    arrive from the server, and you will not see any new messages until
  261.    you return to normal. This mode is useful for copying web page URLs
  262.    or updating your finger notes by copying text into the command line.
  263.  
  264. When you wish to disconnect from the server, enter the command 'quit'.
  265.  
  266. To see an information screen about PMICS, select the 'About...' option
  267. from the main window's system menu.
  268.  
  269.  
  270. Game Windows
  271. ------------
  272. Game windows appear when you play, observe or examine a game. You will see
  273. a chess board with a toolbar down the right side of the window. Status areas
  274. for the white and black players appear at the top and bottom of the board.
  275.  
  276. General
  277.    Each time a move is made, the squares changed by the move will be
  278.    highlighted. Use the main settings notebook to change the colour.
  279.    
  280.    You can change the square and piece colours by dragging from the OS/2
  281.    colour palettes. Dropping on any square will change all squares of that
  282.    colour. To change the piece colours, hold the Ctrl key and drop on either
  283.    a white or black piece. All the white or black pieces will change.
  284.    
  285.    Right-click on the board to display a pop-up menu. The options available
  286.    depend on whether you are playing, examining or observing. The following
  287.    options are always available...
  288.    
  289.    'Board->Flip'
  290.       Flips the board vertically, swapping the relative positions of white
  291.       and black.
  292.       
  293.    'Board->Label'
  294.       Switches the board labels on and off.
  295.       
  296.    'Board->Size'
  297.       Select the size of pieces you wish to use from the sub-menu.
  298.       
  299.    'Help->About...'
  300.       Displays an information screen about PMICS.
  301.  
  302.    You can configure PMICS to automatically display the partner board for any
  303.    bughouse games you play or observe.
  304.  
  305.    Pressing the F4 key will cycle between all the open game windows.
  306.       
  307. Player Status Areas
  308.    The status areas above and below the board display information about the
  309.    white and black players. In order, the information is - player name,
  310.    bughouse pieces in hand, last move made, current strength and a clock
  311.    showing the time left. The dark green background on the clock determines
  312.    the player to move. A red background on the clock means that it is
  313.    currently your move in a game you are playing.
  314.    
  315. Playing a game
  316.    To move a piece, click and hold down the left mouse button over the piece
  317.    you wish to move. Drag the pointer to the destination square. A line will
  318.    appear showing the move.
  319.    
  320.    You can change the promotion piece for pawns by using the pop-up menu and
  321.    selecting the 'Promotion Piece' submenu. The default is a queen.
  322.    
  323.    When you are playing a bughouse match, you can drop pieces from your hand
  324.    by right-clicking on the destination square and selecting a piece type from
  325.    the 'Bughouse drop' submenu.
  326.    
  327.    The following toolbar buttons appear when you are playing a game...
  328.    
  329.    'Accept' (green tick/check)
  330.       Accept an offer (such as draw, abort) from your opponent.
  331.       
  332.    'Decline' (red cross)
  333.       Decline an offer from your opponent.
  334.       
  335.    'Draw' (black and white hands shaking)
  336.       Issue a draw request to your opponent.
  337.       
  338.    'Flag' (red flag)
  339.       Manually call the flag (win on time). This only works if your opponent
  340.       is out of time.
  341.    
  342.    'Resign' (white flag)
  343.       Resign the game.
  344.       
  345.    'Moves' (blue feather pen on parchment)
  346.       Ask the server to list the moves so far. The move list will appear in
  347.       the main window.
  348.       
  349. Examining a game
  350.    Examining a game is similar to playing in that you can move pieces around.
  351.    You can also go back and forward through the moves list and set up the
  352.    pieces. The 'Board setup' submenu on the pop-up menu allows you to place
  353.    pieces on the board. Right-click when the pointer is over the square you
  354.    wish to change. You must have told the server to enter setup mode before
  355.    you can do this.
  356.    
  357.    The following toolbar buttons are available in examine mode...
  358.    
  359.    'Moves' (blue feather pen on parchment)
  360.       Ask the server to list the moves so far. The move list will appear in
  361.       the main window.
  362.  
  363.    'Start' (double arrow pointing left)
  364.       Return to the initial board position.
  365.       
  366.    'Backward' (single arrow pointing left)
  367.       Move back one move.
  368.       
  369.    'Forward' (single arrow pointing right)
  370.       Move forward one move.
  371.       
  372.    'End' (double arrow pointing right)
  373.       Go to the final board position.
  374.       
  375.    'Unexamine' (red cross on binoculars)
  376.       Stop examining the game and close the window.
  377.       
  378. Observing a game
  379.    The only options available when observing a game are the general pop-up
  380.    menu items together with the 'Moves' toolbar button and an 'Unobserve'
  381.    button which stops observing the game and closes the window.
  382.    
  383.  
  384. Player Information Window
  385. -------------------------
  386. Keeping track of who is connected to a server and what they are doing can be
  387. tricky. The Player Information Window can help by listing all connected users
  388. and the games they are playing.
  389.  
  390. The window begins gathering information as soon as you connect to a server.
  391. This means that the list of connected users may not be complete since it only
  392. displays the users who have logged in (or played games) since you arrived.
  393.  
  394. Each line on the list represents one user. The list is sorted in alphabetical
  395. order by user name. Each line may be in two formats; one for logged in and one
  396. for playing a game. For the first, the line will read '<user> is here.'. For
  397. the second, the line will be '<user> is playing <game type> game <number> vs.
  398. <opponent>. For example...
  399.  
  400.    DarkStar is playing rated blitz game 27 vs. MysticUK.
  401.    Friar is here.
  402.    MysticUK is playing rated blitz game 27 vs. DarkStar.
  403.    
  404. Note that both players in a game are listed. The list is updated approximately
  405. every 5 seconds.
  406.  
  407. Click a player on the list to select them. Hold down Ctrl and click to select
  408. multiple players.
  409.  
  410. The toolbar buttons allow you to control the Player Information Window. You
  411. may only press buttons which are relevant to the status of the selected
  412. player or players. The buttons are as follows...
  413.  
  414.    'Clear' (window with part missing)
  415.       Emptied the window and restarts the gathering of information.
  416.       
  417.    'Finger' (hand with pointing finger)
  418.       Asks the server to display rating and personal information about the
  419.       selected users.
  420.  
  421.    'History' (golden crown)
  422.       Asks the server to display the results of the last 10 games for the
  423.       selected users. Very useful when seeking an opponent.
  424.       
  425.    'Challenge' (gauntlet)
  426.       Issues a match challenge to all the selected players. The button will not
  427.       be available if any of the selected users are currently involved in a
  428.       game. You will be presented with a dialog allowing you to set the game
  429.       parameters. When these are set, press the Issue button.
  430.       
  431.    'Observe' (eye on chessboard)
  432.       Observes the selected games in progress. The button will not be available
  433.       unless all the selected users are involved in games. A game window will
  434.       appear for each separate observed game.
  435.       
  436.    'Talk' (mobile phone)
  437.       Opens a one-to-one talk window with each selected user. This button will
  438.       not be available if any of the selected users are involved in games. See
  439.       the section on Talk Windows for more information.
  440.       
  441.  
  442. Talk Windows
  443. ------------
  444. One of the most powerful features in PMICS is the ability to separate the
  445. messages sent by the server according to type. For example, you can create a
  446. window specifically for talking on channel 1, another for talking one-to-one
  447. with a friend and so on. Each talk window can receive as few or as many
  448. different message types as you wish. By default, new talk windows are
  449. temporary and are discarded when they are closed. This can be changed by
  450. marking the window as permanent so that PMICS will remember the settings for
  451. the next time you login.
  452.  
  453. To create a new talk window, click the 'New Talk Window' button on the main
  454. window. Select 'New Window...' from the pop-up menu.
  455.  
  456. Each talk window also has a dedicated toolbar and command line. The buttons
  457. available depend on how you have configured the window. Text entered on the
  458. command line is automatically sent to the destination you select without
  459. having to use the server commands such as 'tell' or 'shout'. This makes it
  460. possible to hold multiple, simultaneous conversations without confusion.
  461.  
  462. The following toolbar buttons are always available...
  463.  
  464. 'Talk Window Settings' (satellite dish with spanner)
  465.    Displays the settings for the current talk window. You can make changes to
  466.    the message types received here.
  467.    
  468. 'Text Copy Mode' (pencil)
  469.    Allows copying from the text received by the window. See the section about
  470.    the 'Main Window' for more details.
  471.    
  472. Buttons will appear after these depending on your settings. For example, if
  473. you create a window dedicated to one channel there is no need to display
  474. any buttons - only the command line is necessary. However, if you create a
  475. window for shouts and chess shouts, three buttons will appear allowing you
  476. to select the type of shout to be sent from the command line.
  477.  
  478. You can configure talk windows either directly or via the main settings
  479. notebook (on the second Hosts page). The settings dialog is the same for
  480. both except that the main settings notebook can change all the talk windows.
  481. The settings available are...
  482.  
  483. 'Title'
  484.    The text which will appear in the title bar of the talk window. You should
  485.    change this to something which represents the type of messages the window
  486.    will receive. For example, a window which listens to tells from channels 46
  487.    and 49 - used by the popular Tournament Director programs on FICS - could be
  488.    entitled "Tournament Channels".
  489.    
  490. 'Permanent'
  491.    When this is checked, PMICS will remember the settings for the window. Next
  492.    time you login, the same window will be available without having to be
  493.    recreated. When this button is unchecked, the window settings will be
  494.    discarded as soon as the talk window is closed. You can use this to delete
  495.    unwanted talk windows.
  496.    
  497. The 'Display Window' group is only available if you have also checked the
  498. 'Permanent' button. The controls in this group determine when the talk window
  499. will appear. There are three choices...
  500.  
  501. 'Manually'
  502.    If you select this choice, the talk window will never appear automatically.
  503.    To open a manual window, click the 'New Talk Window' button on the main
  504.    window and select the desired window title from the menu. A side-effect of
  505.    manually opened windows is that all server messages specifically handled by
  506.    a closed manual window will not be displayed at all. This can be useful for
  507.    reducing clutter in the main window, but can have undesired effects. For
  508.    example, if you create a window which accepts tells from a specific user,
  509.    set the window to manual then close the window, you will not see any tells
  510.    from that user - you are effectively ignoring them.
  511.    
  512. 'When needed'
  513.    When this choice is selected, PMICS will automatically open the window when
  514.    a message for it is received. You can open the window at any by following
  515.    the procedure for manual windows.
  516.    
  517. 'At login'
  518.    When this choice is selected, the talk window will appear as soon as you
  519.    login to the server. You may close the window at any time - this will cause
  520.    it to be treated like a 'When needed' window.
  521.    
  522. The 'Accept' group determines the type of messages received by the talk window.
  523. There are five lines each containing a check button and a text area. Checking
  524. a button will accept messages of that type. Names entered in the text areas
  525. will restrict the talk window to accepting messages only from the named users
  526. or channel numbers. When entering names in the text areas, leave a single space
  527. between each name. Names must also be typed exactly as they appear on the
  528. server i.e. case sensitive. For channels, type the number of each channel you
  529. wish to receive separated by spaces.
  530.  
  531. At the bottom of the 'Accept' group are the 'Tournament Director tells' and
  532. 'Notifications' check boxes. These are two special types of message which the
  533. server can send. The former is sent by automatic tournament programs such as
  534. mamer and tomato. The latter is sent when someone on your notify list (or
  535. someone who has you on their notify list) enters or leaves the server. You
  536. may select one talk window to accept either type of message.
  537.  
  538. Controls appear next to the command line depending on the type of messages you
  539. have asked to receive. These do not affect what is displayed in the window -
  540. they change the type of message automatically sent when you enter text on the
  541. command line.
  542.  
  543. 'Tell mode' (single person)
  544.    This button will appear if you have set the window to receive tells along
  545.    with any other type of message.
  546.    
  547.    A tell is a message sent to a single named user. Clicking this button will
  548.    set the command line to tell mode. In most cases, a spin field will appear
  549.    allowing you to select which user to address. If you have set a single user
  550.    for tells, the spinner is not needed and anything you type on the command
  551.    line will automatically be sent to that user.
  552.    
  553.    The contents of the spinner depend on the list of users you have selected
  554.    for tells. If you selected two or more users, you will be able to spin
  555.    between them. If you selected no users, the window will accept all tells
  556.    sent to you and will automatically insert into the spinner the name of each
  557.    user who sends you a tell. You can change the current name in the spinner
  558.    using the mouse or pressing Ctrl-Up and Ctrl-Down on the keyboard.
  559.    
  560.    If you have selected no specific users, you may also type the name of a
  561.    user into the name spinner. Once you have sent a tell, this name will be
  562.    added to the list.
  563.    
  564. 'Channel mode' (two people)
  565.    This button will appear if you have set the window to receive channel tells
  566.    along with any other type of message.
  567.    
  568.    A channel tell is sent to all users who are listening to a channel. Click
  569.    this button to set the command line to channel tell mode. A spinner will
  570.    appear in much the same way as normal tell mode, except that it will
  571.    contain the list of channels you set the window to receive.
  572.    
  573.    If you did not specify a list of channels, the spinner will contain all
  574.    channel numbers from 0 to 255. In this mode you may also type a channel
  575.    number directly into the spinner as well as using the spin buttons. The
  576.    Ctrl-Up and Ctrl-Down keys work for this also.
  577.    
  578. 'It shout mode' (--> symbol)
  579.    This button will appear if you have set the window to receive shouts.
  580.    
  581.    Sets the command line to it shout mode. An it shout is sent to all users
  582.    who are listening to shouts.
  583.    
  584. 'Shout mode' (lots of people)
  585.    This button will appear if you have set the window to receive shouts.
  586.    
  587.    Sets the command line to normal shout mode. A shout is sent to all users
  588.    who are listening to shouts.
  589.    
  590. 'Chess shout mode' (lots of people with a chess piece)
  591.    This button will appear if you have set the window to receive chess shouts
  592.    along with any other type of message.
  593.    
  594.    Sets the command line to chess shout mode. A chess shout is sent to all
  595.    users who are listening to chess shouts.
  596.    
  597. 'Kibitz mode' (Satellite dish and chessboard)
  598.    This button will appear if you have set the window to receive kibitzes.
  599.    
  600.    Sets the command line to kibitz mode. A kibitz is sent to all the users who
  601.    are observing a game along with the players of the game.
  602.    
  603. 'Whisper mode' (Satellite dish, chessboard and binoculars)
  604.    This button will appear if you have set the window to receive kibitzes.
  605.    
  606.    Sets the command line to whisper mode. A whisper is sent to all the users
  607.    who are observing a game but not the players of the game.
  608.  
  609.    Be very careful when using kibitz or whisper if you are observing multiple
  610.    games. The server can sometimes get confused about which game you wish to
  611.    address and your kibitzes may go to the wrong board!
  612.  
  613. Pressing F3 will cycle between all the open talk windows.
  614.  
  615. Regardless of how many talk windows you create, normal server messages (such
  616. as game lists, finger notes etc..) are always sent to the main window. Also,
  617. be very careful not to send server commands from a talk window - at best you
  618. will send the command to a single user. At worst, you'll shout the command to
  619. everyone on the server! Press the F2 key to quickly move to the main window
  620. command line, enter your command then press F2 again to return to the original
  621. talk window.
  622.  
  623.  
  624. Configuring PMICS
  625. -----------------
  626. PMICS can be customised quite extensively. You can modify virtually every
  627. aspect of the program's operation. This is done using the main settings
  628. notebook which is accessed by clicking the 'Settings' button on the main
  629. window toolbar.
  630.  
  631. The configuration has five main pages and one minor page.  All changes made to 
  632. the configuration take effect immediately - even if you are already connected 
  633. to a server.
  634.  
  635. Hosts Page
  636.    The Hosts page allows you to set up multiple chess servers.
  637.       
  638.    'Servers' list box
  639.       The tag names of all the currently defined servers appear here. Selecting
  640.       a server from the list updates all the other controls with the
  641.       appropriate settings.
  642.       
  643.    'New' button
  644.       Allows you to create a new server. Type a unique tag name into the dialog
  645.       which appear. It will be added to the list in alphabetic order.
  646.       
  647.    'Delete' button
  648.       Removes the currently selected server from the list. Be careful since you
  649.       cannot undo this action. You cannot delete if there is only one defined
  650.       server. You also cannot delete the current server if you are currently
  651.       connected.
  652.       
  653.    'Description' entry
  654.       Type the server description. This appears in the login dialog.
  655.       
  656.    'Address' entry
  657.       Type the server address here i.e. fics.onenet.net. PMICS uses this to
  658.       establish an internet connection to the server. You can use the textual
  659.       form or the dotted-IP form. If you are using TimeSeal for OS/2, you must
  660.       use the dotted-IP form i.e 164.58.253.10 for FICS.
  661.       
  662.    'Port' spinner
  663.       This is the TCP/IP port number on which the server runs. Most chess
  664.       servers operate on port 5000.
  665.       
  666.    'CR->LF' check
  667.       This is normally selected. It determines how carriage return characters
  668.       are sent to the server. If a server doesn't seem to respond to commands,
  669.       you can try unchecking this.
  670.       
  671.    'TimeSeal' check
  672.       Check this button to establish a TimeSeal connection to the server.
  673.       TimeSeal is a lag-compensation program which tracks the time you take to
  674.       make moves and communicates this to the server. To use TimeSeal, you must
  675.       copy the executable as TIMESEAL.EXE into the same directory as PMICS.
  676.       Remember to specify the server address in dotted-IP format.
  677.       
  678.    'Handle' entry
  679.       Your handle on the chess server. If you leave this blank, you will be
  680.       prompted to enter it when you login.
  681.       
  682.    'Guest' check
  683.       Check this to enter the server as a guest. You will not need to type a
  684.       password. You may specify a handle, but it must not be the same as any
  685.       other registered user's handle. If you leave the handle blank, PMICS will
  686.       attempt login using the handle 'PMICSGuest'.
  687.       
  688.    'Password' entry
  689.       If you are a registered user, type your password here. It will be shown
  690.       as asterisks. For better security, leave the password blank. You will be
  691.       prompted to enter it when you login.
  692.       
  693.    'Script...' button
  694.       Press this to enter a login script. Each separate line you enter will be
  695.       sent to the server automatically when you login. Use it for sending
  696.       greetings, setting server variables etc..
  697.       
  698.    'Comments' entry
  699.       Enter comments about the server here.
  700.  
  701. Windows Page
  702.    This page allows you to modify the settings of all the talk windows for the
  703.    currently selected server. The controls are the same as the Talk Window
  704.    Settings dialog with the addition of a 'Next' and 'Previous' button. You
  705.    cannot create new windows here - this must be done in the normal fashion.
  706.    See the Talk Windows section for more details.
  707.  
  708. On-line Page
  709.    The settings on this page affect how PMICS works while you are connected
  710.    to a server.
  711.    
  712.    'Autoflag' check
  713.       Determines whether the flag is automatically called when you are playing
  714.       a game and your opponent runs out of time. The state of this check is
  715.       reflected on the main toolbar.
  716.       
  717.    'Open to matches' check
  718.       Check this to be set open after you login. You will receive match
  719.       requests from other users. Uncheck to prevent this. You can change your
  720.       open status at any time using the 'Open' button on the main toolbar.
  721.       
  722.    'Finger challenger after match request' check
  723.       When checked the server will be asked to display the finger notes of
  724.       any user who challenges you to a match.
  725.       
  726.    'Observe bughouse partner games' check
  727.       If this is checked, observing or playing a bughouse game will
  728.       automatically observe the appropriate partner game.
  729.       
  730.    'Echo typed commands to screen' check
  731.       When checked, the text you type into command lines will be copied into
  732.       the appropriate text area along with the received server messages.
  733.       
  734.    'Show connected player information' check
  735.       If checked, the Player Information Window will appear when you login.
  736.       
  737.    'Show games in progress' check
  738.       When checked, the Player Information Window will display information
  739.       about matches that are in progress. If unchecked, only connected users
  740.       will be displayed in the window. You can only change this setting if the
  741.       previous check is also selected.
  742.       
  743. Display Page
  744.    This page affects the toolbars on the main and player information windows.
  745.    Choose how you would like the toolbars to appear. You can also choose to
  746.    display flyover hints for toolbar buttons. To display a hint, leave the
  747.    mouse pointer over a button for three seconds.
  748.    
  749. Colours Page
  750.    Although many colour settings can be changed using drag-and-drop, there
  751.    are some which cannot. They can be changed here. Select the element you
  752.    wish to modify from the list box then adjust the slider arms to change
  753.    the colour. The 'Apply' button refreshes all windows to let you preview
  754.    the effect of your change. The 'Defaults' button resets all colours to
  755.    their defaults.
  756.    
  757. Sounds Page
  758.    PMICS can associate sounds to some of the events which occur on the server.
  759.    The sound can be a simple beep or a wave file if you have an appropriate
  760.    sound card and have installed multimedia.
  761.    
  762.    'Enable sounds' check
  763.       Check to enable all sounds, uncheck to immediately disable sound.
  764.       
  765.    'Disable sounds while observing' check
  766.       Switches off game sounds (move, check) for observed games.
  767.       
  768.    'Disable sounds while examining' check
  769.       Switches off game sounds (move, check) for examined games.
  770.  
  771.    'Events' list
  772.       Select the event for which you wish to assign a sound.
  773.       
  774.    'None' radio button
  775.       Select this button to have no sound for the current event.
  776.       
  777.    'Speaker beeps' group
  778.       This group allows you to associate a simple beep with the event. Choose
  779.       from any of the three pre-defined beeps (Low, Mid or High), or choose
  780.       your own frequency and duration.
  781.       
  782.    'Sound file' radio button
  783.    
  784.       Select this button to associate a wave file with the current event. Type
  785.       the full name of the wave file into the entry field (i.e.
  786.       'D:\MMOS2\SOUNDS\BOING.WAV'), or click the 'Find...' button to scan your
  787.       system for an appropriate file. The volume at which the sound is replayed
  788.       is controlled by the 'Volume' slider.
  789.       
  790.    'Test sound' button
  791.       Press this button to play the current event sound.
  792.       
  793.  
  794. Hints and Tips
  795. --------------
  796. * PMICS is quite sensitive to your settings on the chess server. For best
  797.   results ensure that your prompt is 5 characters long, ends in 'ics%' and
  798.   that bell variable is set to off.
  799. * PMICS is not sensitive to the 'width' variable on the server. It is
  800.   effectively ignored.
  801.  
  802.  
  803. Endnote
  804. -------
  805. Updates to this document will appear regularly on the PMICS Home Page when I
  806. get the time. Please check the page regularly. The URL is
  807. http://www.tcom.co.uk/secondnature/pmics/
  808.  
  809. Email suggestions and omissions to: paulm@secondnature.co.uk
  810.  
  811. Alternatively, leave a message for 'MysticUK' on FICS.
  812.  
  813. -=O END O=-