Func43_ReturnCPHistoryValue

<< Click to Display Table of Contents >>

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

Func43_ReturnCPHistoryValue

Description

This function goes through catch point history of auto-discovered data for the asset that is assigned to the authorization under test, considering a given period of time in the past, and returns either the minimum or maximum value of the requested column.

 

Processing Notes

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

A check is made on the parameters sent and to make sure those parameters yield an actual column name to search and an actual asset number to check.

The catch point history (both live and archive) is then checked for all catch points that have their roles set as Auto-discovery over the period of time defined by the days in the past parameter.

If any records are found, the MIN or MAX value (as specified) is returned.

Note that there must be at least one catch point that is sourcing to the staging table whose role has been defined as "Autodiscovery".  This is set in the catch point definition record.

 

Inputs

 

Parameter

Explanation

Column to return

An integer value that refers to the cfNo of the column whose value is to be returned by the search.

Days to go back

An integer value that specifies the number of days in the past to search the catch point history for the requested column.  If sent <= 0, 30 will be used.  If sent > 90, then 90 will be used.

Type of value to return

This value must be either MIN or MAX.  If it is sent as any other value, MAX will be used.

 

Outputs

 

Result

Result Explanation

Confidence Adjustment

Return Value

True

One or more catch point history records were found and a value was returned.

N

Value requested

False

(this result is not returned by this function)

N/A

N/A

Else

One of many error conditions.  No column name, no asset number, no records found, or a processing error will return this result.  The thread log will show the actual reason.

Y

0