This document covers the following topics and provides links to the relevant sections of the documentation.
With EntireX you can offer an RPC server, for example a COBOL or Natural RPC server, as a Web service. A typical starting point is a Software AG IDL File, which describes the interface to the RPC server. To create an IDL file, use an IDL extractor such as the IDL Extractor for COBOL or IDL Extractor for Natural to extract it from the RPC server.
The individual steps are listed below with links to the relevant documentation:
Generate Web Service with the Web Services Wrapper
The EntireX Web Services Wrapper is a wizard that generates Web services into a Web service archive from Software AG IDL.
(Optional) Adapt Mapping File with the XML Mapping Editor
The EntireX XML Mapping Editor is intended for experienced users to adapt the XML/SOAP mapping file,
which maps the RPC data to Web services data.
Deploy Web Services Archive with the Web Services Stack
The Software AG Common Web Services Stack (WSS) is a toolkit that provides functionality for executing, configuring
and deploying Web services. It handles the complex process of sending and receiving Web services
requests in Software AG products.
To deploy your archive to a running XML/SOAP Listener, see Deploying EntireX Web Services under Writing Web Services Applications. See also the separate Web Services Stack documentation, also available under webMethods Product Documentation on the Software AG Documentation website.
Test your Web Service with the XML Tester
Using the XML Tester you can send a Web services request to the
EntireX XML/SOAP Listener.
See EntireX XML Tester in the XML/SOAP Wrapper documentation.
With EntireX you can enable an RPC client, for example a COBOL or Natural client, consuming (or calling) a Web service. A typical starting point is an existing WSDL file, which describes the interface to the Web service.
The individual steps are listed below with links to the relevant documentation:
Generate IDL File and Mapping File with the IDL Extractor for WSDL
Use the IDL Extractor for WSDL to generate an IDL file from the service's WSDL together with an XML/SOAP mapping file.
The IDL file is input for an EntireX wrapper; the mapping file maps RPC data to Web services data.
(Optional) Adapt Mapping File with the XML Mapping Editor
The EntireX XML Mapping Editor is intended for experienced users to adapt the XML/SOAP mapping file,
which maps the RPC data to Web services data.
Deploy the XML/SOAP Mapping File with the XML/SOAP Wrapper
The mapping file is deployed to a running XML/SOAP RPC Server. See Deploying an XMM File to XML/SOAP RPC Server in the XML/SOAP Wrapper documentation.
Test the Access to the Web Service with the IDL Tester
The IDL Tester is an easy-to-use utility to check whether a remote call works.
We recommend testing the objects created in the steps above. See EntireX IDL Tester in the EntireX Workbench documentation.
Create an RPC Client using an EntireX Wrapper
When you have created your IDL file, XML/SOAP mapping file and tested the connection from broker to the Web service,
you can now create your own client application using one of the EntireX wrappers,
for example COBOL Wrapper or Natural Wrapper.
