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