QUICK START GUIDE Cisco ONS SONET TL1 for Beginners, Release 9.
What is TL1? TL1 Message Types and Examples Connect to TL1 Log Into TL1 Command Actions and Categories Ten Basic Commands Log Out of TL1 Obtaining Documentation and Submitting a Service Request Note The terms "Unidirectional Path Switched Ring" and "UPSR" may appear in Cisco literature. These terms do not refer to using Cisco ONS 15xxx products in a unidirectional path switched ring configuration.
b. Get information—Some TL1 commands get information or request information be returned from the NE. Example: RTRV-ALM-ALL to show the current status of all active alarm conditions c. Response message—The response portion of a command message correlates to a particular request message. If a command is successful, the NE sends a response message containing the COMPLD code.
Connect to TL1 The first step in using TL1 is to connect to TL1. You only have to connect to TL1 one time per session. A session is a related set of communication transactions between two or more network devices. There are three ways to connect to TL1: via CTC, telnet, or craft interface. Perform one of the following procedures to connect to TL1. Launch CTC and Open a TL1 Session Step 1 From the PC connected to the ONS node, start Netscape or Internet Explorer.
Note Port number 3082 is a raw TCP/IP port; it is not an interactive port and is not recommended for use as an alternate telnet port. Step 1 At the DOS prompt, type cmd and press Enter. (The same steps can also be done from a Unix prompt). Step 2 At the DOS command prompt type: TELNET and press Enter. The Node IP address or Node Name refers to the IP address or Node Name of the node you want to communicate with.
Step 4 You are ready to log into TL1. Follow the steps in the “Log Into TL1” section on page 7. ONS 15600 The TSC card has one RJ-45 port of the faceplate. The RJ-45 port allows you to access the system using a standard web browser. You must use the RJ-45 port on the active TSC. While using the web browser, you can perform local and remote Operations, Administration, Maintenance and Provisioning (OAM&P) functions.
Log Into TL1 Once you have connected to TL1, you must log into TL1 in order to issue commands. Logging into TL1 only has to be done once per session. Step 1 Issue the ACT-USER command: Input Format: ACT-USER:[]::[::]; • TID is the name of the node you want to access. If you only want to query the node you connected to leave the TID blank. • UID is your user ID. UID can be up to 10 characters. • CTAG is any non-blank character series that does not have to be unique.
Table 1 TL1 Command and Autonomous Message Actions Commands or Autonomous Messages That Begin With Generally Do This Command Example ACTALWAPPLY CANC (autonomous message) CANCCHGCLRCONNCOPYDISCDLTEDENTEXINHINITOPRREPT (autonomous message) RLSRMVRSTRTRVSCHEDSETSWTST- Activate Allow Apply Report Cancel Change Clear Connect Copy Disconnect Delete Edit/Change Enter/Create Exercise Inhibit Initialize Operate/Create Report Release Remove Restore Retrieve Schedule Set Switch Test ACT-USER ALW-MSG-ALL APPLY
Table 2 Some TL1 Category Examples If You Want to Look in this Category Applicable Command or Autonomous Message Create a 2-fiber or 4-fiber BLSR BLSR ENT-BLSR Delete a cross-connection on a VT path Cross Connections DLT-CRS- Set the attributes of the air conditioner Environment Alarms and Controls SET-ATTR-CONT Delete a card from the NE Equipment DLT-EQPT Lockout a user from the NE Security INH-USER-SECU See the alarms on a BITS Synchronization REPT ALM BITS1 Change the date on
• To retrieve all alarms on a specific DS1 port see RTRV-ALM-T1, page 14. • To retrieve all conditions on a specific DS1 port see RTRV-COND-T1, page 15. • To retrieve all alarms on a system see RTRV-ALM-ALL, page 16. • To retrieve all conditions on a system see RTRV-COND-ALL, page 17. • To retrieve actual PM values on a DS1 port see RTRV-PM-T1, page 19. • To retrieve the thresholds in place for a DS1 port see RTRV-TH-T1, page 20. • To create a loopback see OPR-LPBK-T1, page 21.
• TACC defines the STS as a test access port with a selected unique TAP number. The TAP number is in the range of 0, 1–999. When TACC is 0 (zero), the TAP is deleted. • TAPTYPE is the test access point type. Values are DUAL or SINGLE. • SOAK is IS-AINS to IS transition soak time as measured in 15 minute intervals, so a value of 4 translates to a soak time of 1 hour. The allowable range is 0–192 intervals (maximum of 48 hours). • SFBER identifies port SFBER; valid values are 1E-3, 1E-4 or 1E-5.
RTRV-T1 Use the RTRV-T1 command to retrieve configuration information on a DS1 port. RTRV-T1 is from the Ports category. Input Format: RTRV-T1:[]::[::::]; • TID is the name of the node you want to access. If you only want to query the node you connected to leave the TID blank. • AID is the access identifier to indicate slot and port. • CTAG is any non-blank character series that does not have to be unique.
• SYNCMSG is the synchronization status message enabled or disabled on the T1 facility. Optional for ONS 15454 and ONS 15310-CL/MA. • SENDDUS is the synchronization status message Don’t use for Synchronization (DUS). Optional for ONS 15454 and ONS 15310-CL/MA, and ONS 15600. • RETIME indicates if retiming is needed. Values are NO or YES. Optional for ONS 15454 and ONS 15310-CL/MA. • AISONLPBK is the AIS to be sent on what type of loopback. • AISVONAIS is enabled or disabled.
RTRV-ALM-T1 Use the RTRV-ALM-T1 command to retrieve all alarms on a specific E1 port. The RTRV-ALM-T1 command is listed as RTRV-ALM- in the Cisco ONS SONET TL1 Command Guide. T1 is just one of the options you can enter. RTRV-ALM-T1 is from the Fault category. Input Format: RTRV-ALM-:[]::::[],[],[][],[][,]; • TID is the name of the node you want to access. If you only want to query the node you connected to leave the TID blank.
• DIRECTION is the PM count retrieval direction. • DESC is a condition description. Response Example: TID-000 1998-06-20 14:30:00 M 001 COMPLD “FAC-5-1,OC12:MJ,SD,SA,09-05,12-30-20,NEND,RCV:\"BER AT SIGNAL DEGRADE LEVEL\”,” ; RTRV-COND-T1 Use the RTRV-COND-T1 command to retrieve all conditions on a specific DS1 port. The RTRV-COND-T1 command is listed as RTRV-COND- in the Cisco ONS SONET TL1 Command Guide. T1 is just one of the options you can enter. RTRV-COND-T1 is from the Fault category.
• NTFCNCDE is the 2-letter notification code. Values are CL (cleared), CR (critical), MJ (major), MN (minor), NA (not alarmed), and NR (not reported). • TYPEREP is the condition itself. • SRVEFF is the effect on service caused by the alarm condition. Values are NSA (not service affecting) or SA (service affecting). • OCRDAT is a date and is optional. • OCRTM is a time and is optional. • LOCN is the location associated with a particular command. • DIRECTION is the PM count retrieval direction.
• LOCN is the associated with aparticular command. Identifies the location from which the PM mode is to be retrieved. The parameter type is LOCATION, which is the location where the action is to take place. • DIRN is the PM count retrieval direction. The parameter type is DIRECTION, which is the transmit and receive directions.
• TID is the name of the node you want to access. If you only want to query the node you connected to leave the TID blank. • AID is the access identifier ALL • CTAG is any non-blank character series that does not have to be unique. • TYPEREQ is the type of condition to be retrieved. A null value is equivalent to ALL. • LOCN indicates the location. • DIRECTION is the direction of PM relative to the entity identified by the AID.
RTRV-PM-T1 Use the RTRV-PM-T1 command to retrieve actual performance monitoring values on a DS1 port. The RTRV-PM-T1 command is listed as RTRV-PM- in the Cisco ONS SONET TL1 Command Guide. T1 is just one of the options you can enter. RTRV-PM-T1 is from the Performance category. Input Format: RTRV-PM-:[]::::[],[],[], [],[],[],[
• MONTYPE shows the threshold type. • MONVAL shows the value. • VLDTY indicates if a full and complete PM value was returned. • LOCN indicates the location. • DIRECTION is the direction. • TMPER is the accumulation time period. • MONDAT is the date. • MONTM is the time. Response Example: rtp1-454tl1-1 2008-07-27 09:34:41 M 43 RTRV “FAC-1-1,T1:CVL,0,PRTL,NEND,RCV,15-MIN,07-27,09-30” ; RTRV-TH-T1 Use the RTRV-TH-T1 command to retrieve the thresholds in place for a DS1 port.
• AID is the access identifier ALL. • AIDTYPE specifies the type of AID. • MONTYPE indicates the monitored type. • LOCN is a location. • THLEV is the threshold value. • TMPER is the accumulation time period for the PM information. Response Example: rtp1-454tl1-1 2008-07-27 09:34:41 M 43 RTRV “FAC-1-1,T1:CVL,0,PRTL,NEND,RCV,15-MIN,07-27,09-30” ; OPR-LPBK-T1 Use the OPR-LPBK-T1 command to establish a loopback. The OPR-LPBK-T1 command is listed as OPR-LPBK- in the Cisco ONS SONET TL1 Command Guide.
RLS-LPBK-:[]::::[],,,[]; • TID is the name of the node you want to access. If you only want to query the node you connected to leave the TID blank. • SRC is an access identifier. Valid values are facility, DS1, and STS. • CTAG is any non-blank character series that does not have to be unique. • LOCATION is the location where the operation is to be carried out. • LPBKTYPE is a loopback type and is optional. LPBKTYPE can be FACILITY or TERMINAL.
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: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.