NonStop SOAP User's Manual

Using NonStop SOAP with a TS/MP Application and
NonStop Processes
NonStop SOAP User’s Manual—520501-012
6-64
Configuring and Running the Server in a WebServer
Environment
The default value is ”dom” for backward compatibility. If you want NonStop
SOAP server to use “sax” as the API, set the value in the NonStop
configuration file.
When using the SAX API, NonStop SOAP does not support SOAP messages
with multi-reference. A SOAP client usually generates multi-referenced
elements in a SOAP request when the RPC style of SOAP messaging is used.
If the SAX API is being used and the SOAP request contains multi-referenced
elements, then a SOAP fault is generated by the NonStop SOAP server.
XML-declaration
sets the character encoding of the XML declaration in the SOAP response. The
possible values are: “ascii”, “output_encoding”, and “none”. If this attribute is
not specified or its value is “ascii” then the encoding of the XML declaration is:
<?xml version=”1.0” encoding=”UTF-8” ?>
If the value of this attribute is “none”, then the XML declaration is not part of the
SOAP response. If the value of this attribute is “output_encoding”, then the
encoding of the XML declaration is in the encoding of the SOAP response. If
an invalid value is supplied for this attribute, the SOAP server outputs an
appropriate error message, and then exits.
4. Edit or create the file /conf/local.config in the iTP WebServer installation directory
to set up automatic form decoding and to add the new Pathway_CGI server class.
(For a description of automatic form decoding, see the iTP Secure WebServer
System Administrator’s Guide .)
To set up automatic form decoding, add this script to the local.config file:
Region /nssoap/* {
AddCGI AUTOMATIC_FORM_DECODING ON
}
To add the Pathway_CGI server class, add These lines:
Server $root/nssoap/ executable-name {
CWD $root/nssoap
Env SOAP_CONFIG_FILE= config-filename
Env ICU_DATA= path-to-ICU
Env EMS_COLLECTOR=\$ process-name
Priority number
Numstatic number
Maxservers number
}
where