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

Description

This function must be used with caution. The purpose of this function is to harvest the authorization under test.

NOTE: Since this function harvests the authorization under test, there can be no further processing of the rule after this function is performed. The rule MUST terminate after this function is used.

This function will return a result of -1 if successful, which (assuming this is the last function of the rule processed) will cause the Housekeeping logic to leave the LUR of the current authorization as is.

NOTE: The results of the application of this rule will, as always, be written back to the authorization under test. In this case, assuming this function is successful, that authorization will have been harvested. Even though, it should still be visible on the user interface of the MIE and available through reporting.

Inputs

Parameter

Explanation

Remove S/W flag

(iParmVal2)

This parameter is a flag that signals the harvest mechanism if the installed software should be removed (physically) or not. If the MSL title to be harvested has a defined software de-install package and this flag is sent as -1, then the de-install package will be sent to remove the software from the machine to which it has been authorized. If the software is not to be de-installed, this flag should be sent as 0. Note that a de-install package has to be defined to remove software, regardless of the setting of this flag. If this flag is sent as -1 and there is no package defined to perform the de-install, the software will not be scheduled for de-install.

Outputs

Result	Result Explanation	Confidence Adjustment	Return Value
True	Current mslNo was successfully harvested	N	-1 (no change to existing LURs)
False	Contact with the MIE to perform the harvest event or authorization event failed.	Y	-10 = contact failed during harvest attempt -30 = contact failed during harvest attempt
Else	Error(s) encountered during attempt to harvest, or a general error occurred	Y	0 = general error -20 = error during harvest attempt -40 = error during harvest attempt

Func54_HarvestAuthorization

Func54_HarvestAuthorization