Input(s)

Output(s)

Definition

Required inputs

AssetID (int) - primary key value of asset record from MIE.  Send as 0 if not known.

AssetIDxmslNo (int) - primary key value of the authorization under test.  Send as 0 if not known.

ctNo (int) - primary key value of the asset's assignee (contact), from MIE.  Send as 0 if not known.

ctNoAuth (int) - primary key value of the authorization's  contact from MIE.  Send as 0 if not known.

ctNoCustodian (int) - primary key value of the asset's custodian (contact) from MIE.  Send as 0 if not known.

CustNo (int) - Customer number.  Used to determine the customer whose data will be used.  This value must be populated and must agree with the custNo of the userID used to authenticate to the MIE when calling this web service.

OptionNo (int) - Option number from MIE.  Send as 2 if not otherwise known.

SiteNo (int) - Site number from MIE.  Send as 1 if not otherwise known.

Optional Inputs (these must be populated if calling the method to analyze a stand-alone request where record(s) are not expected to exist on the MIE to support this analysis (such as calling to determine licenses required for a theoretical scenario or asset request)

AssetNumber (string) - Asset number (tag) assigned to asset under test.

AssetType (string) - type of asset (PC, laptop, desktop, server, etc)

ClusterName (string) - name of cluster to which asset belongs (if applicable)

ClusterRole (string) - role asset plays within cluster (if applicable)

ComputerName (string) - device name (network name) assigned to asset.

Cores (int) - number of cores for this asset

EmailAddress (string) - Email address of the contact assigned to the authorization under test (if applicable)

Environment (string) - environment to which asset under test is assigned (dev, prod, QA, etc)

FirstName (string) - first name of the contact assigned to the authorization under test (if applicable)

Hyperthreading (int) - 0 if hyperthreading is off, -1 if hyperthreading is on for the asset under test.

IsVirtual (int) - 0 if the asset under test is physical, -1 if the asset under test is virtual

LastName (string) - Last name of contact assigned to the authorization under test (if applicable)

LogicalProcessors (int) - if hyperthreading is on, the number of threads or logical processors assigned to the asset under test.

Manufacturer (string) - the manufacturer name of the asset under test.

mstProdNo (int) - Primary key value into the MIE's master product table for the asset under test.  Send as 0 if not known.

Parent (string) - Asset number of the physical asset to which this VM is assigned.  Applies when asset under test is a VM. This is not the preferred way to identify a parent - use PhysicalComputerName instead.

PartitionType (int) - type of partition in use.  1 = soft, 2 = hard.

PhysicalComputerName (string) - Computer name of the physical asset to which this VM is assigned.  Applies when asset under test is a VM.

Processors (int) - The number of processors assigned to the asset under test.

ProcessorMfr (string) - Processor manufacturer/model/name (as found by auto-discovery)

ProcessorSlots (int) - The number of physical slots for processors for the asset under test.

ProdDesc (string) - Product description of the asset under test.

SerialNumber (string) - Serial number of the asset under test.

Status (string) - life cycle status value of the asset under test.

Confidence (float) - confidence value (as defined in rule definition) of LUR answer.

Errors (string) - a textual explanation of any errors that were encountered during analysis.

LUR (int) - License Units Required.  This is the primary output of the Authorization Analyzer.

Notes (string) - shorthand explanation of results of analysis.

ThreadLog (string) - longhand explanation of results of analysis.

AnalyzeAuthorization is the method called to invoke the ESI Authorization Analyzer.
The AA runs in two modes, integrated and stand-alone.  In integrated mode, only the required inputs must be presented before calling the method.  All other information needed to process the rule will be pulled from the MIE's current tables.  Integrated is used when the MIE is being used as the primary source of information.  

Stand-alone mode is used when the MIE is not the primary source of information, in which case the information needed to process the rule must be passed as parameters to the method.  NOTE:  some rule functions will may still have insufficient information to perform their tasks when running in stand-alone mode.  For instance, rule functions that perform comparisons to other assets, or check to see if the current MSL title is covered under software maintenance - basically any rule function that requires data from other data sources beyond the asset, person, or authorization under test.  Stand-alone mode can be used to support request portals, for instance, to return the number of licenses of a requested title based on the requested hardware.