USERLICENSE

The USERLICENSE command assigns or displays user license information.

The number of concurrent users of the products listed below is limited based on the values of run-time license keys. On systems other than MCPvm systems, user licenses are enforced only for the SOMS and ClearPath Visual IDE products; for all other products, you can use the USERLICENSE command to display the number of users. The number of concurrent users is controlled separately for each release of each product. Enforcement occurs as follows:

  • Concurrent users up to the license limit are allowed.

  • You can use the USERLICENSE command to display the current number of users, or to specify a usage percentage level that causes a warning to be displayed.

  • When the number of concurrent users reaches the warning percentage of licensed users, the following RSVP message is displayed: 

    Warning! User Licenses for <product> (<release>) have
reached threshold

    The RSVP goes away if the number of concurrent users falls 5 percent below the warning percentage. The warning percentage can be changed, and defaults to 90%.

  • This first time the number of concurrent users exceeds the number of licensed users, the following RSVP message is displayed, and the logon is allowed: 

    Warning! User Licenses for <product> (<release>) have been
exceeded, grace period will expire in 60 days

    This event initiates a 60-day grace period during which the number of licensed users can exceed the licensed amount. The purpose of this grace period is to give you time to purchase additional licenses. Once the 60 day grace period is initiated, the following reminder is generated everyday at midnight: 

    Reminder: <product> (<release>) exceeded the number of
licenses on <date>. The grace period will expire in <number>
days. After the grace period has expired, only <licensed
users> users may use the product simultaneously.
To suppress these daily warnings, use 'USERLICENSE NOWARN
<product> <release>'.

  • When the number of concurrent users exceeds the number of licensed users and the grace period has expired, the system displays the following RSVP message and denies the log on: 

    Warning! User Licenses for <product> (<release>) have been
exceeded, grace period has expired

For further information about user licensing, refer to the User Licensing Installation and Operations Guide.

Syntax

── USERLICENSE ──┬──────────────────────────────┬──────┤
                 ├─<product>─<percent>──────────┤
                 ├─ - ─<product>─<release>──────┤
                 └─ NOWARN ─<product>─<release>─┘

<product>

One of the following values:

  • CLIENTACCESS for Client Access Services

  • DATAACCESS for Data Access

  • IDE for ClearPath Visual IDE

  • SOMS for SOMS

  • TRANSSERVER for Transaction Server

<percent>

An integer between 0 and 100

<release>

A release level, for instance, 59.1 or 18.0 refer to products released with ClearPath MCP Release 18.0.

Explanation

USERLICENSE

Displays the current state of user license information for all products. The display includes the product name, the release level, the number of active users, the peak number of concurrent users, the warning percentage, the number of licenses available, and the grace ends date.  Attempts to use more licenses than are available after the grace period date are denied. 

A display of "[None]" for the number of licenses available signifies that user licensing is not enforced for this product; whereas a display of "None" signifies that an unlimited user license has been found.

The grace ends date is shown in parentheses if the grace period has expired and attempts have been made to use more licenses than are available. Otherwise, if the grace period has expired, the date is followed by an asterisk.

USERLICENSE <product> <percent>

Changes the warning percentage for the product (all release levels). The warning percentage determines when the system is to display a warning, indicating that the number of active licenses is approaching the maximum.

USERLICENSE − <product> <release>

Deletes the user license information for the product with the specified release level. This command enables you to delete information about old releases that are no longer being used, to avoid clutter in the USERLICENSE response.

If there are no active users and the grace period is not active, this command deletes the entry for the specified level of the product. If there are active users, the entry is not deleted, but the peak user count is set to 0.

If the grace period is active, the command is rejected. If the start of the grace period is greater than four years old, the user license information is deleted during a halt/load. If the user license key is still present in the system keysfile, user license information is re-added, but can be temporarily deleted using the USERLICENSE – command. To prevent the user license information being re-added, use the IK DELETE <key> command to remove the key from the keysfile. See IK (Install Keys) for more information.

USERLICENSE NOWARN <product> <release>

Suppresses the generation of the daily reminder messages when the product has entered the 60-day grace period. Use this command when you have ordered additional licenses for the product.

Examples

Example 1

The following example illustrates sample user license information:

USERLICENSE

User License Information 
Product                Release  Active   (Peak)    Limit  Warn  Grace Ends 
Transaction Server        58.1    None      (3)   [None]      
Transaction Server        59.1    None      (3)   [None]      
Transaction Server LogOn  58.1    None      (5)   [None]      
Transaction Server LogOn  59.1    None      (5)   [None]      
Data Access               58.1    None   (None)   [None]      
Data Access               59.1    None   (None)   [None]      
Client Access Services    17.0    None      (5)   [None]      
Client Access Services    18.0    None      (2)   [None]      
ClearPath Vicual IDE      58.1    None      (3)   (None)   90%

An asterisk (*) appears in the Warn column if the number of active users has reached the specified percentage of available licenses.

The Grace Ends column contains the date after which active users will no longer be able to exceed the number of available licenses. The asterisk (*) indicates that the date has passed. The date is shown in parentheses if the data has passed and an attempt is made to exceed the number of available licenses. This indication is reset after a halt/load.

Example 2

The following command sets the warning percentage:

USERLICENSE TRANSSERVER 85
   Warnings will be generated for TRANSSERVER at 85% of limit

Example 3

The following command removes user license information for Transaction Server: 

USERLICENSE - TRANSSERVER 58.1
   User License information for TRANSSERVER (release 58.1)
   has been deleted

Example 4

The following command suppresses the daily warnings for the ClearPath MCP Release 17.0 version of Client Access Services: 

USERLICENSE NOWARN CLIENTACCESS 17.0
Prev  Up  Next
UR (Unit Reserved)  Home  W (Waiting Mix Entries)