   M A S T E R   M I N D    -  Platform: MVS/CICS


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

   This is the TSO version of Master Mind game recompiled for CICS, 
whitout any adaptation. The only thing added in CICS vesion is the
clear screen before program end: this is unnecessary in TSO version
because is ISPF to clear and refill the screen after program end.
   This program is a demo of the environment-independence of Hilmas
instructions BUILDMAP and CONVERSE, with which are constructed the
full screen maps.



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

CICSMMND.OBJ            executable for MVS/CICS mainframe, in obj form
CICSMMND.HIL            Hilmas source of this file
CXITMMND.OBJ            executable in Italian for CICS, in obj form
CXITMMND.HIL            Italian source of CXITMMND.OBJ
LINKEDIT.JCL            Job example to linkedit CICSMMND 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 CICSMIND.OBJ 'MYUSER.PROGRAM.OBJ'

- Prepare a Job to Linkedit transferred obj in a load library visible by
  CICS: 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 CICS address space.

- Complete installation defining program and transid in PPT and PCT CICS
  tables: the only important thing is to define CICSMMND as Assembler 
  program in PPT; then define a transaction code MMND linked with program
  CICSMMND. Use CEDA in analogous manner.


Program instruction:

   After installation, you can run the program writing in a blank screen
of your CICS session the corresponding transaction code:
   MMND
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 display 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 initial 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           
                                                                
                                                                
-------------------------------------------------------------------------------

