Preface

This preface explains the audience, purpose, and organization of the Cisco DSL Manager Object Class Reference Guide. It also defines the conventions that are used to present instructions and information.

Audience

The Cisco DSL Manager Object Class Reference Guide is designed for software developers who want to develop their own digital subscriber line (DSL) management applications based on the Cisco DSL Manager (CDM) common object model.

Purpose

The purpose of the Cisco DSL Manager Object Class Reference Guide is to serve as a reference and listing of the object classes and their descriptions for CDM Release 3.4. This guide describes the modeling architecture for DSL management applications. For additional information on related documentation, see "Related Documentation" later in this preface.

The object model described in this guide supports the Cisco IOS releases that are supported by CDM Release 3.4. CDM Release 3.4 NI-2 manages any DSLAM running IOS 12.1(4) to 12.1(7), including their functions and hardware features. CDM Release 3.4 NI-2 has functional compatibility with IOS 12.2(1b)DA1 and 12.2(5)DA; additionally, the Annex B and Cisco 6015 DSLAM (for outside plant environment) 12.2(5)DA features are supported.

Organization

"Introduction to the Cisco DSL Manager Object Model," provides an overview of the Cisco DSL Manager object model. The object model includes views and their containment hierarchies, classes and their inheritance structure, and attributes for each class. This chapter also describes the basic design of the Cisco Element Manager Framework (EMF) common object model, on which CDM objects are based.
"Static Class Models," describes the static class models, which include the chassis, module, and interface classes. In the case of the Cisco DSL Manager, the chassis type is most often a digital subscriber line access multiplexer (DSLAM).
"Cisco DSL Manager View Classes," describes the Cisco DSL Manager hierarchy view classes.
"Element Manager Object Classes," describes the element manager object classes including a complete list of classes that the Cisco DSL Manager can deploy. The classes are organized into two categories—classes that represent physical objects, and classes that model services, that is, the subscriber-modeling entity.
"Element Manager ProvisioningDeploying a Cisco DSLAM Chassis," describes the steps that are involved in provisioning objects of the physical or element manager classes and uses the Cisco 6160 DSLAM and DMT line cards as examples.
Glossary.
Index.

Conventions

Table 1 Font Conventions

Convention	Definition	Sample
boldface font	Commands and keywords are in boldface. Also used for names of some GUI elements.	This is similar to the UNIX route command.
italic font	Arguments for which you supply values are in italics. Also used for publication names and for emphasis	See the Cisco 6160 Hardware Installation Guide for further details.
screen font	Terminal sessions and information the system displays are in screen font.	`Are you ready to continue? [Y]`
boldface screen font	Information you must enter is in boldface screen font.	Login: root Password: <password>
^	The symbol ^ represents the key labeled Ctrl.	^D—The key combination in a screen display means hold down the Control key while you press the D key.
[ ]	Elements in square brackets are optional. Also used for default responses to system prompts.	[no] offset-list {in \| out} offset
{x \| y \| z}	Alternative keywords are grouped in braces and separated by vertical bars.	offset-list {in \| out} offset
< >	Nonprinting characters such as passwords are in angle brackets.	DSLAM> Password: <cisco123>
({ })	Indicate a required choice.	offset-list {in \| out} offset
([{ }])	Indicate a required choice within an optional element.	[{letter\number}Enter]

Related Documentation

Obtaining Documentation

The following sections provide sources for obtaining documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following sites:

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription. Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription Store:

Ordering Documentation

Documentation Feedback

We appreciate your comments and feedback about Cisco documentation. There are several ways to submit comments to Cisco.

Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883

and click here at the top of the page in the sentence "Is this Cisco documentation helpful? Click here to give us your feedback." This displays a Documentation Survey that you can complete and submit to Cisco electronically.

Obtaining Technical Assistance

Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.

Cisco.com

Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.

Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you to

You can self-register on Cisco.com to obtain customized information and service. To access Cisco.com, go to the following URL:

Technical Assistance Center

The Cisco TAC is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two types of support are available through the Cisco TAC: the Cisco TAC Web Site and the Cisco TAC Escalation Center.

Priority level 4 (P4)—You need information or assistance concerning Cisco product capabilities, product installation, or basic product configuration.
Priority level 3 (P3)—Your network performance is degraded. Network functionality is noticeably impaired, but most business operations continue.
Priority level 2 (P2)—Your production network is severely degraded, affecting significant aspects of business operations. No workaround is available.
Priority level 1 (P1)—Your production network is down, and a critical impact to business operations will occur if service is not restored quickly. No workaround is available.

Which Cisco TAC resource you choose is based on the priority of the problem and the conditions of service contracts, when applicable.

Cisco TAC Web Site

The Cisco TAC Web Site allows you to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to the following URL:

All customers, partners, and resellers who have a valid Cisco services contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to the following URL to register:

If you cannot resolve your technical issues by using the Cisco TAC Web Site, and you are a Cisco.com registered user, you can open a case online by using the TAC Case Open tool at the following URL:

If you have Internet access, it is recommended that you open P3 and P4 cases through the Cisco TAC Web Site.

Cisco TAC Escalation Center

The Cisco TAC Escalation Center addresses issues that are classified as priority level 1 or priority level 2; these classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer will automatically open a case.

To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to the following URL:

Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled; for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). In addition, please have available your service agreement number and your product serial number.

Table of Contents