NonStop SOAP 4.1 User's Manual
11 NonStop SOAP 4 Features
This chapter provides information about the following features of NonStop SOAP 4:
• “DDL Comments” (page 217)
• “Hot-Deployment of the NonStop SOAP 4 Server” (page 229)
• “Hot-Update for the Deployed Services” (page 229)
• “Internationalization and Encoding” (page 230)
• “Communicating with a Non-Pathway Process” (page 231)
• “Validation Module” (page 233)
• “SOAP_WSDL_NAME DDL Comment” (page 233)
• “Support for Multiple DDL Definitions” (page 234)
• “Check on SOAP Service Deployment” (page 235)
• “Unbounded data elements support” (page 235)
DDL Comments
NonStop SOAP 4 allows you to flag the DDL fields in the DDL file using DDL comments. The DDL
comments feature enables you to modify the request and response SOAP message structures at
runtime. The comment tags should be the first set of nonwhite space character following the *
character (which denotes DDL line as a comment). There could be spaces or tabs following the *
character. If there are more than one comment tags, then the tags should be separated by a space
and adjacent to each other.
NOTE: The DDL Comments must not be applied for a DDL Definition Name. For example:
* @SOAP_OPTIONAL @SOAP_SUPPRESS_IN DEFINITION REQ.
This is wrong and should be avoided.
“Comment Tags” describes the effect of specifying two comment tags. The order in which the
comment tags are specified is not significant.
Table 16 Comment Tags
EffectComment Tag 2Comment Tag 1
@SOAP_SUPPRESS_IN@SOAP_SUPPRESS_IN@SOAP_OPTIONAL
Optional for a request message,
suppressed for the output message
@SOAP_SUPPRESS_OUT@SOAP_OPTIONAL
@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_INOUT@SOAP_OPTIONAL
@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_OUT@SOAP_SUPPRESS_IN
@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_IN
@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_INOUT@SOAP_SUPPRESS_OUT
NOTE: For more information about @SOAP_SUPPRESS_IN @SOAP_SUPPRESS_OUT and
@SOAP_SUPPRESS_INOUT comment tags refer to (page 164)
Before you begin using the DDL comments feature, please ensure the following:
• For the DDL comment tags to be parsed by the SoapAdminCL tool, the DDL file must include
the ?comments complier directive.
For example:
DDL Comments 217