NonStop SOAP 4.1 User's Manual

1. Modify the SDL file.
You must modify the following parameters in the SDL file to migrate transaction management
to NonStop SOAP 4:
• Add or update the value of the GenerateSessionHeader attribute to generate the
XSD schema for the session header block in the WSDL file.
GenerateSessionHeader =“yes”
• Add or update the value of the AbortTransactionOnFault attribute to instruct
NonStop SOAP 4 whether it needs to internally abort the transactions when the service
responds with a fault.
AbortTransactionOnFault=”yes"|"no”
• Add or update the value of the TMFTransactionSupport attribute to inform NonStop
SOAP 4 about the level of transaction support desired by the service.
TMFTransactionSupport=”Required"|"Supports"|"Never”
NOTE: For more information about the TMFTransactionSupport attribute, its permissible
values, and semantics, see “Transaction Management” (page 236).
2. Generate the WSDL file and the services.xml file to deploy the service in NonStop SOAP
, using the SoapAdminCL tool:
OSS> SoapAdminCL –o <NonStop SOAP 4 Deployment Directory> -i <SDL file> -m
where,
-o <NonStop SOAP 4 Deployment Directory>
specifies that the client and service must be created in the <NonStop SOAP 4
Deployment Directory>.
-i <SDL file>
specifies the location of the input SDL file.
-m
is the migration option, and specifies that a separate WSDL file must be created for all
the operations provided by the service in the <NonStop SOAP 4 Deployment
Directory>/client/<service_name>/WSDL directory. The operation-specific WSDL
files generated are compatible with NonStop SOAP 3.
NOTE: On running the SoapAdminCL tool, the SOAP request and response XML files, XML
schema files, and migration WSDL files are also generated.
On successful execution, the following files and directories are generated in the directory
specified in the -o option (when the SDL file used as an input to the SoapAdminCL tool
includes one service containing two operations and each operation containing two responses).
/client
/<service_name>
SoapPW_<operation1_name>.html
SoapPW_<operation2_name>.html
/wsdl
SoapPW_<operation1_name>.wsdl
SoapPW_<operation2_name>.wsdl
/pway-xml
SoapPW_<operation1_name>.xml
SoapPW_<operation1_name>Response0.xml
SoapPW_<operation1_name>Response1.xml
SoapPW_<operation2_name>.xml
SoapPW_<operation2_name>Response0.xml
SoapPW_<operation2_name>Response1.xml
/pway-xsd
Migrating NonStop SOAP 3 Transactions 59