KeyConfigure Internal Reports

Audits - Reports that list programs deployed on each computer or relevant licenses controlling these programs.
Compliance - Compares deployment data to license configuration data for Node-Locked licenses.
Control - Reports that show control policies - what licenses control which programs.
Daily - Graphs of maximum and average usage during each hour of the day
Denials - Reports summarizing program Denial events
Event Dump - A chronological dump of every event in the usage table.
Hardware - A detailed report on hardware attributes of all computers.
Histogram - Histograms, showing concurrent usage over time.
Logins - Summaries of who logged in where, and for how long.
Shadow - Summary of shadow service.
Suite - Usage summary showing licenses and which programs they were used for.
Summarize - General Summaries of configuration and usage.
Usage - Two-level usage summaries, each one summarizing where/who, as well as what.
Weekly - Graphs of maximum and average usage at each time during the week

Overview

KeyConfigure's internal reports allow administrators to seamlessly summarize usage and audit information, and view internal data in hundreds of ways. The reports are supported by KeyServer's various databases, which are also accessible externally through the KeyServer ODBC driver, ksODBC, using any reporting tool. The internal reports have the advantage of being integrated into the User Interface. (Note: the "Run Legacy Report..." item at the top of the Report Menu is included for sites that want to continue using the old KeyServer 5.2 reports - all of these legacy reports have been essentially superseded with the new reporting architecture in K2.)

In addition to using the Reports menu, specific reports can be invoked using the context menu attached to any appropriate selection in the user interface - this has the effect of passing the selected item as a parameter to refine the report's scope. The context menu for any selected item will list only those reports which can accept that item as a parameter.

The following user interface items can be selected for use as a report parameter (via the context menu):

• Program (from the Programs Window - or other windows listing the program name)
• Folder (from the Programs Window - or other windows listing the folder name)
• Computer (from the Computer Window - or other windows listing the computer name)
• Division (from the Computer Window - or other windows listing the division name)
• Program Filter (from the Programs Window)
• Computer Filter (from the Computers Window)
• Pool (from the pool list in license details -for a custom license only)

Once a report has finished building its display, any item in the report can be manipulated in all the same ways that are familiar in other windows: double-clicking will open the details for the object, items can be dragged into appropriate targets, etc. You can even select a line in a report window and use the context menu to run a "sub-report" on just the selected item.

Many columns in the reports will sort when you click in the column header. This is extremely useful for quickly finding the most extreme cases of any particular attribute (e.g. program which is used most often, or for the most hours, etc.).

As each report is opened from the Reports menu you can typically specify a date range which will be remembered for subsequent reports - even for reports invoked from a context menu attached to current selected interface element. For example, after setting a time period of "This Week" from the Reports menu, if you select a computer Division and then invoke the Usage (DIV x prog) report you will see just the program usage last week for computers belonging to the selected division.

With proper ODBC support, all internal reports can be pointed to a high performance database server as data source instead of to the KeyServer. This option is available from the Options button. See Exporting and Report Options Dialog for more information.

Reports can be saved using the "Save" or "Save As..." menu items from the File menu. Various formats including HTML and TEXT are available in a pull down menu from the save dialog. There is also a special format, "KS Report Document" or KSR, that offers a compact, single file format for text and graphics that is readable by KeyConfigure. 

Ignored Programs

Generally speaking, reports will ignore data from programs which are currently set to ignored. So, even if a program was set to logged in the past, usage reports will not select launch and quit events if the program is now set to ignored. Presumably if a program is now set to ignored, an administrator has decided that usage information on that program is not interesting, so reports should not show information on usage of the program. One exception to this rule is the Event Dump report, which is designed solely to show an exhaustive list of all events in KeyServer's usage database.

Naming Conventions

The report names are meant to be short, yet understandable and meaningful. We use the following standard abbreviations:

• comp - Computer
• div - Division
• prog - Program
• lic - License
• user - User
• pool - License Pool (e.g. the name of the Group used as an access restriction for a license pool - configured in the details of a custom license)

These abbreviations are used within parenthesis following the name of various reports. If there is only one term, the report will generate a flat list. For example, "Histogram (PROG)" indicates a list of programs. If there are two terms in parenthesis, the first term (CAPS font) indicates the summary (header) records. Below the expansion triangle for each summary record, the detail records (lower case font) are listed. For example, "Usage (COMP x lic)" indicates a usage summary, where summary lines are computers, and detail lines are licenses  -  "under each COMPuter, list in detail the licenses that were used".

