Name		Name	Last commit message	Last commit date
projects		projects
src/Cobol		src/Cobol
.gitignore		.gitignore
LICENSE		LICENSE
MAINTAINERS.md		MAINTAINERS.md
README.md		README.md

Repository files navigation

cics-java-recgen

Sample CICS Java program to use a record from the IBM Record Generator for Java to build a COMMAREA for linking to the CICS COBOL EDUPGM sample.

Supporting files

com.ibm.cicsdev.jzostest - Eclipse OSGi plugin project
com.ibm.cicsdev.jzostest.cicsbundle - CICS bundle project
EDUPGM.cbl - Sample CICS COBOL application that demonstrates the different data types that can be used in COBOL.
EDUCPY.cbl - Copybook that describes the record structure of the CICS COMMAREA for EDUPGM

Reference

Blog - Building Java records from COBOL with the IBM Record Generator for Java
IBM Record Generator for Java download

Java code

Source code for the following Java class is available in the projects directory

JZOSprog.java- JCICS CICS Java program to link to EDUPGM COBOL program using a generated record

The generated record JAR file cics-java-jcics-edupgm-1.0.jar is supplied in the lib directory of the Eclipse OSGi plugin project

Pre-reqs

CICS TS V5.5 or later
Java SE 17 or later on the workstation
Eclipse with the IBM CICS SDK for Java, or any IDE that supports usage of the Maven Central artifact com.ibm.cics:com.ibm.cics.server.
IBM Record Generator for Java V3.0 or later

Configuration

The sample project can be imported into Eclipse and deployed into a CICS OSGi JVM server as follows:

Import the Eclipse projects from the project folder into CICS Explorer using File -> Import -> General -> Existing projects into workspace.
Change the name of the JVMSERVER in the .osgibundle file from DFHJVMS to the name of the JVMSERVER resource defined in CICS.
Export the bundle project to zFS by selecting Export Bundle project to z/OS Unix File System from the context menu.
Create a CICS bundle defintion, setting the bundle directory attribute to the zFS location you just exported to, and install it.

Usage terms

By downloading, installing, and/or using this sample, you acknowledge that separate license terms may apply to any dependencies that might be required as part of the installation and/or execution and/or automated build of the sample, including the following IBM license terms for relevant IBM components:

• IBM CICS development components terms: https://www.ibm.com/support/customer/csol/terms/?id=L-ACRR-BBZLGX