Cisco ONS 15454 SDH TL1 Command Guide, Release 7.2
About this Guide
Downloads: This chapterpdf (PDF - 733.0 KB) The complete bookPDF (PDF - 12.29 MB) | Feedback

About this Guide

Table Of Contents

About this Guide

Revision History

Document Objectives


Important Notes about TL1 Commands

Document Organization

Related Documentation

Document Conventions

Obtaining Optical Networking Information

Where to Find Safety and Warning Information

Cisco Optical Networking Product Documentation CD-ROM

Obtaining Documentation and Submitting a Service Request

About this Guide

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

This section provides the following information:

Document Objectives


Important Notes about TL1 Commands

Document Organization

Related Documentation

Document Conventions

Obtaining Optical Networking Information

Obtaining Documentation and Submitting a Service Request

Revision History


March 2007

Revision History Table added for the first time.

Corrected product part numbers for the UBIC-V and UBIC-H DS3 cables.

April 2008

Changed the minute range for REPTINVL from 1-1440 min to 5-1440 min for SCHED-PMREPT command in the SCHED Commands chapter.

May 2008

Added a note to the COPY-RFILE command.

June 2008

Deleted the <PH> parameter and updated the Input Format, Example, and Parameter for the INIT-SYS command in section 15.2 of Chapter 15, INIT Commands.

Added a note to the RTRV-FAC command.

September 2008

Added the table "CTC Port Numbers and TL1 Aids" in the chapter, Access Identifiers.

November 2008

Added a note in the description of the PJMON parameter in the RTRV-<STM_Type> and ED-<STM_Type> commands.

January 2009

Added Facility AID format for CE-100T-8 and MS-ISC-100T cards in Chapter 25, Access Identifiers.

February 2009

Added prerequisites to COPY-RFILE command.

May 2009

Updated the supported platform for SW-DX-EQPT in Chapter 24, SW Commands.

June 2009

Updated the input example for the ENT-BULKROLL-<STM_TYPE> command in Chapter 12, ENT Commands.

Updated the input parameters for the APPLY command in Chapter 3, APPLY Commands.

Updated the following:

The output example and output parameters for the RTRV-CMD-SECU command in Chapter 21, RTRV Commands.

The input example and input parameters for the ED-CMD-SECU command in Chapter 11, ED Commands.

August 2009

Updated the input parameter description for APPLY command in Chapter 3, APPLY Commands.

September 2009

Updated the PH parameter description in Chapter 15, INIT Commands.

November 2009

Updated "OPR-PROTNSW-OCH" command description in Chapter 16, OPR Commands.

Updated the <PJMON> parameter description in Chapter 11, ED Commands.

Updated the <PJMON> parameter description in Chapter 21, RTRV Commands.

January 2010

Updated the input format, input example, and added a new parameter <OPRNOMINAL> for ED-<STM_TYPE> command in Chapter 11, ED Commands.

February 2010

Updated Input Parameters table in Chapter "INIT Commands".

September 2010

Updated the table RFILE in the chapter "Access Identifiers".

November 2010

Removed the "prerequisite" section from the "COPY-RFILE" command.

Removed the "ISPROXYSERVER" and "ISFIREWALL" parameters from the ED-NE-GEN command in the chapter "ED Commands".

April 2011

Updated the input parameter description for the ED-<STM_TYPE> command in the chapter, ED Commands.

July 2011

Updated the description for RFILE-DB in "RFILE" section in the chapter, "Access Identifiers"

February 2012

Added "MS-ISC-100T" parameter to the ENT-EQPT command and removed "XCVXC-2.5G" parameter from the ENT-EQPT command in the chapter "ENT Commands".

March 2012

Added Facility AID for CE1000 cards in the chapter "Access Identifiers".

August 2012

The full length book-PDF was generated.

December 2012

Updated the ENT-RMONTH-<MOD2> command in the chapter, "ENT  Commands" and RTRV-RMONTH-<MOD2> command in the chapter "RTRV  Commands".

