HOME | BLOG

FAQ | HELP 

Supported Operating Systems

• Windows 98SE
• Windows Me
• Windows 2000 SP2 or higher
• Windows XP with or without SP1

Supported Browsers

• IE 5.5 SP1 or higher
• IE 6.0 with or without SP1
• IE 7

Getting Started

1. If this is your first time using the application, two ActiveX controls will be installed. These controls are not signed with a digital signature, so you will need to set your browser to accept unsafe ActiveX controls.
• TLTBrowseDirButton is used to browse for a directory.
• SourceCodeCompare is used to compare the source files.
2. Once the ActiveX controls have been installed, you are ready to begin.
3. Temporarily disable pop-up blockers (if any).
4. If you are using firewall software, you may be warned when the ActiveX program starts up. If this happens, indicate to allow the script to run to completion.

How to Login

1. Launch Internet Explorer and navigate to http://www.jamesheiresconsulting.com/scc
2. Login using the username and password provided to you when you purchased EZ-Metrix. Remember that usernames and passwords are case-sensitive.

How to Measure Files

1. If you haven't already defined a rule, this must be done before measuring any files (see below).
2. Select the Compare Files link located at the top of the page
3. Select the desired rule from the dropdown list (REQUIRED). For more information about rules, see below.
4. Enter the session name (optional). Each session has a date code assigned automatically, if you don't provide a session name. Duplicate session names on the same day are not allowed.
5. Under "Old Version Directory", enter the directory path to where the old version of the files reside. You may also browse to the desired location with the button marked "..."
6. Select the "Get Files" button (next to the Old Version Directory text box).
7. If the directory is valid, the text area will fill with the all the filenames residing in that directory.
8. Under "New Version Directory", enter the directory path to where the new version of the files reside. You may also browse to the desired location with the button marked "..."
9. Select the "Get Files" button (next to the New Version Directory text box).
10. If the directory is valid, the text area will fill with the all the filenames residing in that directory.
11. Select the "Compare Files" button.
12. If all the information is correct, a confirmation message will appear.
13. Click the "Yes" button to continue the measurement.
14. Depending on how many files you are measuring and the size of each file, this may take some time. Please Note: The application opens all the files in the directory as ASCII. So if you have binary files in the directory, you may have abnormal results.
15. After the measurement is complete, a report will automatically display.

How to run Reports

The information contained in the comparison report includes:

• Compare date
• Session ID
• Session name
• Rule used
• Old file path
• New file path
• Number of same files
• Number of deleted files
• Number of new files
• For each pair of files compared:
  
  
• Filename
• Number of new lines
• Number of deleted lines
• Number of same lines
• Number of changed lines
• Number of comment lines in old file
• Number of comment lines in new file
• Number of blank lines in old file
• Number of blank lines in new file
• Total number of source code lines in the old file
• Total number of source code lines in the new file


The information that is contained in the non-comparison line count report includes:


• Compare date
• Session ID
• Session name
• Rule used
• File path
• Number of files
• For each file measured:
  
  
• Filename
• Number of comment lines
• Number of blank lines
• Number of source code lines
• Total number of lines

View Quick Report - Select this link to view the latest report.


1. A report for the most recent measurement session will be displayed.

View Past Reports - Select this link to view any past report generated.


1. Select the desired session from the dropdown list.
2. Select the "Get Report" button.
3. The report for the selected session will be displayed.

Export Data to File - Select this link to export the session data to an Excel-compatible file.


1. Select the desired session from the dropdown list.
2. Select the "Get Data" button.
3. Select the "Yes" button on the confirmation page.
4. Browse to the location where you would like to store the resulting file, then select "Save."
5. Data will be saved on the local disk.
6. Select "OK" on the confirmation message.

Rules

EZ-Metrix uses two elements for each rule, comment delimiters and a difference threshold.
Comment delimiters are used to differentiate between comments and source code, from each supported programming language. Since each language has its own comment delimiters, you need a rule for each language you wish to measure. You may specify a single line comment delimiter and two multi-line comment delimiters (start and end). Each can be up to 80 characters long. Comment delimiters are used for both comparison and non-comparison measures.
The difference threshold is a number that helps determine if a line is changed line or new, and is used only for comparison measures. If the number of characters that have been changed is greater than this threshold number, the line is considered new. Otherwise, the line is considered changed.
How to Create a Rule


1. Select the "Create a New Rule" link.
2. Enter the rule name.
3. Enter the single line comment character.
4. Enter the multi-line beginning comment character(s).
5. Enter the multi-line ending comment character(s).
6. Enter the difference threshold.
7. Select the "Create New Rule" button. A confirmation message is displayed.
8. The new rule is created and ready for your use.

How to Update a Rule


1. Select the "Modify an Existing Rule" link.
2. Select the rule to update from the dropdown list.
3. Select the "Get Rule" button.
4. You are not permitted to change the rule ID.
5. Change the single line comment character, if you wish.
6. Change the multi-line beginning comment character(s), if you wish.
7. Change the multi-line ending comment character(s), if you wish.
8. Change the difference threshold, if you wish.
9. Select the "Update Rule" button. A confirmation message is displayed.
10. The new rule is created and ready for your use.

How to Delete a Rule (Admin only)


1. Select the "Delete an Existing Rule" link. If you cannot see this link, you are not an Admin - ask your system admin to perform this function for you.
2. Select the rule to update from the dropdown list.
3. Select the "Delete" button. A warning message is displayed.
4. Read the warning message, and if you still want to delete the rule, select the "Delete" button.
5. The new rule is created and ready for your use.