Audit reports - installed programs

RUN Audit (PROG x comp)
RUN Audit (COMP x prog)

RUN Audit Baseline (COMP x prog)      - requires 6.0.0.9 KeyServer
RUN Audit Delta (COMP x prog)          - requires 6.0.0.9 KeyServer

These four reports show which programs are installed on various computers:

• The Name column tells the name of the computer or program variant (as named in the computer or programs window).
• The Variant column shows the masked version number for a program or the complete KeyAccess version number for a computer.
• The First Seen column is used in detail lines to show when a program was first discovered on each computer. In summary (header) lines of Audit (COMP x prog), it shows the most recent audit date (using italic font).
• The Last Used column shows the date when the program was last used on a computer. In a summary line, its the most recent of all the times listed in the detail lines below.
• The Identifier column shows the Program identifier (for the program family), or for a computer line, the last user of the computer (in italic font).
• The Count column in a detail line shows the number of installed program files- all versions in the variant are included. In a summary (header) line, it counts the number of detail records (e.g. records that appear within the expansion triangle).

The Audit (PROG x comp) report lists under each program, all the computers where it is currently installed. This is similar to the information displayed for a single selected program using "Show Audit" from its context menu. Note: in both cases the "programs" we are talking about here are actually "program variants" - the same items that appear in the Programs window. To list instead, the computers where a fully specified version is installed, use the "version audit" button in the program details window rather than the "variant audit" button (which is does the same thing as "Show Audit").

The Audit (COMP x prog) report lists under each computer, all the programs that are currently installed. This is similar to the information displayed when you select an individual computer and use its context menu item, "Show Audit". However, the report lists program variants while the "Show Audit" context menu lists individual distinct versions. This report has the advantage of consolidating the audit for all computers (or a selected Division) into a single window while supressing unnecessary distinct version details.

The Audit Baseline (COMP x prog) report shows where programs were deployed as of the "baseline" date. By default, the baseline date for each computer is the time of first audit. This can be reset in the Computer Details window. All of the other audit reports show current program deployment based on all the most recent audit data available. You control how "current" to maintain the audit data in the "General Settings..." dialog from the Admin menu.

The Audit Delta (COMP x prog) report is conceptually the difference between Audit (COMP x prog) and Audit Baseline (COMP x prog) - it shows what programs have been installed, updated, or removed between the baseline audit date and the current audit date.

• The Action column in the Baseline and Delta reports show how a program is being managed.
• The Date Stamp column shows the date which is most relevant to that row of the report. For a computer, this shows the date of the Baseline Audit on the computer. For a program in the Baseline report, it shows the date when the program was discovered on the computer. For the Delta report, it shows the date when a change was observed. If the program was newly installed, this is the date when it was first seen. If the program was uninstalled, this is the date when it was last seen.
• The Change column in the Delta report shows what has changed.
  • "Installed" means that no version of the program was in the Baseline Audit, but it has since been installed.
  • "New Vers" means that there was some version of the program in the Baseline Audit, but since then, another version of the program has been installed as well.
  • "Changed Vers" means that there was one version of the program in the Baseline Audit, but since then, it was deleted, and replaced by a different version of the program.
  • "Deleted Vers" means that there were two or more versions of the program in the Baseline Audit, and since then, at least one has been deleted, but at least one is still installed.
  • "Deleted" means that one or more versions of the program were in the Baseline Audit, but all copies of the program have since been deleted.
• The Version column identifies a particular version within the program variant. In the Baseline report, the highest numbered version discovered on each computer is shown. In the Delta report, when a program is added, deleted, or upgraded, the specific program version is shown.

Note: if a certain program, originally discovered via a launch or an audit, is later configured as "Exclude from Audit", then of course any audit reports will be summarizing incomplete data for that program.

Audit reports - programs controlled by a license

RUN Audit License (COMP x lic)
RUN Audit License (LIC x comp)

These reports show audit information, organized by license. Instead of simply showing where every program file is installed, they show where any program controlled by a certain license is installed. This allows you to quickly see which computers could request a certain license, and which licenses a particular computer could request. Note: audit data comes from local file systems only - none of the audit reports give any information about possible access to programs from a file server or other shared file system.