February 2013

Updated the section, "ENT-LNKTERM" in the chapter "ENT Commands".

Added a new section "Important Notes about TL1 Commands" in the "Preface" chapter.

Added "BIT-EC" counter in the output parameters table for "MONTYPE" parameter in the chapters "INIT Commands", "RTRV Commands", and "SET Commands".

Document Objectives

This guide explains the use of Transaction Language 1 (TL1) for the Cisco ONS 15454 SDH systems. Use this guide in conjunction with the appropriate publications listed in the Related Documentation section.


To use this publication, you should be familiar with Cisco or equivalent optical transmission hardware and cabling, telecommunications hardware and cabling, electronic circuitry and wiring practices, and preferably have experience as a telecommunications technician.

Important Notes about TL1 Commands

TL1 commands can be executed manually or through the use of scripts.

When commands are executed manually, there is a delay of few seconds before the next command can be executed. This gives the Network Elements (NE) sufficient time to perform most of the database (DB) operations.

However, when commands are executed using scripts, the functioning of the NE differs. The NE has insufficient time to perform all the database operations and may cause the NE to malfunction. This in turn causes the controller card to reboot. To prevent this, it is recommended that a delay of 3 to 5 seconds be added between the commands that require DB updates in the script.

Document Organization

The Cisco ONS 15454 SDH TL1 Command Guide, R7.2 is organized into the chapters in .

Table 1 Cisco ONS 15454 SDH TL1 Command Guide Chapters 


Chapter 1 "ACT Commands"

Lists activate commands.

Chapter 2 "ALW Commands"

Lists allow commands.

Chapter 3 "APPLY Commands"

Lists apply commands.

Chapter 4 "CANC Commands and Messages"

Lists cancel commands.

Chapter 5 "CHG Commands"

Lists change commands.

Chapter 6 "CLR Commands"

Lists clear commands.

Chapter 7 "CONN Commands"

Lists connect commands.

Chapter 8 "COPY Commands"

Lists copy commands.

Chapter 9 "DISC Commands"

Lists disconnect commands.

Chapter 10 "DLT Commands"

Lists delete commands.

Chapter 11 "ED Commands"

Lists edit commands.

Chapter 12 "ENT Commands"

Lists enter commands.

Chapter 13 "EX Commands"

Lists exercise commands.

Chapter 14 "INH Commands"

Lists inhibit commands.

Chapter 15 "INIT Commands"

Lists initialize commands.

Chapter 16 "OPR Commands"

Lists operate commands.

Chapter 17 "REPT Messages"

Lists report autonomous messages.

Chapter 18 "RLS Commands"

Lists release commands.

Chapter 19 "RMV Commands"

Lists remove commands.

Chapter 20 "RST Commands"

Lists restore commands.

Chapter 21 "RTRV Commands"

Lists retrieve commands.

Chapter 22 "SCHED Commands"

Lists schedule commands.

Chapter 23 "SET Commands"

Lists set commands.

Chapter 24 "SW Commands"

Lists switch commands.

Chapter 25 "Access Identifiers"

Lists access identifiers.

Chapter 26 "Conditions"

Lists conditions.

Chapter 27 "Modifiers"

Lists modifiers.

Related Documentation

Use this Cisco ONS 15454 SDH TL1 Command Guide, R7.2 in conjunction with the following referenced publications:

Cisco ONS 15454 SDH TL1 Reference Guide
Provides general information, procedures, and errors related to using TL1 in the Cisco ONS 15454 SDH.

Cisco ONS SDH TL1 Command Quick Reference Guide
Provides input formats and output formats (where applicable) for all R7.2 TL1 commands and autonomous messages.

Cisco ONS SDH TL1 for Beginners
Provides basic beginning instruction for using TL1.

Cisco ONS 15454 SDH Procedure Guide
Provides procedures and tasks for the corresponding Cisco ONS node and network.

