NonStop SOAP for Java User's Manual

Using the Administration Tools

NonStop SOAP for Java User’s Manual—523860-001

5-25

Tracing SOAP Messages

NonStop SOAP for Java has two options available for tracing SOAP messages:

•

Using Command-Line Based Tcp Tunnel on page 5-25

•

Enabling Server-Side Tracing on page 5-25

Using Command-Line Based Tcp Tunnel

This is a command-line based tool version of Tcp Tunnel. It can open a port on the

machine on which it was started, and will tunnel traffic to the remote host/port

combination. You need to provide a file name at startup.

Start the Tcp Tunnel tool by executing the following script from the bin directory:

OSS: TcpTunnel listenport tunnelhost tunnelport filename

where

listenport

is the port that you want the tool to listen on (that is, the port which you will send

your SOAP messages to).

tunnelhost

is the hostname of the NonStop SOAP server.

tunnelport

is the port that the NonStop SOAP server is running on

filename

is the file where the requests and responses are logged.

The SOAP clients can then be run on NonStop server and instead of providing the

NonStop SOAP server's IP address and port, provide the IP Address of the NonStop

server where the Tcp Tunnel is running and the port to which the Tcp Tunnel is

listening. Requests get written to a file name filename.req and responses to

filename.rsp.

Enabling Server-Side Tracing

The NonStop SOAP for Java product has a feature that allows the tracing of messages

to and from the SOAP server. To do this, you need to provide a start-up parameter in

the web.xml file located in the webapps directory of the NonStop SOAP for Java

product. The default location is:

<iTPWebserver_Instl_Dir>/servlet_jsp/webapps/soap/WEB-INF/web.xml