License Usage

By default, Host On-Demand keeps a count of the number of concurrent active clients at any given time; the Host On-Demand client is pre-configured to send usage information to the configuration server (in the Service Manager). This enables you to determine and validate the number of Host On-Demand licenses that you need, and even track the activity of individual users. To access configuration options for usage monitoring (formally called license-use counting), click on Licenses in the Administration Utility. The Licenses window also gives you the option to disable license-use counting.

If you use the HTML model of Host On-Demand and do not want to monitor license usage, you must input the Disable parameter in the Advanced Options window of the Deployment Wizard.

The number of concurrent active clients is based on a user's ID and IP address. (Because they do not have individual Host On-Demand user IDs, client users of the HTML model are represented by the generic label "HTML.") Locally installed clients are not included in this count. Any of the following combination of sessions is counted as a single use:

• HACL or Beans sessions
• Emulator sessions
• Database On-Demand sessions

A license is considered to be in use from the time a session is started until it is closed, regardless of any pattern of usage during that period. If more than one session is active from the same combination of IP address and user ID, only one client is counted.

To take advantage of the license usage support with Host Access Class Library (HACL) and Host Access Bean programs, you must install a Host On-Demand server (from which the programs must be downloaded). Then define the following properties to be passed to the ECLSession constructor or Session Bean:

• The service of license-use counting itself. This property name is defined by the constant ECLSession.SESSION_LUM_LICENSING, and the value must be HOD.
• The identity of the Host On-Demand server. The property name is defined by the constant ECLSession.SESSION_SERVICE_MGR_HOST, and the value must be the host name or IP address of the Host On-Demand server.
• The identity of the user. In multi-user environments, use the User ID property to further refine license-use counting. This property name is defined by the constant userid, and the value must be a string that uniquely defines a user in a multi-user environment.

Related topics

• Enabling license-use counting
• Considerations for selecting a report interval time