User's Manual

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 -pdb option 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 -pdb option, 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.1 Report generation options table
You can use the following options to generate reports:
Prints the summary information of all messages in the log file.“-summary” (page 28)
Prints the summary information for each source file.“-file_summary” (page 28)
Prints all the messages in the log file.“-all” (page 28)
Displays the reports in HTML.“-html[=<dir>]” (page 29)
Generates the specified cadvise reports in XML format.“-xml[=<filename>]” (page 30)
Prints only those diagnostics with specified diagnostic numbers, N1,N2..Nn.“-diag
N1,N2,N3,...,Nn” (page 30)
Prints the messages with severity greater than or equal to (>=) to N.“-severity N” (page 31)
Suppresses diagnostics or metrics from source files that have any of the specified
strings in the filename path.
“-exclude
<string1:string2:...:stringN>” (page 31)
Generates diagnostics or metrics from source files that contain the any of the specified
string in the file name path. Messages from any other files are suppressed.
“-include
<string1:string2:...:stringN>” (page 32)
Prints program complexity data for all or selected source files.“+metrics” (page 32)
Print only those messages that are related to migration, such as endian and 32-bit
to 64-bit migration related diagnostics.
“-migration” (page 39)
Generates report only for source files that make up the module <name>.“-module <name>” (page 33)
Suppresses the report header in cadvise reports.“-noheader” (page 34)
Enables you to modify the severity of diagnostic DNn to SLn.“-chseverity
<DN1:SL1,DN2:SL2,...,DNn:SLn>”(page34)
Enables you to compare PDB <pdb-name> with the PDB specified using -pdb option.“-basepdb
<basepdbname>” (page 34)
Reads the report options from the specified file.“+opts <file>” (page 38)
6.1 Report generation options table 27