Func09_CheckBundleParents

<< Click to Display Table of Contents >>

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

Func09_CheckBundleParents

Description

This function checks the authorizations for the asset under test, or all devices hosted by the physical parent of the asset under test (including the physical parent), or all devices hosted by all members of the cluster of which the physical parent of the asset under test is a member (depending on various parameters passed), for one or more MSL titles as requested.

It returns a count of the active authorization(s) for the MSL title(s) requested.

 

Processing Notes

If Search all devices in the physical host is checked, the physical parent of the asset under test is used to find all devices hosted on that physical parent (including the physical parent).  All devices are checked for active authorizations of the MSL title(s) requested.

If Search all devices in the cluster of the physical host is checked, the physical parent of the asset under test is used to determine the name of the cluster of which it is a member (if any).  That cluster name is then used to identify all members, and the device names of those members are then used to identify all hosted devices (including the physical hosts).  All identified devices are then checked for active authorizations for the MSL title(s) requested.

If Search all devices in the cluster of the physical host is checked and the physical host is determined for the asset under test and that physical host has no cluster defined (it is not part of a cluster), a message will be logged to the thread log and the count of active authorizations for the physical host ONLY will be returned.  No confidence adjustment will take place and, barring any other errors encountered, the function will return a TRUE.

If any of the Search options are checked and the physical host cannot be determined (if the asset under test is virtual), a message will be logged to the thread log, confidence will be adjusted, and the function will return ELSE.

NOTE:  This function can only be used for authorizations that are assigned to a device (not those that are assigned to a user or group of users).

 

Inputs

 

Parameter

Explanation

MSL title(s) to check

A list of the MSL titles for which active authorizations will be checked against the device(s) specified.  By default, the check will be performed against the asset under test.

Search all devices in physical host

If checked, all devices hosted by the physical parent of the asset under test (if virtual), or the asset under test (if physical), will be checked for active authorizations matching the MSL title(s) to check.  In all cases the physical asset is included in the devices that are checked.

Search all devices in cluster of physical host

If checked, all devices hosted by all nodes of the cluster of which the physical parent of the asset under test (if virtual), or the asset under test (if physical) is a member, will be checked for active authorizations matching the MSL title(s) to check.  In all cases the physical asset(s) are included in the devices that are checked.

 

Outputs

 

Result

Result Explanation

Confidence Adjustment

Return Value

True

If any authorizations matching the MSL titles requested are found on any of the devices matching the scope of devices requested.

N

Total count of matching active authorizations for all requested titles

False

No matching authorizations were found.

N

0

Else

No MSL titles were specified

Searching of host or cluster specified, yet physical parent could not be determined.

If a runtime error is encountered.

Y

0