Access
To select the objects to include in the individual comparison, select either:
the Individual comparison option in the Utilities submenu in the context-sensitive menu for environments.
the Individual comparison option in the Utilities menu, or the equivalent icon in the tool bar of the Session manager.
the Individual comparison option in the context-sensitive menu of the Result 1, Result 2 or Storage tab in the Maintenance manager.
the Individual comparison option in the context-sensitive menu of the Result 1, Result 2 or Storage tab in the Multisource search.
the Individual comparison option in the context-sensitive menu of the DIC, MAC, RAT, MSG, PGO, PGM, MR, CLA or PRC tab of the Repository dialog box in the 4GL Editor.
the Individual comparison option in the context-sensitive menu of the CST, ENT, GRA, JEN, MAC, RAT, MSG, PGM, MR, CLA or PT tab of the Modify/Display a correction dialog box from an environment used in a version manager.
the Individual comparison option in the menu Macro-instruction, RAD template, PGO, Program, Management rule or Program template or Classes in the 4GL Editor's menu bar.
- the Individual comparison option in the Components menu in the Build component manager's menu bar or in the Components list's context-sensitive menu of the same screen.
You can use this dialog box to select two objects in either one or two environments and run the comparison of their source code (for objects with a source code) or their definition (for objects included in the CDM or LDM).
Lists
Object type
Type of the objects to be compared.
Possible values: Class, Build component, Conceptual Entity, Conceptual Property, Constant, Data Type, Dialog Type, Error Message, Join Entity, Logical Entity, Macro-instruction, Management Rule, Personalized Graphical Object, Program, Program - Description, RAD Template and Relationship.
For macro-instructions, RAD templates, personalized graphical objects, programs, management rules, classes and dialog types, the source of two objects is compared. For constants, error messages and CDM or LDM objects, the definition is compared.
Mandatory entry.
Environment name (for Object 1 and Object 2)
Name of the environments involved in the comparison, to be selected from the list of environments catalogued on the workstation.
Mandatory entry.
Process comments
This list displays the possible options for processing comments when converting an ADELIA source to display it in tree form. This list is only enabled if the "Structured sources for ADELIA programs" box is checked.
Managing comments consists in trying to intelligently reposition the comment boxes that precede a block at the top of the block itself.
The following options are possible:
Do nothing |
The comments will be left in place. This is the default behavior before the Adelia Studio 11 PTF07. |
In procedures and breaks |
The comments will be moved to the start of the next block if they are situated between an instruction at the end of the block (END_SFTKYS_PROC / END_PROCEDURE / END_PROCESSING) and the instruction at the start of the next block (SFTKYS_PROCESS / BEGIN_PROCEDURE / BREAK_PROCEDURE / TOTAL_PROCEDURE). In this mode, certain comments will not be repositioned, particularly if the block concerned directly follows an instruction block with no end marker (INITIALIZATION / TRANSACTION / VERIFICATION / VALIDATION). |
Throughout the source |
The process tries to detect and intelligently replace the comment boxes throughout the program's source. |
Data entry
Object name (for Object 1 and Object 2)
Names of the objects to be compared.
The "..." button to the right of the fields opens a dialog box that lets you select an object from the list of objects of the selected type in the selected environment.
If an error message is defined at the application area level, it must be specified in the object name in the following form: ApplicationAreaName-PPPnnnn, where PPP is the prefix and nnnn is the error message number.
Mandatory entry.
Highlight the dates from
This criterion is used when comparing sources.
Date from which all last change dates of different lines only will be displayed with different text and background colors defined in the differences display interface options (defined in Highlighted date).
Caution: in order to change this reference date, the box before it needs to be checked. Then select the date, month or year and scroll using the arrows on the right or enter the date directly using the keyboard.
By default, this criterion takes the value of the most recent choice made on the workstation in any of the comparison tool's interfaces it appears in.
The date is only active if the selected object type corresponds to a source comparison and if the Include last change date in source lines box is checked and active.
Check boxes
Ignore spaces and tabs
This setting is used during the source comparison procedure.
Checked |
Any spaces or tabulations are ignored for the purpose of detecting differences between the lines in the sources. |
By default, this criterion is set to the value of the most recent choice made on the workstation in any of the comparison tool's interfaces.
The check box is enabled only if the selected object type corresponds to a source comparison.
Include last change date in source lines
This criterion is used when comparing sources.
Checked |
The last change date is displayed in the margin of each line of source. |
By default, this criterion takes the value of the most recent choice made on the workstation in any of the comparison tool's interfaces it appears in.
The box is only active if the selected object type corresponds to a source comparison.
Notes:
- The source code line differences calculation only takes into account the content of these lines and not their last change date.
- If two lines are identical, they will have the same last change date (corresponding to the source displayed on the right).
Sources structured for ADELIA programs
This setting is used during the source comparison procedure in ADELIA type programs.
Checked |
The source undergoes the same structured view transformation which can be used in the 4GL editor. |
By default, this criterion is set to the value of the most recent choice made on the workstation in any of the comparison tool's interfaces.
The check box is enabled only if the selected object type corresponds to a source comparison.
Compare lists of related objects
This criterion is used when comparing objects in the CDM or LDM.
Checked |
Any objects specified in the Parameters of a CDM/LDM object comparison dialog box that are associated with the object being compared will also be included in the comparison. |
The box is enabled only if the selected object type belongs to the CDM or LDM.
Buttons
Parameters
Opens the Parameters of a CDM/LDM object comparison dialog box.
The button is enabled only if the Compare lists of associated objects box is enabled and checked.
Compare (validate)
Runs the comparison between the sources of the two selected objects, after checking that they exist.
At the end of the comparison procedure, the Individual comparison dialog box opens.
Cancel
Closes the dialog box without running the comparison.