6 Information Object Classes
32.6923GPPInventory Management (IM) network resources Integration Reference Point (IRP)Network Resource Model (NRM)Release 11Telecommunication managementTS
6.1 Imported information entities and local labels
Label reference | Local label |
32.622 [10], information object class, Top | Top |
32.622 [10], information object class, ManagedElement | ManagedElement |
6.2 Class diagram
6.2.1 Attributes and relationships
This clause depicts the set of IOCs that encapsulate information relevant for this service. This clause provides the overview of all information object classes in UML. Subsequent clauses provide more detailed specification of various aspects of these information object classes.
The inventory NRM contains two alternatives for inventory data modeling. Alternative 1 is for NE structure and hardware inventory. Alternative 2 is an extended version for inventory information modeling consisting of NE structure, hardware, software and license data inventory.
Alternative 1, hardware inventory model
NOTE: The listed cardinality numbers represent transient as well as steady-state numbers, and reflect all managed object creation and deletion scenarios.
Figure 6.2.1: Alternative 1 – Inventory Management NRM Containment/Naming and Association diagram
Each IOC instance is identified with a Distinguished Name (DN) according to 3GPP TS 32.300 [7] that expresses its containment hierarchy. As an example, the DN of a IOC representing a InventoryUnit could have a format like:
SubNetwork=Sweden,meContext=MEC-Gbg-1,ManagedElement=RNC-Gbg-1,InventoryUnit=Inv-1.
Alternative 2, extended model for hardware, software and licence inventory:
Figure 6.2.1-2: Alternative 2 – Inventory Management NRM Containment/Naming and Association diagram
NOTE: Inventory information upload in alternative 2 is done using the the FT IRP and related FT IRP notification capabilites
6.2.2 Inheritance
This subclause depicts the inheritance relationships that exist between IOCs.
Figure 6.2.2 shows the inheritance hierarchy for the IM NRM.
Figure 6.2.2: Inventory Management NRM Inheritance Hierarchy
6.3 Information object class definitions
6.3.1 InventoryUnit
6.3.1.1 Definition
This IOC represents inventory information for an Inventory Unit.
6.3.1.2 Attributes
Attributes of InventoryUnit
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
inventoryUnitType | M | M | – |
vendorUnitFamilyType | CM | M | – |
vendorUnitTypeNumber | CM | M | – |
versionNumber | O | M | – |
vendorName | M | M | – |
serialNumber | CM | M | – |
dateOfManufacture | O | M | – |
dateOfLastService | O | M | – |
unitPosition | O | M | – |
manufacturerData | O | M | – |
relatedFunction | O | M | – |
6.3.1.3 Attribute constraints
Name | Definition |
vendorUnitFamilyType CM Support Qualifier | The inventory is hardware. |
vendorUnitTypeNumber CM Support Qualifier | The inventory is hardware. |
serialNumber CM Support Qualifier | The inventory is hardware. |
6.3.1.4 Relationships
None.
6.3.1.5 State diagram
None.
6.3.1.6 Notifications
None.
6.3.2 InventoryUnitNE
6.3.2.1 Definition
This SupportIOC represents the logical and physical structure of the NE.
6.3.2.2 Attributes
Attributes of InventoryUnitNE
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | |
neId | M | M | |
customerIdentifier | O | M | – |
productName | M | M | – |
vendorName | M | M | – |
productType | O | M | – |
salesUniqueId | O | M | – |
operatorUniqueName | O | M | – |
siteId | O | M | – |
additionalInformation | O | M | – |
6.3.2.3 Attribute constraints
None.
6.3.2.4 Relationships
None.
6.3.2.5 State diagram
None.
6.3.2.6 Notifications
None.
6.3.3 InventoryUnitHw
6.3.3.1 Definition
This SupportIOC represents the hardware components.
6.3.3.2 Attributes
Attributes of InventoryUnitHw
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
hwId | M | M | – |
hwType | M | M | – |
hwName | O | M | – |
hwVersion | M | M | – |
vendorName | O | M | – |
salesUniqueId | O | M | – |
hwUnitLocation | M | M | – |
model | O | M | – |
hwCapability | O | M | – |
modificationDate | O | M | – |
manualDataEntry | O | M | – |
additionalInformation | O | M | – |
6.3.3.3 Attribute constraints
None.
6.3.3.4 Relationships
None.
6.3.3.5 State diagram
None.
6.3.3.6 Notifications
None.
6.3.4 InventoryUnitSw
6.3.4.1 Definition
This SupportIOC represents the software components.
6.3.4.2 Attributes
Attributes of InventoryUnitSw
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
swId | M | M | – |
swName | O | M | – |
swVersion | O | M | – |
vendorName | O | M | – |
salesUniqueId | O | M | – |
classification | M | M | – |
swStatus | O | M | – |
swInstallationTime | O | M | – |
swActivationTime | O | M | – |
additionalInformation | O | M | – |
6.3.4.3 Attribute constraints
None.
6.3.4.4 Relationships
None.
6.3.4.5 State diagram
None.
6.3.4.6 Notifications
None.
6.3.5 InventoryUnitLic
6.3.5.1 Definition
This SupportIOC represents the licence components.
6.3.5.2 Attributes
Attributes of InventoryUnitLic
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
licId | M | M | – |
licType | O | M | – |
vendorName | O | M | – |
validity | O | M | – |
key | O | M | – |
licStatus | O | M | – |
licActivationTime | O | M | – |
salesUniqueId | O | M | – |
additionalInformation | O | M | – |
6.3.5.3 Attribute constraints
None.
6.3.5.4 Relationships
None.
6.3.5.5 State diagram
None.
6.3.5.6 Notifications
None.
6.3.6 TmaInventoryUnit
6.3.6.1 Definition
This IOC represents inventory information for a Tower Mounted Amplifier Unit.
6.3.6.2 Attributes
Attributes of TmaInventoryUnit
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
tmaNumberOfNon-LinearGainValues | CM | M | – |
tmaNon-LinearGainValue | CM | M | O |
tmaAdditionalDataFieldNumber | CO | M | O |
tmaAntennaModelNumber | CO | M | O |
tmaAntennaOperatingBands | CO | M | O |
tmaBeamwidthForEachOpBandInBandOrder | CO | M | O |
tmaGainForEachOpBandInBandOrder | CO | M | O |
tmaInstallationDate | CO | M | O |
tmaInstallersId | CO | M | O |
tmaMaxSupportedGain | CO | M | O |
tmaMinSupportedGain | CO | M | O |
6.3.6.3 Attribute constraints
Name | Definition |
tmaNumberOfNon-LinearGainValues CM Support Qualifier | It is supported over the Iuant interface. |
tmaNon-LinearGainValue CM Support Qualifier | It is supported over the Iuant interface. |
tmaAdditionalDataFieldNumber CO Support Qualifier | It is supported over the Iuant interface. |
tmaAntennaModelNumber CO Support Qualifier | It is supported over the Iuant interface. |
tmaAntennaOperatingBands CO Support Qualifier | It is supported over the Iuant interface. |
tmaBeamwidthForEachOpBandInBandOrder CO Support Qualifier | It is supported over the Iuant interface. |
tmaGainForEachOpBandInBandOrder CO Support Qualifier | It is supported over the Iuant interface. |
tmaInstallationDate CO Support Qualifier | It is supported over the Iuant interface. |
tmaInstallersId CO Support Qualifier | It is supported over the Iuant interface. |
tmaMaxSupportedGain CO Support Qualifier | It is supported over the Iuant interface. |
tmaMinSupportedGain CO Support Qualifier | It is supported over the Iuant interface. |
6.3.6.4 Notifications
None
6.3.7 AntennaInventoryUnit
6.3.7.1 Definition
This IOC represents inventory information for an Antenna Unit.
6.3.7.2 Attributes
Attributes of AntennaInventoryUnit
Attribute name | Support Qualifier | Read Qualifier | Write Qualifier |
id | M | M | – |
maxTiltValue | CO | M | O |
minTiltValue | CO | M | O |
mechanicalOffset | CO | M | O |
baseElevation | CO | M | O |
latitude | CO | M | O |
longitude | CO | M | O |
patternLabel | CO | M | O |
6.3.7.3 Attribute constraints
Name | Definition |
maxTiltValue CO Support Qualifier | It is supported over the Iuant interface. |
minTiltValue CO Support Qualifier | It is supported over the Iuant interface. |
mechanicalOffset CO Support Qualifier | It is supported over the Iuant interface. |
baseElevation CO Support Qualifier | It is supported over the Iuant interface. |
latitude CO Support Qualifier | It is supported over the Iuant interface. |
longitude CO Support Qualifier | It is supported over the Iuant interface. |
patternLabel CO Support Qualifier | It is supported over the Iuant interface. |
6.3.7.4 Notifications
None.
6.4 Information relationship definitions
6.4.1 MFNERelation (O)
6.4.1.1 Definition
This association represents the unidirectional relation between ManagedFunction and InventoryUnitNE.
6.4.1.2 Roles
Name | Definition |
mFunction | This role represents the associated ManagedFunction instances of a InventoryUnitNE instance. |
6.4.1.3 Constraints
None.
6.4.2 NESWRelation (O)
6.4.2.1 Definition
This association represents the bidirectional relation between InventoryUnitNE and InventoryUnitSW.
6.4.2.2 Roles
Name | Definition |
nEList | This role represents the associated InventoryUnitNE instances of a InventoryUnitSW instance. |
sWList | This role represents the associated InventoryUnitSW instances of a InventoryUnitNE instance. |
6.4.2.3 Constraints
None.
6.4.3 NEHWRelation (O)
6.4.3.1 Definition
This association represents the bidirectional relation between InventoryUnitNE and InventoryUnitHW.
6.4.3.2 Roles
Name | Definition |
nEList | This role represents the associated InventoryUnitNE instances of a InventoryUnitHW instance. |
hWList | This role represents the associated InventoryUnitHW instances of a InventoryUnitNE instance. |
6.4.3.3 Constraints
None.
6.4.4 NELICRelation (O)
6.4.4.1 Definition
This association represents the bidirectional relation between InventoryUnitNE and InventoryUnitLIC.
6.4.4.2 Roles
Name | Definition |
nEList | This role represents the associated InventoryUnitNE instances of a InventoryUnitLIC instance. |
lICList | This role represents the associated InventoryUnitLIC instances of a InventoryUnitNE instance. |
6.4.4.3 Constraints
None.
6.4.5 SWLICRelation (O)
6.4.5.1 Definition
This association represents the bidirectional relation between InventoryUnitSW and InventoryUnitLIC.
6.4.5.2 Roles
Name | Definition |
sWList | This role represents the associated InventoryUnitSW instances of a InventoryUnitLIC instance. |
lICList | This role represents the associated InventoryUnitLIC instances of a InventoryUnitSW instance. |
6.4.5.3 Constraints
None.
6.4.6 SWHWRelation (O)
6.4.6.1 Definition
This association represents the bidirectional relation between InventoryUnitSW and InventoryUnitHW.
6.4.6.2 Roles
Name | Definition |
sWList | This role represents the associated InventoryUnitSW instances of a InventoryUnitHW instance. |
hWList | This role represents the associated InventoryUnitHW instances of a InventoryUnitSW instance. |
6.4.6.3 Constraints
None.
6.4.7 HWLICRelation (O)
6.4.7.1 Definition
This association represents the bidirectional relation between InventoryUnitHW and InventoryUnitLIC.
6.4.7.2 Roles
Name | Definition |
hWList | This role represents the associated InventoryUnitHW instances of a InventoryUnitLIC instance. |
lICList | This role represents the associated InventoryUnitLIC instances of a InventoryUnitHW instance. |
6.4.7.3 Constraints
None.
6.4.8 MFSWRelation (O)
6.4.8.1 Definition
This association represents the unidirectional relation between ManagedFunction and InventoryUnitSW.
6.4.8.2 Roles
Name | Definition |
mFunction | This role represents the associated ManagedFunction instances of a InventoryUnitSW instance. |
6.4.8.3 Constraints
None.
6.4.9 MFHWRelation (O)
6.4.9.1 Definition
This association represents the unidirectional relation between ManagedFunction and InventoryUnitHW.
6.4.9.2 Roles
Name | Definition |
mFunction | This role represents the associated ManagedFunction instances of a InventoryUnitHW instance. |
6.4.9.3 Constraints
None.
6.4.10 MFLICRelation (O)
6.4.10.1 Definition
This association represents the unidirectional relation between ManagedFunction and InventoryUnitLIC.
6.4.10.2 Roles
Name | Definition |
mFunction | This role represents the associated ManagedFunction instances of a InventoryUnitLIC instance. |
6.4.10.3 Constraints
None.
6.4.11 Inventory-Function (M)
6.4.11.1 Definition
This association represents the unidirectional association from an InventoryUnit and its related ManagedFunctions.
6.4.11.2 Roles
Name | Definition |
relatedFunction | This role represents the ManagedFunction that is associated with an InventoryUnit. |
6.4.11.3 Constraints
None
6.5 Information attribute definitions
6.5.1 Definition and legal values
Table 6.5.1 defines the attributes that are present in several Information Object Classes of the present document.
Table 6.5.1: Attributes
Attribute Name | Definition | Legal Values |
---|---|---|
baseElevation | The elevation in meters above sea level at the base of the antenna structure. This value, when subtracted from height (see TS 32.792 [14]), provides the height of the antenna above the ground. Note: The value of this attribute has no operational impact on the network, e.g. the NE behavior is not affected by the value setting of this attribute. Note as well that this attribute is not supported over the Iuant interface according to Ref. 3GPP TS 25.466 [12]. | An integral value representing a number of meters in 0.1 meter increments. |
additionalInformation | Supplementary information about inventory data (if any) | |
classification | Name of installed SW (e.g. SW release, SW build, SW patches), empty value possible | |
customerIdentifier | Unique identification of a vendors’ customer | |
dateOfManufacture | Date of Manufacture of inventory unit. | |
dateOfLastService | Date of last service or repair of inventory unit. | |
hwCapability | Hardware capability e.g. capacity, size (empty value is possible) | |
hwName | Mnemonic of hw inventory unit family type (e.g. Fan, PSU) assigned by vendor. | |
hwType | Type of the HW unit e.g. equipment holder, carriage | |
hwUnitLocation | Unique physical / logical location identifier within NE | |
hwVersion | Version / revision no. of current unit e.g. firmware version (empty value possible in case no versioning is available) | |
id | An attribute whose ‘name+value’ can be used as an RDN when naming an instance of this object class. This RDN uniquely identifies the object instance within the scope of its containing (parent) object instance. | |
inventoryUnitId | An attribute whose ‘name+value’ can be used as an RDN when naming an instance of this object class. This RDN uniquely identifies the object instance within the scope of its containing (parent) object instance. | |
inventoryUnitType | Type of inventory unit (see TS 32.690 [11]) | |
key | License activation key according to the used licensing system | |
licActivationTime | It indicates the date and time when the license was activated. | All values indicating valid time. |
licId | Unique identifier of a license (e.g. name, code) | |
licStatus | License status – applicable only for managed licenses (e.g. scheduled, valid, expired, invalid, capacity violated) | |
licType | Describing type of current license (e.g. capacity, particular feature, no. of subscribers) | |
manualDataEntry | Indicates whether unit is passive (manual insertion of inventory data is needed) or active (inventory data can be read from the unit) | |
latitude | The latitude of the antenna location based on World Geodetic System (1984 version) global reference frame (WGS 84). Positive values correspond to the northern hemisphere. Note: The value of this attribute has no operational impact on the network, e.g. the NE behavior is not affected by the value setting of this attribute. Note as well that this attribute is not supported over the Iuant interface according to Ref. 3GPP TS 25.466 [12]. | Valid values described in 3GPP TS 23.032 [13]. |
longitude | The longitude of the antenna location based on World Geodetic System (1984 version) global reference frame (WGS 84). Positive values correspond to degrees east of 0 degrees longitude. Note: The value of this attribute has no operational impact on the network, e.g. the NE behavior is not affected by the value setting of this attribute. Note as well that this attribute is not supported over the Iuant interface according to Ref. 3GPP TS 25.466 [12]. | Valid values described in 3GPP TS 23.032 [13] |
manufacturerData | Manufacturer specific data of inventory unit. | |
model | Equipment configuration, e.g. standard hw unit or a variant that may contain additional disk capacity (empty value possible) | |
modificationDate | Date/time stamp of last change (e.g. repair action) | |
neId | vendor defined unique identifier of a logical or physical network element unit | |
operatorUniqueName | Unique NE identifier used by operator | |
productName | NE name classifying a vendor’s product family or function | |
productType | Identifier of the e.g. platform, in case the product can be based on different HW/SW platforms (not used for logical NEs) | |
salesUniqueId | Unique identifier used by vendor (used e.g. for ordering a new unit) | |
hwId | Hardware identifier allocated by the vendor, e.g. the serialnumber | |
maxTiltValue | The maximum amount of tilt the RET system can support. "Maximum supported tilt" in Ref. 3GPP TS 25.466 [12]. | See "Maximum supported tilt" in Ref. 3GPP TS 25.466 [12]. |
mechanicalOffset | This is a value representing a non-adjustable tilt value, which is imparted to the antenna due to the physical installation. Note: The value of this attribute has no operational impact on the network, e.g. the NE behavior is not affected by the value setting of this attribute. Note as well that this attribute is not supported over the Iuant interface according to Ref. 3GPP TS 25.466 [12]. | A single integral value corresponding to an angle in degrees between 0 and 360 with a resolution of 0.1 degrees. |
minTiltValue | The minimum amount of tilt the RET system can support, "Minimum supported tilt" in Ref. 3GPP TS 25.466 [12]. | See "Minimum supported tilt" in Ref. 3GPP TS 25.466 [12]. |
patternLabel | The pattern name is a textual, alpha-numeric string to allow identification of the antenna pattern along with the antenna vendor information such as model number, etc. Note: The value of this attribute has no operational impact on the network, e.g. the NE behavior is not affected by the value setting of this attribute. Note as well that this attribute is not supported over the Iuant interface according to Ref. 3GPP TS 25.466 [12]. | |
relatedFunction | This attribute contains the DN of one ManagedFunction. | |
serialNumber | Serial number of inventory unit. | |
siteId | NE site in customer network | |
swActivationTime | It indicates the date and time when the software was activated. | All values indicating valid time. |
swId | Unique identifier of a SW unit | |
swName | SW release name used | |
swInstallationTime | It indicates the date and time when the software installation process ended and the sotware was installed. | All values indicating valid time. |
swStatus | Status of the SW unit (e.g. installed, archived) | |
swVersion | Version identifier of the SW unit | |
tmaAdditionalDataFieldNumber | This attribute identifies a standard data field which has no operational impact. Used by the procedures SetDeviceData and GetDevicedata. Defined in Table B.3 of 3GPP TS 25.466 [12]. | Defined in TS 25.466 [12] |
tmaAntennaModelNumber | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaAntennaOperatingBands | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaBeamwidthForEachOpBandInBandOrder | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaGainForEachOpBandInBandOrder | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaInstallationDate | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaInstallersId | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaMaxSupportedGain | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaMinSupportedGain | A data field defined in Table B.3 of 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaNon-LinearGainValue | Defined in 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
tmaNumberOfNon-LinearGainValues | Defined in 3GPP TS 25.466 [12] | Defined in TS 25.466 [12] |
unitPosition | Position of inventory unit (e.g. Rack, shelf, slot, etc.). Depending on the implementation of the inventory unit in the managed system, the value and meaning of this attribute may vary. For example, if a system has three levels and types of inventory units representing Rack, Shelf and Slot respectively (i.e. the Managed Element contains multiple Rack inventory units, each Rack inventory unit contains multiple Shelf inventory units and each Shelf inventory unit contains multiple Slot inventory units), then for this example:
| |
validity | License validity which may include one of the elements duration, end (expiration date) or forever | |
vendorName | Name of inventory unit vendor (or vendors may provide manufacturer name) | |
vendorName | Name of inventory unit vendor. | |
vendorUnitFamilyType | Mnemonic of inventory unit family type (e.g. Fan, PSU) assigned by vendor. | |
vendorUnitTypeNumber | A vendor/manufacturer defined and assigned number which uniquely identifies the unit type and optionally for backward compatibility reasons only, also version (used for replacing HW units, spares). | |
versionNumber | The version information related to vendorUnitTypeNumber. |
6.5.2 Constraints
None
6.6 Particular information configurations
None
Annex A (informative):
Change history
Change history | ||||||||
Date | TSG # | TSG Doc. | CR | Rev | Subject/Comment | Cat | Old | New |
Sep 2002 | SA_17 | SP-020473 | — | — | Submitted to TSG SA #17 for Approval | — | 1.0.0 | 5.0.0 |
Dec 2004 | SA_26 | SP-040816 | 0001 | — | Align Inventory Management Network Resource Model with the latest template from Rel-6 TS 32.150 | F | 5.0.0 | 6.0.0 |
Jun 2005 | SA_28 | SP-050301 | 0002 | — | Remove obsolete compliance text in 4.2 | F | 6.0.0 | 6.1.0 |
Dec 2005 | SA_30 | SP-050714 | 0003 | — | Correct support qualifier – Align IS with requirements in 32.690 | F | 6.1.0 | 6.2.0 |
Jun 2006 | SA_32 | SP-060257 | 0004 | — | Correction of InventoryUnit missing VsDataContainer and Version Number | F | 6.2.0 | 6.3.0 |
Jun 2006 | SA_32 | SP-060257 | 0005 | — | Correct the TS reference number from 32.691 to 32.690 | F | 6.2.0 | 6.3.0 |
Jun 2007 | SA_36 | SP-070269 | 0006 | — | Delete the duplicated vendorUnitTypeNumber attribute definitions | F | 6.3.0 | 6.4.0 |
Jun 2007 | SA_36 | — | — | — | Automatic upgrade to Rel-7 (no CR) at freeze of Rel-7. | — | 6.4.0 | 7.0.0 |
Dec 2008 | SA_42 | — | — | — | Upgrade to Release 8 | — | 7.0.0 | 8.0.0 |
Dec 2009 | – | – | – | – | Update to Rel-9 version | — | 8.0.0 | 9.0.0 |
Mar 2011 | – | – | – | – | Update to Rel-10 version (MCC) | 9.0.0 | 10.0.0 | |
May 2011 | SA_52 | SP-110295 | 0007 | 1 | Add missing common RAT inventory | C | 10.0.0 | 10.1.0 |
May 2011 | SA_52 | SP-110290 | 0008 | 2 | Inventory Model Enhancements – IS | B | 10.0.0 | 10.1.0 |
Dec 2011 | SA_54 | SP-110722 | 0009 | 1 | Correct identifier for InventoryUnitHw | F | 10.1.0 | 10.2.0 |
Sep-2012 | SA_57 | SP-120563 | 0011 | 1 | Addition of swInstallationTime , swActivationTime and licActivationTime | B | 10.2.0 | 11.0.0 |