Recreating a History of Patch Version Changes

Use the Patch menu Recreate History command from the JADE Installation Preferences dialog to recreate a history of patch version changes (summarizing the JADE development environment status line information) following the:

Removal of the change history during extraction, if specified.
Migration to a new JADE system version, as your _userscm.dat file no longer contains your patch version changes.

When you migrate to a new release:
1. Extract your schemas from your current release.
  
  Your patch version changes are not extracted with your schema. Your source changes and patch history summary are therefore lost when you migrate to the new JADE system version. For details about extracting patch information, see "Extracting a Patch Version", earlier in this chapter.
2. Migrate to the new JADE system version.
3. Load your extracted schemas into the new database.
  
  When loading schemas that contain patch information, entities that have no patch number information are loaded into the patch history set up in the target system into which the schema is loaded, by default. If you want to override existing patch versions in entities when loading a schema (that is, you do not want to retain the patch number or numbers specified in a loaded schema file), see "Loading Schemas using the Schema Load Utility" or "overridePatchVersion", in the JADE Schema Load User's Guide, or "Specifying Advanced Load Options", in Chapter 10 of the JADE Development Environment User’s Guide.
  
  When loading patch information in a schema file, if the entities in the schema file have modified timestamp information, the patch history reflects this timestamp information other than the system version, which will be updated to the current system version. This is so that the history can correctly reflect the user who made the change and the date and time when the change was made.
4. Enable patch versioning. (For details, see "Enabling or Disabling Patch Versioning".)
5. Recreate a history of patch version changes, to enable you to display a patch summary.

You cannot recreate a history of patch changes unless global patch versioning is enabled for your JADE development environment.

If the patch version summary is not displayed in the table in the lower portion of the Summary of Patches window, you may have checked the Remove History After Extract check box in the Patch Version Extract dialog or you have just migrated to or installed a new JADE system version. You must therefore recreate the patch history before you can view that summary information.

Recreating a patch version history removes versioned sources (other than the current, or latest) for the patch version.

To recreate a history of patch version changes

Select the Recreate History command from the Patch menu in the JADE Installation Preferences dialog.

The Recreate Patch History dialog, shown in the following image, is then displayed.

For details, see "Using the Recreate Patch History Dialog", in the following subsection.