ZOMDiff

Compares the object descriptions in the Object Dictionary with object descriptions that have been imported from elsewhere.

Syntax

ZOMDiff [<option>...]

Options

;sh

Treat the Shadow Dictionary as the baseline for comparing objects.

;r!

Do not recompute the status of the differences. Issue the report assuming the results to be current.

;d <document name>

This specifies that the output is to be written to the indicated document. The document must be already created. If the ;d option is omitted, it indicates that the output is to be written to the screen.

;a

If a document name is specified, the ;a option indicates that the output is to be appended to the end of the document. If the ;a option is omitted, it indicates that the output is to replace the contents of the document specified in ;d option.

;b

If a document name is specified, the ;b option indicates that you would like to browse the document file after the action is completed. The ;b option does not take effect if the ;d option was not used to specify an output document.

;w

If a document name was not specified, the ;w option sets pause on while the information is being listed to the screen. The ;w option does not take effect if output is directed to a document using the ;d option.

Comments

This service compares the contents of the standard Object Dictionary and the Shadow Object Dictionary and reports on how they differ. By default, the Object Dictionary is assumed to be the baseline for comparison, but this can be reversed by using the ';sh' option. A sample report is shown below:

                   Zim Object Manager

 
               Object Dictionary Differences Report
                        19/10/96
                         03:37
 
***Changed Objects in the Dictionary
 
Document     _$Customers   zim
Variable      i            zim
 
***New Objects in the Dictionary
 
Directory     TestDir       Zim
Document      diffout       Zim
 
***Deleted Objects from the Dictionary
 
Variable      c1            zim
 
***Renamed Objects in the Dictionary
 
Role          csts          Customers zim (was called: custs)
 
***Moved Objects in the Dictionary
Document      diagout         TestDir (was in: Zim)
Document      infoout         TestDir (was in: Zim)

New objects are defined as objects which exist in the actual dictionary that do not exist in the Shadow Dictionary. Changed objects are defined as objects which have had some of their characteristics changed. For example, a variable whose size has changed. Renamed objects are defined as objects which have matching object keys, but are have different object names. Moved objects are defined as objects which have matching object keys, but are defined to be in different Zim directories.

Example

The following command lists the difference report to the screen with pause mode on.

ZOMDiff ;w

The following command puts the difference report in the document "DiffRpt," and brings up the document browser on the report.

ZOMDiff ;d DiffRpt ;b