General

GUI Reference: License Utilization

View the licensed limits on CodeSonar resources - enabled users, anonymous sessions, and per-file charges - and the current utilization of those resources.

Important Note: the CodeSonar Web GUI makes extensive use of JavaScript. Make sure JavaScript is enabled in your web browser.

Navigating To

From Settings: In the Other Links tab, click License Utilization.
From any GUI page
with the standard footer:		 In the page footer, click see licensing details.
By URL: http://hub_location/lines.html

Page Properties

Output formats CSV, JSON, XML (lines.xsd)
Visibility Filter Applied none
RBAC Permissions Needed
Page AccessG_LICENSE_READ
G_LICENSE_UTILIZATION_READ
G_LIST_USERS
Page Contents/FunctionalityG_LICENSE_READ
G_LICENSE_WRITE

Contents and Usage

The following annotated screenshot shows the various parts of a License Utilization page.

Annotated Screenshot: License Utilization page standard header breadcrumbs heading Edit License(s) field Save button Request a new license link utilization summary line count table standard footer

Standard Header See GUI Reference: Standard Header.
Breadcrumbs Home > License Utilization
where Home links to the GUI Home page.
Page Heading License Utilization
Edit License(s) field Only active for users with G_LICENSE_WRITE permission.

Otherwise, a Configure License link is provided. If you click this button you will be prompted to sign in as a user with suitable permissions, then returned to the License Utilization page.

To install or update a license, enter the license text in this field and click Save.

Generally, you will do this if you have received an updated license file from CodeSecure. For full information, see How Licenses Work: License Installation and Updates.
Save [Requires G_LICENSE_WRITE] Click to save the contents of the Edit License(s) field and update licensing for the hub accordingly. If the hub is also reading licensing information from other locations, those locations are listed to the right of the button.

Once the license is updated, the License Utilization page will display the limits for the new license.
"Request a new license" link Click to obtain a new "unsigned (standard) license" for the machine your hub is running on. CodeSonar will generate and display the unsigned license, along with a link to request a signed version of the license from CodeSecure. For full details, see Installation: Hub License: Obtaining a License.

If you are using a floating license, do not use the Request a new license link. Instead, follow the instructions at CodeSonar Installation: Floating License: Obtain and Set Up the License.
Utilization Summary One sentence for each licensed CodeSonar resource.

annotated screenshot fragment: utilization summary

License Charges Table A table listing the license charge for each file on the hub.
  • The table has the standard pagination controls.
  • Each file basename (case-insensitive) is only counted once, even if
    • there are multiple files with the same basename, or
    • a file is analyzed multiple times, or
    • a file occurs in more than one project.
    If there are multiple file instances with the same basename, the instance with the most Lines With Code is counted. When several instances have the same Lines With Code, the oldest such instance is listed: we refer to this as the largest-oldest instance. Note that instance information will appear even if the instance is no longer present on the hub (for example, because the project or analysis it belonged to has been deleted).
  • The available table columns are as follows. Columns displayed by default are marked with an asterisk (*).
    File *  
    Path The File Path.
    Project * The Name of the project in which the largest-oldest instance of the file occurs.
    Analysis ID  
    Charge *  
Standard Footer See GUI Reference: Standard Footer.

Related Tasks