Professional Documents
Culture Documents
Navis EMS-CBGX
TMF 814 Adapter Implementation Reference
Software Release 09.02.00.00
This material is protected by the copyright laws of the United States and other
countries. It may not be reproduced, distributed, or altered in any fashion by any entity
(either internal or external to Lucent Technologies), except in accordance with
applicable agreements, contracts or licensing, without the express written consent of
Lucent Technologies.
Notice. Every effort was made to ensure that the information in this document was
complete and accurate at the time of printing. However, information is subject to
change.
Ordering Information. To order copies of this document, use the online ordering
instructions presented later in this guide.
Support Telephone Numbers. For technical support and other services, see the
customer support contact information in the “About This Guide” section of this
document.
1. License Grant. Lucent hereby grants to you, and you accept, a non-exclusive,
non-transferable license to use the computer software, including all patches, error
corrections, updates and revisions thereto in machine-readable, object code form only
(the “Software”), and the accompanying User Documentation, only as authorized in
this License Agreement. The Software may be used only on a single computer owned,
leased, or otherwise controlled by you; or in the event of inoperability of that
computer, on a backup computer selected by you. You agree that you will not pledge,
lease, rent, or share your rights under this License Agreement, and that you will not,
without Lucent’s prior written consent, assign or transfer your rights hereunder. You
agree that you may not modify, reverse assemble, reverse compile, or otherwise
translate the Software or permit a third party to do so. You may make one copy of the
Software and User Documentation for backup purposes. Any such copies of the
Software or the User Documentation shall include Lucent’s copyright and other
proprietary notices. Except as authorized under this paragraph, no copies of the
Program or any portions thereof may be made by you or any person under your
authority or control.
2. Lucent’s Rights. You agree that the Software and the User Documentation are
proprietary, confidential products of Lucent or Lucent's licensor protected under US
copyright law and you will use your best efforts to maintain their confidentiality. You
further acknowledge and agree that all right, title and interest in and to the Program,
including associated intellectual property rights, are and shall remain with Lucent or
Lucent's licensor. This License Agreement does not convey to you an interest in or to
the Program, but only a limited right of use revocable in accordance with the terms of
this License Agreement.
3. License Fees. The license fees paid by you are paid in consideration of the license
granted under this License Agreement.
4. Term. This License Agreement is effective upon your opening of the package(s) or
use of the switch(es) containing Software and shall continue until terminated. You
may terminate this License Agreement at any time by returning the Program and all
copies or portions thereof to Lucent. Lucent may terminate this License Agreement
upon the breach by you of any term hereof. Upon such termination by Lucent, you
agree to return to Lucent the Program and all copies or portions thereof. Termination
of this License Agreement shall not prejudice Lucent's rights to damages or any other
available remedy.
5. Limited Warranty. Lucent warrants, for your benefit alone, for a period of 90
days from the date of shipment of the Program by Lucent (the “Warranty Period”) that
the program diskettes in which the Software is contained are free from defects in
material and workmanship. Lucent further warrants, for your benefit alone, that during
the Warranty Period the Program shall operate substantially in accordance with the
User Documentation. If during the Warranty Period, a defect in the Program appears,
you may return the Program to the party from which the Program was acquired for
either replacement or, if so elected by such party, refund of amounts paid by you under
this License Agreement. You agree that the foregoing constitutes your sole and
exclusive remedy for breach by Lucent of any warranties made under this Agreement.
EXCEPT FOR THE WARRANTIES SET FORTH ABOVE, THE PROGRAM IS LICENSED
“AS IS”, AND LUCENT DISCLAIMS ANY AND ALL OTHER WARRANTIES,
WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT
LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE AND ANY WARRANTIES OF NONINFRINGEMENT.
8. Export Control. You agree not to export or disclose to anyone except a United
States national any portion of the Program supplied by Lucent without first obtaining
the required permits or licenses to do so from the US Office of Export Administration,
and any other appropriate government agency.
Contents
About This Guide
Purpose...................................................................................................................... xvii
What You Need to Know.......................................................................................... xvii
What’s New in This Guide ......................................................................................xviii
About the Provisioning Server Document Set ........................................................... xix
About the Navis EMS-CBGX TMF 814 Adapter Document Set............................... xx
How to Use This Guide.............................................................................................. xxi
Conventions .............................................................................................................. xxii
Related Documents ..................................................................................................xxiii
Lucent................................................................................................................xxiii
Third Party.........................................................................................................xxiii
Ordering Printed Manuals Online............................................................................xxiii
Customer Comments................................................................................................ xxiv
Technical Support .................................................................................................... xxiv
Chapter 1 Overview
System Architecture...................................................................................................1-1
Requirements .............................................................................................................1-2
EMS Requirements..............................................................................................1-2
Recommendations for Notification Service Usage....................................................1-3
General Recommendations..................................................................................1-3
QoS and Admin Parameters ................................................................................1-3
Constraints...........................................................................................................1-3
TMF Objects ..............................................................................................................1-4
Usage Information .....................................................................................................1-5
Chapter 17 nmsSession
Interfaces..................................................................................................................17-2
NmsSession_I....................................................................................................17-2
Chapter 24 Mapping TMF 814A Data Type and Provisioning Server Attributes
ems ...........................................................................................................................24-3
emssession................................................................................................................24-4
multiLayerSubnetwork ............................................................................................24-5
managedElement......................................................................................................24-7
equipment Holder.....................................................................................................24-9
equipment...............................................................................................................24-12
terminationPoint.....................................................................................................24-14
PTP.........................................................................................................................24-18
CTP ........................................................................................................................24-20
topologicalLink ......................................................................................................24-22
SubnetworkConnection..........................................................................................24-23
protection ...............................................................................................................24-29
trafficDescriptor.....................................................................................................24-34
transmissionParameters..........................................................................................24-36
guiCutThrough.......................................................................................................24-37
maintenanceOps.....................................................................................................24-38
performance ...........................................................................................................24-41
common..................................................................................................................24-41
Acronyms
Index
List of Figures
Figure 1-1. Navis EMS-CBGX TMF 814 Adapter Overview ...........................1-1
Figure 6-1. Termination Point Usage ...............................................................6-16
Figure A-1. Transport Technologies at various layers, and TMF object ........... A-1
Figure A-2. MTNM and G.805 Layered Model................................................. A-2
Figure A-3. 8 Port E3 ATM Card on CBX 500 ................................................. A-4
Figure A-4. 8 Port E3 ATM Card on CBX 500 ................................................. A-5
Figure A-5. 4 Port OC3c/STM1 ATM Card on CBX 500 ................................. A-6
Figure A-6. 6 Port FR Channelized DS3 Card................................................... A-8
List of Tables
Table 1-1. Provisioning Server Object Hierarchy.............................................1-2
Table 1-2. TMF Objects....................................................................................1-4
Table 2-1. List of Sections - emsMgr................................................................2-1
Table 2-2. getAllEMSAndMEActiveAlarms....................................................2-2
Table 2-3. getAllEMSSystemActiveAlarms.....................................................2-3
Table 2-4. getAllTopLevelSubnetworks...........................................................2-3
Table 2-5. getAllTopLevelSubnetworkNames .................................................2-4
Table 2-6. getAllTopLevelTopologicalLinks ...................................................2-4
Table 2-7. getAllTopLevelTopologicalLinkNames..........................................2-5
Table 2-8. getTopLevelTopologicalLink ..........................................................2-5
Table 2-9. getEMS ............................................................................................2-6
Table 3-1. List of Sections - emsSessionFactory ..............................................3-1
Table 3-2. getEmsSession .................................................................................3-2
Table 4-1. List of Sections - emsSession ..........................................................4-1
Table 4-2. getEventChannel..............................................................................4-2
Table 4-3. getManager ......................................................................................4-2
Table 4-4. getSupportedManagers ....................................................................4-3
Table 5-1. List of Sections - multiLayerSubnetwork........................................5-1
Table 5-2. activateSNC .....................................................................................5-3
Table 5-3. checkValidSNC ...............................................................................5-3
Table 5-4. createSNC ........................................................................................5-4
Table 5-5. deactivateSNC .................................................................................5-4
Table 5-6. deleteSNC ........................................................................................5-5
Table 5-7. getAllTPPoolNames ........................................................................5-5
Table 5-8. getAllTPPools..................................................................................5-6
Table 5-9. getAssociatedTP ..............................................................................5-6
Table 5-10. createAndActivateSNC....................................................................5-6
Table 5-11. deactivateAndDeleteSNC ................................................................5-8
Table 5-12. getAllEdgePoints .............................................................................5-9
Table 5-13. getAllEdgePointNames..................................................................5-10
Table 5-14. getAllManagedElements................................................................5-11
Table 5-15. getAllManagedElementNames ......................................................5-12
Table 5-16. getAllSubnetworkConnections ......................................................5-12
Table 5-17. getAllSubnetworkConnectionNames ............................................5-13
Table 5-18. getAllSubnetworkConnectionsWithTP .........................................5-14
Table 5-19. getAllSubnetworkConnectionNamesWithTP................................5-14
Table 5-20. getAllTopologicalLinks.................................................................5-15
Table 5-21. getAllTopologicalLinkNames .......................................................5-16
Table 5-22. getMultiLayerSubnetwork .............................................................5-16
Table 5-23. getRoute.........................................................................................5-17
Table 5-24. getSNC...........................................................................................5-17
Table 5-25. getSNCsByUserLabel....................................................................5-18
Table 5-26. getTopologicalLink........................................................................5-18
Table 6-1. List of Sections - managedElement .................................................6-1
Purpose
This document describes the modules, interfaces and data types for TMF 814.
The purpose of this document is to explain the support for TMF 814A specification
(version 2.1) and as such serves as the implementation reference for Provisioning
Server EMS. This document explains the Application Programming Interface (API)
and covers the following parameters for the Provisioning Server operations:
• Supported/UnSupported parameter
• In, Out and InOut parameter
These parameters provide the Provisioning Server mapping.
This document covers the TMF object naming for the Provisioning Server Objects. It
also covers the mapping of the TMF data types and the corresponding Provisional
Server object attributes.
Be sure to read the Software Release Notice (SRN) for NavisXtend Provisioning
Server. The SRN contains the most current product information and requirements.
Support for CBX 3500 switch Navis EMS-CBGX TMF 814 Adapter Release
09.02.00.00 supports CBX 3500 switch.
Title Description
• Troubleshoot problems.
The guide also provides overview information about Provisioning Server
objects. Specific topics include:
NavisXtend Provisioning Server CLI This guide is a reference for Provisioning Server CLI users. The guide
User’s Reference includes:
• CLI commands in a UNIX man-page format.
• Sample CLI commands for all Provisioning Server objects.
NavisXtend Provisioning Server This guide is a reference for programmers who are using the Provisioning
C++ API User’s Reference Server C++ API to design provisioning clients. The guide includes:
• C++ functions in a UNIX man-page format.
• C++ sample code.
NavisXtend Provisioning Server This guide is a reference for programmers who are using the Provisioning
Object Attribute Definitions Server CLI or C/C++ API. The guide includes:
User’s Reference
• Provisioning Server support for switch, card, LPort, PPort, and circuit
types.
• Alphabetical listing of Provisioning Server object attributes.
• Alphabetical listing of Provisioning Server enumerated data types.
NavisXtend Provisioning Server This guide lists Provisioning Server error codes and their associated text
Error Codes User’s Reference messages.
NavisXtend Provisioning Server This guide describes legacy C API functions. With Release 05.00.02.00,
Legacy C API Reference Lucent stopped developing C API and SNMP interfaces for new features.
Note, however, that Lucent still supports the legacy C API functions
described in this guide.
Navis EMS-CBGX TMF 814 Adapter This guide is a reference for programmers using the Navis
Implementation Reference Guide (Product EMS-CBGX TMF 814 Adapter APIs to design NMS.
Code: 86011 Revision 000) The guide provides information about Navis EMS-CBGX TMF
814A Implementation for Provisioning Server objects. Specific
topics include:
• Object types supported by the Navis EMS-CBGX TMF 814
Adapter
• Naming conventions for object types.
Navis EMS-CBGX TMF 814 Adapter This guide describes how to:
Installation and Administration Guide
• Install the Navis EMS-CBGX TMF 814 Adapter.
(Product Code: 86012 Revision 000)
• Customize the Navis EMS-CBGX TMF 814 Adapter
environment.
• Troubleshoot problems.
“Chapter 2 to Chapter 22” These chapters covers the TMF operations for
modules such as emsMgr, emsSession,
equipment, multiLayerSubnetwork and others.
Conventions
This guide uses the following conventions, when applicable:
Note – provide additional information or helpful suggestions that may apply to the
subject text.
Caution – notify the reader to proceed carefully to avoid possible equipment damage
! or data loss.
Warning – notify the reader to proceed carefully to avoid possible personal injury.
Related Documents
This section lists the related Lucent and third-party documentation that may be helpful
to read.
Lucent
• NavisXtend Provisioning Server Release 09.02.00.00 User’s Guide
(Product Code: 86000)
• NavisXtend Provisioning Server Release 09.02.00.00 Object Attribute Definitions
User’s Reference (Product Code: 86001)
• NavisXtend Provisioning Server Release 09.02.00.00 Command Line Interface
User’s Reference (Product Code: 86002)
• NavisXtend Provisioning Server Release 09.02.00.00 C++ API User’s Reference
(Product Code: 86003)
• NavisXtend Provisioning Server Release 09.02.00.00 Error Codes User’s
Reference (Product Code: 86004)
• NavisXtend Provisioning Server Legacy C API Reference (Product Code: 80163)
• Navis EMS-CBGX TMF 814 Adapter Installation and Administration Guide
(Product Code: 86012)
All manuals for Core Systems and the Master Glossary are available on the Core
Systems Documentation Library CD-ROM (Product Code: 80025).
Third Party
• TMF 513, TMF 608, TMF 814A
See the TeleManagement Forum (TM Forum) at www.tmforum.org for more
information.
Customer Comments
Customer comments are welcome. Please respond in one of the following ways:
• Fill out the Customer Comment Form located at the back of this guide and return
it to us.
Technical Support
The Lucent Technical Assistance Center (TAC) is available to assist you with any
problems encountered while using this Lucent product. Log on to our Customer
Support web site and click on the ‘Contact Us’ link at the top right-hand side of the
page to obtain telephone numbers for the Lucent TAC in your region:
http://www.lucent.com/support
1
Overview
This chapter covers the following:
• “System Architecture” on page 1-1
• “Requirements” on page 1-2
• “TMF Objects” on page 1-4
System Architecture
To interface with Provisioning Server, NMS interacts with the Navis EMS-CBGX
TMF 814 Adapter. The Navis EMS-CBGX TMF 814 Adapter is a multithreaded
application implementing TMF 814, and uses Lucent Provisioning Server EMS, Trap
Server along with Access Control Server through CORBA. The system architecture is
as depicted in the following illustration.
To configure Lucent Switches and access devices, use Navis EMS-CBGX for the
features not available in TMF 814. Also, there can be more than one Provisioning
Server or Access Control Server in the same network for load balancing and handling
more than 200 requests at a time. Navis EMS-CBGX can also be used with other
Lucent Servers for username/password and other features.
Requirements
EMS Requirements
The following objects show the Provisioning Server object hierarchy and should exist
(these objects should be added) in the Provisioning Server database:
General Recommendations
The following recommendations will be implemented:
• Use only Push Model in EMS.
• Use one channel (a set of processes of Navis EMS-CBGX TMF 814 Adapter
associated with a single Provisioning Server Database) to avoid ordering
problems.
• Use one notification service for a set of processes of Navis EMS-CBGX TMF 814
Adapter associated with a single Provisioning Server Database.
Constraints
Object Creation Notifications, Object Deletion Notifications, Attribute Value Changes
(AVC), and State Change Notifications will not be provided while using the Command
Line Interface (CLI).
TMF Objects
Navis EMS-CBGX TMF 814 Adapter maps the Provisioning Server objects to the
TMF 814A defined objects in the best way possible. The following list contains the
conversion between the Provisioning Server objects and the TMF 814A Naming
Attributes:
Usage Information
Follow these instructions:
• Use Provisioning Server Command Line Interface (CLI), NavisCore, or Navis
EMS-CBGX for creating Trunk/PnniLink (Topological Link of TMF 814), and
also for switch addition, modification and deletion.
• For the value of each attribute pertaining to Provisioning Server object, use CLI or
guiCutThrough:
2
emsMgr Module
This chapter covers the following:
Interfaces
EMSMgr_I
This interface covers the following:
• “getAllEMSAndMEActiveAlarms” on page 2-2
• “getAllEMSSystemActiveAlarms” on page 2-3
• “getAllTopLevelSubnetworks” on page 2-3
• “getAllTopLevelSubnetworkNames” on page 2-4
• “getAllTopLevelTopologicalLinks” on page 2-4
• “getAllTopLevelTopologicalLinkNames” on page 2-5
• “getTopLevelTopologicalLink” on page 2-5
• “getEMS” on page 2-6
Operation getAllEMSAndMEActiveAlarms
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• notifications::PerceivedSeverityList_T excludeSeverityList
Operation getAllEMSSystemActiveAlarms
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
Comments This operation returns all the TCAs and system alarms list.
Operation getAllTopLevelSubnetworks
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• multiLayerSubnetwork::SubnetworkIterator_I sIt
Operation getAllTopLevelSubnetworkNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllTopLevelTopologicalLinks
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_INTERNAL_ERROR
Operation getAllTopLevelTopologicalLinkNames
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
Comments This operation returns the list of TopologicalLink object IDs (trunks
supported) as NamingAttributeList_T.
Operation getTopLevelTopologicalLink
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
Comments This operation returns a top level topological link object structure
(trunks supported) as TopologicalLinkList_T.
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
in arguments None
Data Types
The data types for emsMgr module are as follows:
• “EMS_T” on page 24-3
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
3
emsSessionFactory Module
This chapter covers the following:
Note – This module does not have any data types that represent second level
objects. Also, there are no specific notifications associated with this module.
Interfaces
EmsSessionFactory_I
This interface covers the following:
Operation getEmsSession
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ACCESS_DENIED
• string password
• nmsSession::NmsSession_I client
(see “NmsSession_I” on page 17-2)
Comments The user and password are configured using Navis EMS-CBGX.
Otherwise, empty string should be used for user name and password.
4
emsSession Module
This chapter covers the following:
Interfaces
EmsSession_I
This interface covers the following:
Operation getEventChannel
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_ACCESS_DENIED
in arguments None
Operation getManager
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_ACCESS_DENIED
Operation getManager
Operation getSupportedManagers
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_ACCESS_DENIED
Comments The TMF 814 (version 2.1) specifies 9 managers (4 optional and 5
mandatory).
This operation returns the object reference of each supported manager
implemented by Navis EMS-CBGX TMF 814 Adapter.
Data Types
The data types for emsSession module are as follows:
• managerNames_T on page 24-4
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
5
multiLayerSubnetwork Module
This chapter covers the following:
Section Covers
Interfaces
This interface covers the following:
• “MultiLayerSubnetworkMgr_I” on page 5-2
• “SubnetworkIterator_I” on page 5-19
MultiLayerSubnetworkMgr_I
The following table lists the interfaces:
• “activateSNC” on page 5-3
• “checkValidSNC” on page 5-3
• “createSNC” on page 5-4
• “deactivateSNC” on page 5-4
• “deleteSNC” on page 5-5
• “getAllTPPoolNames” on page 5-5
• “getAllTPPools” on page 5-6
• “getAssociatedTP” on page 5-6
• “createAndActivateSNC” on page 5-6
• “deactivateAndDeleteSNC” on page 5-8
• “getAllEdgePoints” on page 5-9
• “getAllEdgePointNames” on page 5-10
• “getAllManagedElements” on page 5-11
• “getAllManagedElementNames” on page 5-12
• “getAllSubnetworkConnections” on page 5-12
• “getAllSubnetworkConnectionNames” on page 5-13
• “getAllSubnetworkConnectionsWithTP” on page 5-14
• “getAllSubnetworkConnectionNamesWithTP” on page 5-14
• “getAllTopologicalLinks” on page 5-15
• “getAllTopologicalLinkNames” on page 5-16
• “getMultiLayerSubnetwork” on page 5-16
• “getRoute” on page 5-17
• “getSNC” on page 5-17
• “getSNCsByUserLabel” on page 5-18
• “getTopologicalLink” on page 5-18
Operation activateSNC
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• subnetworkConnection::GradesOfImpact_T tolerableImpact
(see “GradesOfImpact_T” on page 24-24)
• EMSFreedomLevel_T emsFreedomLevel
(see “EMSFreedomLevel_T” on page 24-6)
• subnetworkConnection::SubnetworkConnection_T theSNC
(see “SubnetworkConnection_T” on page 24-23)
• string errorReason
Operation checkValidSNC
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• subnetworkConnection::TPDataList_T tpsToModify
(see “TPDataList_T” on page 24-28)
• boolean considerResources
Operation createSNC
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• subnetworkConnection::GradesOfImpact_T tolerableImpact
(see “GradesOfImpact_T” on page 24-24)
• EMSFreedomLevel_T emsFreedomLevel
(see “EMSFreedomLevel_T” on page 24-6)
• string errorReason
Operation deactivateSNC
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• subnetworkConnection::GradesOfImpact_T tolerableImpact
(see “GradesOfImpact_T” on page 24-24)
• EMSFreedomLevel_T emsFreedomLevel
(see “EMSFreedomLevel_T” on page 24-6)
• subnetworkConnection::SubnetworkConnection_T theSNC
(see “SubnetworkConnection_T” on page 24-23)
• string errorReason
Operation deactivateSNC
Operation deleteSNC
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getAllTPPoolNames
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Operation getAllTPPools
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• terminationPoint::TerminationPointIterator_I tpIt
Operation getAssociatedTP
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Operation createAndActivateSNC
Status Mandatory
Supported Yes
Operation createAndActivateSNC
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_OBJECT_IN_USE
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_TIMESLOT_IN_USE
• EXCPT_PROTECTION_EFFORT_NOT_MET
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_UNSUPPORTED_ROUTING_CONSTRAINTS
• EXCPT_USERLABEL_IN_USE
• subnetworkConnection::GradesOfImpact_T tolerableImpact
(see “GradesOfImpact_T” on page 24-24)
• EMSFreedomLevel_T emsFreedomLevel
(see “EMSFreedomLevel_T” on page 24-6)
• subnetworkConnection::SubnetworkConnection_T theSNC
(see “SubnetworkConnection_T” on page 24-23)
• string errorReason
Operation createAndActivateSNC
• For offnet circuit types, targetaddr and its related parameters should
be provided in the additionalInfo as input.
Specific attribute or flag is not required to create leaf only. Specify the
aEnd as existing root name and the zEnd as leaf name to create leaf
only.
If the root does not exist, Navis EMS-CBGX TMF 814 Adapter returns
root data. Otherwise, returns the leaf data in the 'out' parameter.
Operation deactivateAndDeleteSNC
Status Mandatory
Supported Yes
Operation deactivateAndDeleteSNC
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• subnetworkConnection::GradesOfImpact_T tolerableImpact
(see “GradesOfImpact_T” on page 24-24)
• EMSFreedomLevel_T emsFreedomLevel
(see “EMSFreedomLevel_T” on page 24-6)
• subnetworkConnection::SubnetworkConnection_T theSNC
(see “SubnetworkConnection_T” on page 24-23)
• string errorReason
Comments This operation deletes circuit and endpoint CTP depending on the
values of EMSFreedomeLevel_T.
EMSFL_CC_AT_SNC_LAYER (enum EMSFreedomLevel_T) and
EMSFL_TERMINATE_AND_MAP are supported in Navis
EMS-CBGX TMF 814 Adapter Release 09.02.00.00.
For EMSFL_TERMINATE_AND_MAP, deletion is not supported in
Navis EMS-CBGX TMF 814 Adapter Release 09.02.00.00.
This operation fetches circuit information and deletes the circuit. Navis
EMS-CBGX TMF 814 Adapter returns the retrieved information in the
out parameter (SubnetworkConnection_T).
Operation getAllEdgePoints
Status Mandatory
Supported Yes
Operation getAllEdgePoints
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_TlayerRateList
(see “LayerRateList_T” on page 24-36)
• transmissionParameters::LayerRateList_T connectionLayerRate
List (see “LayerRateList_T” on page 24-36)
• terminationPoint::TerminationPointIterator_I tpIt
Operation getAllEdgePointNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllEdgePointNames
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
• transmissionParameters::LayerRateList_T connectionLayerRate
List (see “LayerRateList_T” on page 24-36)
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• managedElement::ManagedElementIterator_I meIt
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Comments This operation returns the list of switch object IDs in a particular
network as NamingAttributesList_T.
Operation getAllSubnetworkConnections
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_UNABLE_TO_COMPLY
Operation getAllSubnetworkConnections
• transmissionParameters::LayerRateList_T connectionRateList
(see “LayerRateList_T”on page 24-36)
• subnetworkConnection::SNCIterator_I sncIt
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_UNABLE_TO_COMPLY
• transmissionParameters::LayerRateList_T connectionRateList
(see “LayerRateList_T” on page 24-36)
Operation getAllSubnetworkConnectionNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_UNABLE_TO_COMPLY
• transmissionParameters::LayerRateList_T connectionRateList
(see “LayerRateList_T” on page 24-36)
• subnetworkConnection::SNCIterator_I sncIt
Operation getAllSubnetworkConnectionNamesWithTP
Status Mandatory
Supported Yes
Operation getAllSubnetworkConnectionNamesWithTP
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T connectionRateList
(see “LayerRateList_T” on page 24-36)
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllTopologicalLinks
• topologicalLink::TopologicalLinkIterator_I topoIt
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getMultiLayerSubnetwork
Status Mandatory
Supported Yes
Operation getMultiLayerSubnetwork
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• boolean includeHigherOrderCCs
Operation getSNC
Status Mandatory
Supported Yes
Operation getSNC
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Status Mandatory
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_NE_COMM_LOSS
Operation getTopologicalLink
Status Mandatory
Supported Yes
Operation getTopologicalLink
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
SubnetworkIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for multiLayerSubnetwork module are as follows:
• “EMSFreedomLevel_T” on page 24-6
• “MultiLayerSubnetwork_T” on page 24-5
• “SubnetworkList_T” on page 24-6
• “Topology_T” on page 24-6
Notifications
Object Creation Notifications, Object Deletion Notifications, Attribute Value Changes
(AVC), and State Change Notifications will be provided when appropriate.
6
managedElement Module
This chapter covers the following:
Section Covers
Interfaces
ManagedElementMgr_I
This interface covers the following:
• “getAllActiveAlarms” on page 6-3
• “getAllCrossConnections” on page 6-3
• “getAllManagedElements” on page 6-4
• “getAllManagedElementNames” on page 6-4
• “getAllPTPs” on page 6-5
• “getAllPTPNames” on page 6-6
• “getContainedCurrentTPs” on page 6-6
• “getContainedCurrentTPNames” on page 6-7
• “getContainedInUseTPs” on page 6-8
• “getContainedInUseTPNames” on page 6-9
• “getContainedPotentialTPs” on page 6-9
• “getContainedPotentialTPNames” on page 6-10
• “getContainingSubnetworkNames” on page 6-11
• “getContainingTPs” on page 6-11
• “getContainingTPNames” on page 6-12
• “getManagedElement” on page 6-12
• “getTP” on page 6-13
• “setTPData” on page 6-13
Operation getAllActiveAlarms
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• notifications::ProbableCauseList_T excludeProbCauseList
• notifications::PerceivedSeverityList_T excludeSeverityList
Operation getAllCrossConnections
Status Mandatory
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
• transmissionParameters::LayerRateList_T connectionRateList
(see “LayerRateList_T” on page 24-36)
Operation getAllCrossConnections
Comments This operation is not supported for Navis EMS-CBGX TMF 814
Adapter Release 09.02.00.00.
This operation returns an empty list.
Operation getAllManagedElements
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• managedElement::ManagedElementIterator_I meIt
Comments This operation returns the list of switches and all its attributes in
ManagedElementList_T.
Operation getAllManagedElementNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllManagedElementNames
Operation getAllPTPs
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T tpLayerRateList
(see “LayerRateList_T” on page 24-36)
• transmissionParameters::LayerRateList_T connectionLayerRate
List (see “LayerRateList_T” on page 24-36)
• terminationPoint::TerminationPointIterator_I tpIt
Operation getAllPTPNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
• transmissionParameters::LayerRateList_T connectionLayerRate
List (see “LayerRateList_T” on page 24-36)
Operation getContainedCurrentTPs
Status Optional
Supported Yes
Operation getContainedCurrentTPs
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
• terminationPoint::TerminationPointIterator_I tpIt
Operation getContainedCurrentTPNames
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getContainedCurrentTPNames
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
• terminationPoint::TerminationPointIterator_I tpIt
Comments This operation returns the object IDs of TPs (includes the TPs that are
in use by the circuit) in TerminationPointList_T.
Only ATM and Frame Relay layer rates are supported.
Operation getContainedInUseTPNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
Comments This operation returns the object IDs of TP (includes the TPs that are in
use by the circuit) as NamingAttributesList_T.
Only ATM and Frame Relay layer rates are supported.
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getContainedPotentialTPs
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
• terminationPoint::TerminationPointIterator_I tpIt
Comments This operation returns the object IDs of TPs (includes the TPs that are
configured and non-configured) in TerminationPointList_T.
If the input layer rate is LR_ATM_VP, getContainedPotentialTPs on
PPort returns VPI circuit endpoint.
If the input layer rate is LR_ATM_VC, getContainedPotentialTPs on
PPort returns VCI circuit endpoint on that VPI.
If the input laye rate is LR_ATM_NI, getContainedPotentialTPs on
PPort returns direct LPort, virtual LPort and OpticellTrunk LPort.
Similar behavior is supported for Frame Relay layer rate.
Only ATM and Frame Relay layer rates are supported.
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• transmissionParameters::LayerRateList_T layerRateList
(see “LayerRateList_T” on page 24-36)
Operation getContainedPotentialTPNames
Comments This operation returns the object ids of TPs (includes the TPs that are
configured and non-configured) as NamingAttributesList_T.
If the input layer rate is LR_ATM_VP, getContainedPotentialTPs on
PPort returns VPI circuit endpoint.
If the input layer rate is LR_ATM_VC, getContainedPotentialTPs on
PPort returns VCI circuit endpoint on that VPI.
If the input laye rate is LR_ATM_NI, getContainedPotentialTPs on
PPort returns direct LPort, virtual LPort and OpticellTrunk LPort.
Similar behavior is supported for Frame Relay layer rate.
Only ATM and Frame Relay layer rates are supported.
Operation getContainingSubnetworkNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Status Mandatory
Supported Yes
Operation getContainingTPs
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getContainingTPNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Status Mandatory
Operation getManagedElement
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getTP
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Status Mandatory
Operation setTPData
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
ManagedElementIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for managedElement Manager module are as follows:
• “ManagedElement_T” on page 24-7
• “CommunicationState_T” on page 24-8
• “ManagedElementList_T”on page 24-8
Notifications
Attribute Value Changes (AVC), and State Change Notifications will be provided
when appropriate.
Current TPs refer to configured TPs. Potential TPs refer to configured and
non-configured TPs. InUse TPs refer to TPs in use by the child object (for example,
circuit is child for the LPort).
The following table describes the examples for InUseTP, CurrentTP and PotentialTP
shown in the illustration.
• Channel 3
• LPort 1
• LPort 2
• LPort 4
• LPort 5
• LPort 2
• LPort 5
• Pseudo LPort 6
• LPort 2
• LPort 4
• LPort 5
• LPort 2
• Pseudo LPort 3
• LPort 5
7
equipment Module
This chapter covers the following:
Interfaces
EquipmentInventoryMgr_I
This interface covers the following:
• “getAllEquipment” on page 7-3
• “getAllEquipmentNames” on page 7-3
• “getAllSupportedPTPs” on page 7-4
• “getAllSupportedPTPNames” on page 7-5
• “getAllSupportingEquipment” on page 7-5
• “getAllSupportingEquipmentNames” on page 7-6
• “getContainedEquipment” on page 7-6
• “getEquipment” on page 7-7
• “provisionEquipment” on page 7-7
• “setAlarmReportingOff” on page 7-8
• “setAlarmReportingOn” on page 7-9
• “unprovisionEquipment” on page 7-9
Operation getAllEquipment
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EquipmentorHolderIterator_I eqIt
Operation getAllEquipmentNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllEquipmentNames
Operation getAllSupportedPTPs
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Operation getAllSupportedPTPNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
Comments This operation returns the list of physical ports object IDs on the switch
as NamingAttributeList_T.
Operation getAllSupportingEquipment
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getAllSupportingEquipment
Operation getAllSupportingEquipmentNames
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Comments The operation returns the list of equipment object IDs and equipment
holder object IDs as NamingAttributesList_T.
Operation getContainedEquipment
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getContainedEquipment
Operation getEquipment
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Comments The operation returns the equipment and equipment Holder object
structure (EquipmentOrHolderList_T).
Operation provisionEquipment
Status Optional
Supported Yes
Operation provisionEquipment
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_OBJECT_IN_USE
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
Operation setAlarmReportingOff
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Comments This operation is not supported for Navis EMS-CBGX TMF 814
Adapter Release 09.02.00.00.
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Comments This operation is not supported for Navis EMS-CBGX TMF 814
Adapter Release 09.02.00.00.
Operation unprovisionEquipment
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_OBJECT_IN_USE
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS_IN
EquipmentOrHolderIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators
Data Types
The data types for equipment module are as follows:
• “EQTCreateData_T” on page 24-13
• “Equipment_T” on page 24-12
• “EquipmentHolder_T” on page 24-9
• “EquipmentHolderType_T” on page 24-10
• “EquipmentObjectType_T” on page 24-10
• “EquipmentObjectTypeList_T” on page 24-10
• “EquipmentOrHolder_T” on page 24-10
• “EquipmentOrHolderList_T” on page 24-10
• “EquipmentTypeQualifier_T” on page 24-10
• “HolderState_T” on page 24-11
• “ServiceState_T” on page 24-11
Notifications
Object Creation Notifications, Object Deletion Notifications, Attribute Value Changes
(AVC), and State Change Notifications will be provided when appropriate.
8
terminationPoint Module
This chapter covers the following:
Interfaces
TerminationPointIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for terminationPoint module are as follows:
• “Directionality_T” on page 24-14
• “TerminationMode_T” on page 24-14
• “TerminationPointList_T” on page 24-16
• “TPConnectionState_T” on page 24-16
• “TPProtectionAssociation_T” on page 24-16
• “TPType_T” on page 24-17
• “TerminationPoint_T” on page 24-20
9
topologicalLink Module
This chapter covers the following:
Note – If you use CLI or guiCutThrough to create, delete and modify Topological
Links, a fully-standard non-proprietary (except for proprietary EMS/NE data) TMF
814 Version 2.1 implementation is required.
Interfaces
TopologicalLinkIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for topologicalLink module are as follows:
• “TopologicalLink_T” on page 24-22
• “TopologicalLinkList_T” on page 24-22
10
subnetworkConnection Module
This chapter covers the following:
Section Covers
Interfaces
SNCIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for subnetworkConnection module are as follows:
• “SubnetworkConnection_T” on page 24-23
• “GradesOfImpact_T” on page 24-24
• “NetworkRouted_T” on page 24-24
• “ProtectionEffort_T” on page 24-25
• “Reroute_T” on page 24-25
• “RerouteChangeEvent_T” on page 24-25
• “Resource_T” on page 24-25
• “ResourceList_T” on page 24-25
• “Route_T” on page 24-25
• “SNCCreateData_T” on page 24-25
• “SNCState_T” on page 24-27
• “SNCType_T” on page 24-27
• “StaticProtectionLevel_T” on page 24-27
• “SubnetworkConnectionList_T” on page 24-28
• “TPData_T” on page 24-28
• “TPDataList_T” on page 24-28
11
protection Module
This chapter covers the following:
Section Covers
Interfaces
ProtectionGroupIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
ProtectionMgr_I
This interface covers the following:
• “getAllNUTTPNames” on page 11-2
• “getAllPreemptibleTPNames” on page 11-3
• “getAllProtectedTPNames” on page 11-3
• “getAllProtectionGroups” on page 11-4
• “getProtectionGroup” on page 11-4
• “performProtectionCommand” on page 11-5
• “performProtectionCommand” on page 11-5
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• ProtectionGroupIterator_I pgpIt
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Operation getProtectionGroup
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• globaldefs::NamingAttributes_T reliableSinkCtpOrGroupName
• globaldefs::NamingAttributes_T fromTp
• globaldefs::NamingAttributes_T toTp
Comments Optional, but already in place for APS and servicename bindings. This
operation returns SwitchData_T.
Operation retrieveSwitchData
Status Optional
Supported Yes
Operation retrieveSwitchData
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
Data Types
The data types for protection module are as follows:
• “ProtectionCommand_T” on page 24-31
• “ProtectionGroup_T” on page 24-29
• “ProtectionGroupList_T” on page 24-31
• “ProtectionGroupType_T” on page 24-31
• “ProtectionSchemeState_T’ on page 24-31
• “ProtectionType_T” on page 24-31
• “ReversionMode_T” on page 24-32
• “SwitchData_T” on page 24-32
• “SwitchDataList_T” on page 24-32
• “SwitchReason_T” on page 24-33
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
12
trafficDescriptor Module
This chapter covers the following:
• TDCreateData_T
Interfaces
TrafficDescriptorMgr_I
This interface covers the following:
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• TrafficDescriptorIterator_I trafficDescIt
Comments This operation returns the list of all mandatory trafficDescriptors (only
on network.0.0.0.0 level) in TrafficDescriptorList_T.
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_TOO_MANY_OPEN_ITERATORS
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
Status Mandatory
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• EXCPT_TOO_MANY_OPEN_ITERATORS
• terminationPoint::TerminationPointIterator_I tpIt
Operation getAssociatedCTPs
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
TrafficDescriptorIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for trafficDescriptor module are as follows:
• “ServiceCategory_T” on page 24-34
• TDCreateData_T
• “TrafficDescriptor_T” on page 24-34
• “TrafficDescriptorList_T” on page 24-34
• “TrafficParameterList_T” on page 24-35
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
Attribute Name Filled in Data Data Type Default Access Range of Values
Structure Value
Attribute Name Filled in Data Data Type Default Access Range of Values
Structure Value
PcrClp0PcrClp01 TrafficParameter
List_T
Attribute Name Filled in Data Data Type Default Access Range of Values
Structure Value
PcrClp0McrClp0 TrafficParameter
List_T
BestEffort TrafficParameter
Tagging List_T
13
transmissionParameters Module
This chapter covers the following:
Data Types
The data types for transmissionParameters module are as follows:
• “LayeredParameterList_T” on page 24-36
• “LayeredParameters_T” on page 24-36
• “LayerRate_T” on page 24-36
• “LayerRateList_T” on page 24-36
Note – All Provisioning Server attributes that do not map to TMF 814
transmissionParameters will appear as transmissionParameters input or output to
the API call, where transmissionParameters are used.
14
guiCutThrough Module
This chapter covers the following:
Interfaces
GuiCutThroughMgr_I
This interface covers the following:
• “destroyGCT” on page 14-2
• “getGCTProfileInfo” on page 14-2
• “launchGCT” on page 14-3
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
in arguments None
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Data Types
The data types for guiCutThrough module are as follows:
• “GCTProfileInfo_T” on page 24-37
• “GuiCutThroughData_T” on page 24-37
• “GuiCutThroughDataList_T” on page 24-37
• “ServerLaunchCapability_T” on page 24-37
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
15
maintenanceOps Module
This chapter covers the following:
Interfaces • “CurrentMaintenanceOperationIterator_I” on
page 15-2
• “CurrentMaintenanceOperationList_T” on page
24-39
Interfaces
CurrentMaintenanceOperationIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
MaintenanceMgr_I
This interface covers the following:
Operation getActiveMaintenanceOperation
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_NE_COMM_LOSS
• CurrentMaintenanceOperationIterator_I cmoIt
Status Optional
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
• EXCPT_INVALID_INPUT
• EXCPT_ENTITY_NOT_FOUND
• EXCPT_UNABLE_TO_COMPLY
• EXCPT_NE_COMM_LOSS
• MaintenanceOperationMode_T maintenanceOperationMode
(see “MaintenanceOperationMode_T” on page 24-40)
Data Types
The data types for maintenanceOps module are as follows:
• “CurrentMaintenanceOperation_T” on page 24-38
• “CurrentMaintenanceOperationList_T” on page 24-39
• “MaintenanceOperation_T” on page 24-39
• “MaintenanceOperationMode_T” on page 24-40
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
16
mtnmVersion Module
This chapter covers the following:
Section Covers
Note – This module does not have any data types that represent second level
objects. Also, there are no specific notifications associated with this module.
Interfaces
Version_I
This interface covers the following:
• “getVersion” on page 16-2
Status Mandatory
Supported Yes
Exceptions None
in arguments None
out / inout / return This operation returns the version of the interface (string).
values
Comments This service returns the version of the IDL that the corresponding EMS
object supports.
The format of the return string is as follows: Release.Major[.Minor]
where Release, Major and Minor are strings that contain only digits.
For example, 2.1 indicates release 2 and major release 1, 1.3 indicates
release 1 and major release 3, and so on. Note that x.y has the same
meaning as x.y.0 The minor digit is used for bug fixing the major
release. e.g 1.2.1 is a minor release on 1.2. Any changes to any IDL
files must be approved by the Specification Authority.
For TMF 814A version 2.1, the version is "2.1".
This operation is implemented in EmsSessionFactory_I.
17
nmsSession
This chapter covers the following:
Note – This module does not have data types that represent second level objects.
Also, there are no specific notifications associated with this module.
Note – Navis EMS-CBGX uses this module to notify nmsSession. This module
must be implemented by NMS client.
Interfaces
NmsSession_I
This interface covers the following:
• “eventLossCleared” on page 17-2
• “eventLossOccurred” on page 17-2
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Comments Navis EMS-CBGX TMF 814 Adapter uses this function to inform
NMS of any eventLossCleared.
Status Mandatory
Supported Yes
Exceptions None
Comments Navis EMS-CBGX TMF 814 Adapter uses this function to inform
NMS of any eventLossOccurred.
18
performance Module
Note – performance module is not supported in this release. The details of the
module are available in TMF 814A version 2.1.
19
session Module
This chapter covers the following:
Note – This module does not have any data types that represent second level
objects. Also, there are no specific notifications associated with this module.
Interfaces
Session_I
This interface covers the following:
• “oneway” on page 19-2
• “ping” on page 19-2
• “getAssociatedSession” on page 19-3
Status Mandatory
Supported Yes
Exceptions None
in arguments None
Comments None
Status Mandatory
Supported Yes
Exceptions None
in arguments None
Comments None
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
in arguments None
20
globaldefs Module
This chapter covers the following:
• ExceptionType_T
• NameAndStringValue_T
• NamingAttributes_T
• NamingAttributesList_T
• NVSList_T
• Time_T
Interfaces
NamingAttributesIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for globaldefs module are as follows:
• ConnectionDirection_T
• ExceptionType_T
• NameAndStringValue_T
• NamingAttributes_T
• NamingAttributesList_T
• NVSList_T
• Time_T
21
notifications Module
This chapter covers the following:
• CorrelatedNotifications_T
• EventList_T
• FileTransferStatus_T
• NameAndAnyValue_T
• NotifIDList_T
• NVList_T
• ObjectType_T
• PerceivedSeverity_T
• PerceivedSeverityList_T
• ProbableCauseList_T
• ProposedRepairAction_T
• ProposedRepairActionList_T
• ServiceAffecting_T
• SpecificProblem_T
• SpecificProblemList_T
Interfaces
EventIterator_I
See “Iterators for Provisioning Server TMF 814A Implementation” on page 25-1 for
information about the supported iterators.
Data Types
The data types for notifications module are as follows:
• CorrelatedNotificationList_T
• CorrelatedNotifications_T
• EventList_T
• FileTransferStatus_T
• NameAndAnyValue_T
• NotifIDList_T
• NVList_T
• ObjectType_T
• PerceivedSeverity_T
• PerceivedSeverityList_T
• ProbableCauseList_T
• ProposedRepairAction_T
• ProposedRepairActionList_T
• ServiceAffecting_T
• SpecificProblem_T
• SpecificProblemList_T
22
common Module
This chapter covers the following:
Interfaces
Common_I
This interface covers the following:
Status Mandatory
Supported Yes
Exceptions globaldefs::ProcessingFailureException
• EXCPT_INTERNAL_ERROR
in arguments None
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Operation setNativeEMSName
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Comments Provisioning Server does not allow Customer Name changes (except
LPort and Provisioning Server Circuit object). Since this interface is
optional, it will not be supported in Navis EMS-CBGX TMF 814
Adapter Release 09.02.00.00.
Status Optional
Supported No
Exceptions globaldefs::ProcessingFailureException
• EXCPT_NOT_IMPLEMENTED
Comments Provisioning Server does not allow object Name changes. Since this
interface is optional, it will not be supported in Navis EMS-CBGX
TMF 814 Adapter Release 09.02.00.00.
Data Types
The data types for common module are as follows:
• “Capability_T” on page 24-41
• “CapabilityList_T” on page 24-41
Notifications
Attribute Value Changes (AVC) and State Change Notifications will be provided when
appropriate.
23
TMF 814A Object NamingAttributes for
Provisioning Server
This chapter provides the TMF 814A Object NamingAttributes for Provisioning
Server.
ems
Table 23-1. ems - NamingAttributes
Attributes Name/Value and Description
NamingAttributes name="EMS";value="CompanyName/EMSname"
Provisioning Server Navis EMS-CBGX TMF Adapter appears as the EMS to the
NamingAttributes NMS. The EMS name is
name="EMS";value="LucentTechnologies/Provisioning Server"
multiLayerSubnetwork
Table 23-2. multiLayerSubnetwork - NamingAttributes
Attributes Name/Value and Description
NamingAttributes • name="EMS";value="CompanyName/EMSname"
• name="MultiLayerSubnetwork";value="SubnetworkName"
managedElement
Table 23-3. managedElement NamingAttributes
Attributes Name/Value and Description
• name="ManagedElement"; value="ManagedElementName"
equipment Holder
Table 23-4. equipment Holder - NamingAttributes
Attributes Name/Value and Description
• name="EquipmentHolder"; value="EquipmentHolderName"
Provisioning Server This TMF object shows a daughter board - mother board
NamingAttributes hierarchy. It is used to model the BIO cards on the Lucent GX 550
MultiService WAN switch.
For example, Switch.130.100.10.3.card.7 represents a BIO in slot
7 of a GX550. The TMF name is:
• name="EMS"; value="LucentTechnologies/Provisioning
Server"
• name="ManagedElement";value="/switch=130.100.10.3"
• name="EquipmentHolder";value="/shelf=1/slot=7"
equipment
Table 23-5. equipment NamingAttributes
Attributes Name/Value and Description
• name="EquipmentHolder"; value="EquipmentHolderName"
• name="Equipment"; value="EquipmentName"
Provisioning Server Provisioning Server card objects (on the Lucent's CBX and
NamingAttributes BSTDX switches) and subcard objects (on the Lucent's GX550
Switch and all cards on the Lucent's GX250 Extended Shelf
Switch are modeled using this TMF object.
EMS and managedElement take the form as shown in equipment
Holder.
TPPool
Navis EMS-CBGX TMF 814 Adapter does not support any corresponding
Provisioning Server object for TPPool.
PTP
Table 23-6. PTP - NamingAttributes
Attributes Name/Value and Description
• name="ManagedElement"; value="ManagedElementName"
• name="PTP";value="PTPName"
Provisioning Server Provisioning Server PPorts and IMA groups map to TMF PTPs.
NamingAttributes EMS and managedElement naming convention is as described in
“trafficDescriptor” on page 23-9.
PTPName can have the following values:
CTP
Table 23-7. CTP - NamingAttributes
Attributes Name/Value and Description
NamingAttributes • name="EMS";value="CompanyName/EMSname"
• name="ManagedElement";value="ManagedElementName"
• name="PTP";value="PTPName"
• name="CTP";value="CTPName"
Provisioning Server Provisioning Server channels, IMA links (fragment CTP), LPorts
NamingAttributes (direct/virtual/opti-trunk/direct-trunk) and ATM addresses (for
offnet circuits, only the destination endpoint ATM addresses
specified) map to CTPs. CTPName can have the following values:
• channel: Switch.130.100.10.2.card.6.pport.1.channel.1:
"/channel=1"
• For the remote VPI, the VCIs are also specified, the CTP name
is "/remoteaddress=<remoteaddress>/vpi=[1..n]/vci=[1..n]"
topologicalLink
Table 23-8. topologicalLink NamingAttributes
Attributes Name/Value and Description
NamingAttributes • name="EMS";value="CompanyName/EMSname"
• name="TopologicalLink";value="TopologicalLinkName"
Provisioning Server Provisioning Server trunks and PNNI links map to TMF
NamingAttributes topologicalLink. With EMS taking values as above,
topologicalLinkName can have any of the following values:
• /Network=130.100.0.0/Trunk=lucent_dt_nbi
(direct / Opti trunks)
• /Switch=181.181.1.51/PnniLink=GAYA:GWALIOR_
PNNI_LINK:GWALIOR:60a01230000000000000000000000
00040fb04e54200
subnetworkConnection
Table 23-9. subnetworkConnection NamingAttributes
Attributes Name/Value and Description
• name="MultiLayerSubnetwork"; value="SubnetworkName"
• name="SubnetworkConnection";
value="SubnetworkConnectionName"
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=1/vpi=
3/vci=787 (ATM PVC/redirect circuit)
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=
1/PMPCktRoot/vpi=2/vci=222 (ATM PMP root)
• /Switch=130.100.10.2/shelf=1/slot=9/port=8/lport=1/
PMPCktLeaf/vpi=2/vci=222 (ATM PMP leaf)
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=1/
OffNetCircuit/vpi=2/vci=222 (Offnet - pt to pt)
• /Switch= 130.100.10.2/shelf=1/slot=9/port=1/lport=1/
PMPOffNetCktRoot/vpi=2/vci=222 (Offnet PMP root)
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=
1/PMPOffNetCktRoot/vpi=2/vci=222/PMPOffNetCktLeaf=1
(Offnet PMP leaf)
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=1/spvc/vpi=2
/vci=222 (old SPVC prior to Release 09.01.00.00)
• /Switch=130.100.10.2/shelf=1/slot=9/port.=1/lport=1/
PMPSpvcRoot/vpi=2/vci=222 (Old PMP spvc root)
• /Switch=130.100.10.2/shelf=1/slot=9/port=1/lport=1/
PMPSpvcRoot/vpi=2/vci=222/PMPSpvcLeaf=1
(Old PMP spvc leaf)
• /Switch=130.100.10.2/card=9/port=1/lport=1/activeSvc/vpi=
2/vci=222 (SVC)
• name="EMS";value="Lucent Technologies/Provisioning
Server"
• name="MultiLayerSubnetwork";value="/network.130.100.0.0"
• name="SubnetworkConnection";value="/Switch=130.100.10.2/
shelf=1/slot=9/port=1/lport=1/activeSvc/vpi=2/vci=222"
Protection
Table 23-10.Protection NamingAttributes
Attributes Name/Value and Description
Naming • name="EMS";value="CompanyName/EMSname"
Attributes
• name="ManagedElement";value="ManagedElementName"
• name="PGP";value="ProtectionGroupName"
Provisioning Server Provisioning Server aps and servicename objects are modeled
NamingAttributes using this TMF object. For example:
• aps: Switch.130.100.10.3.card.8.pport.1.Aps
name="EMS";value="Lucent Technologies/Provisioning
Server"
name="ManagedElement";value="/switch=130.100.10.3"
name="PGP";value=""/shelf=1/slot=8/port=1/Aps"
• servicename:Network.130.100.0.0.ServiceName.madhukp_
service_ilmi (both Resilient UNI/NNI and LMI bindings)
name="EMS";value="Lucent Technologies/Provisioning
Server"
name="ManagedElement";value="" (empty string)
name="PGP";value="/Network=130.100.0.0/ServiceName=
madhukp_service_ilmi"
trafficDescriptor
Table 23-11.trafficDescriptor - NamingAttributes
Attributes Name/Value and Description
Other Objects
Table 23-12. Other Objects NamingAttributes
Attributes Name/Value and Description
NamingAttributes • name="EMS";value="CompanyName/EMSname"
• name="ManagedElement";value="ManagedElementName"
• name="AID";value="NameOfEntity"
24
Mapping TMF 814A Data Type and
Provisioning Server Attributes
This chapter provides the mapping between the Provisioning Server and the TMF
object. This chapter also describes the attributes of the TMF objects. This chapter
covers the following sections:
• “ems” on page 24-3
• “emssession” on page 24-4
• “multiLayerSubnetwork” on page 24-5
• “managedElement” on page 24-7
• “equipment Holder” on page 24-9
• “equipment” on page 24-12
• “terminationPoint” on page 24-14
• “PTP” on page 24-18
• “CTP” on page 24-20
• “topologicalLink” on page 24-22
• “SubnetworkConnection” on page 24-23
• “SubnetworkConnection” on page 24-23
• “protection” on page 24-29
• “trafficDescriptor” on page 24-34
• “transmissionParameters” on page 24-36
• “guiCutThrough” on page 24-37
• “maintenanceOps” on page 24-38
• “performance” on page 24-41
• “common” on page 24-41
Note – IMA group is not supported in Navis EMS-CBGX TMF 814 Adapter
09.02.00.00.
ems
Table 24-1. ems - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct EMS_T {
emssession
Table 24-3. emssession - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
• EquipmentInventoryMgr
• guiCutThroughMgr
• MaintenanceMgr
• MultiLayerSubnetworkMgr
• PerformanceManagementMgr
• ProtectionMgr
• TrafficDescriptorMgr
multiLayerSubnetwork
Table 24-5. multiLayerSubnetwork - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct MultiLayerSubnetwork_T{
managedElement
Table 24-7. managedElement - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct ManagedElement_T {
equipment Holder
Table 24-9. equipment Holder - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct EquipmentHolder_T {
• AdminStatus Up and
OperStatus Down
(OUT_OF_SERVICE)
equipment
Table 24-11.equipment - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct Equipment_T {
• AdminStatus Up and
OperStatus Up
(IN_SERVICE)
• AdminStatus Up and
OperStatus Down
(OUT_OF_SERVICE)
struct EQTCreateData_T {
terminationPoint
struct TerminationPoint_T {
PTP
Table 24-14.PTP - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct TerminationPoint_T {
CTP
Table 24-16.CTP - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct TerminationPoint_T {
• TM_NEITHER_
TERMINATED_NOR_
AVAILABLE_FOR_
MAPPING for LPorts.
• TM_TERMINATED_AND_
AVAILABLE_FOR_
MAPPING for channels,
IMA groups.
topologicalLink
Table 24-18.topologicalLink - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct TopologicalLink_T {
SubnetworkConnection
Table 24-20.SubnetworkConnection - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct SubnetworkConnection_T {
struct SNCCreateData_T {
protection
Table 24-22.protection - Provisioning Server Object Mapping
TMF Object Provisioning Server Object Mapping
struct ProtectionGroup_T {
• PSS_AUTOMATIC is for
1:N configurations which is
not supported by
Provisioning Server.
ReversionMode_T reversionMode; For aps object "Revertive" attr. For resilient UNI/NNI
serviceNames, the value is
For serviceNames and RLMI
always
bindings, "RLMISwitchOverMode"
RM_NON_REVERTIVE.
attr.
• HoldOffTime
• PC_CLEAR maps to
Provisioning Server
ServiceNameBinding
Attribute Primary
• PC_FORCED_SWITCH à
maps to Provisioning
Server
ServiceNameBinding
Attribute Backup.
struct SwitchData_T {
trafficDescriptor
Table 24-24.trafficDescriptor - Attributes
ServiceCategory_T QosClass
enum ServiceCategory_T
{SC_CBR, SC_VBRRT,
SC_VBRNRT, SC_ABR, SC_UBR,
SC_GFR, SC_NA };
struct TrafficDescriptor_T {
TrafficParameterList_T Type, Param1, Param2 and Param3 PCR, SCR, MBS and MCR are
trafficParameters; are used accordingly available from the database.
CDV and CDVT are LPort
/circuit attributes. These are not
bound to a traffic descriptor in
Provisioning Server "Type"
attribute.
string conformanceDefinition; No corresponding Provisioning UNI 3.1 (default) and 4.0 are
Server attribute. both supported by Provisioning
Server.
transmissionParameters
Table 24-25.transmissionParameters - Attributes
TMF Object Attributes Provisioning Server Object Comments
Attribute
struct LayeredParameters_T {
guiCutThrough
struct GCTProfileInfo_T {
struct GuiCutThroughData_T {
maintenanceOps
struct CurrentMaintenanceOperation_T {
performance
Note – performance module is not supported.
common
Table 24-28.common - Attributes
TMF Object Attributes Provisioning Server Object Comments
Attribute
25
Iterators for Provisioning Server TMF
814A Implementation
Iterators are supported as per TMF 814A. The following table provides the iterator
support information for each module:
equipment Yes
globaldefs Yes
maintenanceOps Yes
managedElement Yes
multiLayerSubnetwork Yes
Subnetwork
notifications Yes
performance No
protection Yes
subnetworkConnection Yes
terminationPoint Yes
topologicalLink Yes
trafficDescriptor Yes
Note – Navis EMS-CBGX TMF 814 Adapter supports 50 iterators only. Use the
destroy() method once the listing is not required for client usage.
26
Troubleshooting Navis EMS-CBGX TMF
814A Implementation
Implementation Problems
• Invalid Attribute name: FwdqosClass. It should be as shown in Provisioning
Server Attribute Guide
Ensure that the attributes follow the conventions specified by Provisioning Server.
For more information about the attributes, see Provisioning Server Object
Attribute Definition User’s Reference documentation.
• CORBA::Unknown exception to client in giving additionalInfo input data
from client to Navis EMS-CBGX TMF 814 Adapter.
For provisioning card, subcard and creating circuits, the input data for Navis
EMS-CBGX TMF 814 Adapter contains additionalInfo structure.
To provide additionalInfo (input data from client to Navis EMS-CBGX TMF 814
Adapter), follow these instructions:
1. additionalInfo should be created with valid length. Sufficient memory should be
allocated.
2. The contents, that is the name and value strings should be empty strings (if
information is not provided). For example,
additionalInfo.name = ""
additionalInfo.value = "".
Otherwise, if the input data for additionalInfo or the contents (name or value) are
null, this results in CORBA::Unknown exception at client side.
A
Mapping TMF 814 Layer Rates with
Provisioning Server
This appendix covers these sections
• “Transport Technologies” on page A-1
• “ATM CTP Layering” on page A-3
Transport Technologies
The following transport technologies are used in conjunction with TCP/IP model,
where PTP and CTP are created at different layer rate (line rate). These layer rates are
used in PTP/CTP object naming convention of TMF 814.
Navis EMS-CBGX TMF 814 implementation maps the layer rate at PTP (PPort,
Channel, ImaGroup) and CTP (ImaLink/LPort). Follow the naming conventions as per
TMF 814A object naming convention as mentioned in “TMF 814A Object
NamingAttributes for Provisioning Server” on page 23-1. Though there are various
layer rates supported at PTP level in Lucent switches, EMS is restricted to configure
and use only few layer rates as illustrated in the following sections using card and
equipment as examples:
• “8 Port DS3 (ATM) Card” on page A-4
• “8 Port E3 (ATM) Card” on page A-5
• “4 Port OC-3c/STM1 Card” on page A-6
• “6 Port FR DS3 Card” on page A-7
• “6 Port FR Channelized DS3 Card (Only 3/1/10)” on page A-8
Note – Layer rate for PTP is not distinguished and input is not considered in Navis
EMS-CBGX TMF 814 Adapter Release 09.02.00.00.
This card has DS3 SONET PPort that carries ATM Cell.
Provisioning Server PPort / LPort Layer Rate TMF PTP / CTP Name
Name
B
Supported Layer Rates in Navis
EMS-CBGX TMF 814 Adapter
Layer Rates
The following table lists the layer rates supported by Navis EMS-CBGX TMF 814
Adapter:
ManagedElementMgr_I
MultiLayerSubnetworkMgr_I
ActualMinimum SvcVciMax
SVCVCI
Bandwidth Bandwidth
AtmSignalingType AtmProtocol
Acronyms
This guide uses the following acronyms:
Acronym Description
CE Circuit Emulation
CS Cell Switching
DS digital service
Acronym Description
IP Internet Protocol
PM performance monitoring
PMP point-to-multipoint
Acronym Description
TP Termination Point
Index
C equipment module
data types, 7-10
common module EquipmentInventoryMgr_I, 7-2
Common_I, 22-2 notifications, 7-10
data types, 22-4
notifications, 22-4
G
D globaldefs module
data types, 20-2
Data types NamingAttributesIterator_I, 20-2
common module, 22-4 guiCutThrough module
emsMgr module, 2-6 data types, 14-3
emsSession module, 4-3 GuiCutThroughMgr_I, 14-2
equipment module, 7-10 notifications, 14-3
globaldefs module, 20-2
guiCutThrough module, 14-3
maintenanceOps module, 15-3 I
managedElement module, 6-15
multiLayerSubnetwork module, 5-20 Interfaces, 3-2
notifications module, 21-2 Common_I, 22-2
protection module, 11-6 CurrentMaintenanceOperationIterator_I, 15-2
subnetworkConnection module, 10-2 EMSMgr_I, 2-1
terminationPoint module, 8-2 EmsSession_I, 4-2
topologicalLink module, 9-2 EmsSessionFactory_I, 3-2
trafficDescriptor module, 12-5 EquipmentInventoryMgr_I, 7-2
transmissionParameters module, 13-2 EventIterator_I, 21-2
GuiCutThroughMgr_I, 14-2
MaintenanceMgr_I, 15-2
E ManagedElementMgr_I, 6-2
MultiLayerSubnetworkMgr_I, 5-2
emsMgr module NamingAttributesIterator_I, 20-2
data types, 2-6 NmsSession_I, 17-2
EMSMgr_I, 2-1 ProtectionGroupIterator_I, 11-2
notifications, 2-6 Session_I, 19-2
emsSession module SNCIterator_I, 10-2
data types, 4-3 TerminationPointIterator_I, 8-2
emsSession_I, 4-2 TopologicalLinkIterator_I, 9-2
notifications, 4-3 topologicalLinkIterator_I, 9-2, 11-2
EmsSessionFactory module trafficDescriptorMgr_I, 12-2
EmsSessionFactory_I, 3-2 Version_I, 16-2
M overview, 1-1
TMF Objects, 1-4
maintenanceOps module usage information, 1-5
CurrentMaintenanceOperationIterator_I, 15-2 nmsSession module
data types, 15-3 NmsSession_I, 17-2
MaintenanceMgr_I, 15-2 Notifications
notifications, 15-3 common module, 22-4
managedElement module emsMgr module, 2-6
data types, 6-15 emsSession module, 4-3
ManagedElementMgr_I, 6-2 equipment module, 7-10
Notifications, 6-15 guiCutThrough module, 14-3
Modules maintenanceOps module, 15-3
common, 22-1 managedElement module, 6-15
emsMgr, 2-1 multiLayerSubnetwork module, 5-20
emsSession, 4-1 protection module, 11-6
emsSessionFactory, 3-1 trafficDescriptor module, 12-6
equipment, 7-1 notifications module
globaldefs, 20-1 data types, 21-2
guiCutThrough, 14-1 EventIterator_I, 21-2
maintenanceOps, 15-1
managedElement, 6-1
mtnmVersion, 16-1 P
multiLayerSubnetwork, 5-1
nmsSession, 17-1 protection module
notifications, 21-1 data types, 11-6
performance, 18-1 notifications, 11-6
protection, 11-1 ProtectionMgr_I, 11-2
session, 19-1 Provisioning Server
subnetworkConnection Module, 10-1 mandatory object attributes for equipment, 7-10
terminationPoint, 8-1 mandatory object attributes for
topologicalLink, 9-1 TDCreateData_T, 12-7
trafficDescriptor, 12-1 object hierarchy, 1-2
transmissionParameters, 13-1 TMF 814A Object NamingAttributes, 23-1
mtnmVersion module
Version_I, 16-2
multiLayerSubnetwork module Q
data types, 5-20
QoS and Admin Parameters, 1-3
MultiLayerSubnetworkMgr_I, 5-2
notifications, 5-20
R
N Recommendations
General, 1-3
Navis EMS-CBGX TMF 814 Adapter
Requirements
constraints, 1-3
S
session module
Session_I, 19-2
subnetworkConnection module
data types, 10-2
SNCIterator_I, 10-2
T
terminationPoint module
data types, 8-2
TerminationPointIterator_I, 8-2
topologicalLink module
data types, 9-2
TopologicalLinkIterator_I, 9-2, 11-2
TopologicalLinkIterator module
TopologicalLinkIterator_I, 9-2
trafficDescriptor module
data types, 12-5
notifications, 12-6
trafficDescriptorMgr_I, 12-2
transmissionParameters
data types, 13-2
EMAIL:cspubs@lucent.com
MAILING ADDRESS:
Lucent Technologies
Multiservice Switching
1 Robbins Road Westford, MA 01886
Were the examples and illustrations helpful for performing tasks? If not, how
can they be improved?
Was there any information you needed that was not in the manual? If so, how
can we best deliver that information to you?
Cut Here
Name Company
Mailing Address