Auto-Chunk window: Fields

 


Current Dictionary

Displays the name of the current editable dictionary. This is the dictionary that the chunk dictionary will be created from (the application dictionary for stand-alone applications or the extracted dictionary for integrating applications.)

Chunk Dictionary

Allows you to name the chunk dictionary you create. Clicking the Chunk Dictionary lookup button displays a dialog box in which you can enter the chunk dictionary name. The name will appear in the Chunk Dictionary field.

Dictionary

Allows you to enter the name the dictionary will have when the chunk is unchunked. The default name is the same as the name of the editable dictionary the chunk is being made from.

You can change this name if you want the dictionary created during the unchunking process to have a different name than the default name.

Module

Allows you to specify which module the Major Version, Minor Version and Build Number information will be associated with. This setting is used when the version numbers and build number are retrieved from the dictionary.

Major Version/Minor Version/Build Number

These fields indicate the major and minor version numbers for your application. The Build Number indicates the build of the current version of the dictionary. For instance, if this is the first build of release 1.3 of your application, enter a 1 for the major number, 3 for the minor number and 1 for the build number. The version numbers and build number can be retrieved from the dictionary using the Runtime_GetModuleInfo() function. Typically these numbers are displayed in the application's About Box.

The values you choose for the major version and minor version are significant. If the installation folder contains a dictionary for a previous version of your product dictionary, the dictionary chunk you are creating will unchunk only if the major version and minor version numbers in the chunk match those in the existing dictionary. If the version numbers don’t match, an error indicating the issue will be written to the InstallErrors.txt file in the installation folder. The dictionary chunk won’t be deleted.

If you have multiple dictionary chunks with the same major version and minor version values, the build number is used to determine the order in which the dictionary chunks are unchunked. The chunks with lower build number values are unchunked first.

If the installation folder contains a dictionary for which the major and minor version numbers match those of the dictionary chunk, the build number will be examined. If the build number of the chunk is the same or greater than the build number of the dictionary, the chunk will be unchunked. If the build number of the chunk is lower, it will not be unchunked, and a message indicating the issue will be written to the InstallErrors.txt file in the installation folder. The dictionary chunk will be deleted.

Installation Scripts

Fields in this group allow you to specify which installation scripts (procedures) will be run when the chunk is unchunked. To specify a starting or ending script, mark the corresponding check box and then click the lookup button for the starting or ending script. The Global Procedures window will appear, allowing you to select a script from a list of existing procedures in the application dictionary.

To remove the procedure script selected for the starting or ending script, simply unmark the check box for the starting script or ending script.

Compression

Settings in this group allow you to specify the level of compression for the chunk dictionary:

Total Compression

Mark this option if you want to create the smallest version of a chunk dictionary. All script source will be removed, as well as any empty blocks of space.

Remove Unused Blocks

Mark this option if you want to remove only empty blocks of space from the chunk dictionary.


Documentation Feedback