Using the Patch Version Setup Dialog

The Patch Version Setup dialog, shown in the following image, is displayed when you select the Set Patch Number command from the Patch menu in the JADE Installation Preferences dialog, to enable you to set up a new patch version for a selected schema.

The current JADE system release version is displayed at the top left of the dialog.

To set a new patch version

  1. In the Select Schema combo box, select the schema whose patch version you want to set up. You can select one schema only.

  2. If patch versioning is currently disabled for your selected schema (indicated in the Schema Details group box), check the Enable Patch Versioning check box in the Schema Details group box.

    Alternatively, if patch versioning is currently disabled for your selected schema, check the Disable Patch Versioning check box to enable patch version control.

  3. To assign a new patch version number for changes made by all developers in the selected schema, specify your new patch version number in the New Patch Number text box. (By default, the current number is incremented by 1.)

    If the patch number that you specify is lower than the current patch version number, a warning dialog is displayed when you click the OK button, advising you of this, and prompting you to click the Yes button if you want to continue. Click the No button to return to the Patch Version Setup dialog to specify a higher number, if required.

  4. In the Keep source versions list box, select the number of changes within the current patch version number whose sources you want to keep. If the default number of five source changes is accepted and you make six changes to a method source, for example, only the latest ten changes are retained for subsequent source comparison.

    If you anticipate that schema methods may be changed several times, consider setting this to a higher value. (No warning is raised if the number of changes within the patch version exceeds the specified number, so you may later find that the first source change is no longer retained.)

  5. If your selected schema has subschemas and you want these patch version options to apply also to all subschemas in that schema, check the Include Subschemas check box. By default, these patch version options apply only to the schema that you selected in the Select Schema list box; that is, you set up different patch version criteria for subschemas.

  6. Check the Include Recompiled Methods check box if you want to include all methods that are recompiled because of other changes but whose source has not changed.

    By default, recompiled methods are not included; that is, this control is unchecked.

    You should check this control when the patch is to be applied to a schema that does not have sources available. (For details, see "Removing Source Code", in Chapter 2 of the JADE Installation and Configuration Guide, and "Loading Schemas using the Schema Load Utility", in the JADE Schema Load User's Guide.)

  7. Click the OK button. (Alternatively, click the Cancel button to abandon your selections.)

Patch version control is then applied to any change by developers to an entity, including schema format changes, in the selected schema (and optionally any subschemas).