Since a single license can control multiple programs, the Audit License (COMP x lic) report may list the same license multiple times under one particular computer (one entry for each program controlled by the license that was found on this computer). If there are distinct licenses controlling the same program, you will see the same computer appearing under each of the licenses (assuming the computer has a copy of this program installed). This may be confusing at first: the point is to reveal what the audit tells you about which licenses might potentially be requested from each computer based on any relevant programs that are installed. The "Last Used" time along with various usage reports will tell you which licenses have actually been requested.

• The Name column tells the name of the computer or license.
• The Limit column shows the license limit for license lines, and indicates whether it is a Node Locked license.
• The Program and Version columns specify the program variant which is installed on the computer.
• The Copies column tells how many copies of the program variant are installed on the computer.
• The Last Used column tells when the program variant was last used on the computer, and can help decide which licenses to reallocate.

Compliance reports

These reports show information related to node-locked licenses only. They show where node-locks have been allocated, where programs which are controlled by node-lock licenses are installed, and where these two conditions do not exactly correspond.

There are three basic cases which are represented in these reports.

1. A computer has a node-lock allocated to it for a license. It also has at least one program which is controlled by the license installed. This is the "normal" case, where node-locks have been allocated correctly.
2. A computer has a node-lock allocated to it for a license, but does not have any programs installed which are controlled by the license. This may happen if an administrator allocated node-locks manually, before installing software on the computer, or if a computer used a program once, but has since uninstalled the program.
3. A computer has a program installed which is controlled by a node-lock license, but the license has not been allocated to the computer. This may happen if the program has been installed, but not yet used.

Both reports show exactly the same information, but organize it in different ways. Since a single license can control multiple programs, there may be more than one line for a particular license/computer pair - one for each program installed on the computer which is controlled by the license.

• The Name column tells the name of the computer or license. If the name of a detail line is highlighted in red, it is one of the "non-standard" cases, and you may want to change how licenses are allocated.
• The Locked/Limit column shows how many licenses are locked (allocated), and what the limit is.
• The Status column shows two pieces of information. First, it may or may not have a checkmark icon in it. If it does, the license is locked to the computer. Second, it has a short string describing the status of the license allocation for the computer, and perhaps suggesting what you may want to change about the license allocation. For a complete description of each status code, see the next section.
• The Program and Version columns specify the program variant which is installed on the computer.
• The Copies column tells how many copies of the program variant are installed on the computer.
• The Last Used column tells when the program variant was last used on the computer - this can help you decide which licenses to reallocate.

Status strings:

• "Locked" - this is the "normal" case - the license is locked to the computer, and a program controlled by it is installed.
• "Locked other" - a program controlled by this license is installed, but at least one other node-lock license which controls the same program is locked on this computer. This may appear with the check-mark, meaning that multiple licenses controlling the same program are locked to the same computer. In this case, the name will be highlighted in red, because you may only need one of the licenses to be locked to the computer.
• "Could unlock" - the license is locked to the computer, but no programs controlled by the license are installed. If you are not going to install the programs in the near future, you could unlock the license from this computer. When this is the status, the name column is highlighted in red.
• "Should unlock" - the license is locked to the computer, but no programs controlled by the license are installed. Furthermore, the number of computers which the license is locked to is equal to the license limit, so no further computers can lock the license. If you are not going to install the programs in the near future, you probably should unlock the license from this computer. When this is the status, the name column is highlighted in red.
• "Should lock" - a program controlled by the license is installed, but the license is not locked. However, there is at least one license available to be locked, so depending on your exact license agreement, you should probably lock the license. Note that if a license has 4 allocated and a limit of 5, and there are 3 computers which have programs installed but no license locked, all three will say "Should lock", even though you would only be able to lock one of them. When this is the status, the name column is highlighted in red.
• "Should uninstall" - a program controlled by the license is installed, but the license is not locked. Additionally, the license is allocated up to the limit, so you cannot lock the license on this computer. Therefore, depending on your exact license agreement, you should probably uninstall the program, so you will not be in violation of your license agreement. Since this is the only case where you may not be able to remain compliant by simply changing license allocation in KeyConfigure, both the status column and the name column are highlighted in red.
• "Allowed other" - this is a strange case, where the installed program is controlled by the node-lock license, but is also controlled by a license of a different type (CUL, unlimited, or custom). This is a case you should not see, because if a license needs to be controlled by a node-lock license, it should not be controlled by any other type of license (at least not on the same computer).

