NonStop SOAP 4.1 User's Manual

Figure 7 Processing Logic in NonStop SOAP 3 and NonStop SOAP 4.1

Service

WSDL

</>

Services.xml

SDR

NonStop

SOAP 3 Server

NonStop

SOAP 4 Server

You can use the SoapAdminCL tool (available with the NonStop SOAP 4.1 distribution) to convert

the NonStop SOAP 3 SDR file and the DDL dictionary files to the NonStop SOAP 4.1

services.xml file and WSDL files. For all the operations of the service, the SoapAdminCL tool

generates the SOAP request and response XML files, XML schema files, and HTML client files.

NOTE: You must not stop a service to migrate it from NonStop SOAP 3 to NonStop SOAP 4.1.

This means that your clients using the service do not experience any downtime.

Migrating and deploying an application from NonStop SOAP 3 to NonStop SOAP 4.1 requires

the following tasks:

• “Generating the SDL File from the NonStop SOAP 3 SDR File” (page 53)

• “Modifying the SDL File” (page 54)

• “Generating the HTML Client, WSDL, XML Schema, and services.xml Files to Deploy the

Service” (page 54)

• “Migration Considerations” (page 56)

Generating the SDL File from the NonStop SOAP 3 SDR File

If you do not have the SDL file for the NonStop SOAP application, you can generate it from the

NonStop SOAP 3 SDR file using the SoapAdminCL tool.

NOTE: For information about using the SoapAdminCL tool, see Chapter 10: “NonStop SOAP

Tools” (page 194).

To generate the SDL file from the NonStop SOAP 3 SDR file, complete the following steps:

1. Set the OSS environment variable SOAP_SDLDB_LOC to the Guardian location where the

SDR file for the NonStop SOAP 3 application is available:

OSS> export SOAP_SDLDB_LOC=\$<datavol>.<subvol>

For example:

OSS> export SOAP_SDLDB_LOC=\$data.soapapp

2. Add the directory containing the SoapAdminCL executable image to the OSS PATH variable.

OSS>export PATH=<NonStop SOAP 4 Installation Directory>/tools:$PATH

For example:

OSS>export PATH=/usr/tandem/nssoap/t0865h01/tools:$PATH

3. Go to the OSS directory where you want to generate the SDL file:

OSS> cd <My SDL location>

For example:

Migrating the NonStop SOAP 3 Services 53