Cisco Transport Manager GateWay/CORBA User's Guide and Programmer Manual, 7.2
Preface

Table Of Contents

Preface

Objectives

Audience

Conventions

What's New or Changed in This Guide

Related Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines


Preface


This section explains the objectives, intended audience, and organization of this publication and describes the conventions that convey instructions and other information.

Objectives

This document provides a detailed description of the northbound Common Object Request Broker Architecture (CORBA) interfaces supported by Cisco Transport Manager (CTM). This document serves as a reference for developers of OSS applications that will interface with the CTM Release 7.2 GateWay/CORBA interface. It provides details of input parameters, output parameters, and attributes.

Use this document to:

Learn about the northbound GateWay/CORBA interfaces supported by CTM R7.2

Understand the input parameters, output parameters, and attributes associated with CTM GateWay/CORBA

Audience

The primary audience for this guide includes network operations personnel and system administrators. This guide assumes the reader is familiar with the following products and topics:

Cisco ONS 15000 series products

Cisco Carrier Routing System 1 (CRS-1)

Cisco Catalyst 6509

Cisco XR 12000

Cisco MDS 9000 Multilayer Director and Fabric Switch

Cisco MGX 8880 Media Gateway

Voice-enabled Cisco MGX 8850 Multiservice Switch

Voice-enabled Cisco MGX 8830 Multiservice Switch

Basic internetworking terminology and concepts

Network topology and protocols

Microsoft Windows 2000 Professional and XP Professional

Sun Microsystems Solaris administration

Oracle database administration

Object Management Group (OMG) CORBA, Notification Service, and Naming Service

Telecommunication Management Network (TMN) architecture model

Conventions

This document uses the following conventions:

Item
Convention

Commands and keywords

boldface font

Displayed session and system information

screen font

Information that the user must enter

boldface screen font

Variables that the user must supply

italic screen font

Menu items and button names

boldface font

Selecting a menu item

Option > Network Preferences



Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.


Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the manual.



Timesaver Means the described action saves time. You can save time by performing the action described in the paragraph.



Tip Means the information will help you solve a problem. The tips information might not be troubleshooting or even an action, but could be useful information, similar to a Timesaver.


What's New or Changed in This Guide

The following table describes information that has been added or changed since the initial release of this guide.

Table 1 New and Changed Information in This Guide 

Date Released
Description
Location

February 27, 2007

Added this text for the getAllSupportedPTPs method > AdminState parameter:

Down and Up are valid values shown for ML-series cards (ML100T, ML1000, and ML-FX).

For CE-series and E-series Ethernet cards, valid values are In Service, Auto In Service, Out of Service, and Out of Service by Maintenance.

SERV_NA is not a valid value for any card.

3.5.3  equipment::EquipmentInventoryMgr_I::getAllSupportedPTPs, page 53


Related Documentation

This section describes the available documentation related to CTM R7.2.

This guide is one part of the CTM R7.2 documentation set. The CTM documentation set comprises the following guides:

1. Release Notes for Cisco Transport Manager Release 7.2—Describes the caveats for CTM R7.2.

2. Cisco Transport Manager Release 7.2 Installation Guide—Explains how to install CTM R7.2 and how to upgrade from previous releases.

3. Cisco Transport Manager Release 7.2 User Guide—Describes how to use the CTM software, which consists of user applications and tools for network discovery, network configuration, connection management, fault management, system administration, and security management.

4. Cisco Transport Manager Release 7.2 GateWay/CORBA User Guide and Programmer Manual—This guide.

5. Cisco Transport Manager Release 7.2 High Availability Installation Guide—Explains how to install CTM in a high availability (HA) environment.


Note You can access the most current CTM R7.2 documentation online at http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/optnet/ctm/index.htm.


The documents in Table 2 are available in print, on CD-ROM, and on www.cisco.com.

Table 2 Related Cisco Documentation 

Cisco Product
Document Title

Cisco 7600

Cisco 7600 Series Router Module Configuration Notes

Regulatory Compliance and Safety Information for the Cisco 7600 Series Routers