Control (LIC x prog)

This report is intended to give you an overview of what programs each license controls. The summary lines show licenses, while the detail lines show programs. Many licenses will most likely control a single program, so often you will see a strict alternation of one summary header for the license, one detail for its single program.

• The Name column tells the name of the license or program.
• The Version column only applies to program lines (details). It shows the version of the program variant, and also indicates whether the program is keyed.
• The Limit column only applies to the license lines, and shows the license limit.
• The Type column only applies to license lines. It indicates whether the license is a "Site", "CUL", "Node", or "Custom" license.
• The Flags column gives additional detail about a line. For licenses it is either "n", "p", or "np". If there is an "n" it indicates that the license is set to allow use on the network. If there is "p", it indicates that the license is set to be portable. For program lines, it is either "a" or "d", meaning "allow launch offline" or "disallow launch offline", and indicates whether this option is checked off in the program details or not.
• The Group column indicates if there is a group restriction on the license. If the license is a custom license, you may see "multiple (custom)" in grey, meaning that there are multiple pools with different group restrictions.

Control (PROG x lic)

This report is intended to give you an overview of how each program is being controlled by KeyServer. The summary lines show programs, while the detail lines show licenses. Many programs will typically be controlled by a single license, so often you will see a strict alternation of one summary header for the program, and one detail for its single controlling license.

• The Name column tells the name of the program or license. In some cases, following a license name, the column may be blank for some number of lines. This means that the license is a custom license, which has multiple pools. In this case, there is one line for each pool, but since they all belong to the same license, the name of the license is displayed once for the first pool, and suppressed for subsequent pools.
• The Version column only applies to program lines (summary headers). It shows the significant digits of the program variant, and also indicates whether the program is keyed.
• The Limit column shows how many copies of the program or license (under the proper circumstances) can be used at once. For a program, it is the sum of the totals of all the licenses which control the program.
• The Type column only applies to license lines. It indicates whether the license is a "Site", "CUL", "Node", or "Custom" license.
• The Flags column gives additional detail about a line. For program lines, it is either "a" or "d", meaning "allow launch offline" or "disallow launch offline", and indicates whether this option is checked off in the program details or not. For licenses, it is either "n", "p", or "np". If there is an "n" it indicates that the license/pool is set to allow use on the network. If there is "p", it indicates that the license/pool is set to be portable.
• The Group column indicates if there is a group restriction on the license, if it is not a custom license. For custom licenses, the column contains the group for each pool of the license.
• The pool limit is only filled in if the license is a custom license. In that case, it shows the limit for just this pool of the license

Occasionally, you may see "license not found!!!" in red. This means that a license was deleted, but a program is still supposed to be controlled by the missing license. If the program is controlled only by the missing license, the result will be that the program cannot be run.

Daily reports

These reports let you see visually the pattern of usage of a program or license, throughout the course of the day. The right side of the window lists each program or license, and when you click on one, a graph is drawn on the left side of the window.

These reports let you see visually the pattern of usage of a program or license throughout the course of an "average" day. When the report is run on usage data spanning several days, all of the 1 pm data is averaged together for the 1 pm display, all the 2 pm data is averaged together for the 2 pm display, etc. The right side of the window lists each program or license, and when you click on one, a graph is drawn on the left side of the window.

• The black part represents the average (over the various days) of the maximum usage values during that hour of the day.
• The red part represents the average (over the various days) of the maximum queued values during that hour of the day.
• The first line of Daily (LIC) says "KeyServer" and will show you a graph of "KeyServer usage" - that is, users logging on to the KeyServer, and logging off again.
• In Daily (PROG), only Controlled programs are shown. This is because Logged program data could give misleading information - logged programs may have missing quit events, so over time, a histogram might climb ever higher.
• The horizontal axis lablels the hours of the day from Midnight to Midnight.
• The name of the program or license is displayed below. If it is a program, it is followed by the version, and either M or W (Macintosh or Windows), and possibly K (Keyed).
• Peak usage and other summary statistics are calculated. For a license, these statistics include the license limit and maximum length of the waiting queue (for the entire data set selected by the report).

