There are different strategies for migrating existing source control projects from earlier versions of PowerBuilder. To migrate a target from PowerBuilder 8 or later, you can check the target out from source control, then add the target to a workspace in the new version of PowerBuilder. When the Migrate Application dialog box prompts you to migrate the libraries in the application library list, click OK to begin the migration.
If you change the directory hierarchy for target libraries in the new version of PowerBuilder, you should use the Existing Application target wizard to create a new target instead of adding and migrating a PowerBuilder 8 or later target. If you keep the old target file (PBT) in the new target path, you must give the new target a different name or the wizard will not be able to create a new PBT.
For information on using the Existing Application target wizard, see “Using the Existing Application target wizard”.
When you open a PowerBuilder 8 or later workspace in the current version of PowerBuilder, a dialog box prompts you to migrate the workspace targets. If you select the No Prompting check box and click OK, the target libraries are migrated without additional prompting, and the Migrate Application dialog box never displays. You can then add the migrated target objects to source control from the new version of PowerBuilder.
For more information about migration, see “Migrating targets”.
Uninstalling PowerBuilder 8 If you uninstall PowerBuilder 8 from a machine where you have already installed a later version of PowerBuilder, the uninstall deletes the PBNative registry entry. Subsequently, if you want to use PBNative source control with PowerBuilder 10, you must reregister PBNAT105.DLL. Attempting to use PBNative before reregistering the DLL produces an error message that points out the problem and the solution. You can reregister the DLL by opening a DOS command box, switching to the Sybase\Shared\PowerBuilder directory, and entering the command REGSVR32 PBNAT105.DLL.
The uninstall for PowerBuilder 9 and later does not remove the DLL or the registry entry for PBNative source control.
Migrating an application from PowerBuilder 7 or earlier requires a different approach, since workspaces and targets were introduced with PowerBuilder 8. You need to create a new workspace and appropriate targets for any PowerBuilder 7 (or older) objects that you are migrating.
The strategies available to you or the project manager are:
To use the first strategy, you must keep a copy of the old version of PowerBuilder—at least until you have finished migrating all your source-controlled PBLs.