Running the JADE Logical Certifier from a Dialog

You can also run the diagnostic tool from a dialog interface, which enables you to interactively specify schemas or classes that you want to certify or repair. The JADE Logical Certifier icon is installed in your JADE program folder when you install JADE or upgrade to this release.

To run the standalone JADE Logical Certifier application, perform one of the following actions

From the JADE development environment:
1. Select the RootSchema in the Schema Browser of the current schema version (if applicable).
2. Select the Run command from the File menu or the Applications command from the Browse menu.
  
  Alternatively, click the Run Application toolbar button.
3. From the Run Application dialog that is then displayed, select the JadeLogicalCertifier application the Application Name text box.
Select the JADE Logical Certifier program icon from your JADE program folder.

The following is an example of the command line required to run the JADE Logical Certifier tool.
```
c:\jade\bin\jade.exe path=c:\jade\system schema=RootSchema ini=c:\jade\system\jade.ini app=JadeLogicalCertifier server=SingleUser
```

The Jade Logical Certifier dialog, shown in the following image, is then displayed.

Although all schemas are selected for logical certification by default (that is, Certify All Schemas is selected in the Operation combo box), you can expand the certify and meta certify nodes in the Operation combo box to tailor the logical certification or user or meta data. Select the:

Certify Selected Schemas operation if you want to select the schemas whose classes are logically certified from the list in the Schemas list box.
Certify Selected Classes operation if you want to select one or more classes displayed in the Classes list box for the schema selected in the Schemas list box. (You can select one schema only, when using this operation.)
Meta Certify All Schemas operation if you want to check the referential integrity of the schema definition. (As this operation checks the schema definition of all user schemas, you cannot select individual schemas in the Schemas list box.)
Meta Certify Selected Classes operation if you want to select one or more meta classes displayed in the Classes list box for all user schemas. (As the certification of meta data in selected classes is performed at the RootSchema level, you cannot filter the schema selection for this operation.)
Repair operation after you have edited the _logcert.fix file, to run the repair of detected errors. (As this operation repairs all errors for which fixes are available, you cannot filter the selection of the schemas or classes for which the repair operation is run.)
Set Incremental Transaction ID operation if you want to manually set the transaction ID that the Logical Certifier uses during an incremental certify to determine if an inverse has been changed and needs to be checked. (For details, see "Manually Determining the Incremental Transaction ID".) The Set Incremental Transaction ID dialog is then displayed.

By default, when you have selected the Certify All Schemas operation, inverses in all classes in all schemas will be checked.

Select the Incremental Certify option button if you want to check only inverse references and collections that have changed since the last time the system was certified.

Checking only changed inverses incrementally can significantly reduce the time required to check the integrity of user data.

When you certify all schemas or you meta-certify all schemas (that is, you have selected the Certify All Schemas or Meta Certify All Schemas option in the Operation combo box), the Workers check box is enabled, so that you can control the number of worker processes available if you want all classes to be processed in parallel. By default, a single worker process is used. When you specify that more than one worker process can be used, the elapsed time to certify a system may be reduced.

The number of worker processes will depend on a multitude of different factors, including things such as available I/O bandwidth, CPU cores, the number of instances, and the number of inverses in each class. As a guide, the number of workers should not exceed the number of CPU cores minus one.

Entities in the Schema and Classes list boxes are disabled when their selection does not apply to the selected logical certify operation. To select a group or range of classes or schemas displayed in the Classes or Schemas list box, use the Shift key or Ctrl key, respectively.

Although all items in the selected operation are certified by default, you can select the Certify Created During Date Range option button and then enter the start and end creation dates of the items that you want certified. The JADE Logical Certifier application then checks only the items that were created within the specified date range.

The JadeLog directory instance is used as the default value for output from the logical certification. If you want to direct output to another directory, specify the required valid absolute path in the Log File Directory text box. Alternatively, click the adjacent browse button (indicated by the … points of ellipsis symbol) to display the common Browse for Folder dialog that enables the selection of the log file directory in which certified, checked, or repaired files will be located.

Certification data is appended to the _logcert.log file and the _repair.log file. Meta data certification output is written to _metacert.* files, except for the fix file, which is output as _logcert.fix.

If you do not want certify progress messages to be output to the Jade Interpreter Output Viewer window, uncheck the Display Progress check box. By default, certify progress messages are output to the viewer window. You can control the frequency with which these messages are output, by specifying the number of instances in the Instances text box. By default, messages are output every 10,000 instances.