Skip to content

Latest commit

 

History

History
150 lines (122 loc) · 5.26 KB

README.md

File metadata and controls

150 lines (122 loc) · 5.26 KB

operquiz

GitHub top language Scc Count Badge Scc Count Badge Scc Count Badge Scc Count Badge GitHub repo size GitHub

Table of contents

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

License: GPL v2 Lines of code