NonStop SOAP 4.1 User's Manual

Developing the Message Receiver User Functions involves the following tasks:
1. “Running the SoapAdminCL Tool to Generate the Message Receiver User Functions Stub
Files” (page 150)
2. “Implementing the Business Logic in the Message Receiver User Functions Stub Files” (page 150)
3. “Engaging the Message Receiver User Functions at the Service Level” (page 151)
4. “Verifying the Message Receiver User Functions Output” (page 152)
Running the SoapAdminCL Tool to Generate the Message Receiver User Functions Stub Files
To run the SoapAdminCL tool to generate the Message Receiver User Functions stub files, complete
the following steps:
1. Add the directory that includes the SoapAdminCL executable image to the OSS PATH variable.
OSS>export PATH=<NonStop SOAP 4 Installation Directory>/tools:$PATH
For example:
OSS>export PATH=/usr/tandem/nssoap/t0865h01/tools:$PATH
2. Run the SoapAdminCL tool to generate the Message Receiver User Functions stub files:
OSS> SoapAdminCL -MRUF <MRUF_name> -o <output directory>
where,
<output directory>
specifies the output directory where the Message Receiver User Functions stub files will be
generated.
<MRUF_name>
specifies the name of the generated Message Receiver User Functions.
For example:
OSS> SoapAdminCL –MRUF logging –o /home/usr/mynssoap
3. Verify that the following directory structure is created in the <output directory>:
MRUserFunctions
/logging
/MRUF_src
logging_MRUF.h
logging_MRUF.c
Makefile
where,
logging_MRUF.h
is the header file for the Message Receiver User Functions.
logging_MRUF.c
is the C stub file where you can implement the business logic for the pre_service and
pre_marshal Message Receiver User Functions.
Makefile
is the Makefile to build the Message Receiver User Functions DLL.
Implementing the Business Logic in the Message Receiver User Functions Stub Files
After generating the Message Receiver User Functions stub files using the SoapAdminCL tool, you
must implement the business logic in the pre_service and pre_marshal Message Receiver
User Functions as described in:
• “Implementing the pre_service Message Receiver User Function” (page 151)
• “Implementing the pre_marshal Message Receiver User Function” (page 151)
150 Customizing NonStop SOAP 4 Message Processing