Cisco 7600 Series Router Installation Guide

Cisco 7600 Series Router Module Release Notes

Cisco Catalyst 6509

Catalyst 6500 Series Configuration Notes

Catalyst 6500 Series Switch Installation Guide

Catalyst 6500 Series Switch Module Installation Guide

Release Notes for Catalyst 6500 Series Software

Cisco CRS-1

Cisco Craft Works Interface User Guide

Cisco CRS-1 Series Carrier Routing System Interface Configuration Guide

Cisco CRS-1 Series Carrier Routing System Getting Started Guide

Cisco CRS-1 Series Carrier Routing System Regulatory Compliance and Safety Information

Cisco IOS XR XML API Guide

CRS-1 Series Carrier Routing System Getting Started Guide

Release Notes for the Cisco CRS-1 Series Carrier Routing System

Cisco MDS 9000 Multilayer Director and Fabric Switch

Cisco MDS 9000 Family Command Reference

Cisco MDS 9000 Family Configuration Guide

Cisco MDS 9000 Family Fabric Manager Configuration Guide

Cisco MDS 9000 Family Fabric Manager User Guide

Cisco MDS 9000 Family Software Upgrade and Downgrade Guide

Cisco MDS 9000 Family System Messages Guide

Cisco MDS 9xxx Family CIM Programming Reference Guide

Cisco MDS 9xxx Series Hardware Installation Guide

Cisco MDS SAN-OS Release Compatibility Matrix for IBM SAN Volume Controller Software for Cisco MDS 9000

Cisco Security Advisory: OpenSSL Vulnerability in the Cisco MDS 9000 Family

Release Notes for the Cisco MDS 9xxx Family

Cisco MGX 8880 Voice Gateway

Voice-enabled MGX 8850/8830 Multiservice Switch

Cisco MGX 8850 (PXM1E/PXM45), MGX 8950, MGX 8830, and MGX 8880 Command Reference, Release 5

Cisco MGX 8850 (PXM1E/PXM45), MGX 8950, MGX 8830, and MGX 8880 Configuration Guide, Release 5

MGX Error Messages, Release 5

Route Processor Module

Voice Interworking Service Module, Release 3.2

Voice Interworking Service Module, Release 3.3

Voice Switch Services Documentation

Cisco XR 12000

Cisco CRS-1 and IOS XR Software Documentation, Release 3.2

Regulatory Compliance and Safety Information for Cisco 12000 Series Routers

Note Documents listed for the Cisco CRS-1 also apply to the Cisco XR 12000.

ONS 15216

Cisco ONS 15216 EDFA Operations Guide

Cisco ONS 15216 EDFA2 Operations Guide

Cisco ONS 15216 EDFA3 Operations Guide

Cisco ONS 15216 FlexLayer User Guide

Cisco ONS 15216 OSC-1510 User Guide

Cisco ONS 15216 System Dispersion Compensation Unit User Guide

Installing Cisco ONS 15216 100 GHz DWDM Filters

Installing Cisco ONS 15216 OADMs

Release Notes for the Cisco ONS 15216 EDFA

Release Notes for the Cisco ONS 15216 OADM

Upgrade Procedures for the Cisco ONS 15216 EDFA2

ONS 15302

Cisco ONS 15302 Installation and Operations Guide

Cisco ONS 15302 Quick Installation Guide

Release Notes for the Cisco ONS 15302

ONS 15305 (CTC-based)

Refer to online documentation; document titles not yet final at printing.

ONS 15305 (non-CTC-based)

Cisco ONS 15305 Installation and Operations Guide

Cisco ONS 15305 Quick Installation Guide

Release Notes for the Cisco ONS 15305

ONS 15310

Cisco ONS 15310 Network Defaults

Cisco ONS 15310 Procedure Guide

Cisco ONS 15310 Reference Manual

Cisco ONS 15310 Troubleshooting Guide

Release Notes for the Cisco ONS 15310

ONS 15327

Cisco ONS 15327 Procedure Guide

