Migrating SAS BI Web Services for .NET to SAS BI Web Services for Java

SAS 9.3 BI Web Services no longer includes a .NET version. The benefit of Web services is that the technology of the server does not matter to the client. Because of differences in the underlying technologies between previous .NET and Java versions of SAS BI Web Services, the format for input and output messages differed significantly between the two products. This meant that clients created for one version were typically not compatible with the other version. To encourage interoperability and further innovation in SAS BI Web Services, SAS 9.3 does not include a .NET version.
SAS 9.3 BI Web Services for Java is fully backwards compatible with both the Java and .NET versions of SAS 9.2 BI Web Services. When you perform a migration using the SAS Migration Utility and the SAS Deployment Wizard from SAS 9.2 to SAS 9.3, any generated Web services are also migrated. If the generated Web service being migrated was created with SAS 9.2 BI Web Services for .NET, the migrated SAS 9.3 version is fully compatible with clients that were created for the SAS 9.2 .NET version. The migration process sets a flag on the generated Web service metadata that Web services can use when generating and displaying the WSDL and processing a Web service invocation. You need to modify only the endpoint of the generated Web service in the client code to point to the new endpoint in the migrated system. You can retrieve the new endpoint of the migrated service by using the SAS Configuration Manager or by locating the Web service in /System/Services in SAS Management Console.
If you regenerate a Web service that was migrated from a .NET installation, then the Web service is no longer compatible with clients that were previously created. You can force .NET backwards compatibility by passing the dotnetMode=true query parameter when retrieving WSDLs and invoking Web services. For example, to retrieve a .NET-backwards-compatible WSDL file, use a URL similar to http://host:port/SASBIWS/services/yourServiceName?wsdl&dotnetMode=true. To invoke the Web service, send requests to the endpoint http://host:port/SASBIWS/services/yourServiceName?dotnetMode=true.