NonStop SOAP User's Manual

NonStop SOAP User’s Manual—520501-012
B-1
B Using DDL Comment Tags
Tabl e B- 1 shows the valid and invalid combinations of the NonStop SOAP DDL
comment tags for a single DDL field.
X: Invalid combinations and cannot be used.
1 : This is the same as using @SOAP_SUPPRESS_INOUT (the other comment tag is ignored)
The tag legend used in Table B-1 is:
The order of processing for the SOAP DDL comment tags during un-marshal/marshal
processing is:
•
@SOAP_SUPPRESS_IN, @SOAP_SUPPRESS_OUT,
@SOAP_SUPPRESS_INOUT
The first check is to see if a field is tagged as suppressed. If yes, then the field and
all of its associated comment tags are ignored.
•
@SOAP_OPTIONAL
If a field is marked optional then processing continues for that field only if the
following is true:
Table B-1. DDL Comment Tag Usage
Tags OPTNL SUPR_IN SUPR
_OUT
SUPR
_IO
OCCURS BASE64 ELEM ATT
R
OPTNL X 1
SUPR_IN X 1 1
SUPR_OUT 1 X 1
SUPR_IN 1 1 1 X 1 1 1 1
OCCURS 1 X X
BASE64 1 X
ELEM 1 X X
ATTR 1 X X X
OPTNL SOAP_OPTIONAL
SUPR_IN @SOAP_SUPPRESS_IN
SUPR_OUT @SOAP_SUPPRESS_OUT
SUPR_IO @SOAP_SUPPRESS_INOUT
OCCURS @SOAP_OCCURS_DEP_ON
BASE64 @SOAP_BASE64
ELEM @SOAP_ELEMENT
ATTR @SOAP_ATTRIBUTE