Clicking on the graph (left) portion of "Daily (License)" will toggle between choosing the vertical axis to show the license total (if not infinite), and showing only up to the peak usage. This is useful if the license total is significantly higher than the peak usage, because it magnifies the vertical differences.

Denials

These reports are very simple - they show which programs were denied (a user tried to run the program, but was denied because they could not get a license for the program), and how many times they were denied. The main summarization is by program, and under the expansion triangle, you can see either computers, divisions, or users, depending on which report you run.

• The Name column tells the name of the program / computer / division / user.
• The Version column only applies to program lines (summary headers). It shows the significant digits of the program variant, and also indicates whether the program is keyed.
• The Type column indicates the action for a program, or the platform for a computer. It is empty for division and user lines.
• The Count column tells how many times the program was denied (and how many times the program was denied to the particular computer, division, or user on a detail line).

Event Dump

Event Dump is the most detailed report on usage information. As such, it is probably not generally that useful, but is extremely valuable in certain situations. It shows, in chronological order, one line for every single event which KeyServer records. All events relate to Server startup/shutdown, Computer audit, User logon/logoff, Program launch/quit, and License obtain/return/deny.

Caution: on a KeyServer supporting thousands of clients with heavy usage data going back several months, the Event dump might require several gigabytes of memory space to hold perhaps many millions of event records. In order to avoid virtual memory thrashing, you should always run the Event Dump report on a limited data set. Restrict to a specific time period of interest, and/or select a specific Computer, Program, or License. Use its context menu to run the report - this will download events concerning only the selected item.

• The "Name" column shows a name which is associated with the event. For server events, it is simply "KeyServer" (the name as configured in KeyConfigure appears in the "User" column). For logon/logoff events, it is the computer name. For programs, it is the program variant name. For licenses, it is the license name. This name, and the icon next to it, shows what details window will be opened when you double-click that line in the report.
• The "Vers" column shows the version of the KeyServer process, the version of KeyAccess which was used to log on/off, the version of a program, or the license total and type of a license.
• The "Event" column shows a short name for the event type, as well as a blue/green/yellow dot for program events. Note that the color of the dot may not agree with the event type. The event type was recorded when the event occured, while the dot simply tells the current action for the program. For example, you may see a green dot for a logged launch event. This simply means that at the time of the event, the program was Logged, but now it is Ignored.
• The "Why" column shows a short description of why the event occurred.
• The "License" column shows the name of the enabling license, in the case of program launch events, and shows time at which the event began, for all "end" type events (shutdown/logoff/quit/return).
• The "When" column shows when the event occurred. This is the column on which the entire report is sorted.
• The "User" column shows the name of the user who triggered the event.
• The "Address" column shows the address of the computer on which the event occurred, at the time at which it occurred.
• The "Computer" column shows the name of the computer on which the event occurred, at the time at which it occurred (it may have changed since then).
• The "Extra" column shows the name of the group which enabled the usage event, if there was one.

This report can be given any of the four types of parameters (computer/program/license/user). Regardless of parameter type, server events are always shown.

• If a computer is the parameter, all events on that computer are shown (user events, program events, license events).
• If a program is the parameter, all events of that program are shown (only launch/quit events).
• If a license is the parameter, all events pertaining to that license are shown (license events, and program events which were enabled by that license).
• If a user is the parameter, all events for that user are shown (logon events, license events, program events, audit events).

Under a few conditions, lines will be highlighted in red. These are events where something is wrong. These are the specific conditions:

• The license no longer exists. In this case, "License Not Found" will appear in either the "Name" column (for a license event), or the "License" column (for a program event).
• The program is no longer known to the KeyServer (it has been manually deleted, or the programs table was deleted entirely). "Program Not Found" will appear in the "Name" column.
• This is a server startup event, and there is no server shutdown event in between the last startup event and this one. Thus, the server must have crashed at some point in between.

Hardware

This report is similar to the Computers Window, but shows many more attributes of each computer. All of the information displayed can be seen in each individual Computer Details Window, but this report allows all of the information to be seen at once, and will sort the computers by any of the attributes which are displayed.

If the data in a column is displayed in bold, then the computer ID for the computer is based on that piece of data. For example, if the MAC column for a particular computer is in bold, then the computer ID is the letter "N" plus the MAC address. Most likely, almost all of the computers will be using the same attribute for the computer ID.

Histograms

