NonStop SOAP 4.1 User's Manual

Modifying the Message Flow in the Pathway Message Receiver using NonStop SOAP 4 Message
Receiver User Functions.....................................................................................................147
The axis2_msg_recv_get_skipService()Function................................................................147
The axis2_msg_recv_get_skipMarshal()Function..............................................................148
The axis2_msg_recv_set_skipService()Function..............................................................148
The axis2_msg_recv_set_skipMarshal()Function...............................................................149
Developing Sample Message Receiver User Functions for NonStop SOAP 4............................149
Running the SoapAdminCL Tool to Generate the Message Receiver User Functions Stub
Files..........................................................................................................................150
Implementing the Business Logic in the Message Receiver User Functions Stub Files..............150
Implementing the pre_service Message Receiver User Function.....................................151
Implementing the pre_marshal Message Receiver User Function....................................151
Engaging the Message Receiver User Functions at the Service Level...................................151
Verifying the Message Receiver User Functions Output.....................................................152
8 NonStop SOAP 4 Service Description Language.........................................153
SDL File Elements and Attributes.............................................................................................153
SDL Service Types.................................................................................................................154
The Pathway Element........................................................................................................154
The PathwayEnvironment Element..................................................................................154
The Service Element................................................................................................155
The Operation Element............................................................................................159
The Process Element.........................................................................................................174
The ProcessEnvironment Element....................................................................................174
The ProcessDetails Element......................................................................................174
The ServerAPI Element......................................................................................................176
9 NonStop SOAP 4 Configuration Files........................................................177
The itp_axis2.config File........................................................................................................177
Linking iTP WebServer to the NonStop SOAP 4 Deployment..................................................177
Specifying iTP WebServer Filemap for NonStop SOAP 4.......................................................177
Defining the Log Levels of the NonStop SOAP 4 Server.........................................................178
Defining the Log File Size..................................................................................................180
Defining Separate Log and Trace Files for NonStop SOAP 4 Servers.......................................180
The axis2.xml File.................................................................................................................180
Setting the Message Receiver and the Message Exchange Pattern..........................................180
Attaching a Module at the Global Level..............................................................................181
Attaching Message Receiver User Functions at the Global Level..............................................181
Specifying the Order of Phase Invocation in NonStop SOAP 4 Message Processing.................182
The services.xml File..............................................................................................................182
Updating the Service Parameters........................................................................................183
Configuring a service as a Pathway application..............................................................183
Configuring a service as a process................................................................................183
Configuring a service as a DLL......................................................................................183
Other Service Parameters.............................................................................................184
Defining Multiple SOAP Response Selection Criteria.............................................................186
Controlling TMF Transaction Support..................................................................................188
Engaging a Module at the Service Level.............................................................................189
Setting the Operation-Specific MEP....................................................................................189
Setting the Operation-Specific Message Receiver..................................................................190
The module.xml File..............................................................................................................190
Specifying the Module Name and Module Class File Name..................................................191
Defining a New Handler and Specifying its Invocation Order................................................191
Defining the Module-Specific Parameters.............................................................................192
Contents 7