Generating usage reports

You can use the utilization reporting tool to generate compiler usage reports based on the usage information stored in the usage files.

To generate a report, use the command-line options or the urt configuration file to specify how you want a report to be generated. For more information about these options, see Utilization reporting tool command-line options.

Notes:

You can set up a cron service to run the utilization reporting tool on a regular basis. If the usage files from which the tool generate reports need to be copied to the machine where the tool is running, you can also automate this copying task with cron.
To reduce contention for read and write access to the usage files, do not run the tool or copy the usage files when the compiler is being used.

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

After a usage report is generated, the utilization reporting tool uses the following exit codes to indicate the compliance status of your compiler license:

Exit code ="1".

The utilization reporting tool has detected that the number of Concurrent User license entitlements specified in the -qmaxconcurrentusers entry in the utilization tracking configuration file has been exceeded. See the generated report for details and contact your IBM representative to purchase additional Concurrent User licenses.
Exit code ="0".

The compiler utilization is within the number of Concurrent User license entitlements specified.

For more information about the urt command, see Understanding the utilization reporting tool.