Cisco Cisco Evolved Programmable Network Manager 2.0 Developer's Guide

 
Northbound MTOSI Interface 

 

 

 

 

 

Cisco EPN Manager 2.0.1 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 is 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). 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 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.