Cisco ONS 15454 SDH Reference Manual
Provides reference material for the corresponding Cisco ONS node and network.

Cisco ONS 15454 SDH Troubleshooting Guide
Provides general troubleshooting procedures, alarm descriptions, performance monitoring (PM) parameters, and Simple Network Management Protocol (SNMP) parameters.

Cisco ONS 15454 DWDM Procedure Guide
Explains installation, turn up, provisioning, and maintenance for Cisco ONS 15454 dense wavelength division multiplexing (DWDM) systems.

Cisco ONS 15454 DWDM Reference Manual
Explains installation, turn up, provisioning, and maintenance for Cisco ONS 15454 DWDM systems.

Cisco ONS 15454 DWDM Troubleshooting Guide
Provides troubleshooting information and troubleshooting-related parameters for the Cisco ONS 15454 (ANSI) and Cisco ONS 15454 SDH (ETSI) platforms, specifically the DWDM application that can operate on either platform.

Ethernet Card Software Feature and Configuration Guide for the Cisco ONS 15454,
Cisco ONS 15454 SDH, and Cisco ONS 15327
Provides software features for all Ethernet cards and configuration information for Cisco IOS on ML-Series cards.

Release Notes for the Cisco ONS 15454 SDH Release 7.2
Provides caveats, closed issues, and new feature and functionality information.

For an update on End-of-Life and End-of-Sale notices, refer to

Document Conventions

This publication uses the following conventions:


[     ]

Keywords or arguments that appear within square brackets are optional.

{ x | x | x }

A choice of keywords (represented by x) appears in braces separated by vertical bars. The user must select one.


The control key. For example, where Ctrl + D is written, hold down the Control key while pressing the D key.

screen font

Examples of information displayed on the screen.

<     >

Command parameters that must be replaced by module-specific codes.

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

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



This warning symbol means danger. You are in a situation that could cause bodily injury. Before you work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with standard practices for preventing accidents. Use the statement number provided at the end of each warning to locate its translation in the translated safety warnings that accompanied this device. Statement 1071




Dit waarschuwingssymbool betekent gevaar. U verkeert in een situatie die lichamelijk letsel kan veroorzaken. Voordat u aan enige apparatuur gaat werken, dient u zich bewust te zijn van de bij elektrische schakelingen betrokken risico's en dient u op de hoogte te zijn van de standaard praktijken om ongelukken te voorkomen. Gebruik het nummer van de verklaring onderaan de waarschuwing als u een vertaling van de waarschuwing die bij het apparaat wordt geleverd, wilt raadplegen.




Tämä varoitusmerkki merkitsee vaaraa. Tilanne voi aiheuttaa ruumiillisia vammoja. Ennen kuin käsittelet laitteistoa, huomioi sähköpiirien käsittelemiseen liittyvät riskit ja tutustu onnettomuuksien yleisiin ehkäisytapoihin. Turvallisuusvaroitusten käännökset löytyvät laitteen mukana toimitettujen käännettyjen turvallisuusvaroitusten joukosta varoitusten lopussa näkyvien lausuntonumeroiden avulla.




Ce symbole d'avertissement indique un danger. Vous vous trouvez dans une situation pouvant entraîner des blessures ou des dommages corporels. Avant de travailler sur un équipement, soyez conscient des dangers liés aux circuits électriques et familiarisez-vous avec les procédures couramment utilisées pour éviter les accidents. Pour prendre connaissance des traductions des avertissements figurant dans les consignes de sécurité traduites qui accompagnent cet appareil, référez-vous au numéro de l'instruction situé à la fin de chaque avertissement.




Dieses Warnsymbol bedeutet Gefahr. Sie befinden sich in einer Situation, die zu Verletzungen führen kann. Machen Sie sich vor der Arbeit mit Geräten mit den Gefahren elektrischer Schaltungen und den üblichen Verfahren zur Vorbeugung vor Unfällen vertraut. Suchen Sie mit der am Ende jeder Warnung angegebenen Anweisungsnummer nach der jeweiligen Übersetzung in den übersetzten Sicherheitshinweisen, die zusammen mit diesem Gerät ausgeliefert wurden.




