|
<< Click to Display Table of Contents >> Navigation: Modules > Asset Management > Software License Management > Authorization Analyzer (Complex license types) > AA Functions > Func57_AggregateRoundUp |
Description
This function allows the rule to roll up the floating point LUR values from a group of authorizations, and round up the value to the next whole number. Then it will assign the rolled up value on one authorization and zero out the rest.
Processing Notes
The function will validate the input parameters, and then process the aggregation of authorizations that match the parameters. The final LUR will be carried on one authorization in the group. Subsequent passes through the rule will sort the authorizations by LUR, so that the single authorization carrying the LUR will be processed last and will continue to carry the LUR.
NOTE: This function requires that each asset include a computer name when attempting to correlate host and cluster relationships.
NOTE: Great care should be taken to ensure that the results of the subrule being called returns a valid LUR for the individual authorizations being processed in the aggregation. If the subrule returns a large number, or string value, then the rolled up and rounded LUR carried for the aggregate could be a bad number.
NOTE: If multiple authorizations in the same aggregate group run the same rule in one DCLA run, the first run will assign the LUR and the other runs will leave the already assigned LUR alone instead of reprocessing the aggregate all over again.
NOTE: The function returns an accessible variable along with its return code that can be looked up by further nodes in the rule: AGGREGATELUR. See AA-Specific Tags for more details.
Inputs
Parameter |
Explanation |
|---|---|
Search all devices on the physical host (Overrides just the asset under test) |
This is a yes/no checkbox. If selected, the physical host of the authorization under test and all VMs on it will be searched. |
Search all devices in the cluster of the physical host (Overrides asset under test and physical host) |
This is a yes/no checkbox. If selected, all host that match the cluster of the physical host of the authorization under test, and all VMs on those hosts will be searched. |
Search all devices based on condition (Overrides asset under test and physical host and cluster host) |
This allows for an asset based condition to be used to identify the group of assets to be considered. |
Environment(s) to include (CTRL to select multiple) |
This allows a specific list of master environments to be included for consideration. If left blank (default), then no check for the asset environment is performed. Click here for help on maintaining master environment mapping. |
Search this family (overrides family of MSL on authorization, accepts tags) |
Use the selected family for the search rather than the family of the MSLno on the authorization under test. |
Search this class (overrides family parameter, accepts tags) |
Use the selected class for the search rather than the family of the MSLno on the authorization under test. |
Call this subrule for each authorization |
This is a dropdown selection for the subrule to be called for each individual authorization in the aggregation. |
Advanced reason code (Optional) |
An advanced reason code can be assigned to authorizations that are altered by this function. |
Outputs
Result |
Result Explanation |
Confidence Adjustment |
Return Value |
|---|---|---|---|
True |
This compound function will make adjustments to the authorizations participating in the aggregation. The result of the authorization under test will be set to -1 to let DCLA know that no changes should be made to this record. |
No |
-1 |
False |
Case 1: Duplicate assets found when identifying the host. Case 2: No assets found for the configured condition. Case 3: Search cluster selected, but no cluster name found on the physical asset. Case 4: No host found that match the cluster name. Case 5: Insufficient host information. Case 6: Nothing returned when querying for cluster hosts. Possibly a system error communicating with the SQL server. Case 7: No assets returned that match the parent name. Case 8: No authorizations match the input criteria. Case 9: Failure updating a an authorization with the results of the subrule. |
Yes |
0 |
Else |
A general error occurred. |
Yes |
0 |