   M A S T M I N D    -  Platform: MVS/TSO


   Game of Master Mind, played by user vs. mainframe and by mainframe
vs. user, at the same time.


   In this distribution file (MASTMIND.ZIP) there is:

MASTMIND.OBJ            executable for MVS/TSO mainframe, in obj form
MASTMIND.HIL            Hilmas source of this file
MASTMNDI.OBJ            executable in Italian for TSO, in obj form
MASTMNDI.HIL            Italian source of MASTMNDI.OBJ
LINKEDIT.JCL            Job example to linkedit MASTMIND obj
README.TXT              this help file


OBJ installation:

- Create in MVS a sequential file, for example 'MYUSER.PROGRAM.OBJ'
  with RECFM=FB and LRECL=80, for example of 1 cylinder.

- SEND obj module from PC to MVS in this file in BINARY form, with your 
  3270 emulation; the most important thing is a binary transfer (therefore 
  without ASCII CRLF) in a file with record length of 80 bytes.
  Use this PC command (in a PC with IBM/PCOMM 4.1 3270 emulation installed):

     SEND MASTMIND.OBJ 'MYUSER.PROGRAM.OBJ'

- Prepare a Job to Linkedit transferred obj in a load library (possibily
  in Linklist): use LINKEDIT.JCL as example: fit this JCL to your needs
  changing library names

- Submit linkedit job to create load module; output library must be a
  load library used by TSO users (i.e. in  //JOBLIB ) or a linklist library
  (in this case, you must refresh linklist with F LLA,REFRESH command)



Program instruction:

   After installation, you can run the program writing in command line
of your ISPF/TSO session:
   TSO MASTMIND
ad a full screen game 'tableau' for two contemporary plays appears.

You can use some options in command line, near the program name:
    SECRET          immediate view of BigBlue's secret code.
    NEW             NEW Master Mind (4 digits, 8 values)
    SUPER           SUPER Master Mind (5 digits, 8 values)
    LETTER          view LETTERS instead of numbers


                                                                                
                            Rules  of  Master Mind                            
                                                                                
   The game consists to guess a secret code coded by the opponent; code is
composed by a sequence of four or five digits. Every digit go from 1 to 6  
(or 8); optionally digits can be replaced by letters (from A to F, or H).  
At every attempt to guess the secret code, the coder answers showing the 
number of digits right for value and position (Black pins) and showing the 
number of digits right only for the value but not for position (White pins). 
Every digit can be counted only one time (for Black or White pins). 
Can be coded double digits (or triple, and so on).                                                                     
                                                                                
                            Double Master Mind                                  
                                                                                
   In this version of the game, both man and calculator are at the same  
time coder and decoder; so there is a double Master Mind game, in which 
wins the player that guess first the right secret code.
Draw is possible if human guess code simultaneously to calculator.                                                   
                                                                                


    This is the main screen of the game:

----------------------------------------------------------------------------
 * Double MASTER MIND *   Opponent: BIG-BLUE  - Move:    1  -      15:16:04    
                                                                               
                 BIG-BLUE                     YOU                              
           +-----------------+          +-----------------+                    
           !           ! w b !          !           ! w b !                    
           +-----------------+          +-----------------+                    
         1 ! . . . .   !     !        1 ! 4 2 2 2   ! . . !                    
         2 !           !     !        2 !           !     !                    
         3 !           !     !        3 !           !     !                    
         4 !           !     !        4 !           !     !                    
         5 !           !     !        5 !           !     !                    
         6 !           !     !        6 !           !     !                    
         7 !           !     !        7 !           !     !                    
         8 !           !     !        8 !           !     !                    
         9 !           !     !        9 !           !     !                    
        10 !           !     !       10 !           !     !                    
        11 !           !     !       11 !           !     !                    
        12 !           !     !       12 !           !     !                    
           +-----------------+          +-----------------+                    
                 YOU                          BIG-BLUE                         
                                                                               
                                                                               
 Let's write your secret code on a piece of paper ! - Values from "1" to "6".  
  PF1: Help   PF2: Options   PF3: Exit    PF4: New game                        

-----------------------------------------------------------------------------
 in which you are the decoder in the left board (that is you guess against
 calculator) and the coder in the right board (calculator guess your code)

    And this is the option screen:

-----------------------------------------------------------------------------
                  - Options of Master Mind game -               
                                                                
                                                                
                                      Your name      YOU        
                                                                
       Possible values of every code: (6 to 8): 6  (new game)   
                                                                
         Number of positions of code: (4 or 5): 4  (new game)   
                                                                
  Code represented in Numbers or Letters (N/L): N               
                                                                
          Difficulty level  (1=medium, 2=hard): 1               
                                                                
                                                                
                                                                
   Note: Original Master Mind: 4 positions - 6 values           
              New Master Mind: 4 positions - 8 values           
            Super Master Mind: 5 positions - 8 values           
                                                                
                                                                
-------------------------------------------------------------------------------

