NonStop SOAP 4.1 User's Manual

10 NonStop SOAP Tools............................................................................194
The SoapAdminCL Tool.........................................................................................................194
Generating NonStop SOAP 4 Files using the SDL File...........................................................194
Generating Module and Handler Stubs..............................................................................199
Generating Message Receiver User Functions Stubs..............................................................200
Generating the NonStop SOAP 4 SDL File from the NonStop SOAP 3 SDR File........................201
Additional Options..........................................................................................................202
The WSDL2PWY Tool...........................................................................................................203
Generating NonStop SOAP 4 Client Stubs..........................................................................204
Generating Service Stubs..................................................................................................205
XML Schema and C Data Types Mapping...........................................................................206
Migrating to Contract-First Services.....................................................................................208
WSDL2PWY Limitations....................................................................................................210
The WSDL2C Tool................................................................................................................211
Generating NonStop SOAP 4 Client Stubs..........................................................................211
Generating NonStop SOAP 4 Service Skeleton Files.............................................................213
The NonStop SOAP 4 Administration Utility.............................................................................215
Installing NonStop SOAP 4 Administration Utility.................................................................215
11 NonStop SOAP 4 Features.....................................................................217
DDL Comments.....................................................................................................................217
Specifying DDL Fields as Optional......................................................................................218
Exposing DDL Fields as XML Attributes................................................................................221
Setting the SoapDDLAttribute in the SDL File...................................................................222
Flagging a DDL Field with SOAP DDL Comment Tags.......................................................222
Specifying Base64 Encoding.............................................................................................225
Using the SOAP_OCCURS_DEP_ON DDL Comment Tag.......................................................226
Hot-Deployment of the NonStop SOAP 4 Server.......................................................................229
Hot-Update for the Deployed Services.....................................................................................229
Internationalization and Encoding...........................................................................................230
Configuring the request encoding......................................................................................230
Configuring the response encoding....................................................................................230
Configuring the server encoding........................................................................................231
Communicating with a Non-Pathway Process............................................................................231
Creating an SDL File to Communicate with a Non-Pathway Process........................................232
Creating a DDL File with the Request/Response Structures.....................................................232
Generating NonStop SOAP 4 Files using the SoapAdminCL Tool...........................................232
Validation Module................................................................................................................233
SOAP_WSDL_NAME DDL Comment.......................................................................................233
Support for Multiple DDL Definitions........................................................................................234
Check on SOAP Service Deployment.......................................................................................235
Unbounded data elements support..........................................................................................235
12 Transaction Management.......................................................................236
Transaction Module Configuration..........................................................................................237
SOAP Server Transaction Management...................................................................................238
SOAP Client Transaction Management....................................................................................238
Begin a New Transaction..................................................................................................239
Continue a Transaction.....................................................................................................241
Commit a Transaction.......................................................................................................242
Abort a Transaction..........................................................................................................244
Configuring the Level of Transaction Support............................................................................245
Transaction Timeouts.............................................................................................................246
Configuring Transaction Timeout........................................................................................247
Configuring Transactions to Abort on Fault..........................................................................248
Session Management and Transactions...................................................................................249
8 Contents