These reports let you see visually the pattern of usage of a program or license. The right side of the window lists each program or license, and when you click on one, a histogram is drawn on the left side of the window.

• The black bars represent the maximum concurrent use of the program or license during each time slice.
• Gray bars represent usage which has not been completed (programs or licenses which are still in use). You are likely to see a lot of gray for Logged program. More on this below.
• If there is red drawn, that shows that there was a waiting queue for the license (or the license controlling the program).
• The first line of Histogram (LIC) says "KeyServer" and will show you a histogram of "KeyServer usage" - that is, users logging on to the KeyServer, and logging off again.
• In Histogram (PROG), the programs are divided into two sections: first the Controlled programs are listed, then the Logged programs are listed. This is to emphasize the fact that the usage information for these two types of program may be different. Because logging is not quite as strict as controlling, logged programs may have missing quit events, so over time, the gray portion of the histogram may continually increase (past the point of actual usage).
• Below the histogram, the beginning and end time of the x-axis are printed.
• Next, the name of the program or license is displayed. If it is a program, it is followed by the version, and either M or W (Macintosh or Windows), and possibly K (Keyed).
• Next, there is a series of lines describing highlights of usage, such as peak usage. For the license histogram, there are more lines, since licenses can have a limit, and waiting queues.

Clicking on the histogram (left) portion of "Histogram (LIC)" will toggle between choosing the vertical axis to show the license total (if not infinite), and showing only up to the peak usage. This is useful if the license total is significantly higher than the peak usage, because it magnifies the vertical differences.

Login reports

These reports summarize Login information. They show who logged in from where, and for how long.

• The "Name" column shows the name of the computer, division, or user.
• The "Type" column shows the client platform: Windows or Macintosh.
• The "Total hours:mins" column shows the total login time. For a summary line, it is the total login time for all the detail lines listed below the expansion triangle. For a detail line, it is the total login time for that particular detail record.
• The "Total Count" column shows the number of sessions (login / logout pairs) which are summarized on the line.
• The "Avg hours:mins" column shows the average login time per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.
• The "Avg Count" column shows the average number of sessions per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.
• The "Last Session" column shows the time of the last logout. This does not give you any information on a currently active session, if any.

Shadow

This report shows a list of shadows that served at some point in the specified time period.

• The Address column shows the address of the shadow.
• The Total Count column shows how many times the shadow served.
• The Total hours:mins column shows how long the shadow served for.
• The Avg hours:mins column shows how long the shadow served, as an average per service interval (Total hours:mins / Total count).

Suite (LIC x prog)

This report shows you a summary of both license and program usage, organized by license. The group headers are licenses, and show usage summaries for each license over the time period. The details are programs, and show usage summaries for the program, in the cases where it was enabled by the particular license.

• The "Name" column shows the name of the license or program
• The "Version" column shows the version of the program (with the keyed symbol, if appropriate)
• The "Computers" column shows a distinct count of the number of computers on which the license or program was used.
• The "Total hours:mins" column shows the total usage time for the license or program.
• The "Total Count" column shows the number of times the license or program was used.
• The "Avg hours:mins" column shows the average usage time, per computer per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.
• The "Avg Count" column shows the average number of uses, per computer per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.

If the same program is controlled by multiple licenses, it may appear on multiple lines in the report, under different licenses.

It is important to note that the header lines do not necessarily show a sum of the detail lines. They show a usage summary for the license. So if it is a suite license (one which controls multiple programs), the license usage total may be less than the sum of the program usage totals, since computers may have used multiple programs at the same time.

Summarize reports

These reports give an overall summary of configuration and usage. They give more information than the programs window or the license window, but less detail about usage than the Usage reports.

• The first line says "KeyServer" and will show you a summary of "KeyServer usage" - that is, users logging on to the KeyServer, and logging off again.
• In Summarize (PROG), the programs are divided into two sections: first the Controlled programs are listed, then the Logged programs are listed. This is to emphasize the fact that the usage information for these two types of program may be different. Because logging is not quite as strict as controlling, logged programs may have missing quit events, so over time, the in use count may gradually grow (past the point of actual usage, becoming less and less accurate).
• The Name column shows the name of the program or license.
• The Version column is only shown in Summarize (PROG) and shows the version of the program variant
• The Type column shows the type of the program or license.
• The In Use column shows how many copies of the program or license are in use. This should match what you can see in the Licenses window or Programs (Controlled) window. However, it is only a "best guess" for logged programs, and may not be accurate.
• Summarize (PROG) has a Deny column which shows how many times a program launch was denied (controlled programs only).
• The Max column shows the Maximum number of copies that were in use at any particular time (Maximum Concurrent usage)
• Summarize (LIC) has a Limit column which shows the license limit.
• The Total column shows the Total number of launch / license checkout events for the program / license
• The Total Time column shows the total amount of time the program or license was used for (hours:minutes). If copies are still in use, this reflects usage up until the end of the time range for the report.
• Summarize (LIC) has four additional columns which show the current length of the waiting queue for the license, the maximum length of the queue, the total time spent on the queue, and the average time spent on the queue.

