Understanding the utilization reporting tool

You can use the utilization reporting tool to generate compiler usage reports from the information in one or more usage files, and optionally prune the usage files when you generate the reports.

The tool is located in the /opt/ibmurt/1.1/bin directory. You can use the urt command to invoke it. The syntax of the urt command is as follows:
Read syntax diagramSkip visual syntax diagram
        .----------------------------.   
        V                            |   
>>-urt------+----------------------+-+-------------------------><
            '-command_line_options-'     

The generated report is displayed on the standard output. You can direct the output to a file if you want to keep the report.

Command-line options control how usage reports are generated. For more information about the options, see Utilization reporting tool command-line options.

A default configuration file ibmurt.cfg is provided in the /opt/ibmurt/1.1/config directory. Entries in this file take the same form as the command-line options and have the same effect. You can also create additional configuration files and use the -qconfigfile option to specify their names.

You can specify the options in one or more of the following places:
  1. The default configuration file
  2. The additional configuration file specified with -qconfigfile
  3. The command line

The utilization reporting tool uses the options in the default configuration file before it uses the options on the command line. When it encounters a -qconfigfile option on the command line, it reads the options in the specified configuration file and puts them on the command line at the place where the -qconfigfile option is used.

If an option is specified multiple times, the last specification that the tool encounters takes effect. Exceptions are -qconfigfile and -qsameuser. For these two options, all specifications take effect.