Understanding usage reports
You can use the report that the utilization report tool generates to analyze the compiler usage in your organization.
The report has a REPORT SUMMARY section that lists the following information:
- The date and time when the report was generated.
- The .cuf file or a list of all .cuf files used to generate the report.
- The options that were passed to the urt command, with default values for any unspecified options.
- Possible messages categorized as ERROR, WARNING, or INFO. For detailed information about possible messages, see Diagnostic messages from utilization tracking and reporting.
Here are the sample reports generated with the two different report types:
Sample 1: A sample report generated with
-qreporttype=detail
REPORT SUMMARY
--------------
DATE: 12/18/18 TIME: 01:30:24
OPTIONS USED (* indicates that a default value was used):
reporttype=detail
maxsubdirs=0
configfile="/opt/ibmurt/1.2/config/ibmurt.cfg"
rptmaxrecords=nomax
*adjusttime=
usagefileloc="/home/testrun/ibmxlcompiler.cuf"
*sameuser=
timesort=ascend
usagefilemaxsize=nomax
usagefilemaxage=nomax
FILES USED:
/home/testrun/ibmxlcompiler.cuf
REPORT DETAILS
--------------
USAGE INFORMATION FOR PRODUCT: IBM XL C/C++ for AIX 16.1
Max. Concurrent Users Exceeded? : *** YES ***
Max. Concurrent Users Allowed: 1 Max. Concurrent Users Recorded: 5
Exempt Users:
Product invocations:
Start Time End Time User Number of Concurrent Users
------------------ ------------------ ----------------- --------------------------
12/17/18 16:56:44 12/17/18 16:57:13 user1@host1.ibm.com 1
12/18/18 00:58:29 12/18/18 00:58:32 user2@host2.ibm.com 1
12/18/18 01:16:01 12/18/18 01:16:02 user3@host3.ibm.com 5 ( exceeds max. allowed)
12/18/18 01:16:02 12/18/18 01:16:26 user2@host2.ibm.com 5 ( exceeds max. allowed)
12/18/18 01:16:08 12/18/18 01:16:08 user3@host2.ibm.com 5 ( exceeds max. allowed)
12/18/18 01:16:12 12/18/18 01:16:12 user2@host1.ibm.com 5 ( exceeds max. allowed)
12/18/18 01:16:24 12/18/18 01:16:28 user1@host2.ibm.com 5 ( exceeds max. allowed)
12/18/18 01:26:11 12/18/18 01:27:46 user3@host3.ibm.com 2 ( exceeds max. allowed)
12/18/18 01:26:27 12/18/18 01:27:46 user1@host1.ibm.com 2 ( exceeds max. allowed)
12/18/18 01:29:59 12/18/18 01:30:00 user2@host1.ibm.com 1
12/18/18 01:30:00 12/18/18 01:30:00 user2@host2.ibm.com 3 ( exceeds max. allowed)
12/18/18 01:30:14 12/18/18 01:30:15 user3@host1.ibm.com 3 ( exceeds max. allowed)
12/18/18 01:30:14 12/18/18 01:30:14 user2@host2.ibm.com 3 ( exceeds max. allowed)
Sample
2: A sample report generated with
-qreporttype=maxconcurrentREPORT SUMMARY
--------------
DATE: 12/18/18 TIME: 01:32:53
OPTIONS USED (* indicates that a default value was used):
reporttype=maxconcurrent
maxsubdirs=0
configfile="/opt/ibmurt/1.2/config/ibmurt.cfg"
rptmaxrecords=nomax
*adjusttime=
usagefileloc="/home/testrun/ibmxlcompiler.cuf"
*sameuser=
timesort=ascend
usagefilemaxsize=nomax
usagefilemaxage=nomax
FILES USED:
/home/testrun/ibmxlcompiler.cuf
REPORT DETAILS
--------------
USAGE INFORMATION FOR PRODUCT: IBM XL C/C++ for AIX 16.1
Max. Concurrent Users Exceeded? : *** YES ***
Max. Concurrent Users Allowed: 1 Max. Concurrent Users Recorded: 5
Exempt Users:
Dates and times where usage exceeded the maximum allowed:
Date Time Number of Concurrent Users Users
------------ ---- -------------------------- -----
12/18/18 01:16:01 5 user3@host3.ibm.com
user2@host2.ibm.com
user3@host2.ibm.com
user2@host1.ibm.com
user1@host2.ibm.com
12/18/18 01:16:02 5 user3@host3.ibm.com
user2@host2.ibm.com
user3@host2.ibm.com
user2@host1.ibm.com
user1@host2.ibm.com
12/18/18 01:16:08 5 user3@host3.ibm.com
user2@host2.ibm.com
user3@host2.ibm.com
user2@host1.ibm.com
user1@host2.ibm.com
12/18/18 01:16:12 5 user3@host3.ibm.com
user2@host2.ibm.com
user3@host2.ibm.com
user2@host1.ibm.com
user1@host2.ibm.com
12/18/18 01:16:24 5 user3@host3.ibm.com
user2@host2.ibm.com
user3@host2.ibm.com
user2@host1.ibm.com
user1@host2.ibm.com
12/18/18 01:26:11 2 user3@host3.ibm.com
user1@host1.ibm.com
12/18/18 01:26:27 2 user3@host3.ibm.com
user1@host1.ibm.com
12/18/18 01:30:00 3 user2@host2.ibm.com
user2@host1.ibm.com
user3@host1.ibm.com
12/18/18 01:30:14 3 user2@host2.ibm.com
user2@host1.ibm.com
user3@host1.ibm.com
12/18/18 01:30:14 3 user2@host2.ibm.com
user2@host1.ibm.com
user3@host1.ibm.com
Note: There are circumstances under which an end time might not be recorded. These might
include:
- There was a major failure of the compiler, for example, power loss during a compilation.
- The invocation had not ended at the time when the report was generated, or at the time when the usage file was being copied.
- The permission to write to the usage file was revoked at some time before the end time of the invocation was recorded.