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 is generated.
The .cuf file or a list of all .cuf files used to generate the report.
The options that have been 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.

After the summary section, there is a REPORT DETAILS section for each compiler version. This section lists all of the compiler invocations recorded in the usage files. The content of these sections varies depending on the report type that you have specified. For detailed information about the report types, see -qreporttype.

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/09      TIME: 01:30:24

OPTIONS USED (* indicates that a default value was used):

reporttype=detail
maxsubdirs=0
configfile="/opt/ibmurt/1.1/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 for AIX 11.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/09 16:56:44  12/17/09 16:57:13  user1@host1.ibm.com 1
12/18/09 00:58:29  12/18/09 00:58:32  user2@host2.ibm.com 1
12/18/09 01:16:01  12/18/09 01:16:02  user3@host3.ibm.com 5 ( exceeds max. allowed)
12/18/09 01:16:02  12/18/09 01:16:26  user2@host2.ibm.com 5 ( exceeds max. allowed)
12/18/09 01:16:08  12/18/09 01:16:08  user3@host2.ibm.com 5 ( exceeds max. allowed)
12/18/09 01:16:12  12/18/09 01:16:12  user2@host1.ibm.com 5 ( exceeds max. allowed)
12/18/09 01:16:24  12/18/09 01:16:28  user1@host2.ibm.com 5 ( exceeds max. allowed)
12/18/09 01:26:11  12/18/09 01:27:46  user3@host3.ibm.com 2 ( exceeds max. allowed)
12/18/09 01:26:27  12/18/09 01:27:46  user1@host1.ibm.com 2 ( exceeds max. allowed)
12/18/09 01:29:59  12/18/09 01:30:00  user2@host1.ibm.com 1
12/18/09 01:30:00  12/18/09 01:30:00  user2@host2.ibm.com 3 ( exceeds max. allowed)
12/18/09 01:30:14  12/18/09 01:30:15  user3@host1.ibm.com 3 ( exceeds max. allowed)
12/18/09 01:30:14  12/18/09 01:30:14  user2@host2.ibm.com 3 ( exceeds max. allowed)

Sample 2: A sample report generated with -qreporttype=maxconcurrent

REPORT SUMMARY
--------------

DATE: 12/18/09      TIME: 01:32:53

OPTIONS USED (* indicates that a default value was used):

reporttype=maxconcurrent
maxsubdirs=0
configfile="/opt/ibmurt/1.1/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 for AIX 11.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/09       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/09       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/09       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/09       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/09       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/09       01:26:11    2                             user3@host3.ibm.com   
                                                         user1@host1.ibm.com   
12/18/09       01:26:27    2                             user3@host3.ibm.com   
                                                         user1@host1.ibm.com   
12/18/09       01:30:00    3                             user2@host2.ibm.com   
                                                         user2@host1.ibm.com
                                                         user3@host1.ibm.com
12/18/09       01:30:14    3                             user2@host2.ibm.com   
                                                         user2@host1.ibm.com
                                                         user3@host1.ibm.com
12/18/09       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.

An invocation with no end time recorded is not included in the count of concurrent users.