Snapshot columns

Edit online

This glossary provides a brief description of every column that can be found in the audit snapshot generated in License Metric Tool.

B C D H I N M O P R S U V

B

Edit online

Bundle Metric Contribution (previously: FlexPoint Quantity): Indicates the number of license metric units that the particular product contributes to the overall metric quantity of the FlexPoint bundle or Cloud Pak to which that product is assigned.

C

Edit online

Changed PVU per Core

Specifies whether the number of processor value units assigned to a single core was manually changed for the server that is listed in the Server Name column. If the value is Yes, you can check the comment that was provided as the reason of the change. It is listed in the audit_trails.csv file, and has the following format.

Modification Type: PVU per core value changed
Details: The PVU per core value was changed to 70 on server server_name. The provided reason: reason.

Charged

Indicates whether the component contributes to license metric utilization of the product or not.

If the product is assigned to a Cloud Pak or FlexPoint bundle, the column additionally indicates whether the product contributes to license metric utilization of the Cloud Pak or FlexPoint bundle. In such case, the value in the column is Yes, only when both the relation between the component and product, and the relation between the product and Cloud Pak are charged. Otherwise, the value is No.

Relation between component and product is charged	Relation between product and Cloud Pak is charged	Value in the column
Yes	Yes	Yes
Yes	No	No
No	Yes	No
No	No	No

Cloud Pak or Flex Point Bundle (previously: FlexPoint Bundle, Flex Point or Cloud Pak Bundle )

FlexPoint bundle or Cloud Pak to which the product and its components are assigned.

clusterID

Fully qualified domain name of the IBM License Metric Tool server from which they audit snapshot was generated.

Comment

Extra technical information. Possible values include:

Incomplete virtualization hierarchy - It indicates that data from a physical host on which the virtual machine exists is missing. As a result, default PVU counting is applied. For information how to solve the problem, see: Troubleshooting the Outdated VM Manager Data and No VM Manager Data statuses. For information about default PVU counting, see: Default subcapacity counting.
All instances are excluded

Component

Software component that was discovered on the computer that is listed in the Computer column.

Computer Deleted

Specifies whether the computer that is listed in the Computer column existed in the environment when the snapshot was generated.

Computer

BigFix®: Host name of the endpoint on which the BigFix client is installed.
Disconnected: Host name of the endpoint on which the disconnected scanner is installed.

Computer First Seen

BigFix: Date and time when information about the computer was imported from BigFix for the first time.
Disconnected: Date and time of generating the disconnected scanner package that was imported to the License Metric Tool server for the first time.

Computer Last Seen (previously: Last Seen)

BigFix: Date and time when the agent connected to the BigFix server the last time.
Disconnected: Date and time of generating the disconnected scanner package that was last imported to the License Metric Tool server.

Computer Type

Type of the computer. Possible values include:

Physical
Virtual
Public cloud

Current Server Name

Name of the server on which the computer that is listed in the Computer column resided when the snapshot was generated. Capacity of that server does not influence utilization of license metric. The server whose capacity influences metric utilization is listed in the Server Name column.

D

Edit online

date: Date when license metric quantity was measured. The date is provided in the YYYY-MM-DD format.
Details: Information about the type and date of action that is listed in the audit_trails.csv file as well as the user who performed the action.
Discovery End: Date and time when the component instance stopped being detected. If the component is still detected, the column is empty.
Discovery Start: Date and time when the component was first detected by License Metric Tool.

H

Edit online

Hybrid Product: Indicates if the product can be deployed only on traditional VMs or both on traditional VMs and Kubernetes clusters. If both deployment options are possible, cumulative license usage might need to be combined from both License Metric Tool and License Service.

I

Edit online

id: GUID of the software product written in lower case and without dashes.
Imported Part Numbers: Part number that was imported to License Metric Tool. It represents the product that is listed in the Product Name column and the license metric that is assigned to the product.
IP Address: IP address of the computer that is listed in the Computer column.
Is Imported: Specifies whether a part number that is listed in the Part Number column was also imported to License Metric Tool by a user.

M

Edit online

metricName

Code name of the license metric. For a full list of available metric code names, see: Metric IDs and code names. An exception from the list are the following metric code names.

The report shows PROCESSOR_VALUE_UNIT instead of PVU_SUB_CAP
The report shows RESOURCE_VALUE_UNIT instead of RVU_SUB_CAP
The report does not include the following metrics: PVU_FULL_CAP, RVU_FULL_CAP

Metric Peak Value Time

Date and time when utilization of the license metric was the highest during the period for which the snapshot was generated.

metricQuantity

The highest number of metric units that the product used on the date that is specified in the date column.

Metric Quantity

The highest number of metric units that the product used within the period for which the snapshot was generated. Metric quantity is measured at the metric peak value time. It represents metric utilization in the entire environment.

