Access
To select the elements to include in the global comparison, select either:
the Global comparison option in the Utilities submenu in the context-sensitive menu for environments.
the Global comparison option in the Utilities menu, or the equivalent icon in the tool bar of the Session manager.
the Global comparison option in the context-sensitive menu of the Result 1, Result 2 or Storage tab in the Maintenance manager.
the Global comparison option in the context-sensitive menu of the Result 1, Result 2 or Storage tab in the Multisource search.
the Global comparison option in the context-sensitive menu of the DIC, MAC, RAT, MSG, PGO, PGM, MR or CLA tab of the Repository dialog box in the 4GL Editor.
the Global comparison option in the context-sensitive menu of the CST, CEN, LEN, 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 Global 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.
This dialog box lets you select the second environment, create the list of comparison elements and run a source comparison (for objects with a source code) and/or an object definition comparison (for objects included in the CDM or LDM).
A comparison element is defined by:
an exact or generic object name,
an object type or a set of object types (optional),
an application area attachment restriction (optional).
Displayed data
Environment 1
Name of the environment from which the Global comparison option was activated.
The list of objects to be compared is compiled from this environment on the basis of the comparison elements specified by the user.
Lists
Environment 2
Name of the other environment involved in the comparison, to be selected from the list of environments catalogued on the workstation (excluding environment 1).
Mandatory entry.
Object type
Type of object to be compared.
Possible values: [CDM] set containing all the object types in the CDM (Conceptual Entity, Conceptual Property, Data Type and Relationship), [LDM] set containing all the object types in the LDM (Join Entity, Data Type, Logical Entity), [Any Type] to include all object types, 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.
This parameter must be specified in order to be able to add comparison elements to the list.
Note: When the value [CDM] is selected, only properties that are not assigned to a conceptual entity are included in the comparison and visible in the Global Comparison box. The other properties are included indirectly by the comparison, based on their conceptual entity.
If you select the Conceptual Property type, on the other hand, all properties are included in the comparison.
Application area
List of application areas in environment 1 and [All App. Areas] for all application areas combined.
*REPOSITORY corresponds to error messages defined at the repository level.
This parameter must be specified in order to be able to add comparison elements to the list.
Comparison elements
List of the comparison elements used to compile the list of objects to be compared.
The list is initially sorted by name, in ascending order. You can sort the list according to a column, in ascending or descending order, by clicking the corresponding column header.
Multiple-selection list.
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
Object name or generic name (e.g., A* for all object names beginning with A, or *MANAGEMENT* for all object names containing MANAGEMENT).
The object name MUST be specified in order to be able to add comparison elements to the list, unless [CDM] or [LDM] has been selected in the "object type" field, in which case the field will be shaded.
The field is only visible if the type of the selected object is not Error message.
Prefix/No.
Prefix and number of the error messages. These two fields are used as filters allowing to filter the display of error messages in the Error messages tab of the Object manager.
These fields are only visible if the type of the selected object is Error message.
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 criterion 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.
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. |
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. |
Compare lists of related objects
This criterion is used when comparing objects in the CDM or LDM.
If this box is checked, any objects specified in the Parameters of a CDM/LDM object comparison box that are associated with the object being compared will also be included in the comparison.
The box is enabled if the list of comparison elements contains one or more CDM or LDM objects.
Context-sensitive menu
Retrieve
This option updates the Object type, Application area and Object name fields as dictated by the selected comparison element.
This option can also be accessed by double-clicking a comparison element.
It is only active if a single comparison element is selected.
Remove
This option removes the selected comparison elements from the list.
It is only active if one or more comparison elements are selected.
Remove all
This option removes all the comparison elements from the list.
It is only active if the list contains one or more comparison elements.
Import
This option lets you retrieve a comparison element list previously exported into a file using the Export option.
It opens a .CMP file selection system interface. When you validate a file selection, the comparison elements in the file are added to the list. Additionally, if environment 2 has not already been specified, it is specified by the one in the file.
Export
This option lets you save the comparison element list, and environment 2, to a file.
It opens a system interface used to save to a file with the .CMP extension.
It is only active if the list contains one or more comparison elements.
Buttons
Add to list
Adds a comparison element to the list, with the values specified in the Object type, Application area and Object name fields.
Parameters
Opens the Parameters of a CDM/LDM object comparison dialog box.
The button is only enabled if the Compare lists of associated objects check box is enabled and checked.
Compare (validate)
Opens the Global comparison dialog box.
The list of objects to be compared is compiled, then the sources in the two environments are compared.
Cancel
Closes the dialog box without running the comparison.