NonStop SOAP 4.1 User's Manual
1. Define the request and response XML payload for the service.
For example, for the math service:
• The request XML payload for the add operation is:
<Body>
<add>
<param1>1< /param1>
<param2>2< /param2>
</add>
</Body>
• The response XML payload for the add operation is:
< Body>
< addResponse>
<result>3< /result>
< /addResponse>
</Body>
2. Copy the mathddl file from the <NonStop SOAP 4 Installation
Directory>/sample_services/math/service to an OSS location.
This OSS location will be referred as <Math Source Directory>.
NOTE: The NonStop SOAP 4 distribution includes the mathddl DDL file for all the operations
of the math service.
3. Edit the DDL file copied to the <Math Source Directory> to modify the ?DICT location.
Set the ?DICT location to a valid subvolume location on your system.
NOTE: You can create the DDL file for the math service using a text editor in the <Math
Source Directory>.
The DDL file must contain the following entries:
?dict $<volume>.<subvolume>
?comments
DEFINITION PARAMETER.
10 PARAM1 TYPE binary 32.
10 PARAM2 TYPE binary 32.
END
DEFINITION RESULT.
10 Response TYPE binary 32.
END
where,
$<volume>.<subvolume>
is a valid Guardian location where you want to create the dictionary files for the math
service.
Ensure that you have read and write permissions for this directory.
4. To compile the DDL file, use the following command:
oss> gtacl –p ddl < “service DDL file”
For example:
OSS> gtacl –p ddl < mathddl
Ensure that the DDL command does not return any errors. For information about DDL errors,
see the Data Definition Language (DDL) Reference Manual.
On successfully completing the DDL dictionary compilation, the dictionary files are generated in
the Guardian subvolume specified in the service DDL file.
Developing NonStop SOAP 4 Services using Service APIs 97