Merge branch 'master' into patch-1

Author: jellypuno

COBOL Programming Course #2 - Advanced Topics/COBOL Programming Course #2 - Advanced Topics.md

@@ -49,29 +49,29 @@ Can you fix the code to get the correct result? The new source code is named **C
 
 You can find them in the github repository for the COBOL course, in the subfolder **/COBOL Programming Course #2 - Advanced Topics/Challenges/Debugging**.
 
-# COBOL Challenge - The COVID-19 Reports
+## COBOL Challenge - The COVID-19 Reports
 
 Today, you are tasked to create a COVID-19 Summary Report of all the countries around the world, using information from the COVID19API website.
 
-## Instructions
+### Instructions
 
-- Extract the response from this API: https://api.covid19api.com/summary. You will receive a JSON file that is similar to the image below:
+1. Extract the response from this API: https://api.covid19api.com/summary. You will receive a JSON file that is similar to the image below:
 
     ![](Images/cobolchCOV19-img1.png)
 
-- Convert that file to CSV format. It should look like this. In my example, I only chose the “Countries” part.
+2. Convert that file to CSV format. It should look like this. In my example, I only chose the “Countries” part.
 
     ![](Images/cobolchCOV19-img2.png)
 
-- Using Zowe, upload the CSV file to the mainframe.
+3. Using Zowe, upload the CSV file to the mainframe.
 
 **Hint:** You can use the command `zowe files ul ftds “file location” “dataset name”` to upload the CSV file to the mainframe.
 
-- Create a new member in your *.CBL data set to write your COBOL program.
+4. Create a new member in your *.CBL data set to write your COBOL program.
 
 **Hint:** You can create a member using Zowe Explorer or Zowe CLI.
 
-- Write a COBOL program that reads the uploaded CSV file and reformats it to display the contents like this:
+5. Write a COBOL program that reads the uploaded CSV file and reformats it to display the contents like this:
 
     ```
     ********************************************************************
@@ -89,9 +89,9 @@ Today, you are tasked to create a COVID-19 Summary Report of all the countries a
     ********************************************************************
     ```
 
-- Compile and test your work.
+6. Compile and test your work.
 
-## Advanced Tasks
+### Advanced Tasks
 
 If you want a more challenging approach, try the optional tasks below:
 
@@ -103,17 +103,17 @@ If you want a more challenging approach, try the optional tasks below:
 
     ![](Images/cobolchCOV19-img4.gif)
 
