License database format

A license database contains several kinds of lines. A line can define a multiple-iuser license, specify license priorities for individual users, or enable auditing of licensing activity.

License set definition lines

A DevOps Code ClearCase® license key consists of a single line of text, which defines a certain number of licenses. Most licenses are tied to a specific license server host and cannot be moved to any other host without first following the procedures outlined in Moving licenses to another host. If the vendor field is TEMPORARY, you can move the license to any license server host.

The license file can contain any number of –license lines. All the lines are combined into a single license; the maximum numbers accumulate to determine the total number of license slots.

User priority lines

The license file can contain any number of –user lines, each of which specifies one or more users (by name or by numeric ID). These lines are concatenated into a single license priority list. The first user on the list has the highest priority; each successive user has a lower priority. Users who are not on the list can use the products, but they share the lowest priority.

Excluded user lines

The license file can contain any number of –nuser lines, each of which specifies one or more users (by name or by numeric ID). The specified users cannot obtain a license and thus cannot use the product.

The –user and –nuser lines can be intermixed. If a user is named in both kinds of line, the first entry is used.

Audit-enable line

A line consisting of the word –audit enables auditing of license activity. On Linux® or the UNIX® system, licensing audit messages are written to the file /var/adm/clearcase/log/albd_log; on Windows®, these messages are written to the Windows event log. On either platform, the following license events are logged:
  • A user is granted a new license.
  • A user is denied a license because all licenses are in use.
  • A user entered a clearlicense –release command (the success or failure of the command is also logged).

Time-out line

By default, a DevOps Code ClearCase license granted to a user expires after 60 minutes of inactivity (60 minutes in which the user does not run a cleartool command or DevOps Code ClearCase GUI). A –timeout line changes the expiration interval to the specified number of minutes. The minimum interval is 30 minutes; there is no maximum interval.