Questo simbolo di avvertenza indica un pericolo. La situazione potrebbe causare infortuni alle persone. Prima di intervenire su qualsiasi apparecchiatura, occorre essere al corrente dei pericoli relativi ai circuiti elettrici e conoscere le procedure standard per la prevenzione di incidenti. Utilizzare il numero di istruzione presente alla fine di ciascuna avvertenza per individuare le traduzioni delle avvertenze riportate in questo documento.




Dette advarselssymbolet betyr fare. Du er i en situasjon som kan føre til skade på person. Før du begynner å arbeide med noe av utstyret, må du være oppmerksom på farene forbundet med elektriske kretser, og kjenne til standardprosedyrer for å forhindre ulykker. Bruk nummeret i slutten av hver advarsel for å finne oversettelsen i de oversatte sikkerhetsadvarslene som fulgte med denne enheten.




Este símbolo de aviso significa perigo. Você está em uma situação que poderá ser causadora de lesões corporais. Antes de iniciar a utilização de qualquer equipamento, tenha conhecimento dos perigos envolvidos no manuseio de circuitos elétricos e familiarize-se com as práticas habituais de prevenção de acidentes. Utilize o número da instrução fornecido ao final de cada aviso para localizar sua tradução nos avisos de segurança traduzidos que acompanham este dispositivo.




Este símbolo de aviso indica peligro. Existe riesgo para su integridad física. Antes de manipular cualquier equipo, considere los riesgos de la corriente eléctrica y familiarícese con los procedimientos estándar de prevención de accidentes. Al final de cada advertencia encontrará el número que le ayudará a encontrar el texto traducido en el apartado de traducciones que acompaña a este dispositivo.




Denna varningssignal signalerar fara. Du befinner dig i en situation som kan leda till personskada. Innan du utför arbete på någon utrustning måste du vara medveten om farorna med elkretsar och känna till vanliga förfaranden för att förebygga olyckor. Använd det nummer som finns i slutet av varje varning för att hitta dess översättning i de översatta säkerhetsvarningar som medföljer denna anordning.




Este símbolo de aviso significa perigo. Você se encontra em uma situação em que há risco de lesões corporais. Antes de trabalhar com qualquer equipamento, esteja ciente dos riscos que envolvem os circuitos elétricos e familiarize-se com as práticas padrão de prevenção de acidentes. Use o número da declaração fornecido ao final de cada aviso para localizar sua tradução nos avisos de segurança traduzidos que acompanham o dispositivo.




Dette advarselssymbol betyder fare. Du befinder dig i en situation med risiko for legemesbeskadigelse. Før du begynder arbejde på udstyr, skal du være opmærksom på de involverede risici, der er ved elektriske kredsløb, og du skal sætte dig ind i standardprocedurer til undgåelse af ulykker. Brug erklæringsnummeret efter hver advarsel for at finde oversættelsen i de oversatte advarsler, der fulgte med denne enhed.



Obtaining Optical Networking Information

This section contains information that is specific to optical networking products. For information that pertains to all of Cisco, refer to the Obtaining Optical Networking Information section.

Where to Find Safety and Warning Information

For safety and warning information, refer to the Cisco Optical Transport Products Safety and Compliance Information document that accompanied the product. This publication describes the international agency compliance and safety information for the Cisco ONS 15454 system. It also includes translations of the safety warnings that appear in the ONS 15454 system documentation.

Cisco Optical Networking Product Documentation CD-ROM

Optical networking-related documentation, including Cisco ONS 15xxx product documentation, is available in a CD-ROM package that ships with your product. The Optical Networking Product Documentation CD-ROM is updated periodically and may be more current than printed documentation.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.