NonStop SOAP 4.1 User's Manual

to customize a service. When engaged at the global level, they enable you to customize all the
services deployed in a NonStop SOAP 4 deployment.
Table 2 lists the functions of user-exits provided by NonStop SOAP 3, and the equivalent modules,
handlers, and Message Receiver User Functions provided by NonStop SOAP 4.
Table 2 User-exits Mapped with Equivalent Functions in NonStop SOAP 4.1
FunctionEquivalent Handlers and Message
Receiver User Functions in NonStop
SOAP 4.1
User-exits in NonStop
SOAP 3
Enables you to modify the input XML/SOAP document
sent by the client.
NonStop SOAP 4 module and
handler (engaged in the
PostDispatch phase)
pre_process()
Enables you to modify the request buffer passed to
the service, the PATHMON name, server class name,
and NonStop process name.
pre_service Message Receiver
User Function (fixed deployment
before service invocation)
pre_service()
Enables you to modify the response buffer returned
by the service.
pre_marshal Message Receiver
User Function (fixed invocation
before marshalling)
pre_marshal()
Enables you to modify the output XML document.pre_marshal Message Receiver
User Function (engaged in the
MessageOut phase)
pre_marshal_header()
Enables you to modify the XML/SOAP response to the
client.
NonStop SOAP 4 module and
handler function (engaged in the
MessageOut phase)
post_process()
NOTE: NonStop SOAP 4.1 does not support the skipParse flag. NonStop SOAP 3 supported
this flag, which indicated NonStop SOAP 3 to skip the parsing of the request.
Migrating the NonStop SOAP 3 User-exit Samples
The NonStop SOAP 3 user-exit samples you can migrate are:
• The mod_empdb sample: This sample shows the migration of the pre_process()and
post_process()user-exits.
• The empdb_MRUF sample: This sample shows the migration of the pre_service() and
pre_marshal()user-exits.
• The skipMarshal sample: This sample shows the migration of the skipMarshal flag.
NOTE: The NonStop SOAP 3 user-exits samples are located in the <NonStop SOAP 3
Installation Directory>/samples/pathway/UserExits directory.
This section describes the following steps:
• “Migrating the pre_process() and post_process() user-exits using mod_empdb”
(page 62)
• “Migrating the pre_service() and pre_marshal() user-exits in NonStop SOAP 3 to
Message Receiver User Functions in NonStop SOAP 4.1” (page 71)
Migrating the pre_process() and post_process() user-exits using mod_empdb
The mod_empdb sample shows the migration of the pre_process()and
post_process()user-exits in NonStop SOAP 3 to the corresponding mod_empdb module in
NonStop SOAP 4.1.
62 Migrating NonStop SOAP 3 Services to NonStop SOAP 4 or Higher Versions