Cisco ONS 15327 Reference Manual

Cisco ONS 15327 Software Upgrade Guide

Cisco ONS 15327 Troubleshooting Guide

Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Guide

Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Quick Reference Guide

Release Notes for the Cisco ONS 15327

ONS 15454 SDH

Cisco ONS 15454 SDH Procedure Guide

Cisco ONS 15454 SDH Reference Manual

Cisco ONS 15454 SDH Software Upgrade Guide

Cisco ONS 15454 SDH Troubleshooting Guide

Cisco ONS 15454 SONET/SDH ML-Series Multilayer Ethernet Card Software Feature and Configuration Guide

Release Notes for the Cisco ONS 15454 SDH

ONS 15454 SONET

Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Guide

Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Quick Reference Guide

Cisco ONS 15454 Procedure Guide

Cisco ONS 15454 Reference Manual

Cisco ONS 15454 Software Upgrade Guide

Cisco ONS 15454 SONET/SDH ML-Series Multilayer Ethernet Card Software Feature and Configuration Guide

Cisco ONS 15454 Troubleshooting Guide

Release Notes for the Cisco ONS 15454

ONS 15501

Cisco ONS 15501 User Guide

Regulatory Compliance and Safety Information for the Cisco ONS 15500 Series

Release Notes for the Cisco ONS 15501

ONS 15530

Cisco ONS 15530 Configuration Guide and Command Reference

Cisco ONS 15530 Hardware Installation Guide

Cisco ONS 15530 MIB Quick Reference

Cisco ONS 15530 Optical Transport Turn-up and Test Guide

Cisco ONS 15530 Planning and Design Guide

Cisco ONS 15530 System Alarms and Error Messages

Network Management for the Cisco ONS 15530

Quick Reference for the Cisco ONS 15530 TL1 Commands

Release Notes for the Cisco ONS 15530

ONS 15540 ESP

Cisco ONS 15540 ESP Configuration Guide and Command Reference

Cisco ONS 15540 ESP Hardware Installation Guide

Cisco ONS 15540 ESP MIB Quick Reference

Cisco ONS 15540 ESP Planning and Design Guide

Cisco ONS 15540 ESP Troubleshooting Guide

Network Management for the Cisco ONS 15540 ESP

Optical Transport Turn-Up and Test Guide

Regulatory Compliance and Safety Information for the Cisco ONS 15500 Series

Release Notes for the Cisco ONS 15540 ESP

ROMMON and Functional Image Release Notes

ONS 15540 ESPx

Cisco ONS 15540 ESPx Cleaning Procedures for Fiber Optic Connections

Cisco ONS 15540 ESPx Configuration Guide and Command Reference

Cisco ONS 15540 ESPx Hardware Installation Guide

Cisco ONS 15540 ESPx MIB Quick Reference

Cisco ONS 15540 ESPx Planning and Design Guide

Cisco ONS 15540 ESPx System Alarms and Error Messages

Network Management for the Cisco ONS 15540 ESPx

Optical Transport Turn-Up and Test Guide

Quick Reference for the Cisco ONS 15540 ESP and Cisco ONS 15540 ESPx TL1 Commands

Regulatory Compliance and Safety Information for the Cisco ONS 15500 Series

Release Notes for the Cisco ONS 15540 ESPx

ROMMON and Functional Image Release Notes

ONS 15600 SDH

Cisco ONS 15600 SDH Procedure Guide

Cisco ONS 15600 SDH Reference Manual

Cisco ONS 15600 SDH TL1 Test Access

Cisco ONS 15600 SDH Troubleshooting Guide

Release Notes for the Cisco ONS 15600 SDH

ONS 15600 SONET

Cisco ONS 15600 Procedure Guide

Cisco ONS 15600 Reference Manual

Cisco ONS 15600 TL1 Command Guide

Cisco ONS 15600 Troubleshooting Guide

Release Notes for the Cisco ONS 15600

ONS 15800

Cisco ONS 15800 DWDM System Common Platform Installation Manual

