Demonstration Applications

Attention: This feature is in Early Adopter Product (EAP) release status. We intend to provide the finalized feature in a future release. Please contact Micro Focus SupportLine if you require further clarification.

The CICS Web Services feature is EAP for development and testing usage. It should not be used for production deployment in this product release.

Restriction: This topic applies to Windows environments only.

Enterprise Developer provides several sample projects that contain the components required to complete the CICS Web Services tutorials for both WSDL and JSON. Components of the Reverse, InvokeReverse, LoanDemo, ReverseJSON, LoanDemoJSON, and filmsREST applications are provided for these tutorials.

Reverse Application
The Reverse application is a CICS COBOL application that takes one or more character strings as input, reverses each of them, and sends the reversed strings as output.
InvokeReverse Application
The InvokeReverse application is generated from an existing WSDL file. With it, you invoke the Reverse application running in an enterprise server region.
ReverseJSON Application
The ReverseJSON application is a CICS COBOL application that takes a character string as input, reverses it, and sends the reversed string as output.
LoanDemo and LoanDemoJSON Applications
LoanDemo consist of a CICS application, LOANPAYM, that simply accepts a Principal amount, a Loan Term amount, and a Rate amount. These three input values are required to calculate and return a Monthly Payment amount.
filmsREST
The filmsREST application is a CICS COBOL application that stores and retrieves film records, which include the title, year released, director, and media format for each film.

Demonstration Files

The demonstration files for WSDL tutorials are provided by means of a project template named CICSWebServicesProjectTemplate_Eclipse. This template is located in the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\Classic\CWS directory by default.

The demonstration files for JSON tutorials are provided by sample projects that are also used by the Samples Browser. They also reside in the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\CICS\Classic\CWS directory by default.

Each provided project contains several folders and files required to complete the tutorials; however not all of the files are used in every tutorial:

.cobolBuild, .cobolProj, and .project
Eclipse template files used to create each tutorial project.
RESTLogic.cpy
A copybook that contains the logic required to create a RESTful Web service provider.
LOANPAYM.cbl
A CICS COBOL program used to create a CICS Web service provider using the bottom-up method.
LOANINP.cpy
A copybook that contains the input structure for the LOANPAYM program.
LOANOUT.cpy
A copybook that contains the output structure for the LOANPAYM program.
revLogic.cpy
For WSDL tutorials, a copybook that contains the business logic for the generated Web service.
revLogicJ.cpy
For JSON tutorials, a copybook that contains the business logic for the generated JSON Web service.
CICSWebServicesTemplate.xml
An Enterprise Server template used to create an enterprise server region on which to run CICS Web services.
films.json
A JavaScript Object Notation (JSON) file that describes a RESTful CICS Web service.
reverse.json
A JavaScript Object Notation file that describes both the input and the output structures for a CICS Web Service.
loadlib
As you work through the tutorials, you create this folder to contain files generated by Enterprise Developer. Initially, it does not appear listed on the project.
dfhdrdat
A resource definition file that defines the resources required to run the Web service on Enterprise Server.
reverse.wsdl
A Web Service Description Language (WSDL) file that describes a CICS Web service.
basicsoap11provider.xml
A basic SOAP configuration file used for the provider pipeline.
basicsoap11requester.xml
A basic SOAP configuration file used for the requester pipeline.
JSONConfig.xml
A basic JSON configuration file used for the provider pipeline.

Project Configuration

Projects created using the provided template and sample projects are configured to use the following settings. All other settings remain set to their respective defaults:

Output path
This is set to write generated files to the loadlib project folder.
Build path
Includes the cpy project subfolder, ensuring that the compiler finds all included copybooks.
Preprocessor
Set to build the project using the CICS preprocessor.
Character set
Set to use the ASCII character set.
Dialect
Set to use the Micro Focus COBOL dialect.
Mode
Sets the mode to word-storage by setting the IBMCOMP compiler directive.