NonStop SOAP 4.1 User's Manual

Deploying a NonStop SOAP 4 Pathway Web Service
A NonStop SOAP 4 Pathway Web service can be deployed using an external WSDL file (a WSDL
file not generated by the SoapAdminCL tool).
To deploy the Pathway Web service using an external WSDL file, complete the following steps:
1. Place the WSDL file in the <NonStop SOAP 4 Deployment
Directory>/services/<service_name> directory.
For example, in case of the reflector service, place the WSDL file for the reflector
service in the <NonStop SOAP 4 Deployment Directory>/services/reflector
directory.
2. Next, you must create a services.xml file for your service. You can start by copying an
existing services.xml file to your service directory and then modify it to reflect information
about your particular service. A sample services.xml file is found in the <NonStop SOAP
4 Installation Directory>/sample_services/echo directory.
3. Edit the services.xml file to reflect the configuration settings for your business environment.
NonStop SOAP 4 reads the services.xml file at run-time to deploy the service based on
the instructions set in the services.xml file.
The services.xml file is used to set the following configuration parameters:
1. Define service description parameters, such as name of the service, name of the service
class, path of the service WSDL file, name of the PATHMON or process, and the server
language.
2. Define the response selection criteria in case the service is designed to support multiple
valid responses.
3. Configure transaction management specific parameters such as, granularity of the TMF
transaction support and the operation-specific timeout.
4. Specify references of any modules that need to be engaged at the service level.
5. Specify the message exchange pattern and the message receiver that each operation
needs to use.
NOTE: For more information on services.xml file, see “NonStop SOAP 4 Configuration
Files” (page 177).
4. Save and close the services.xml file.
Accessing a NonStop SOAP 4 Pathway Web Service
To access the deployed reflector service, complete the following steps:
1. Go to the <iTP WebServer Deployment Directory>/conf directory and run the
restart script:
OSS> cd <iTP_WebServer_Deployment Directory>/conf
OSS> ./restart
Developing a NonStop SOAP 4 Pathway Web Service Using the WSDL2PWY Tool 269