-## Solution
+### Solution
 
 To check the solution, refer to the blog post [here](https://medium.com/@jessielaine.punongbayan/solution-covid-19-reports-cobol-challenge-6c509579e3fe?source=friends_link&sk=5a662034a03c91d639b77267ed6abfc9).
 
 Happy Coding! 😉
 
 _Disclaimer: This challenge is also posted in [Medium.com](https://medium.com/@jessielaine.punongbayan/cobol-challenge-covid-19-reports-ee03a946bd23)._
 
-# COBOL Challenge - The Unemployment Claims
+## COBOL Challenge - The Unemployment Claims
 
-Let us go to a more advanced challlenge! Your task is to create an end-to-end solution. That means that our end goal is to build an application that will fire Zowe APIs to Mainframe and display the result in the application. This is how the flow would look like:
+Now let's try a more advanced challenge! Your task is to create an end-to-end solution. Our end goal is to build an application that will fire Zowe APIs to the mainframe and display the result in the application. This is how the flow would look:
 
 ![](Images/cobolchClaims-img1.png)
 
@@ -123,7 +123,7 @@ _Of course, you do not have to complete the whole challenge if you do not want t
 
 The data that we are going to use will come from https://www.data.gov/. According to their website, this is a repository of data that is available for public use. For more information, please visit their website.
 
-To be more specific, we are going to get “The Monthly Unemployment Claims of the State of Missouri”.
+To be more specific, we are going to get the monthly unemployment claims of the state of Missouri.
 I chose this because it is separated according to different categories:
 
 - **By Age:** https://catalog.data.gov/dataset/missouri-monthly-unemployment-claims-by-age-d20a7
@@ -138,61 +138,59 @@ You can consume the data in different formats such as CSV, RDF, JSON or XML. You
 
 You are given a new set of data for The Unemployment Claims. Your tasks are as follows:
 
-- To create a new database for the new set of data and combine them based on Record ID.
-- To provide a way for other COBOL programs and other applications to access this newly created database
-- To create a report specifying all the information available in the newly created database. The report will contain, but not limited to, the following information: Record ID, Age, Ethnicity, Industry, Race and Gender.
+- To create a new database for the new set of data and combine the data based on the Record ID field.
+- To provide a way for other COBOL programs and other applications to access this newly created database.
+- To create a report specifying all the information available in the newly created database. The report will contain, but not be limited to, the following information: Record ID, Age, Ethnicity, Industry, Race and Gender.
 
 ### Instructions
 
-- Let’s create a database. This can be done in various ways but the easiest one the I could think of is a VSAM file. Create a COBOL program that will consume your data. Using the RECORD-ID as the key (which is more visible when reading the CSV file), create a KSDS VSAM file and store all the information there.
+1. Create a database. This can be done in various ways but the easiest one the I could think of is a VSAM file. First, create a COBOL program that will consume your data. Then, using the RECORD-ID as the key (which is more visible when reading the CSV file), create a KSDS VSAM file and store all the information there.
 
-    _What this means is that, one record will have the RECORD-ID as the key and added to it are all the information from The Monthly Unemployment Claims (Fields from Age, Ethnicity, Industry, Race and Gender) will be added or connected to the RECORD-ID._
+    _What this means is that one record will have the RECORD-ID as the key and all the information from The Monthly Unemployment Claims (Fields from Age, Ethnicity, Industry, Race and Gender) will be added or connected to the RECORD-ID._
 
     The flow would look like this:
 
     ![](Images/cobolchClaims-img2.png)
 
-- Create a COBOL sub-routine. This program will allow other programs to read the data from the VSAM file. This sub-routine should be able to do the following scenario:
-
-- accepts requests to get information of a specific record ID.
-- _(Optional)_ accepts requests to get information of all the records inside the database. What does this mean? It means that instead of providing a record ID, I could provide an indicator the I want to create a report of all the records inside the database.
+2. Create a COBOL sub-routine. This program will allow other programs to read the data from the VSAM file. This sub-routine should be able to perform the following tasks:  
+    - accept requests to get information about a specific record ID.
+    - _(Optional)_ accept requests to get information about all the records inside the database. What does this mean? It means that instead of providing a record ID, I could provide an indicator that I want to create a report of all the records inside the database.
 
     ![](Images/cobolchClaims-img3.png)
 
     _The purpose of the COBOL sub-routine is to allow other COBOL programs or other application to access the information inside the VSAM file._
 
-- Create a Main COBOL Program. This program will create a report based on the records inside the newly created database. The process is as follows:
-
-- It should call the COBOL sub-routine passing the Record ID or (Optional) an indicator that you want to print all records in the database.
-- It should receive the response from the sub-routine.
-- It should process the response and generate a report. This report can be a formal report or just a display in the SYSOUT. It’s up to you.
+3. Create a Main COBOL Program. This program will create a report based on the records inside the newly created database. The process is as follows:  
+    - The program calls the COBOL sub-routine passing the Record ID or, optionally, an indicator that you want to print all records in the database.
+    - It receives the response from the sub-routine.
+    - It processes the response and generates a report. This report can be a formal report or just a display in the SYSOUT. It’s up to you.
 
     The flow should look like this:
 
     ![](Images/cobolchClaims-img4.png)
 
-- Create your JCLs.
+4. Create your JCLs.
 
     _By this point, if you choose to do the exercise using COBOL programs only, you should be able to read the data from your VSAM file, process it and generate a report. The generated report could be an information of a specific record or multiple records._
 
-- _(Optional)_ Create an application. It can be different applications like a Mobile App, a Web App or an Electron App. It is up to you. In this application you should be able to view a record by providing a RECORD-ID. The flow would be similar to Step #3.
+5. _(Optional)_ Create an application. It can be any type of application; a Mobile App, a Web App or an Electron App. It is up to you. In this application you should be able to view a record by providing a RECORD-ID. The flow would be similar to Step #3.
 
-    This is an example of a possible design of the application:
+    This is an example of a possible application design:
 
     ![](Images/cobolchClaims-img5.png)
 
 
-    **Hint:** How can I accomplish this? By using the Zowe CLI NPM package, you can fire Zowe APIs that will submit your JCLs and get the results. From there, you can view the output and display it in your application. This article can provide a good example.
+    **Hint:** How can I accomplish this? By using the Zowe CLI NPM package, you can fire Zowe APIs that submit your JCLs and get the results. From there, you can view the output and display it in your application. This article can provide a good example.
 
     **Hint:** What APIs am I going to use? You will use the Jobs Submit API and View Jobs Spool or View Dataset API. For more information, please visit [this site](https://docs.zowe.org/stable/web_help/index.html).
 
-- _(Optional)_ Create a CI/CD process that will create a nightly build of your application. [This article](https://medium.com/modern-mainframe/beginners-guide-cobol-made-easy-leveraging-open-source-tools-eb4f8dcd7a98?source=friends_link&sk=443517b1feaba8e392f5807246c25ca4) can help explain that process.
+6. _(Optional)_ Create a CI/CD process that will create a nightly build of your application. [This article](https://medium.com/modern-mainframe/beginners-guide-cobol-made-easy-leveraging-open-source-tools-eb4f8dcd7a98?source=friends_link&sk=443517b1feaba8e392f5807246c25ca4) can help explain that process.
 
     Sample CI/CD Build using CircleCI:
 
     ![](Images/cobolchClaims-img6.gif)
 
-### Craving for more programming challenge?
+### Craving more programming challenges?
 
 Add more functionality to your COBOL Sub-routine like: