<< Click to Display Table of Contents >> Navigation:  Modules > Asset Management > Software License Management > Authorization Analyzer (Complex license types) > AA Functions > Func45_ChangeAuthMSL

Description

This function must be used with caution.  The purpose of this function is to change the Managed Software List (MSL) title with which the authorization under test in associated.  For example, if the authorization under test is for Microsoft SQL Server 2008 R2 Standard and you, as the rule designer, have encountered a circumstance where that authorization now needs to be assigned to SQL Server 2008 R2 Data Center, this is the function needed to perform that.  

This function works by first issuing a full harvest of all units of the authorization under test.  If that succeeds, it then issues a request for authorization for the new title with the same number of units that were associated with the old title.

The new title may be specified as a Wiki Master title.  If it is specified as a Wiki Master, it will be traced down to the local MSL and the new authorization will be created against the linked local MSL title, not the Wiki Master title.  If no linked local title exists, an ELSE path will be returned.

 

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.

NOTE:  Do not cross authorization types.  Meaning, if the old title is authorized by device, do not attempt to change it to one that is authorized by named user.  It is very likely insufficient information will exist with the old authorization to allow successful authorization of the new title to occur.

NOTE:  Since this function results in the change of an authorization, it must be handled as a separate harvest, then authorization transaction.  Since anything to do with authorizations is a financial event to the MIE, the transaction must be handled this way to ensure proper credit and debit records are created.

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.  Just remember to look for the results in the old authorization, not the new authorization.

 

Processing Notes

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

•Checks to see if the mslNo TO specified is a Wiki Master title.  If so, traces that title down to the current customer's MSL.  If no local MSL title is linked to the Wiki Master title that has been specified, an Else path is returned.

•Current authorization under test is harvested.

•If the harvest is successful, an authorization is requested for the new title.  The organization ID, department ID, cost center, units, instance name and number, asset id and asset number, contact, and contact list from the old authorization are used to create the new authorization.  

•The proper debit and credit records will be created due to the harvest and subsequent authorization transactions.

 

Inputs

 

 

Outputs