Create Chunk Dictionary window: Fields

 


Dictionary

Displays the name of the source dictionary from which the dictionary chunk is being made. The name in this field is the name of the dictionary that the chunk will become part of. For instance, if you're creating a chunk from the stand-alone dictionary RESM.DIC, be sure that name appears here. If you're creating a chunk from an extracted integrating dictionary, be sure that dictionary name appears here.

Sequence Number

Specifies the order in which this chunk will be read when "unchunked." If you're creating a single chunk for the entire dictionary, specify 1. If you break the application dictionary into several smaller chunks, the chunks will be merged into the application dictionary in the order specified here.

Module

Indicates which module the Major Version, Minor Version and Build Number information is associated with. The setting in this field is used when the version numbers and build number are retrieved from the dictionary.

Major/Minor/Build Number

The Major and Minor 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.

Starting/Ending Script

These fields specify which installation scripts (procedures) will be run when the chunk is merged into the application dictionary. 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.

The starting and ending scripts run only after all dictionary chunks have been merged into the application dictionary. All starting scripts are run in the order the chunks were merged. Then all ending scripts are run in reverse order. For example, if three dictionary chunks were merged, the starting and ending scripts would run in the following order:

 

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

Dictionary Module Type

Allows you to select the type of resources (Forms, Reports or Core resources) you want to add to the chunk dictionary.

Series

Allows you to select the series from which you want to add resources to the chunk dictionary.

Source Dictionary Modules

Displays modules of the selected series and type. To add a module to the chunk dictionary, select it from the list, then click Transfer.

Chunk Dictionary Modules

Displays modules that will be included in the chunk dictionary. To remove a module, highlight it and click Delete.

Size

Displays the size of the selected module in the associated list.

Total

Displays the total size of all modules in the associated list.


Documentation Feedback