# Layout of the JCOVER output file

Updated: 9/18/2020, 6:16:41 AM
Created: 9/18/2020, 6:16:41 AM
Last Updated By: ronaldojr9
Read Time: 5 minute(s)

Tags: jbase tools jcover

# Description

The records written to the jcover output file have different formats depending upon what they are showing. The formats are identified by a prefix on the record key. Note that in the following examples a * character is used to delimit certain fields. This is the default delimiter character. Remember if the -d option was used to jcover, then this delimiter will be different.

# E*itemid*filename*lineno

These items show which lines of code have been executed. They are only generated if the -e option is used on jcover. There will be one item for each different line of code executed during the application execution.

Item Id The 4 fields show the record type (E) , the item id, the source file name and the line number that were executed.
<1> The actual line of source code taken from the source 'itemid' in file 'filename'

# F*itemid*filename

Used internally to keep track of what items in what files have been accessed as part of the jcover execution

Item Id The 3 fields show the record type (F) , the item id and the source file name that were executed.

# G*descr

These are general information items.

Item Id The 2 fields show the record type (G) and then a unique identifier, not really of any use.
<1> Textual description of the general information.
<2> The actual general information.
<3> The order in which the fields are to be displayed using 'LIST filename GENINFO'

# S*itemid

These items show what item has been executed and are used to build up a list of statistical analysis of the executed item.

Item Id The 2 fields show the record type (S) and the item id that were executed.
<1> Item ID of the source executed.
<2> File name containing the executed source.
<3> Number of lines of source. This attribute will be the sum of attributes <4> and <5>.
<4> Total number of comment lines in the source code.
<5> Number of lines of code in the source that are executable. Blank lines and comment lines are not included in this count.
<6> Number of lines of code executed by the application.
<7> Number of lines of code executed by the application as a percentage of the total number of executable lines.
<8> Number of lines of code not executed by the application.
<9> Number of lines of code not executed by the application as a percentage of the total number of executable lines.
<10>-<20> Reserved for future use.
<21> Details of line 1 of the source code. A character 'C' shows line 1 is a comment line. A numeric value shows line 1 is executable code and has been executed this many times. A blank shows line 1 is executable code, but was not executed during the application execution.
<22> Ditto as <21> but for line 2 of the source code.
<23> Ditto as <21> but for line 3 of the source code.

etc. for all lines in the source code.

# U*itemid*filename

For every file name specified with the -ffilename parameter of jcover, there will be one of these items for every item in every file that was not used during the application execution. These items are only generated if the -u option is used on jcover. Item id's that show a non-source item will not be included and these are items that are appended with .o , .a , .so , .sl , .obj , .d or .d or items that begin with ! , $ or *.

Item Id The 3 fields show the record type (U) , the item id and the source file name that were not executed in any way whatsoever.

# X*itemid*filename*lineno

These items show which lines of code have not been executed. They are only generated if the -x option is used on jcover. There will be one item for each different line of code not executed during the application execution. Only the source files that have one or more line of code executed will be included here. Any source items not executed at all will not have a X* item but will be included in the U* items (assuming the -u option was used)

Item Id The 4 fields show the record type (X) , the item id, the source file name and the line number that were not executed, but the source did have one or more lines of code executed.
<1> The actual line of source code taken from the source 'itemid' in file 'filename'

Back to Tools