PowerBuilder Runtime Packager

From: http://sybooks.sybase.com/onlinebooks/group-pb/pbg0902e/apptech/@Generic__BookTextView/48736

PowerBuilder Runtime Packager

The PowerBuilder Runtime Packager is a tool that packages the PowerBuilder files an application needs at runtime into a Microsoft Windows Installer package (MSI) file. Windows Installer is an installation and configuration service that is installed with more recent Microsoft Windows operating systems.

You must have Microsoft Windows Installer on your system in order to run the Runtime Packager successfully. Microsoft provides a redistributable package for installation and upgrade on Windows NT and Windows 2000. The Installer is always available on Windows XP.

For more information and to obtain the latest version of Windows Installer, see Windows Installer in the MSDN Library .

The Runtime Packager is intended for use with client applications installed on Windows systems. It does not package the files required if your application exports data as PDF, or if it uses the DataWindow Web control for ActiveX or a plug-in. Make sure that you read the sections referenced in Table 39-2 that apply to your application before using the Runtime Packager.

To use the PowerBuilder Runtime Packager:

1. Select Programs>Sybase>PowerBuilder 9.0>PowerBuilder Runtime Packager from the Windows Start menu or launch the pbpack90 executable file in your Shared\PowerBuilder directory.

2. Select a location for the generated MSI file.

3. Select the database interfaces your application requires.

   The DLLs for the database interfaces you select are added to the package. For ODBC, the pbodb90.ini file is also added. For JDBC, the pbjdbc1290.jar and pbjvm90.dll files are also added. The Java Runtime Environment (JRE) is not added. For more information, see "JDBC database interface".

   Other ODBC or OLE DB files your application may require, such as DataDirect drivers, are not added. For information about deploying these files, see "ODBC database drivers and supporting files" and "OLE DB database providers".

4. If your application uses DataWindow XML export or import, check the XML support check box.

   The Runtime Packager adds PBXerces90.DLL and xerces-c_2_1_0.dll to the package

5. If your application uses the XML services provided by the PowerBuilder Document Object Model, or if it is an EJB or SOAP Web services client, select the appropriate check boxes.

   The Runtime Packager adds the DLLs and JAR files required to the package. For more information about the files required for extensions, see "PowerBuilder extensions".

6. Click Create.

   The Runtime Packager creates an MSI file that includes the files required by the components you selected, as well as the following PowerBuilder runtime DLLs:

   • libjcc.dll

   • pbdwe90.dll

   • pbdwr90.dll

   • pbdwr90.pbd

   • pbjag90.dll

   • pbjvm90.dll

   • pbrtc90.dll

   • pbtra90.dll

   • pbvm90.dll

   The MSI file is a compressed file that can be executed directly on any Windows platform. It registers any self-registering DLLs, adds the installation destination path to the Windows Registry, sets the system PATH environment variable, and adds information to the Registry for the Install/Uninstall page in the Windows Control Panel. It can also be used in some third-party installation software packages.