README.md

operquiz

Table of contents

• General info
• Flowchart: How to play quiz game
• Technologies
• Installation
• Features
• Run the Project
• TOO
• License

General info

Batch and console quiz game about IBM mainframe written in COBOL programming language

      ******************************************************************
      *    OPERATOR CONSOLE & SCREEN QUIZ ABOUT MAINFRAME
      ******************************************************************
      *
      *          COPYRIGHT:  GNU GPLV2 LICENSE 2023
      *          AUTHOR:     PRZEMYSLAW ADAM KUPISZ
      *          VERSION:    2
      *
      *    WARNING
      *          CODE WAS COMPILED AND RUN
      *          WRITTEN IN LEGACY VSCODE WITHOUT GNUCOBOL EXTENSION
      *
      *    PURPOSE
      *          TRAINING AND COGNITIVE OBJECTIVES OF COBOL 
      *
      *    INFO
      *          PGM TAKES PARMS FROM JCL TO SELECT OPERATION MODE
      *          OPERATOR (C)ONSOLE OR (B)ATCH
      *          FOR BATCH WRITE JCL PARM TO COMMAND PGM FLOW
      *          BATCH = PRINTS 5 QUESTIONS AND ABCD ANSWERS PROPOSAL
      *          C,ABCDA = CHECKS CORRECT ANSWERS AND PRINTS SUMMARY
      *          ('ABCDA' IS AN EXAMPLE LIKE 'BBBCC')
      *
      ******************************************************************
      *
      *    PROJECT CONTAINS:
      *          JCL JOB           OPERQUIZ.JCL   JCL WITH PARMS
      *          MAIN PGM          OPERQUIZ.CBL   INIT
      *          SUB PGM MODULES   ORQMOD01.CBL   WELCOME TEXT FOR CONS
      *                            ORQMOD02.CBL   CONSOLE PART OF QUIZ
      *          COBYBOOKS         CPBQAC01       QUESTIONS AND ANSWERS
      *                            CPBQAC02       V2 OF Q&A REC FORMAT
      *
      ******************************************************************

Flowchart: How to play quiz game

flowchart TD
    A[Set JCL PARM to play] -->C{Choose<br/> mode}
    C -->|Interactive| D(Operator Console)
    D -->|'CONSOLE'| F(DISPLAY QUESTION)
    F -->G(ACCEPT ANSWER)
    G-->F
    C -->|Batch| E(SPOOL)
    E-->|'BATCH'| I(PRINTS<br/> ALL QUESTIONS <br/>AND<br/> ANSWERS PROPOSAL)
    E-->|'C,ABCDA'| H(PRINTS <br/> PERCENTAGE SUMMARY <br/>OF<br/> CORRECT NASWERS)

Loading

Technologies

Project is created with:

• COBOL
• JCL

Installation

• Available z/OS COBOL compiler PTF

Features

Feature	% Progress	Status
START/STOP TIME	##########	Completed
ELAPSED TIME	##########	Completed
Console Operator play	##########	Completed
5 questions in quiz	##########	Completed
Percentage SUMMARY	##########	Completed
Batch play	##########	Completed
PSEUDO-RANDOM ORDER OF THE QUESTIONS	#	In Progress
Beautify code	###	In Progress

Run the Project

• First we need to compile it using default JCL for Enterprise COBOL
• Then we check compile results and correct warnings or errors if exists or just send them here to the author (to fix the code)
• Edit 'OPERQUIZ.JCL' and change it for our need
• Options available to SET the proper MODE

//*            PLEASE CHOOSE ONLY ONE PARAMETER:
//* OPERATOR        FOR CONSOLE OPERATOR INTERACTION
//* BATCH           BATCH TO PRINT QUESTIONS AND ABCD ANSWERS PROPOSAL
//* C,ABCDA         TO PRINT THE CORRECT ANSWERS SUMMARY
//*   -----  , WHERE ABCDA IS A USER ANSWER FOR 5 QUESTIONS
//*
//          SET USERP1='OPERATOR'
//**        SET USERP1='BATCH'
//**        SET USERP1='C,-----'
//STEP1 EXEC PGM=OPERQUIZ,PARM='&USERP1'

Default setting is an operator mode and the rest of available options is commented:

//          SET USERP1='OPERATOR'

For batch mode PRINT QUESTIONS we need to comment and uncoment JCL code as below:

//**      SET USERP1='OPERATOR'
//        SET USERP1='BATCH'

For batch mode CHECK USER ANSWERS AND PRINT SUMMARY we need to input 5 letters from range A to D to JCL code in place of '-----':

//        SET USERP1='C,AABBC'

From TSO: SUBMIT 'USERID.OPERQUIZ.JCL'

TODO

• Branch in V3.0.0 will implement some PSEUDO-RANDOM order of the questions for console mode

License