Cisco Cisco Evolved Programmable Network Manager 1.2 Developer's Guide

Northbound MTOSI Interface 

 

 

 

Cisco EPN Manager 1.2 Maintenance Pack 5 (V.1.2.500) MTOSI API Guide for OSS Integration 

 

 

20 

MTOSI Object Name (Reference - MTOSI Document SD2-7) is the management identifier of an MTOSI Object. 
It is used to represent MTOSI Object references in the MTOSI request and response messages. It consists of 
two parts, DN and RDN, explained in the table below: 
 

 
 
 

 
  
 
 
 
 
 

In Cisco EPN Manager, the RDN value mostly derived from the name of the inventory object that the 
particular RDN represents (for example, ME RDN, the value is name of the Device) and in some cases where 
the name alone cannot distinguish the object within its relative scope, a combination of the inventory object 
attributes will be used.  
 
The following are some examples for the Object Names. 
 

<ns8:me> 
 <ns5:name> 
    <ns3:rdn> 
       
<ns3:type>MD</ns3:type> 
    
<ns3:value>CISCO_EPNM</ns3:va
lue> 
     </ns3:rdn> 
     <ns3:rdn> 
        
<ns3:type>ME</ns3:type> 
        <ns3:value>cvg-scapa-
223.cisco.com</ns3:value> 
      </ns3:rdn> 
</ns5:name> 
</ns8:me> 

<ns8:eq> 
 <ns5:name> 
    <ns3:rdn> 
       
<ns3:type>MD</ns3:type> 
<ns3:value>CISCO_EPNM</ns3:va
lue> 
     </ns3:rdn> 
     <ns3:rdn> 
        
<ns3:type>ME</ns3:type> 
        <ns3:value>cvg-scapa-
223.cisco.com</ns3:value> 
      </ns3:rdn> 
  <ns3:rdn> 
    <ns3:type>EQ</ns3:type> 
    <ns3:value>name=0/0-PORT-
0-IDPROM;partnumber=CPAK-
100G-LR4</ns3:value> 
  </ns3:rdn> 
</ns5:name> 
</ns8:eq> 

<ns8:eq> 
 <ns5:name> 
    <ns3:rdn> 
       
<ns3:type>MD</ns3:type> 
<ns3:value>CISCO_EPNM</ns3:va
lue> 
     </ns3:rdn> 
     <ns3:rdn> 
        
<ns3:type>ME</ns3:type> 
        <ns3:value>cvg-scapa-
223.cisco.com</ns3:value> 
      </ns3:rdn> 
  
<ns3:rdn><ns3:type>CTP</ns3:t
ype><ns3:value>name=OTU20/7/0
/11;LR=LR_OCH_Transport_Unit_
2 </ns3:value> 
  </ns3:rdn> 
</ns5:name> 
</ns8:eq> 

 

Note: It is assumed that the Network that Cisco EPN Manager will have unique names for all the Devices in 
the network and the Network operator would ensure the uniqueness of the Device names. If two or more 
devices have the same name, the MTOSI API will not produce consistent results when using the Object Name 
as input to any of the MTOSI APIs. 

 

In  case  of  the  Networks  which  cannot  have  unique  names  for  the  devices,  Cisco  EPN  Manager  can  be 
configured  to  handle  the  Object  Names  using  the  ID  based  references,  but  this  requires  an  internal 
configuration change for Cisco EPN Manager which is not directly supported. 

Distinguished Name 
(DN) also known as 
FDN (Fully 
Distinguished Name) 

The management identifier of the MTOSI object. All MTOSI object instances 
have a unique DN. Note that the MTOSI DN is based on a sequence of RDNs.  
 

Relative 
Distinguished 
Names (RDN)  

A naming component of the DN. Each MTOSI RDN represents the local 
name of an MTOSI object instance understood in the context of the MTOSI 
objects hierarchy structure.  
The MTOSI RDN is composed of two data:  
1. The MTOSI object type identifier.  
2. The name of MTOSI object instance.