NonStop SOAP 4.1 User's Manual

Implementing the pre_service Message Receiver User Function
For the implementation of business logic for the pre_service Message Receiver User Function,
see the sample code in the <NonStop SOAP 4 Installation Directory
>/sample_services/modules/logging_MRUF/src/logging_MRUF.c file.
Implementing the pre_marshal Message Receiver User Function
For the implementation of business logic for the pre_marshal Message Receiver User Function,
see the sample code in the <NonStop SOAP 4 Installation Directory
>/sample_services/modules/logging_MRUF/src/logging_MRUF.c file.
The logging_MRUF.c file contains the source code and is located in <NonStop SOAP 4
Installation Directory>/sample_services/modules/logging_MRUF/src.
To build your logging module, complete the following steps:
1. Copy the MRUserFunctions_logging directory to the <NonStop SOAP 4 Deployment
Directory> directory.
OSS>cp -rf
<NonStop SOAP 4 Installation Directory>/sample_services/modules/logging_MRUF/src
<NonStop SOAP 4 Deployment Directory>/MRUserFunctions/logging/MRUF_src
2. Set the environment variable AXIS2C_HOME to <NonStop SOAP 4 Deployment
Directory> using the OSS command:
OSS> export AXIS2C_HOME=<NonStop SOAP 4 Deployment Directory>
3. Run the following OSS command to build the logging module DLL:
OSS>cd <NonStop SOAP 4 Deployment Directory>/MRUserFunctions/logging/MRUF_src
OSS>make
The make command builds the libaxis2_MRUF_logging.so DLL and places it in the
<NonStop SOAP 4 Deployment Directory>/MRUserFunctions directory.
NOTE: If you encounter an error while building the logging module, repeat the steps listed
in “Running the SoapAdminCL Tool to Generate the Message Receiver User Functions Stub
Files” (page 150) and “Implementing the Business Logic in the Module Handler Stub Files”
(page 134).
Engaging the Message Receiver User Functions at the Service Level
After the DLL Message Receiver User Functions (libaxis2_MRUF_logging.so) are built, you
must engage the DLL with NonStop SOAP 4.
The Message Receiver User Functions can be engaged in NonStop SOAP 4 only if the
libaxis2_MRUF_logging.so DLL file is present in the <NonStop SOAP 4 Deployment
Location>/MRUserFunctions.
NOTE: If you do not generate the Message Receiver User Functions stub files in the <NonStop
SOAP 4 Deployment Directory>, you must copy the generated DLL file in the <NonStop
SOAP 4 Deployment Directory>/MRUserFunctions directory. For information about
generating DLL files, see “Implementing the Business Logic in the Message Receiver User Functions
Stub Files” (page 150).
Copy the libaxis2_MRUF_logging.so file in the <NonStop SOAP 4 Deployment
Directory>/MRUserFunctions directory, using the following command:
OSS> cp <output directory>/MRUserFunctions/libaxis2_MRUF_logging.so <NonStop SOAP 4 deployment
location>/MRUserFunctions/.
To engage the Message Receiver User Functions at the service level, add the following entry in the
services.xml file located in the <NonStop SOAP 4 Deployment
Directory>/services/empdb directory:
Customizing the NonStop SOAP 4 Message Process Using Message Receiver User Functions 151