Information Center

Enabling license-use counting

Click Licenses in the Administration Utility to access the License Use Administration window. Here you can view usage statistics, adjust your license-use count configuration, and even select a log file option enabling you to track Host On-Demand activity of individual users.

License-Use Statistics
License-Use Count (configuration options)

By default, clients report to the Service Manager for license-use counting. Users of the configuration server-based and combined deployment models of Host On-Demand can disable the function in the License-Use Count area. If you use the HTML model, however, and need to disable client communications with the Service Manager (to avoid opening an extra port in your firewall, for example), you must de-activate license-use counting differently. Input the Disable parameter in the Advanced Options window of the Deployment Wizard.

License-Use Statistics

Information from the latest count is displayed when you open the License window or when you click Refresh.
Start date
The date and time that the first check was performed.

Highest number of clients logged on
The highest number of concurrent active clients since the start date, and the date and time that this occurred. The overall information is saved in a file named LicenseOverallHistory.txt in the \private directory. This file contains one entry per day showing the highest number of active clients each day since the start date and is continuously appended until it is deleted or renamed.

Highest number of clients since midnight
The highest number of active clients since midnight and the date and time that this occurred.

Number of clients at last report interval
The number of active clients when the last count was performed and the date and time this occurred. The information is saved in a file named LicenseRecentHistory.txt in the \private directory. This file contains entries for the last 12 counts.

License-Use Count

Here you specify how Host On-Demand clients send usage information to the configuration server (in the Host On-Demand Service Manager). Your input is valid whether your clients communicate directly with the configuration server, or communicate through the configuration servlet.
You must click Apply to activate any changes that you make.
Enable
Enables clients to report to the Host On-Demand configuration server. This option is selected by default. To stop clients from reporting, clear the check box. (Clearing the box automatically de-activates all License-Use Count options.)

Log Client Check-ins
Triggers a log entry for every client report received by the configuration server. The log entry content enables you to track the activity of individual users.
Each entry records: Host On-Demand writes these entries to files every twenty-four hours at midnight. It names the files according to date and stores them in the private directory.
If you want the license files stored to another directory, you can specify that with a Java system property on the line that invokes java to start the NCServiceManager. For example, to write the log files to directory /usr/lpp/HOD/licensefiles on z/OS, you would add the following:
-Dcom.ibm.hod.licensedirectory=/usr/lpp/HOD/licensefiles

Clients Report to

Host Name/IP Address

Report Interval
Select the amount of time for clients to wait between reports. Clients begin using the new interval once the previous interval has expired.

Related topics

  • Considerations for selecting a report interval time
  • License usage overview