Open the Table of Contents

You are here: About the Sentinel RMS Utilities > lsusage

# lsusage - Displays the License Manager Log File

lsusage displays a summary of application usage, providing information on license transactions contained in the License Manager usage file.

lsusage Options

Use lsusage in the following format:

lsusage [options]

One or more of the following options must be specified:

Option | Description
--- | ---
-l log-file | Selects the License Manager log file to display. Must be specified. If this is the only option, the summary will be displayed on the screen.
-c CSV-format-file | Specifies the name of an output file to which the output will be written in Comma-Separated Values (CSV) format. This CSV file can be used with Microsoft Access to produce graphical reports. For further details we suggest you to read through Creating License Manager Use Reports.
-f feature1[,version1]: feature2[,version2]... | Specifies feature(s) and version(s) to be included in the output. Note that version is optional. If this option is not supplied, the output will contain all features and versions in the log file.
-m start-month | Specifies the first month (1-12) of the time period to be included in the output. If not specified, then the -a option is ignored and January 1 is assumed for the start month and start day.
-a start-day | Specifies the first day (1-31) of the month to be included in the output. For example, if you have specified March as the start month, specifying a start day of 1 means that the output will be for a time period beginning with March 1. If not included, and the -m option is included, a start day of 1 is assumed.
-y start-year | Specifies the first year of the time period to be included in the output. Use four digits to specify the year. If not included, then -m and -a are ignored and the output begins with the first data in the file.
-M end-month | Specifies the last month (1-12) of the time period to be included in the output. If not specified, then the -A option is ignored and the default value of December 31 is assumed.
-A end-day | Specifies the last day (1-31) of the month to be included in the output. If not included, and the -M option is included, an end day of 31 is assumed.
-Y end-year | Specifies the last year of the time period to be included in the output. Use four digits to specify the year. If not included, then -M and -A are ignored, and the output ends with the last data in the log file.
-h | Displays a list of all options that can be used.

lsusage Display

The lsusage display looks something like this:

Application Usage Summary |  |  |  |  |  |  |  |
%age Denied | %age Issued | Total Tokens Issued | %age Queued Granted | %age QRequest | Min.App. Duration (minutes) | Avg.App Duration (minutes) | Max.App Duration (minutes) | Total Capacity Issued
For Feature Name: bounce, Version: Non-Capacity |  |  |  |  |  |  |  |
0.00 | 100.00 | 2 | 0.00 | 0.00 | 2.35 | 3.08 | 3.82 | -
For Feature Name: bounce, Version: Non-Pooled Capacity, 4000 |  |  |  |  |  |  |  |
0.00 | 100.00 | 2 | 0.00 | 0.00 | 2.35 | 3.08 | 3.82 | 8000

LOG REPORT FOR SESSION:0

where:

Element | Description
--- | ---
Feature name/ Version | Identifies the license for which this entry was made.
%age Denied | The percentage of requests for this license that were denied (usually because the hard limit of the license had already been reached), or if license queuing is enabled, this is the percentage of queued requests denied.
%age Issued | The percentage of requests for this license that were granted.
Total Tokens Issued | The number of tokens for this license that were issued.
%age Queued granted | The percentage of queued license requests that were granted.
%age QRequest | The percentage of license requests that were placed in the license queue. (License requests are queued only if license queuing is enabled for this license.)
Min. App. Duration | The minimum number of minutes the application for this license was in use.
Avg. App. Duration | The average number of minutes the application for this license was in use.
Max. App. Duration | The maximum number of minutes the application for this license was in use.
Total Capacity Issued | The total capacity issued for the specific feature and version.
LOG REPORT FOR Session: x | The session numbers for this License Manager that were logged in this file.

Warning: lsusage will not display license transactions that are encrypted to level 3 and 4. For information on encrypted log file transactions, see Setting Usage Logging.

If the Sentinel RMS log file contains characters that are not 7-bit ASCII (for example, if a user name contains multi-byte characters such as Japanese Kanji characters), those characters will not be viewable when looking directly at the log file. However, if you use the lsusage -c option to create CSV-format output from the log file, you will be able to view the multi-byte characters if you view the CSV-format file with an appropriate text editor on an operating system that displays the multi-byte language. Also, when anonymous usage logging option is enabled, that multi byte user and host names will be logged anonymously.
You can also create Microsoft Access reports from the CSV-format file that can be viewed on a computer using the appropriate multi-byte operating system. (For information on creating reports from log file CSV-format output, see Creating License Manager Use Reports)