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.
Note: All
FileName variables indicate the default name of the file. This can change if you override the default settings by providing specific file names on the
Generate Web Service dialog box.
- Provider (service), WSDL Top-down
-
- Input File
- A WSDL file that describes a CICS COBOL application that runs as a Web service.
- Output Files
- When you generate a CICS Web service provider from a WSDL file
using the top-down method,
Enterprise Developer generates the following CICS Web service components in the current project folder:
- WSDLFileName.cbl
- A skeleton CICS COBOL provider program.
- WSDLFileNameI01.cpy
- A copybook containing the COBOL data structures required to send a SOAP request as input. This file is generated but does not appear in the Solution Explorer.
- WSDLFileNameO01.cpy
- A copybook containing the COBOL data structures required to receive a SOAP response message as output. This file is generated but does not appear in the Solution Explorer.
- WSDLFileName.svi
- A service interface file.
- Requester (client), WSDL Top-down
-
- Input File
- A WSDL file that describes a CICS COBOL application that runs as a Web service.
- Output Files
- When you generate a CICS Web service requester from a WSDL file
in a Visual Studio project
using the top-down method,
Enterprise Developer generates
a new project named
WSDLFileNameCICSClientApp that contains
the following CICS Web service components:
- First8CharsWSDLFileName.cbl
- A skeleton CICS program.
- First5CharsWSDLFileNameI01.cpy
- A copybook containing the COBOL data structures required to send a SOAP request as input.
- First5CharsWSDLFileNameO01.cpy
- A copybook containing the COBOL data structures required to receive a SOAP response message as output.
- WSDLFileName.wsbind
- A bind file that maps the SOAP request to the data structure in the input copybook, and maps the data structure in the output copybook to the SOAP response message.
- Provider (service), WSDL Bottom-up
-
- Input Files
- CICS COBOL application that minimally consists of a main program (.cbl) file, and two copybook (.cpy) files - one containing input data structures, and one containing output data structures.
- Output Files
-
- SVIFileName.svi
- A service interface that you name and generate from the CICS COBOL application using the
Interface Mapper.
Note: This service interface must use the SOAP transport type and be defined with one operation that uses default mappings only.
- SVIFileName.wsbind
- A bind file, generated from the
.svi file, that maps the SOAP request to the data structure in the input copybook, and maps the data structure in output copybook to the SOAP response message.
- SVIFileName.wsdl
- The Web service definition file that describes the CICS COBOL application.
- Provider (service), JSON Top-down
-
- Input File
- A set of request and response JSON files that describe a CICS COBOL application that runs as a Web service.
- Output Files
- When you generate a CICS Web service provider from request and response JSON files in a Visual Studio project using the top-down method,
Enterprise Developer generates the following CICS Web service components in the current project folder:
- RequestJSONFileName\First5CharsRequestJSONFileName.cbl
- A skeleton CICS COBOL provider program.
- RequestJSONFileName\First5CharsRequestJSONFileNameI01.cpy
- A copybook containing the COBOL data structures required to send a JSON request as input. This file is generated but does not appear in the Solution Explorer.
- RequestJSONFileName\First5CharsResponseJSONFileNameO01.cpy
- A copybook containing the COBOL data structures required to receive a JSON response as output. This file is generated but does not appear in the Solution Explorer.
- RequestJSONFileName.svi
- A service interface file that contains default mappings between the generated CICS COBOL skeleton application and the CICS Web service described in the JSON.
- RequestJSONFileName\RequestJSONFileName.wsbind
- A bind file, generated from the
.svi file, that maps the JSON request to the data structure in the generated input copybook, and maps the data structure in the generated output copybook to the JSON response message.
- Provider (service), RESTful JSON Top-down
-
- Input File
- One RESTful JSON file that describes a CICS COBOL application that runs as a Web service.
- Output Files
- When you generate a CICS Web service provider from RESTful JSON in a Visual Studio project using the top-down method,
Enterprise Developer generates the following CICS Web service components in the current project folder:
- JSONFileName\First8CharsJSONFileName.cbl
- A skeleton CICS program.
- JSONFileName\First5CharsJSONFileName01.cpy
- A copybook containing both input and output data structures. This file appear in the Solution Explorer as a subentry under the generated
.cbl file.
- JSONFileName\JSONFileName.svi
- A service interface file that contains default mappings between the generated CICS COBOL skeleton application and the CICS Web service described in the JSON.
- JSONFileName\JSONFileName.wsbind
- A bind file, generated from the
.svi file, that maps the JSON request to the input structure in the generated copybook, and maps the output data structure in the generated copybook to the JSON response message.
- Requester (client), JSON Top-down
-
- Input File
- A set of request and response JSON files that describe a CICS COBOL application that runs as a Web service.
- Output Files
- When you generate a CICS Web service requester from set of request and response JSON files
in a Visual Studio project
using the top-down method,
Enterprise Developer generates
a new project named
RequestJSONFileNameCICSClientApp that contains
the following CICS Web service components:
- ProgramName.cbl
- A skeleton CICS program where
ProgramName is the name specified in the Generate Web Service dialog box.
- ProgramNameInBundle
- A folder that contains generated input files.
- jsbinds\First7CharsProgramNameI.json
- A JSBIND file for converting between input JSON messages and COBOL data structures.
- jsbinds\RequestJSONFilename.json
- A copy of the input JSON that corresponds to the generated skeleton CICS program.
- META-INF\cics.xml
- A reference file used by
Enterprise Server to establish the structure of the input bundle directory.
- ProgramNameOutBundle
- A folder that contains generated output files.
- jsbinds\First7CharsProgramNameO.json
- A JSBIND file for converting between output JSON messages and COBOL data structures.
- jsbinds\ResponseJSONFilename.json
- A copy of the output JSON that corresponds to the generated skeleton CICS program.
- META-INF\cics.xml
- A reference file used by
Enterprise Server to establish the structure of the output bundle directory.
- Provider (service), JSON Bottom-up
-
- Input Files
- CICS COBOL application files that minimally consists of a main program (.cbl) file, and two copybook (.cpy) files - one containing input data structures, and one containing output data structures.
- Output Files
-
- SVIFileName.svi
- A service interface that you name and generate from the CICS COBOL application using the
Interface Mapper.
Note: This service interface must use the JSON transport type and be defined with one operation that uses default mappings only.
- SVIFileName.wsbind
- A bind file, generated from the
.svi file, that maps the JSON request to the data structure in the input copybook, and maps the data structure in output copybook to the SOAP response message.
- SVIFileNameI.json
- A JSON file that describes the input structures of the CICS COBOL application.
- SVIFileNameO.json
- A JSON file that describes the output structures of the CICS COBOL application.
