When you migrate .NET Web Service components, you might need to remove or install supporting files on development and deployment computers.

If you deployed .NET projects from earlier versions of PowerBuilder, verify or complete these steps before redeploying the migrated .NET projects:

• For .NET Windows Forms projects, select Full for the project rebuild type before you redeploy your applications from PowerBuilder Classic for the first time.
• For .NET Web Service targets, clear ASP.NET temporary files for the application or component on development computers and production servers.
  The temporary files are located in the C:\WINDOWS\Microsoft.NET\Framework\<version>\Temporary ASP.NET Files\<projectName> directory, where <version> is typically v2.0.50727, and <projectName> is the project’s Web application name or its Web service virtual directory name.
• For all .NET targets, uninstall earlier versions of PowerBuilder runtime files (system assemblies and win32 DLLs) on all deployment computers or servers, then install the runtime files for the current version of PowerBuilder using the Runtime Packager or another tool, as described in the “Checklist for deployment” section of the Deploying Applications and Components to .NET book.
• To migrate a PowerBuilder 12.0 or 12.1 solution, open its .PBWX file using the File menu. If you double-click or drag and drop the file into PowerBuilder .NET 12.6, the Visual Studio Conversion wizard opens, inappropriately. You can use the double-click and drag-and-drop methods to open PowerBuilder 12.6 solutions.

Note
You can convert .NET Windows Forms targets to WPF targets in PowerBuilder .NET. SAP suggests that you migrate older .NET Windows Forms targets to PowerBuilder Classic before you convert them to WPF targets. You cannot directly convert .NET Assembly targets in PowerBuilder Classic to .NET Assembly targets in PowerBuilder .NET.

Migrating EAServer targets from earlier versions of PowerBuilder to PowerBuilder Classic may require some additional considerations. PowerBuilder .NET does not support EAServer targets.

Migrating Components to EAServer 6.0.1 or Later

Intercomponent calls from a PowerBuilder component running in EAServer 6.0.1 require proxies for all called components. In earlier versions of EAServer, a PowerBuilder component can sometimes call another PowerBuilder component running in the same server without the use of a proxy, because the PowerBuilder VM dynamically creates a proxy for the component using method names that match the names of the component's methods.

In EAServer 6.0.1 and later, PowerBuilder components are wrapped as EJBs, providing an extra layer of security and preventing the PowerBuilder VM from dynamically generating a proxy with names that match the component's method names. Therefore, you must create a proxy object for all components you invoke with intercomponent calls. Without a proxy object, the TransactionServer object cannot obtain the correct method names of the component you are calling.

Accessing EAServer Components from .NET Targets

PowerBuilder installs the EAServer DLLs, com.sybase.iiop.net.dll and com.sybase.ejb.net.dll, in the Global Assembly Cache (GAC) on the development computer, and requires these DLLs on runtime computers for applications that access EAServer components from .NET targets. You can use the Runtime Packager to place these DLLs in the GAC on deployment computers.

Note
The DLLs intalled by the PowerBuilder setup program have been tested, and are compatible with EAServer 6.3.1. However, if you use an EAServer version other than 6.3.1, SAP recommends that you copy the DLLs from the EAServer/Lib directory to the GAC of all computers where you deploy your applications. If you then run or re-run the Runtime Packager, you must also recopy these DLLs to the GAC, because the Runtime Packager overwrites them.

Creating an EJB Client Proxy for an EAServer 6.x Component

Building EJB client applications for EJBs running in EAServer 6.x requires additional steps when you create the EJB client proxy.

Procedure

1. Copy the <packagename> directory from the %DJC_HOME%\deploy\ejbjars\ directory on the server to the client computer, where <packagename> is the package that contains the EJB you want to use.
2. In the Select EJB Component dialog box that you open from the EJB Client Proxy project painter, add this directory to the class path.
3. Generate the proxy.

Creating a Client Application for an EAServer 6.x EJB Component

Building EJB client applications for EJBs running in EAServer 6.x requires additional steps when you create the client.

Procedure

1. Copy the eas-server-15.jar file (or eas-server-16.jar if you are using JDK 1.6.x) from the %DJC_HOME%\lib directory to the client computer and include its full path in the client’s CLASSPATH.
2. Copy the stub files from %DJC_HOME%\genfiles\java\classes\ directory to the client computer and include this path in the client’s CLASSPATH. Copy the <packagename> directory from the %DJC_HOME%\deploy\ejbjars\ directory on the server to the client computer, where <packagename> is the package that contains the EJB you want to use, and include this path in the client’s CLASSPATH.
   If you copied these files and directories to a directory on the client called EAServer6, and you want to use an EJB in a package named datamapping, the client CLASSPATH setting might look like this:
   

   Classpath=D:\EAServer6\lib\eas-server-15.jar;D:\EAServer6\genfiles\java\classes;D:\EAServer6\deploy\ejbjars\datamapping

In PowerBuilder versions 10.5 and later, you cannot use system types as variable names in Web service proxies.

If a PowerBuilder system type is used as a variable name, the Web Service Proxy wizard renames the variable by applying the prefix ws_. If you are migrating Web service applications from PowerBuilder 10.2 or earlier, and regenerating the Web service proxies in PowerBuilder 10.5 or later, you may need to modify your code to reflect the change in variable names.

PowerBuilder system types include not only the objects and controls listed on the System tab page in the PowerBuilder Browser, but also the enumerated types listed on the Enumerated page in the Browser, such as band, button, encoding, location, and weekday. For example, if you build a Web service from a PowerBuilder custom class user object, and one of its functions has a string argument named <location>, in the proxy generated for that Web service, the argument is changed to <ws_location>.

In PowerBuilder 10.5.2 and later, when you use the OLE DB database interface with a Microsoft SQL Server database and retrieve data into a DataWindow, or use an embedded SQL cursor in a SELECT statement, server-side cursors help to support multiple command execution.

If this has a negative impact on performance, try increasing the size of the Block database parameter to 500 or more, or adding the following line to the [Microsoft SQL Server] section in the PBODB initialization file to turn off server-side cursors:

 ServerCursor = 'NO'
      

A change was made in PowerBuilder 10.2.1 Build 9716, PowerBuilder 10.5.1 Build 6505, and PowerBuilder 11.0 Build 5021, to correct an anomalous behavior when the SelectedTab property was applied at runtime to a tab for which the Visible property was set to false.

As a result of this change, there is a change in the behavior of the OpenTab and OpenTabWithParm functions. In earlier versions, calling the OpenTab or OpenTabWithParm function to open a user object as a tab page displayed the tab page even if the user object’s Visible property was set to false. In the current version, the user object’s Visible property must be set to true for the tab page to appear.

If your application uses the ImportFile method to import very large text files into a DataWindow or DataStore, ImportFile returns the error code -15.

PowerBuilder versions 10.0 and later are Unicode enabled. Earlier ANSI versions of PowerBuilder were able to import larger text files

Note
The release bulletins for earlier versions listed the size limit for large files as approximately 839,000 lines. However, the size limit depends on the number of columns in the files, as well as the number of lines.