Usage reports

These reports all summarize usage information for licenses or programs (actually "program variants"). Each report pair presents the same information but with the summary and detail fields interchanged.

The division reports (DIV or div) aggregate together information from all the computers within each division.

The pool reports allude to the "pools" which can be set up in a custom license in order to enforce group membership requirements that restrict access to each pool. Pool reports show which group requirement allowed the usage of a license or program, either through a pool in a custom license, or through a group restriction for a CUL or Node-Lock license. Any usage which did not require group membership shows up as "unrestricted". If you have not set up groups, group restrictions on licenses, or custom licenses with multiple pools, these "pool" reports will not be very interesting since ALL usage would be detailed with a single line: "unrestricted".

• The "Name" column shows the name of the computer, division, license, pool, program, or user
• The "Version" column only appears in reports that show program usage, and contains the significant digits of the program variant (with the keyed symbol, if appropriate)
• The "Type" column shows the type of a computer, program, or license. It is blank for divisions, pools, and users.
• The "% Usage" column is only available in Usage reports where the primary group is a license or program. It shows what percent of the total usage time was contributed by each detail line. This could be useful for billback.
• The "Total hours:mins" column shows the total usage time. For a summary line, it is the total usage over all its detail lines. For a detail line, it is the total usage for that particular line.
• The "Total Count" column shows the number of usage events for each line. For a summary line, it is the sum of the counts for all the detail lines that appear below its expansion triangle.
• The "Avg hours:mins" column shows the average usage time, per computer/pool/user per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.
• The "Avg Count" column shows the average number of uses, per computer/pool/user per week. If the report is on less than half a week, this field shows "N/A", since an average would be misleading.
• The "Last Used" column shows the quit time for a program or license return time for a license. This field will not reflect currently active usage of a program (or license) that has been launched but has not yet quit.

Note: for some lines, the events grouped under the line can only have occurred for a single computer/pool/user, so the average is really just per week. The average is per week for all detail lines, because at this point, there is always a single computer/pool/user. For reports where computer/user/pool is the primary grouping, even the summary lines show average per week, since already at the summary level there is a single computer/user/pool. But for the reports where program or license is the primary grouping, the summary line averages are per computer/user/pool per week.

Weekly reports

These reports let you see visually the pattern of usage of a program or license throughout the course of an "average" week. When the report is run on usage data spanning several weeks, all of the Monday data is averaged together for the Monday display, all the Tuesday data is averaged together for the Tuesday display, etc. The right side of the window lists each program or license, and when you click on one, a graph is drawn on the left side of the window.

• The black part represents the average (over the various weeks) of the maximum usage values during that part of the week.
• The red part represents the average (over the various weeks) of the maximum queued values during that part of the week.
• The first line of Weekly (LIC) says "KeyServer" and will show you a graph of "KeyServer usage" - that is, users logging on to the KeyServer, and logging off again.
• In Weekly (PROG), only Controlled programs are shown. This is because Logged programs could give misleading information - logged programs may have missing quit events, so over time, a histogram might climb ever higher.
• The horizontal axis labels the days of the week starting with Sunday.
• The name of the program or license is displayed below. If it is a program, it is followed by the version, and either M or W (Macintosh or Windows), and possibly K (Keyed).
• Peak usage and other summary statistics are calculated. For a license, these statistics include the license limit and maximum length of the waiting queue (for the entire data set selected by the report).

Clicking on the graph (left) portion of "Weekly (License)" will toggle between choosing the vertical axis to show the license total (if not infinite), and showing only up to the peak usage. This is useful if the license total is significantly higher than the peak usage, because it magnifies the vertical differences.

Related Topics