Metric

Type of software license metric that is used by the product.

Modification Date

Date and time when the modification that is listed in the audit_trails.csv file was performed.

Modification Type

Type of modification.

Modified By

User who modified the item.

N

Edit online

name: Name of the software product.

O

Edit online

OS: Operating system of the computer that is listed in the Computer column.

P

Edit online

Part Number

Part number that represents the product and its license metric as listed in the software catalog.

Partition Cores

Number of partition cores that were assigned to the computer that is listed in the Computer column when the peak of metric value occurred.

Path

Installation path of the software that was discovered on the computer or the path where the .swidtag file was discovered.

Peak Date

Date when the product used the highest number of metric units within the period for which the snapshot was generated.

Physical Server CPU Core Full Capacity

Number of physical cores that were available on the server that is listed in the Server Name column when peak of metric value occurred. The information is available in the pvu_full_capacity.csv and rvu_full_capacity.csv files.

Physical Server CPU Core Subcapacity

Number of physical cores that were available to the product that is listed in the Product Name column when peak of metric value occurred. The information is available in the pvu_sub_capacity.csv file.

Physical Server CPU Core Subcapacity Limit

Number of physical cores that were available on the server that is listed in the Server Name column when peak of metric value occurred. The information is available in the following files:

pvu_sub_capacity.csv
rvu_sub_capacity.csv
vpc_capacity.csv

Physical Server PVU Full Capacity

Number of cores (Physical Server CPU Core Full Capacity column) multiplied by the number of PVUs assigned to the processor core (PVU per Core column). It represents PVU full capacity for the server that is listed in the Server Name column. The information is available in the pvu_full_capacity.csv file.

Physical Server PVU Subcapacity

Number of cores (Physical Server CPU Core Subcapacity column) multiplied by the number of PVUs assigned to the processor core (PVU per Core column). It represents PVU subcapacity for the product that is listed in the Product Name column. The information is available in the pvu_sub_capacity.csv file.

Physical Server PVU Subcapacity Limit

Number of cores (Physical Server CPU Core Subcapacity Limit column) multiplied by the number of PVUs assigned to the processor core (PVU per Core column). It represents PVU full capacity for the server that is listed in the Server Name column. The information is available in the pvu_sub_capacity.csv file.

Processor

Name of the processor normalized to the name that is listed in the PVU table. If the discovered processor was not matched with any processor from the PVU table, the value is

Unknown
processor

Processor Brand String

Full specification of the processor including its brand, model and speed as read from the operating system of the computer that is listed in the Computer column.

Product and Metric from IBM Catalog

Specifies whether information that the product can use the license metric comes from the software catalog that is provided by IBM or was added manually.

Product Name

Name of the software product.

Product Release

Release of the software product.

Publisher

Name of the company that published the software product.

PVU per Core

Number of processor value units that are assigned to a processor core on a server that is listed in the Server Name column. By default, the value is taken from the PVU table but it can also be set manually. If it was set manually, the value in the column Changed PVU per Core is Yes.

R

Edit online

Recalculation Needed: Specifies whether recalculation was needed when the snapshot was generated. If the value is Yes, metric quantity for the product might not be correct. It happens because actions that influence metric quantity were performed but the value was not recalculated. For example, a component was reassigned to a different product. A correct snapshot contains only entries for which the value in the Recalculation Needed column is No.

S

Edit online

Server Name

A unique system in the enterprise. The value depends on what type of computer is listed in the Computer column.

If the computer is a physical machine, the Server Name column shows the hardware manufacturer, type, and a machine serial number.
If the computer is a virtual machine, the Server Name column shows the manufacturer and host name of the physical host.
If the computer is a virtual machine for which a VM manager is not configured, the Server Name column shows a UUID assigned by License Metric Tool prefixed with TLM_VM_. A correct snapshot should not contain any entries with such a value unless you have the permission of the IBM Compliance Team.
The serial number of the physical host with zCX (System Z Container Extensions) is followed by the for zCX suffix. For example, for CEC with z/VM guest and zCX hypervisor, the serial numbers will be 123456 and 123456 for zCX respectively. The distinction is related to the different pricing rules established for zCX. For information how to use License Metric Tool to report subcapacity of products that are deployed in zCX, see: Using the IBM License Metric Tool for sub-capacity pricing. For information about subcapacity counting rules, see: Sub-capacity (Virtualization) License Counting RulesIBM System z™ Virtualization Environment.

If multiple virtual machines are running on the same physical server, the same server name is listed multiple times.

U

Edit online

Unconfirmed Product Instance: Specifies whether the assignment of the component to the product was confirmed. Confirming the assignment is optional and does not impact metric utilization.

V

Edit online

Virtualization Layer ID: Internal ID of the virtualization layer on which the software component is installed. The information is used by the IBM Support for troubleshooting purposes.