NonStop SOAP 4.1 User's Manual

1. Open the empsdl.xml file and complete the following:
Set the GenerateMessageReceiverUserFunctionsFiles attribute in the <Service>
element to "yes".
For example:
<Service Name="empdb"
ServerClassName="empdb"
GenerateMessageReceiverUserFunctionsFiles="yes"
...
2. Add the directory containing the SoapAdminCL executable image to the OSS PATH variable,
if the path has not been previously set.
OSS>export PATH=<NonStop SOAP 4.1 Installation Directory>/tools:$PATH
For example:
OSS>export PATH=/usr/tandem/nssoap/t0865h01/tools:$PATH
3. Run the SoapAdminCL tool to generate the required stub files.
OSS> SoapAdminCL –i <name of the empdb SDL file>
-o <NonStop SOAP Deployment Directory>
For example:
OSS>SoapAdminCL –i empsdl.xml –o /home/usr1/mynssoap
NOTE:
• Use the -f option with the SoapAdminCL command to overwrite the existing files. If
you do not specify the -f option, SoapAdminCL will generate new files based on the
SDL attributes and report a failure for the existing files which are not overwritten.
4. Verify that the following directory structure is created in <NonStop SOAP 4 Deployment
Directory>:
<NonStop SOAP 4 Deployment Directory>
/services
/empdb
/MRUF_src
Makefile
empdb_MRUF.c
empdb_MRUF.h
SoapPW_empdb.wsdl
services.xml
where,
Makefile
is the Makefile to build the empdb_MRUF.c code
empdb_MRUF.c
is the source file that implements the pre_service() and pre_marshal() business
logic for the handler.
empdb_MRUF.h
is the header file for the empdb_MRUF.c file.
Migrating the business logic for the pre_service() user-exit
After the empdb_MRUF stub files are generated, migrate the business logic for the pre_service()
user-exit to Message Receiver User Function. To do so, edit the empdb_MRUF.c file located in the
<NonStop SOAP 4.1 Deployment Directory>/services/empdb/MRUF_src directory
to implement the business logic of the pre_service user-exit in the
empdb_pre_service_function().
Migrating NonStop SOAP 3 User-exits 73