Using the Runtime Packager

The DataWindow .NET Runtime Packager is a tool that packages most of the files a DataWindow .NET application needs at runtime into a Microsoft Windows Installer (MSI) file. Windows installer is an installation and configuration service that is installed with most Microsoft operating systems.

StepsTo build an MSI file for a DataWindow .NET application:

  1. Launch the dwpack20 executable file in your Sybase\DataWindow .NET 2.0 directory.

    The image shows the Runtime Packager
  2. Select WinForm deployment for a Windows form application or WebForm deployment for an ASP.NET Web application.

  3. Clear the check boxes for the database interfaces not required for your application.

  4. If your application does not use the ability to import or export the data in a DataWindowControl in XML format, clear the XML Support check box.

  5. (Optional) Specify a different name and/or location for the DataWindow .NET runtime package.

  6. Click Create.

    The Runtime Packager creates an MSI file and adds to it the base components listed in Table 13-1, the pblab105.ini file, and the files you selected. It does not add any executable, DLL, PBD, or PBL files to the package. You can add these files to the MSI file or copy them to the destination directory manually. Running the MSI file on the target computer copies all the files in the package into the directory specified.

    For information about working with MSI files, see the Windows Installer section in the Microsoft documentation.

Finding files in a Web application

When the MSI file generated for a Web application is run on the Web server, it creates an environment variable called DWDOTNET20 and sets its value to the path where the DataWindow DLLs were installed. When the Web application runs, the DataWindow server loads the unmanaged DataWindow .NET DLLs based on the directory specified in the DWDOTNET20 environment variable.

If you choose not to use the Runtime Packager, you can create a DWDOTNET20 environment variable and copy the unmanaged DLLs to the directory it specifies manually.

The .NET assemblies, DataWindow.dll, DataWindowInterop.dll, WebDataWindow.dll, Sybase.PowerBuilder.Db.dll, and Sybase.PowerBuilder.DbExt.dll are also installed in the specified directory. You should move these files to your application’s bin directory, or use another technique for deploying them, as described in “Deploying .NET assemblies”.