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.
The actual tilt at any point in time is the summation of mechanicalOffset and retTiltValue.

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:

  • for the Inventory Unit representing a Rack, the Frame Identification code may be used as the value of this attribute;
  • for the Inventory Unit representing a Shelf, the Rack Shelf code may be used as the value of this attribute;
  • for the Inventory Unit representing a Slot, the position code may be used as the value of this attribute.

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