SOAP Procedure

Specifying an Output Log File

The log file contains HTTP headers and data that are transmitted to and from servers when transmitting the HTTP request in PROC SOAP. You use the log file that is created with the DEBUG option to log debug output.

To turn on logging to see the SOAP request and response for an entire SAS session, you must restart SAS with the –jreoptions command line option.

PROC SOAP uses log4j for logging requests and responses so that you can trace them. To create a log file that contains the request issued and the response received, create a file that has the following contents:

log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=wire.log
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern =%d %5p [%c] %m%n

log4j.logger.httpclient.wire=DEBUG, FILE

Enable logging by setting a Java system option using –jreoptions on the SAS command line or in a SAS configuration file. The following syntax shows how to set the system option:

-jreoptions (-Dlog4j.configuration=path-to-log4j-config-file)

The following example shows how to use the entry on the SAS command line. The example uses the Windows operating environment. Be sure to enter the entry on one line:

"C:\Program Files\SAS\SASFoundation\9.2\sas.exe" -CONFIG "C:\Program
Files\SAS\SASFoundation\9.2\nls\en\SASV9.CFG" -jreoptions
(- Dlog4j.configuration=file:/c:/public/log4j.properties)

Using the configuration file and jreoptions method described above turns on logging for the entire SAS session. To turn on httpclient.wire for an individual PROC SOAP call, use the DEBUG option.

You can use the DEBUG option to turn on wire logging for the duration of a PROC SOAP call. The value of the DEBUG option is the path or filename to the output file.