Cisco ONS 15800 DWDM System Description

Cisco ONS 15800 DWDM System Installation, Setup, and Test Manual

Cisco ONS 15800 DWDM system module handbooks

Cisco ONS 15800 DWDM System Technical Specifications Manual

Cisco Photonics Local Terminal Software Administrator Manual for the ONS 15800 System

Cisco Photonics Tool Kit Software Administrator Manual for the ONS 15800 System

TL1 Message Manual for the Cisco ONS 15800/15801 System

ONS 15801

Cisco ONS 15801 DWDM System Common Platform Installation Manual

Cisco ONS 15801 DWDM System Description Manual

Cisco ONS 15801 DWDM System Installation, Setup, and Test Manual

Cisco ONS 15801 DWDM system module handbooks

Cisco ONS 15801 DWDM System Technical Specifications Manual

Cisco Photonics Local Terminal Software Administrator Manual for the ONS 15801 System

Cisco Photonics Tool Kit Software Administrator Manual for the ONS 15801 System

TL1 Message Manual for the Cisco ONS 15800/15801 System

ONS 15808

Cisco ONS 15808 DWDM System Common Platform Installation Manual

Cisco ONS 15808 DWDM System Description Manual

Cisco ONS 15808 DWDM System Extended Long Haul Installation, Setup, and Test Manual

Cisco ONS 15808 DWDM System Long Haul Installation, Setup, and Test Manual

Cisco ONS 15808 DWDM System Module Technical Description Manual

Cisco Wavelength Director Software Installation Manual for the ONS 15808 System

TL1 Command Reference for the Cisco ONS 15808 DWDM System


The following related documentation may also be used as reference:

Telcordia GR-253-CORE: Synchronous Optical Network (SONET) Transport Systems: Common Generic Criteria

Telcordia GR-815-CORE: Generic Requirements for Network Elements/Network Systems (NE/NS) Security

Telcordia GR-820-CORE: Generic Digital Transmission Surveillance

Telcordia GR-831-CORE: Operations Applications Messages

Telcordia GR-2998-CORE: Generic Requirements for Wavelength Division Multiplexing (WDM) Element Management Systems

Telcordia GR-3000-CORE: Generic Requirements for SONET Element Management Systems

ITU-T G.774: Synchronous Digital Hierarchy (SDH)—Management information for the network element view

ITU-T G.784: Synchronous Digital Hierarchy (SDH) management

ITU-T G.826: Error performance parameters and objectives for international, constant bit rate digital paths at or above the primary rate

ITU-T G.829: Error performance events for SDH multiplex and regenerator sections

ITU-T G.831: Management Capabilities of Transport Networks based on the synchronous digital hierarchy (SDH)

ITU-T G.872: Architecture of optical transport networks

ITU-T M.3010: Principles for a Telecommunications management network

ITU-T M.3100: Generic network information model

ITU-T M.3400: TMN Management Functions

ITU-T X.721: Information technology-Open Systems Interconnection-Structure of management information: Definition of management information

ITU-T X.731: Information technology-Open Systems Interconnection-Systems Management: State management function

ITU-T X.733: Information technology-Open Systems Interconnection-Systems Management: Alarm reporting function

ITU-T X.734: Information technology-Open Systems Interconnection-Systems Management: Event report management function

ITU-T X.735: Information technology-Open Systems Interconnection-Systems Management: Log control function

ITU-T X.736: Information technology-Open Systems Interconnection-Systems Management: Security alarm reporting function

TMF 513: TM Forum Business Agreement, version 1.02

TMF 513: Multi-Technology Network Management Business Agreement, version 2.0

TMF 608: Multi Technology Network Management Information Agreement, version 0.4

TMF 608: Multi Technology Network Management Information Agreement, version 2.0

TMF 814: Multi Technology Network Management Solution Set, version 0.2

TMF 814: Multi-Technology Network Management Solution Set, version 2.0

TMF 814A: Multi-Technology Network Management Solution Set, TM Forum Implementation (IS) Template Guidelines, version 2.0

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html