NonStop SOAP 4.1 User's Manual

Figure 5 NonStop SOAP 4 Request Processing Flow for TS/MP or NonStop process-based Web
Services
DLL based
Business Application
Pathway/Process-
based Business
Application
Buffer
Client
HTTP Headers
SOAP Envelope
SOAP Header
XML Data
SOAP Body
CGI Interface SOAP Engine Message
Receiver
SOAP Envelope
SOAP Header
XML Data
XML Data
SOAP Body
A Web service client sends a request to the NonStop SOAP server using the SOAP protocol through
the iTP WebServer. The request message is processed as follows:
1. When this request is received by the NonStop SOAP server, the CGI interface of NonStop
SOAP processes the HTTP headers in the request message and forwards the SOAP envelope
to the NonStop SOAP engine.
2. The NonStop SOAP engine processes the SOAP envelope, SOAP body, and the SOAP header.
The XML request inside the SOAP body is then sent to the message receiver.
3. The message receiver converts the XML request to a format understood by the underlying
business application and sends the request data to the business application. NonStop SOAP
converts the response received from the business application to a SOAP message and sends
this response to the Web service client through the iTP WebServer.
For example, in a Pathway or process service invocation, the XML request is converted to a
character buffer by the Pathway message receiver and is sent to a server class or process
respectively. The server class or process sends the response buffer which is then converted
into response XML by the Pathway message receiver.
Compatibility
NonStop SOAP 4 is backward compatible with NonStop SOAP 3.
Services developed in NonStop SOAP 4 are compatible with:
• SOAP clients that support SOAP 1.1 and SOAP 1.2 protocol.
• SOAP clients that communicate with NonStop SOAP 3 services.
Clients developed in NonStop SOAP 4 are compatible with:
• SOAP services that support SOAP 1.1 and SOAP 1.2 protocol
• SOAP services developed in NonStop SOAP 3.
Migration
NonStop SOAP 4 provides tools to migrate NonStop SOAP 3 services to NonStop SOAP 4 services.
The information in the SDR used by the NonStop SOAP 3 services, can be extracted into NonStop
SOAP 4 compatible SDL using the SoapAdminCL tool or the NonStop SOAP 4 Administration
Utility (T0904). The SDL generated from the SDR is then used to migrate NonStop SOAP 3 service
to a NonStop SOAP 4 service.
The SoapAdminCL tool or the NonStop SOAP 4 Administration Utility (T0904) can also be used
to generate WSDL files which are compatible with the NonStop SOAP 3 service that is being
34 Introduction to NonStop SOAP