Skip to content

Commit

Permalink
Merge pull request #293 from openmainframeproject/prep-v3.0.0
Browse files Browse the repository at this point in the history
Prepare for v3.0.0 release
  • Loading branch information
MikeBauerCA authored Dec 22, 2022
2 parents 7dac59d + 2146984 commit be5ba59
Show file tree
Hide file tree
Showing 12 changed files with 62 additions and 47 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ \section*{
\\[35pt]
\Huge COBOL Programming Course 1 \\[10pt]
\Huge Getting Started \\[15pt]
\Large Version 2.3.0}\label{cobol-programming-course-1}}
\Large Version 3.0.0}\label{cobol-programming-course-1}}
\end{center}

\pagebreak
Expand Down
2 changes: 1 addition & 1 deletion COBOL Programming Course #1 - Getting Started/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ These materials are being used by other organizations to provide COBOL training

## Build

The PDF is built using the following [pandoc](https://pandoc.org/) command. Note: pdflatex is required. [MiKTeX](https://miktex.org/) can be installed to accomodate this.
The PDF is built using the following [pandoc](https://pandoc.org/) command. Note: pdflatex is required. [MiKTeX](https://miktex.org/) can be installed to accommodate this.

```
pandoc "COBOL Programming Course #1 - Getting Started.md" -o "COBOL Programming Course #1 - Getting Started.pdf" --number-sections --toc -B Front_Matter.tex --listings
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -211,7 +211,7 @@ COBOL programming language has many words with specific meaning to the COBOL com

A few COBOL reserved words pertinent to this book are: PERFORM, MOVE, COMPUTE, IF, THEN, ELSE, EVALUATE, PICTURE, etc. You can find a table of all COBOL reserved words is located at:

[https://www.ibm.com/docs/en/cobol-zos/6.3?topic=appendixes-reserved-words](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=appendixes-reserved-words)
[https://www.ibm.com/docs/en/cobol-zos/6.4?topic=appendixes-reserved-words](https://www.ibm.com/docs/en/cobol-zos/6.4?topic=appendixes-reserved-words)


### What is a COBOL statement?
Expand Down Expand Up @@ -334,7 +334,7 @@ This section provides useful resources in the form of manuals and videos to assi

### Professional manuals

As Enterprise COBOL experience advances, the need for professional documentation is greater. An internet search for Enterprise COBOL manuals includes: “Enterprise COBOL for z/OS documentation library - IBM”, link provided below. The site content has tabs for each COBOL release level. As of April 2020, the current release of Enterprise COBOL is V6.3. Highlight the V6.3 tab, then select product documentation.
As Enterprise COBOL experience advances, the need for professional documentation is greater. An internet search for Enterprise COBOL manuals includes: “Enterprise COBOL for z/OS documentation library - IBM”, link provided below. The site content has tabs for each COBOL release level. As of December 2022, the current release of Enterprise COBOL is V6.4. Highlight the V6.4 tab, then select product documentation.

[https://www.ibm.com/support/pages/enterprise-cobol-zos-documentation-library](https://www.ibm.com/support/pages/enterprise-cobol-zos-documentation-library)

Expand All @@ -343,15 +343,15 @@ Three ‘Enterprise COBOL for z/OS” manuals are referenced throughout the chap

1. Language Reference - Describes the COBOL language such as program structure, reserved words, etc.

[http://publibfp.boulder.ibm.com/epubs/pdf/igy6lr30.pdf](http://publibfp.boulder.ibm.com/epubs/pdf/igy6lr30.pdf)
[https://publibfp.dhe.ibm.com/epubs/pdf/igy6lr40.pdf](https://publibfp.dhe.ibm.com/epubs/pdf/igy6lr40.pdf)

2. Programming Guide - Describes advanced topics such as COBOL compiler options, program performance optimization, handling errors, etc.

[http://publibfp.boulder.ibm.com/epubs/pdf/igy6pg30.pdf](http://publibfp.boulder.ibm.com/epubs/pdf/igy6pg30.pdf)
[https://publibfp.dhe.ibm.com/epubs/pdf/igy6pg40.pdf](https://publibfp.dhe.ibm.com/epubs/pdf/igy6pg40.pdf)

3. Messages and Codes - To better understand certain COBOL compiler messages and return codes to diagnose problems.

[http://publibfp.boulder.ibm.com/epubs/pdf/c2746481.pdf](http://publibfp.boulder.ibm.com/epubs/pdf/c2746481.pdf)
[https://publibfp.dhe.ibm.com/epubs/pdf/c2746482.pdf](https://publibfp.dhe.ibm.com/epubs/pdf/c2746482.pdf)

### Learn more about recent COBOL advancements

Expand All @@ -367,6 +367,10 @@ Three ‘Enterprise COBOL for z/OS” manuals are referenced throughout the chap

[https://www.ibm.com/support/pages/cobol-v63-was-announced-whats-new](https://www.ibm.com/support/pages/cobol-v63-was-announced-whats-new)

- What’s New in Enterprise COBOL for z/OS V6.4:

[https://www.ibm.com/docs/en/cobol-zos/6.4?topic=wn-what-is-new-in-enterprise-cobol-zos-64-cobol-64-ptfs-installed](https://www.ibm.com/docs/en/cobol-zos/6.4?topic=wn-what-is-new-in-enterprise-cobol-zos-64-cobol-64-ptfs-installed)

## Lab

In this lab exercise, you will connect to an IBM Z system, view a simple COBOL hello world program in VS Code, submit JCL to compile the COBOL program, and view the output. Refer to "Installation of VS Code and extensions" to configure VS Code if you have not already done so. You can either use IBM Z Open Editor and Zowe Explorer, or Code4z.
Expand Down Expand Up @@ -777,7 +781,7 @@ The maximum length of a picture clause is dependent upon the data type and compi

Where cs is any valid currency symbols such as the dollar sign ($).

All PIC clause symbols are described in the [Enterprise COBOL for z/OS Language Reference manual](http://publibfp.boulder.ibm.com/epubs/pdf/igy6lr30.pdf).
All PIC clause symbols are described in the [Enterprise COBOL for z/OS Language Reference manual](https://publibfp.dhe.ibm.com/epubs/pdf/igy6lr40.pdf).


### Coding COBOL variable / data-item names
Expand Down Expand Up @@ -2661,7 +2665,7 @@ The sign condition determines whether the algebraic value of a numeric operand i

**Note**: To read more information about these conditions please visit the link:

[https://www.ibm.com/docs/en/cobol-zos/6.3?topic=structure-conditional-expressions](https://www.ibm.com/docs/en/cobol-zos/6.3?topic=structure-conditional-expressions)
[https://www.ibm.com/docs/en/cobol-zos/6.4?topic=structure-conditional-expressions](https://www.ibm.com/docs/en/cobol-zos/6.4?topic=structure-conditional-expressions)


## Lab
Expand Down Expand Up @@ -2844,7 +2848,7 @@ COMPUTE | Restriction does not apply

*Table 2. How the composite of operands is determined*

In all arithmetic statements, it is important to define data with enough digits and decimal places to ensure the required accuracy in the result. Arithmetic precision details are available in the [IBM Enterprise COBOL Programming Guide Appendix A](http://publibfp.boulder.ibm.com/epubs/pdf/igy6pg30.pdf).
In all arithmetic statements, it is important to define data with enough digits and decimal places to ensure the required accuracy in the result. Arithmetic precision details are available in the [IBM Enterprise COBOL Programming Guide Appendix A](https://publibfp.dhe.ibm.com/epubs/pdf/igy6pg40.pdf).



Expand Down Expand Up @@ -3074,7 +3078,7 @@ Previous COBOL industry specifications included intrinsic functions, which remai

- **Categories of intrinsic functions**

- **Intrinsic functions in Enterprise COBOL for z/OS V6.3**
- **Intrinsic functions in Enterprise COBOL for z/OS V6.4**

- **Mathematical example**

Expand Down Expand Up @@ -3154,9 +3158,9 @@ Intrinsic functions operate against alphanumeric, national, numeric, and integer

- **Integer** functions are of class and category numeric. The returned value is always considered to have an operational sign and is an integer intermediate result. The number of digit positions in the value returned is determined by the function definition.

## Intrinsic functions in Enterprise COBOL for z/OS V6.3
## Intrinsic functions in Enterprise COBOL for z/OS V6.4

The current release of Enterprise COBOL for z/OS V6.3 includes 70 intrinsic functions. Each one of these functions falling into one of the aforementioned six categories. While an entire book could be written on intrinsic functions, a single example for each of the six categories is provided in this section.
The current release of Enterprise COBOL for z/OS V6.4 includes 82 intrinsic functions. Each one of these functions falling into one of the aforementioned six categories. While an entire book could be written on intrinsic functions, a single example for each of the six categories is provided in this section.


### Mathematical example
Expand Down Expand Up @@ -3408,8 +3412,8 @@ To read more on data sets, visit the IBM Knowledge Center:
- S013-68: Block size is larger than 32752
- S013-A4: SYSIN or SYSOUT is not QSAM file
- S013-A8: Invalid record format for SYSIN or SYSOUT
- S013-D0: Attemped to define PDS with FBS or FS record format
- S013-E4: Attemped to concatenate more than 16 PDSs
- S013-D0: Attempted to define PDS with FBS or FS record format
- S013-E4: Attempted to concatenate more than 16 PDSs

**Frequent Causes:**
Most of the reason for this ABEND code is due to inconsistencies between the JCL and the COBOL program.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ \section*{
\\[35pt]
\Huge COBOL Programming Course 2 \\[10pt]
\Huge Learning COBOL \\[15pt]
\Large Version 2.3.0}\label{cobol-programming-course-2}}
\Large Version 3.0.0}\label{cobol-programming-course-2}}
\end{center}

\pagebreak
Expand Down
2 changes: 1 addition & 1 deletion COBOL Programming Course #2 - Learning COBOL/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ These materials are being used by other organizations to provide COBOL training

## Build

The PDF is built using the following [pandoc](https://pandoc.org/) command. Note: pdflatex is required. [MiKTeX](https://miktex.org/) can be installed to accomodate this.
The PDF is built using the following [pandoc](https://pandoc.org/) command. Note: pdflatex is required. [MiKTeX](https://miktex.org/) can be installed to accommodate this.

```
pandoc "COBOL Programming Course #2 - Learning COBOL.md" -o "COBOL Programming Course #2 - Learning COBOL.pdf" --number-sections --toc -B Front_Matter.tex --listings
Expand Down
Loading

0 comments on commit be5ba59

Please sign in to comment.