SOAP runtime configuration

The following configuration is available for SOAP web services at run time.

WSDL Location

The download of the WSDL file can be achieved using an url such as:

http://localhost:8080/test/servlet/SONGS?wsdl

where test is the webapp name and SONGS is the web service name. The download is requested via the ?wsdl parameter.

On the server the property iscobol.soap.wsdl.location controls the location of the wsdl file. It should point to a file system path where wsdl files are copies, ie:

iscobol.soap.wsdl.location=/opt/tomcat8/wsdl_files

The servlet appends the webservice name and ".wdsl" to this path to form a path name, which, if found, is then downloaded. If the file is not found or the property is not set, and http error 404 is returned.

Logging

Logging can be enabled globally and exceptions can be set on a per-method basis.

The following properties can be added to iscobol.properties to control SOAP services logging:

•	iscobol.soap.log=0/1 enables or disables logging on a global level

•	iscobol.soap.log.{methodname}=0/1 enables or disables logging for the SOAP service with the specified method name. This overrides the global settings specified above

•	iscobol.soap.log.folder= is used to configure le folders where log files should be generated. The file name is generated dynamically using the following pattern: {methodname}-{SESSIONID}.log.

For example: to enable logging for the SONGS web service add the following properties:

iscobol.soap.log.songs=1

To enable logging for all soap web services except for the songs web service use the following:

iscobol.soap.log=1 iscobol.soap.log.songs=0

If a SOAP envelope cannot be sucessfully extracted from the request, an exception log is written on standard error (catalina.out if using Tomcat). In the log there will be the exception message and the HTTP request data.