ELMRPT(1)

NAME
elmrpt - Report license activity

SYNOPSIS
elmrpt [ -d daterange -f feature -h -i -l -m# -t timeunit -u category -w # ] [ logfiles | logdirs ] ...

DESCRIPTION
Elmrpt produces a report of licenses available or license activity from one or more license server log files. The default log file is /usr/adm/elm.log for and systems and SYS$MANAGER:ELM.LOG on systems. Note that elmrpt may be used with log files from all releases of as well as an older licensing system called Flexlm™. Elmrpt will completely merge results from both system in its reports.

Please refer to elmadmin(1) and elmusage(1) if a snapshot of current license activity is desired.

Elmrpt can display its information in two formats: numerically and as a histogram.

NUMERIC REPORTS
Here is a sample of the default numeric output from elmrpt:

Total Total Over Number Number Percent Total
Feature Requests InUse SoftLim Issued Denied Denied Time Used
---------------------------------------------------------------
multiword 746 450 736 10 1% 980:30:21
megac 312 197 301 11 4% 1097:50:30
stardb 174 78 28 129 45 26% 120:44:34

Notice that in the default report, a sum is printed for each feature. A daily total can also be displayed with ``elmrpt -t day'':

| Total Total Over Number Number Percent Total
|Feature Requests InUse SoftLim Issued Denied Denied Time Used
----------------------------------------------------------------------
Apr 14|startdb 46 42 46 0 0% 17:40:35
Apr 15|startdb 6 5 6 0 0% 18:46:50
Apr 16|startdb 60 55 5 54 6 10% 37:10:21
Apr 17|startdb 3 2 3 0 0% 00:23:11

Time units can be specified in month, day, hour, minute, and even second. The fields in a numeric report are:

Feature
    The feature alias, if one exists, otherwise the feature name.

Total Requests
    The total number of license requests for the Feature during the time period.

Total InUse
    The maximum (peak) number of licenses that were in use concurrently during the time period.

Over SoftLim
    If a soft limit has been applied to the feature, this will be the number of licenses in use over the soft limit during the time period. (Total InUse - SoftLimit.)

Number Issued
    The number of licenses successfully issued during the time period.

Number Denied
    The number denied, most likely from the maximum number of licenses being already in use during this time period.

Percent Denied
    The percentage of denied licenses out of the total number of requests for the period.

Total Time Used
    The total time that the feature was checked-out during the period displayed in hours:minutes:seconds.

Reports can be further detailed not only by time, but by user, user@host, and/or user@host+display.

For example, the report-by-user (-uu) option:

| Total Total Over Number Number Percent Total
|Feature Requests InUse SoftLim Issued Denied Denied Time Used
-----------------------------------------------------------------------
Feb 9|multiword 34 33 3 29 5 15% 04:44:50
| jim 20 3 16 4 20% 00:00:30
| carol 5 1 5 0 0% 04:40:10
| bob 1 1 1 0 0% 00:04:10
Feb 10|multiword 9 2 9 0 0% 19:54:44
| jim 1 1 1 0 0% 12:00:10
| bob 2 1 2 0 0% 00:10:17
| tom 6 2 6 0 0% 07:44:17

A report-by-host (-uh) report:

| Total Total Over Number Number Percent Total
|Feature Requests InUse SoftLim Issued Denied Denied Time Used
-----------------------------------------------------------------------
Feb 9|multiword 34 33 3 29 5 15% 04:44:50
| @mars 20 3 16 4 20% 00:00:30
| @venus 5 5 5 0 0% 04:40:10
| @neptune 1 1 1 0 0% 00:04:10
Feb 10|multiword 29 7 17 0 0% 30:54:44
| @mars 1 1 1 0 0% 12:00:10
| @neptune 19 7 7 0 0% 10:10:10
| @saturn 9 6 9 0 0% 08:44:17

HISTOGRAM REPORTS

Use of the -h option will produce a histogram instead of a numeric table. The same options that apply to numeric tables can be applied to report in histograms:

Here is a sample of a histogram to report daily totals (elmrpt -h -t day):

|Feature +=issued -=denied o=in use *=in use over softlimit
-----------------------------------------------------------------------
Apr 14|multiword ++++++++++++++++++++++++++++++++++ |46+0
| oooooooooooooooooooooooooooooooooo**** |46+6
Apr 15|multiword ++++ | 6+0
| ooo | 5+0
Apr 16|multiword ++++++++++++++++++++++++++++++++++++++++++++---|54+4
| oooooooooooooooooooooooooooooooo |40+0
Apr 17|multiword ++ | 3+0
| o | 1+0
Apr 18|multiword +++ | 4+0
| oo | 2+0
Apr 19|multiword ++++++++++++++++++++ |26+0
| oooooooooooo |20+0

When displayed as a histogram, the number of successful requests is displayed as a series of pluses (``+'') and denied requests as a series of minuses (``-''), followed by the actual number of successful and denied requests, plus (+) separated (as in 54+4). The total number of requests is the sum of these two numbers.

The second line displays the peak concurrent usage. The open circles (``o'') indicate usage under the soft limit, and asterisks (``*'') indicate usage over the soft limit, This line is followed by the in use count under the soft limit and the in use count over the soft limit, plus (+) separated (as in 26+0). The total concurrent in use is the sum of these two numbers.

Histograms are normalized for a screen width of 78, which may be adjusted with the -w option.

Even more interesting are hourly totals, showing activity during the day. Notice the peak usage during the late morning and mid-afternoon:

|Feature +=issued -=denied o=in use *=in use over softlimit
---------------------------------------------------------------------------
Apr 15 06:00|multiword | 2+0
| | 1+0
Apr 15 07:00|multiword + |14+0
| o |11+0
Apr 15 08:00|multiword +++++ |60+0
| ooooooooo |70+0
Apr 15 09:00|multiword ++++++++++++++ |130+0
| oooooooooooooooooooooooooooooooo |190+0
Apr 15 10:00|multiword ++++++++++++++++++++++++++++++++++++++--------|300+30
| ooooooooooooooooooooooooooooooooooooooooo*** |250+20
Apr 15 11:00|multiword ++++++++++++++++++++++++++++++++++++++++ |370+0
| ooooooooooooooooooooooooooooooooooooooooo**** |245+30
Apr 15 12:00|multiword ++++++++++++++++++ |155+0
| oooooooooooooooooooooooooooooooooo |210+0
Apr 15 13:00|multiword ++++ |48+0
| oooooooooooooooooooooooo |157+0
Apr 15 14:00|multiword ++++++++++++++++++++++++++++++ |220+0
| oooooooooooooooooooooooooooooooooooooooooooo |240+0
Apr 15 15:00|multiword ++++++++++++++++++++++++++++++++++++++++------|200+26
| ooooooooooooooooooooooooooooooooooooooooo*****|249+39
Apr 15 16:00|multiword ++++++++++++++++++++++++++++++++++++ |299+0
| oooooooooooooooooooooooooooooooooooooo |237+0
Apr 15 17:00|multiword ++++++++++++++++++++++++++ |190+0
| oooooooooooooooooooooooooooo |204+0
Apr 15 18:00|multiword ++++++++++++++++ |145+0
| oooooo |45+0
Apr 15 19:00|multiword ++ |26+0
| oooo |39+0
Apr 15 20:00|multiword + |16+0
| ooo |27+0

Here's a report-by-user (-uu) report in histogram form:

|Feature +=issued -=denied o=in use *=in use over softlimit
-----------------------------------------------------------------------
Apr 14|multiword +++++++++++++++++++++++++++++++++++ |46+0
| oooo | 5+0
| janett +++++++++++++++++++++++++++++++ |41+0
| oo | 3+0
| ken ++ | 3+0
| o | 1+0
| bill + | 2+0
| o | 1+0
Apr 15|multiword ++++ | 6+0
| ooo | 3+0
| janett +++ | 4+0
| oo | 2+0
| ken + | 2+0
| o | 2+0

And, similarly, month totals per machine may be printed:

|Feature +=issued -=denied o=in use *=in use over softlimit
---------------------------------------------------------------------
Apr|multiword +++++++++++++++++++++++++++++++++++++++++++++++|270+0
| ooooooooooooooooooooooooo |190+0
| @venus +++ | 27+0
| oo | 20+0
| @mars ++++++++ | 41+0
| ooooooo | 30+0
| @neptune +++++++++++++++ | 99+0
| oooooooo | 58+0
| @pluto +++++++++++ | 60+0
| ooo | 24+0
| @saturn ++++ | 33+0
| oooo | 30+0

INSTALLED LICENSES
A summary of installed licenses can also be obtained via the -l option of elmrpt. The summary will be sorted by the feature name, or alias, if one. Here's an example:

Feature Tokens SoftLimit Starts Expiration Key File
Avstar 600 Dec 10 00:00:00 1993 Dec 10 23:59:59 1996 /usr/lib/elm/100.lic
CDblaster 55 /audio/key/9510.lic
MultiC 90 /multi/key/120.lic
MultiMath 250 Nov 30 23:59:59 1995 /multi/key/140.lic
MultiWord 900 800 Jan 15 00:00:00 1994 Jan 15 23:59:59 1995 /multi/key/50.lic

OPTIONS

-d [ from - to | from ]
    Limit reporting for dates between from and to inclusive. The from and to dates may be specified in one of two formats:

    95-Feb-3 12:30:00

    95/2/3 12:30:00

    In both cases, the year (and delimeter ``-'' or ``/'') are optional. In the first format you specify the first three letters of the month. In the second form, the month number followed by a slash is used. The delimeters ``-'' and ``/'' are interchangable.

    For example:

    elmrpt -d "Mar-15 - Apr-15 5:30"

    elmrpt -d "3/15 - 4/15 5:30"

    Note that in either format, only the month is required - the year, day, hour, minutes, and seconds will default to zero if missing. If the hyphen and to date are missing, the report will run to the last date.

-f feature
    Only list activity for the feature named. Multiple -f options may be used to limit display to several features.

-h  Print a usage histogram instead of numeric data. (See also -w option below.)

-i  Prints the release number of elmrpt and the release of the library it was compiled with, then exits.

-l  License listing. Display a summary of licenses available along with the number of tokens, soft limit, start date, expiration date, and key file name. No other options are meaningful with -l.

-m #[units]
    Minimum duration. With this option, commands than execute for less than the time specified by # will be ignored. A single letter s, m, h, d, or w, following the # may be used to specify units of seconds, minutes, hours, days, or weeks. The default is seconds.

    With a low #, such as 5 or 10 seconds, this option may be used to effectively eliminate phantom statistics — those from commands that checks out, but fail to execute.

    This option may also be used when you wish to eliminate short application sessions from your statistics. For example, -m1m will only display applications that have run for at least one minute.

    With a large number, only long application sessions will be gathered. For example, -m1h will only display applications that have run for at least one hour.

-t timeunit
    Display total license activity for each timeunit, where timeunit may be month, day, hour, minute, second. (A unique abbreviation, such as ``min'', is ok.) For example:

    elmrpt -d "3/15 - 4/15 5:30" -t hour

    If the -t option is not specified, a grand total only is printed.

-u category
    Detail report by each user, as specified by category. The category may contain one or more key letters ``u'', ``h'', and ``d'' for user name, host, and display, respectively. Key letters may be combined in any combination of 1 to three letters. For example, -uu details per user name only; -uh details per host name only; and -uuh provides more detail, with results displayed for each distinct user@host.

-w #
    Specify a display width of # character units. The default is 78. This option is currently only effective with the -h (histogram) option.

The remaining arguments are zero or more license server log file names or directories. If any argument is a directory, then all log files in that directory are digested. Elmrpt will silently skip files that are not license manager log files.

If no files are specified on the command line, then the default /usr/adm/elm.log for and , or SYS$MANAGER:ELM.LOG for , will be used.

FILES
/usr/adm/elm.log — default log file.

\USR\ADM\ELM.LOG — default log file.

SYS$MANAGER:ELM.LOG — default log file.

CAVEAT
The ``Total Time Used'' field will only be valid for log files from release 2.3 and above or FlexLM log files for which time logging has been enabled.

SEE ALSO
elmalert(1), elmusage(1), elmadmin(1), elmd(1)