You are here: About the Sentinel RMS Utilities > lsusage > lsusage Options

lsusage

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)