NonStop SOAP 4.1 User's Manual

const axutil_env_t * env
PRE_MARSHAL_FUNCTION func)
Parameters:
inst
is an input parameter and is a pointer to the Message Receiver User Functions structure created
using the MessageReceiverUserFunctions_create() function.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
func
is an input parameter that holds the name of function that implements the pre_marshal
functionality.
Return Values:
• AXIS2_SUCCESS on success.
• AXIS2_FAILURE on failure.
Implementing the pre_service and pre_marshal Message Receiver User Functions
The pre_service and pre_marshal user functions, implemented in the Message Receiver User
Functions, can be used to modify the request and response buffers, and Pathway and NonStop
process-specific parameters, such as PATHMON name, Process name, and serverclass name.
The pre_service and pre_marshal functions also enable you to modify the default Pathway
message receiver flow by setting the skip_service and skip_marshal flags.
The pre_service Message Receiver User Function
The pre_service Message Receiver User Function is called after the request buffer is created
and before the request buffer is sent to the Pathway or NonStop process-based service.
You can use the pre_service Message Receiver User Function to change the following
parameters:
• Request message buffer
• PATHMON and server class name (for Pathway-based services)
• Process name (for process-based service)
You can modify the default process of NonStop SOAP 4 using the following flags:
• Skip service invocation
• Skip response creation
NOTE: For more information on customizing the NonStop SOAP 4 default message process, see
“Modifying the Message Flow in the Pathway Message Receiver using NonStop SOAP 4 Message
Receiver User Functions” (page 147).
Synopsis:
int <service name>_pre_service_function(
axis2_MessageReceiverUserFunctions_t *MessageReceiverUserFunctions,
axis2_char_t * payload,
const axutil_env_t * env,
int ReqLen,
struct axis2_msg_ctx * in_msg_ctx,
struct axis2_msg_ctx * out_msg_ctx)
Customizing the NonStop SOAP 4 Message Process Using Message Receiver User Functions 141