Demonstration Applications

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, ReverseJSON, LoanDemo, LoanJSON, and BookREST 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 LoanJSON Applications
LoanDemo and LoanJSON 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.
BookREST Application
The BookREST application is a CICS COBOL application that stores and retrieves book records, which include title, author, genre, stock inventory number, and inventory and sale amounts.

Demonstration Files

The demonstration files for WSDL tutorials are provided by means of a project template named CICSWebServicesProjectTemplate_VS. 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:

CWSProject.cblproj
A Visual Studio project file used as a template to create a solution and all projects.
book.cbl
A CICS COBOL program used to create a RESTful Web service provider using the top-down method.
BookR02.cpy
A copybook that defines the container structure for the book program.
book-rec.cpy
A copybook that defines the bookfile record structure for the book program.
LOANPAYM.cbl
A CICS COBOL program used to create a CICS Web service provider using the bottom-up method.
LOANIN.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.
revJson.cpy
For JSON tutorials, a copybook that contains the business logic for the generated JSON Web service.
CICSWebServicesProjectTemplate.xml
An Enterprise Server template used to create an enterprise server region on which to run CICS Web services.
BookREST.json
A JavaScript Object Notation (JSON) file that describes a RESTful CICS Web service.
reverseReq.json
A JavaScript Object Notation file that describes the input structure for a CICS Web service.
reverseResp.json
A JavaScript Object Notation file that describes the output structure for a CICS Web Service.
loadlib
Initially empty, this folder is created and configured to contain build files generated by Enterprise Developer.
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.
jsonjavaprovider.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 build files to the loadlib project folder.
Project dependencies
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.