NonStop SOAP 4.1 User's Manual

• “Migrating to Contract-First Services” (page 208)
• “WSDL2PWY Limitations” (page 210)
Generating NonStop SOAP 4 Client Stubs
The WSDL2PWY tool generates the NonStop SOAP 4 client stubs in the C programming language.
The generated client stubs contain the interface code to be implemented when developing a client
using NonStop SOAP 4 client APIs.
To generate the NonStop SOAP 4 client stubs using the WSDL2PWY tool, complete the following
steps:
1. Set the OSS environment variable NSSOAP_HOME to the OSS location where the NonStop
SOAP 4 installation directory is located:
OSS> export NSSOAP_HOME=<NonStop SOAP 4 Installation Directory>
For example:
OSS> export NSSOAP_HOME=/usr/tandem/nssoap/t0865h01
where,
/usr/tandem/nssoap/t0865h01 is the NonStop SOAP 4 installation directory.
2. Add the directory containing the WSDL2PWY 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. Add the <Java Installation Directory>/bin directory to the PATH environment
variable, using the command:
OSS> export PATH=<Java Installation Directory>/bin:$PATH
For example:
OSS> export PATH=/usr/tandem/java/bin:$PATH
where,
/usr/tandem/java/
is the Java installation directory.
4. Generate the client stubs using the WSDL2PWY command:
OSS> WSDL2PWY [options] –uri [wsdl_path]
where,
[options] includes the following:
-o <output location>
specifies the output location where the client stubs and the Makefile
(Makefile_client)must be generated.
-a
generates the client stubs to invoke a Web service in asynchronous or non-blocking
mode. In this mode, the client sends a request to the Web service and continues
processing without waiting for a response.
-s
generates the client stubs to invoke a Web service in synchronous mode or blocking
mode. In this mode, the client sends a request to the Web service and waits for a
response.
-uri <wsdl_path>
specifies the location of the WSDL file.
204 NonStop SOAP Tools