Func40_LookUpLicenseMetric

<< Click to Display Table of Contents >>

Navigation:  Modules > Asset Management > Software License Management > Authorization Analyzer (Complex license types) > AA Functions >

Func40_LookUpLicenseMetric

Description

This is a specialized function that is designed to lookup a required publisher-specific factor from the ATdataMSLCountLogic table using a combination of the MSL Publisher Source, auto-discovered processor description, auto-discovered chassis information, and physical processor count found for the asset whose authorization is being evaluated.

This function is used to evaluate IBM PVUs as well as Oracle Core Factor, in addition to other publisher-specific look-ups.

 

Processing Notes

This function goes through the following steps to derive the required factor:

The MSL Publisher Source parameter is validated to ensure that it is not blank.  If it is blank, then the return value is set to 'else' and the confidence adjustment value is set.  Publisher source tells which publisher's logic to use (such as Oracle Core Factor or IBM PVU).

The asset record for the authorization being processed (asset under test) is read to retrieve the processor description.  If it is blank, then the return value is set to 'else' and the confidence adjustment value is set.

The auto-discovered chassis information is retrieved by tracing the record for the asset under test back to the staging table as well as the staging archive table in order to find the most recent record reported by a catch point that has been marked as serving the role of Autodiscovery.  If a record can be found in either of the staging tables, the chassis information is retrieved.  Otherwise, the chassis information is set to "*NOTFOUND!*"

The asset under test is then checked to see if it has either the Parent column populated (which is the asset number of it's physical host) or the PhysicalComputerName column populated (which is the computer name of its physical host).  If so, the processor and processor socket counts are retrieved from the parent (physical) asset record.  If not, the processor and processor socket counts are retrieved from the asset record under test (assumption is that the asset under test is a physical machine if no parent and no physicalcomputername values exist)

A query is performed to find records in the ATdataMSLCountLogic table that match the MSL Publisher Source, Processor description, and optionally the chassis manufacturer and model and maximum processor (socket) counts.  Any records in the Count Logic table that have a start and end date set will be checked to make sure the record is still relevant, as will the Active flag.  There may be multiple records returned.  The program will evaluate each record returned until it finds a record where there is either no condition record configured, or the configured condition evaluates to 'true'.  When a valid record is found, the required factor value will be set, the rule result will be set to 'true', and processing will exit the function.

If no valid record is found, the rule result will be set to 'false', confidence will be adjusted, and processing will exit the function.

 

Inputs

 

Parameter

Explanation

MSL Publisher Source

A dropdown list of valid publishers is provided.

 

Outputs

 

Result

Result Explanation

Confidence Adjustment

Return Value

True

A required units conversion value was found.

 

-1

False

A required units conversion value was not found.

The conditions for the MSL logic count record(s) were not met.

Y

0

Else

MSL Publisher Source parameter is blank.

No processor name found on asset record.

Exception was raised and trapped.

Y

0