6 Generating reports

Cadvise either stores the diagnostic messages in the PDB or outputs them into the stderr. To analyze these diagnostic messages, you can generate a report using the cadvise report command. Cadvise report provides multiple options for filtering the diagnostic messages stored in the log files. These reports can also be viewed and saved as HTML files. Using these options, you can view a selected set of diagnostic messages. The cadvise reports can be generated from the following:

•The PDB

Cadvise builds that use the -pdboption store the diagnostic messages in the program database. The following command generates report from the PDB:

cadvise report <report-options> -pdb pdbdir

•The log files

Cadvise builds that do not use the -pdboption, output them into stderr. You can redirect these to a log file for later analysis. The following command generates the report from log files:

cadvise report <report-options> logfile

6.1Report generation options table

You can use the following options to generate reports:

“-summary” (page 28)

Prints the summary information of all messages in the log file.

 

 

“-file_summary” (page 28)

Prints the summary information for each source file.

 

 

“-all” (page 28)

Prints all the messages in the log file.

 

 

“-html[=<dir>]” (page 29)

Displays the reports in HTML.

 

 

“-xml[=<filename>]” (page 30)

Generates the specified cadvise reports in XML format.

 

 

“-diag

Prints only those diagnostics with specified diagnostic numbers, N1,N2..Nn.

N1,N2,N3,...,Nn” (page 30)

 

 

 

“-severity N” (page 31)

Prints the messages with severity greater than or equal to (>=) to N.

 

 

“-exclude

Suppresses diagnostics or metrics from source files that have any of the specified

<string1:string2:...:stringN>”(page31)

strings in the filename path.

 

 

“-include

Generates diagnostics or metrics from source files that contain the any of the specified

<string1:string2:...:stringN>”(page32)

string in the file name path. Messages from any other files are suppressed.

 

 

“+metrics” (page 32)

Prints program complexity data for all or selected source files.

 

 

“-migration” (page 39)

Print only those messages that are related to migration, such as endian and 32-bit

 

to 64-bit migration related diagnostics.

 

 

“-module <name>” (page 33)

Generates report only for source files that make up the module <name>.

 

 

“-noheader” (page 34)

Suppresses the report header in cadvise reports.

 

 

“-chseverity

Enables you to modify the severity of diagnostic DNn to SLn.

<DN1:SL1,DN2:SL2,...,DNn:SLn>”(page34)

 

 

 

“-basepdb

Enables you to compare PDB <pdb-name> with the PDB specified using -pdb option.

<basepdbname>” (page 34)

 

 

 

“+opts <file>” (page 38)

Reads the report options from the specified file.

 

 

6.1 Report generation options table

27