NonStop SOAP 4.1 User's Manual

4. “Modifying the Message Flow in the Pathway Message Receiver using NonStop SOAP 4
Message Receiver User Functions” (page 147)
Configuring NonStop SOAP 4 Message Receiver User Functions
Message Receiver User Functions can be configured in NonStop SOAP 4 at the service level and
at the global level.
This section includes the following topics:
• “Configuring NonStop SOAP 4 Message Receiver User Functions at the service level” (page 138)
• “Configuring NonStop SOAP 4 Message Receiver User Functions at the global level” (page 138)
Configuring NonStop SOAP 4 Message Receiver User Functions at the service level
To configure Message Receiver User Functions at the service level, complete the following steps:
1. Add the parameter name MessageReceiverUserFunctions under the service element
in the services.xml configuration file. The value of the
MessageReceiverUserFunctions parameter must be set to the DLL (.so file) that
implements the Message Receiver User Functions:
<parameter name=”MessageReceiverUserFunctions”>[Message Receiver User Functions DLL]</parameter>
For example:
<parameter name=”MessageReceiverUserFunctions”>axis2_MRUF_empdb</parameter>
NOTE: The parameter element that defines the MessageReceiverUserFunctions
must always be written on a single line.
2. Place the DLL that implements the Message Receiver User Functions in the <NonStop SOAP
4 Deployment Directory>/MRUserFunctions directory.
NonStop SOAP 4 generates the name of the DLL by adding lib as the prefix and .so as the
suffix to the Message Receiver User Functions DLL class defined in the services.xml
configuration file.
For example:
If axis2_MRUF_empdb is the Message Receiver User Functions class name, the name of the
DLL that implements the Message Receiver User Functions must be
libaxis2_MRUF_empdb.so.
NOTE: Message Receiver User Functions are different from the handlers that are used to
customize the default NonStop SOAP 4 phases or user-defined phases, in the following ways:
• Message Receiver User Functions are called from the Message Receiver.
• Message Receiver User Functions do not have a module configuration file.
• Message Receiver User Functions DLLs must be placed in the <NonStop SOAP 4
Deployment Directory>/MRUserFunctions directory. Handlers must be placed
in the <NonStop SOAP 4 Deployment Directory>/Modules/<module_name>
directory.
Configuring NonStop SOAP 4 Message Receiver User Functions at the global level
To configure Message Receiver User Functions at the global level, complete the following steps:
138 Customizing NonStop SOAP 4 Message Processing