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.
- CICSWebServicesProjectTemplate.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.