8 2 4 Include and Process File Data

LANSA Deployment Tool

8.2.4 Include and Process File Data

Use the option Include File Data to determine if file data should be included when deploying the file and how to manage any existing file data – if the file already exists – in relation to new file data.

 

 

To avoid unnecessarily unloading and reloading file data when installing patches or later versions of an Application where the file definitions have not changed, use the option Exclude data, Reload existing.

Also note, that after installing an MSI, the DAT file is deleted. This means it is not available for a patch to use, unless the patch has changed the table layout or the data is different, in which case the patch will include it. So to avoid complications, with patches, always use the option Exclude data, Reload existing.

It is highly recommended when creating a patch to go through ALL the files you have shipped and change the File Data option to Exclude data, Reload existing.

The following processing options are available:

File Data option

Action

Exclude data, Drop existing

No file data is included in the package.  If the file already exists, all data will be removed.

Exclude data, Reload existing

No file data is included in the package.  If the file already exists, all data will be retained.

When installing patches, if the file definition has not changed, this option should be used to avoid unloading and reloading file data.

This is the default option.

Include data, Drop existing

File data is included in the package.  If the file already exists, all data will be removed and package data will be loaded.

Include data, Ignore duplicates

File data is included in the package.  If the file already exists, all data will be retained and package data will be loaded.  Any duplicate records in the package data will be ignored.

Include data, Replace duplicates

File data is included in the package.  If the file already exists, all data will be retained and package data will be loaded.  Any duplicate records in the package data will replace the existing record.

Include data (new files only)

This option is deprecated. It will be removed in the next release.

File data is included in the package and will be installed if the file does not already exist.

If the file already exists in the application no processing of the file data will occur.

Include data (existing files only), Drop existing

This option is deprecated. It will be removed in the next release.

File data is included in the package but will only be installed if the file already exists.  Any pre-existing file data is not reloaded.

Include data (existing files only), Ignore duplicates

This option is deprecated. It will be removed in the next release.

File data is included in the package but will only be installed if the file already exists.  Any pre-existing file data is reloaded after the new file data and duplicate records in the package data will be ignored.

Include data (existing files only), Replace duplicates

This option is deprecated. It will be removed in the next release.

File data is included in the package but will only be installed if the file already exists.  Any pre-existing file data is reloaded before the new file data and duplicate records in the package data will replace the existing record.