Chapter 1, Getting Started

Transaction Language 1 (TL1) is a subset of the input and output messages contained in the International Telecommunications Union (ITU) Man-Machine Language (MML). TL1 provides a standard set of messages that can be used for communicating between operating systems and network elements, and personnel and network elements. The ONS 15454 and ONS 15327 can support up to 20 concurrent TL1 sessions in this release. For more information about TL1, refer to Telcordia document GR-833-CORE, Network Maintenance: Network Element and Transport Surveillance Messages.

1.1 Setting up TL1 Communication

The period during which a user is logged into the ONS 15454 or ONS 15327 is called a session. There are three options you can use to open a session (login):

The TL1 password (PID) is masked when accessing a TL1 session using any of these options. When you logout of any of these options, you are closing a session. The ONS 15454 and ONS 15327 allow a maximum of 20 concurrent TL1 sessions using any one or any combination of the options listed above. For information on issuing commands to multiple nodes, see "TL1 Gateway."

1.1.1 Open a TL1 session

Use the following procedures to open a TL1 session via the CTC, telnet, or craft interface. In the procedures the Activate and Cancel User commands are shown in their input format. For more information about these and other commands and messages, see "TL1 Command Descriptions."

Procedure: Open a TL1 Session Via CTC

Step 1

From the PC connected to the ONS 15454, start Netscape or Internet Explorer.

Step 2

Enter the ONS 15454 IP address of the node you want to communicate with in the Netscape or Internet Explorer Web address (URL) field.

Step 3

Log into the CTC. The IP address at the title bar should match the IP address of the node you entered in Step 2.

Step 5

Choose the node you want to communicate with from the Select Node dialog box.

A TL1 interface window opens. There are three sub-windows in the TL1 interface window: Request history, Message log, and TL1 request. Type commands in the TL1 request window. You will see responses in the Message log window. The Request history window allows you to recall previous commands by clicking on them.

Step 8

Type the Activate User command in the TL1 request window to open a TL1 session:

Note

You must press Enter after the semicolon in each TL1 command, or the command will not be issued.

Step 9

Type the Cancel User command in the TL1 request window or press the Disconnect button to close a TL1 session:

Procedure: Open a TL1 Session Via Telnet

To access TL1 commands in a telnet session over a craft interface or a LAN connection (TCC front panel or backplane pins) you can choose from several ports. Port number 3082 is a raw TCP/IP port; it will not echo and it will not prompt the user. Port number 3083 is a telnet port that uses the telnet protocol and associated telnet escape sequences. Port number 2361 is supported for backward compatibility with earlier releases and has the same behavior as Port 3083 (telnet port). Use the following procedure with PCs running Windows operating systems.

Step 1

At the DOS prompt, type cmd and click OK. (The same steps can also be done from a Unix prompt).

The Node IP address or Node Name refers to the IP address or Node Name of the node you want to communicate with. Port number is the port (2361, 3082, or 3083) where TL1 commands are understood. If the connection is successful, a screen opens with a prompt.

Procedure: Open a TL1 Session Via Craft Interface

The TCC/XTC has two built-in interface ports for accessing the ONS 15454. With one RJ-45 LAN connection you can access the system using a standard browser interface. In the browser interface, you can perform local and remote Operations, Administration, Maintenance, and Provisioning (OAM&P) functions and open a VT100 emulation window to enter TL1 commands. If a browser is not available, you can access the system using a nine-pin RS-232 port. The RS-232 port supports VT100 emulation such that TL1 commands may be entered directly without a browser.

Step 1

Connect the serial cable to the RS-232 port on the active TCC/XTC card.

Step 4

At the > prompt, type the Activate User command to open a TL1 session:

1.2 TL1 Command Syntax

The TID, AID, and CTAG route and control the TL1 command. Other parameters provide additional information required to complete the action requested by the command. TL1 command codes, parameter names and parameter values can be either uppercase or lowercase exclusively or any combination of the two, unless specifically noted in the command description.

The TID is a unique name given to each system when it is installed. The name identifies the particular NE (in this case, the ONS 15454 or ONS 15327), to which each command is directed. Each TID can have a maximum of 20 ASCII characters limited to letters, digits, and hyphens, but each TID must start with an alphabetic character. The presence of the TID is required in all input commands, but its value can be null (represented by two successive colons). The TID can be null when the operating system directly communicates with the target NE. The recommended value for the TID, when it is used, is the target's CLLI code. To establish the TID for an ONS 15454/15327 node, use the Provisioning > General tabs in CTC.

Note If the TID contains any characters other than letters and digits, such as spaces, the text string form (enclosed in double quotes) must be used.

The AID is an access code used to identify and address specific objects within the ONS 15454 and the ONS 15327. These objects include individual pieces of equipment, transport spans, access tributaries, and other objects.

The CTAG is a unique identifier given to each input command by the user. When the ONS 15454/ONS 15327 system responds to a specific command, it includes the command's CTAG in the reply. Including the CTAG eliminates discrepancies about which response corresponds to which command. Valid CTAG values include strings of up to six characters comprised of identifiers (alphanumeric, beginning with a letter) or decimal numerals (a string of decimal digits with an optional non-trailing ".").

The following specification characters are used throughout this document as vehicles for defining the syntax:

•

" " enclose a literal character, for example an output format "SLOT-7:PLUGIN,TC,,,,,,,:\"EQUIPMENT PLUG-IN\",TCC"

1.3 Autonomous Messages

The autonomous TL1 messages are included in "TL1 Command Descriptions" and listed alphabetically. Figure 1-1 shows the autonomous message format. The autonomous message tag (ATAG) is used for message sequencing. The number is incremented by one for each autonomous message sent by the ONS 15454 or ONS 15327. The ONS 15454 and ONS 15327 use whole numbers 0000 to 9999.

1.3.1 Alarm Codes

The alarm code indicates the severity of the autonomous message. Valid values for alarm codes in decreasing order of severity are as follows:

Critical, Major, and Minor correspond to the reporting of alarmed events. The Non-alarm message designation is used when the NE is reporting non-alarmed events, periodic measurements, or results of previously-scheduled diagnostics or audits. If multiple alarms are reported in the same message, the alarm code is the highest severity of those being reported.

The following is an example of an output message that includes the Critical alarm code:

AB7-56 1970-01-01 16:02:10
*C 100.100 REPT ALM EQPT
"SYSTEM:CR,HITEMP,NSA,,,,:\"High Temperature\",TCC"

1.4 TL1 Commands by User Security

The following table specifies command access privileges for each user security level.

Table 1-1 Command Access
Command	Superuser	Provisioning	Maintenance	Retrieve
APPLY	X
COPY-RFILE	X
DLT-USER-SECU	X
ED-DAT	X
ED-USER-SECU	X
ENT-USER-SECU	X
DLT--	X	X
ED--	X	X
ENT--	X	X
SET--	X	X
SET-TOD	X	X
INIT--	X	X	X
OPR--	X	X	X
RLS--	X	X	X
RMV--	X	X	X
RST--	X	X	X
SW--	X	X	X
ACT--	X	X	X	X
ALW--	X	X	X	X
CANC--	X	X	X	X
ED-PID	X	X	X	X
INH--	X	X	X	X
REPT * *	X	X	X	X
RTRV--	X	X	X	X

User security levels limit the amount of time a user can leave the system idle before the TL1 session is locked to prevent unauthorized users from making changes. Higher security levels have shorter idle times. Table 1-2 shows security levels and their idle times.

1.5 Provisioning a DS3E Card in CTC Using TL1

The DS3E card can autosense the framing being received and set the framing accordingly; however, this framing autosense feature can only be set using CTC. Use CTC to set the FMT attribute on a DS3E card to autoprovision which results in the FMT field being blanked out for a few seconds while the DS3E card is determining the framing mode coming into that particular port. The FMT field is then set accordingly to unframed, M23, or CBit. If the DS3E card is not present (pre-provisioned), setting the FMT field to autoprovision will result in the FMT field defaulting to unframed.

The TL1 interface does not support the autoprovision option for the DS3E card; the TL1 interface only supports unframed, M23, or CBit. If autoprovision is selected from CTC and at the same time the TL1 command RTRV-T3 is issued, the TL1 output will result in the FMT field populated with unframed during the time period that the DS3E card (if present) is autosensing the frame format. If the DS3E card is not present (pre-provisioned), issuing RTRV-T3 after CTC sets the FMT to autoprovision will result in the TL1 output populating the FMT field with unframed.

1.6 CTC Interoperability

A TL1 cross-connect that has been upgraded to a CTC circuit can no longer be managed by TL1. For example, if you issue a DLT-CRS-<STS_PATH> command to delete a circuit, you will see that the circuit still appears in CTC as "incomplete." The reason for this is because in addition to creating cross-connects (as TL1 does), CTC creates another object on the source node that stores network-level circuit attributes. CTC will continue to see that object after the cross-connect is deleted which is why it shows an incomplete circuit.

Table 1-2 Security Idle Times
Security Level	Idle Time
Retrieve	Unlimited
Maintenance	60 minutes
Provisioning	30 minutes
Superuser	15 minutes

Starting with R3.4, there is a Create cross connects only (TL1-like) check box that appears in CTC when creating circuits. If applicable, you can check this box to create one or more cross-connects to complete a signal path for TL1-generated circuits. If this box is checked, you cannot assign a name to the circuit; and VT tunnels, Ethergroup sources, and drops are unavailable. Refer to the Cisco ONS 15454 Procedure Guide or the Cisco ONS 15327 User Documentation for information about CTC circuit creation.

1.7 Mixed Mode Timing Support

Although TL1 supports mixed mode timing in this release, Cisco strongly advises against its implementation. Mixed mode timing is not a recommended timing mode because of the inherent risk of creating timing loops. Refer to Telcordia document GR-436-CORE, Digital Network Synchronization Plan for recommended synchronization planning. Refer to the Cisco ONS 15454 Procedure Guide or the Cisco ONS 15327 User Documentation for information about setting up ONS 15454/15327 timing. For further assistance contact the Cisco Technical Assistance Center (TAC) at www.cisco.com or call 1-877-323-7368 for unresolved problems.

1.8 TL1 Command Completion Behavior

When you enter a TL1 command, one of three completion codes will be returned. The completion codes are: completed (CMPLD), partial (PRTL), and deny (DENY). You can specify an explicit, implicit, or explicit with implicit list as explained in the following sections.

1.8.1 General Rules

Note The command completion behavior does not apply to RTRV-CRS, RTRV-ALM, and RTVR-COND commands.

1.8.1.1 Explicit List of AIDs - No Wildcards

If a set of AIDs is explicitly listed, including a set of just one AID, then each AID must complete successfully to return a CMPLD message. If more than one AID is in the set and at least one AID succeeds but all do not, then a PRTL with errors for each failed AID is returned. If all AIDs in the set fail, a DENY with errors for each failed AID is returned.

1.8.1.2 Implicit List of AIDs - Single AID With Wildcard

If a set of AIDs is implied by the use of the ALL modifier on a single AID, then follow the same rules as in the "Explicit List of AIDs - No Wildcards" section. The caveat is that the implicit list only includes AIDs that apply to the command:

where Slot 3 contains an OC-12 and the command is ED-STS1 but STS-3-4 and STS-3-7 are STS3C. The set implied by STS-3-ALL then only contains STS-3-{1,2,3,10,11,12} and will not return an error for STS-3-{4,5,6,7,8,9}. Disregard the STS3C in this case because the modifier of the command specifies that the user is only interested in STS-1 paths. The rule specified in this section then applies to the implicit set of {1,2,3,10,11,12}.

1.8.1.3 Explicit List Grouped With Implicit List

1.8.2 Command Completion Behavior for Retrieval of Cross-Connections

When you enter a RTRV-CRS command, one of three completion codes will be returned. The completion codes are: completed (CMPLD), partial (PRTL), and deny (DENY). You can specify an explicit, implicit, or explicit with implicit list as explained in the following sections.

1.8.2.1 Explicit List of AIDs - No Wildcards

For an explicit list of AIDs on a RTRV-CRS command, an error code will be returned for each AID that fails validation (e.g. the user specifies STS-N-13 when SLOT-N only contains an OC-12) or for each AID where no matching cross-connection is found. To determine the completion code, follow the rules from the "Explicit List of AIDs - No Wildcards" section. If the result is either PRTL or CMPLD, then a list of matching cross-connections will accompany the response.

1.8.2.2 Implicit List of AIDs - Single AID With Wildcard

If a set of AIDs is implied by the use of the ALL modifier on a single AID, then follow the same AID expansion rule as defined in the example from the "Implicit List of AIDs - Single AID With Wildcard" section. Then apply the following rules to the set:

If all valid AIDs match, CMPLD is returned with a matching list of cross-connections.

If some valid AIDs match but not all, CMPLD is returned with a matching list of cross-connections.

RTRV-CRS-STS1:[<TID>]:STS-9-ALL:<CTAG>; where STS-9-ALL maps to STS-9-{1,2,3,10,11,12} because there is a single-port OC-12 card in Slot 3 with STS-3C defined for STS-9-4 and STS-9-7. You then traverse the set and return only the STS1 cross-connections that exist using end points in that set. If no cross-connections are retrieved, CMPLD is returned.

1.8.2.3 Explicit List Grouped With Implicit List

Explicit list returns CMPLD, implicit list returns CMPLD, return CMPLD plus matching list

Explicit list returns CMPLD, implicit list returns DENY, return PRTLwith errors plus matching list

Explicit list returns PRTL, implicit list returns CMPLD, return PRTL with errors plus matching lists

Explicit list returns PRTL, implicit list returns DENY, return PRTL with errors plus matching list

Explicit list returns DENY, implicit list returns CMPLD, return PRTL with errors plus matching list

Explicit list returns DENY, implicit list returns DENY, return DENY with errors

1.9 Test Access

The test access (TACC) feature allows a third-party Broadband Remote Test Unit (BRTU) to create non-intrusive test access points (TAPs) to monitor the circuits on the ONS 15454/15327 for errors. The test access feature also allows the circuit to be split (intrusive), so that the transmission paths can be tested for bit errors via the use of various bit test patterns. The two BRTUs supported by the ONS 15454/15327 are the Hekimian/Spirent BRTU-93 (6750) and the TTC/Acterna Centest 650.

The test access functionality provides TL1 commands for creating and deleting TAPs, connecting or disconnecting TAPs to circuit cross-connects and changing the mode of test access on the ONS 15454/15327. You can view test access information in CTC; in node view click the Maintenance > Test Access tabs.

Refer to Telcordia document GR-834-CORE, Network Maintenance: Access and Testing and GR-1402-CORE, Network Maintenance: Access Testing - DS3 HCDS TSC/RTU and DTAU Functional Requirements for more information about Test Access. See "TL1 Command Descriptions" for TL1 command information.

A TAP provides the capability of connecting the circuit under test to a BRTU. This connection initially provides in-service monitoring capability to permit the tester to determine that the circuit under test is idle. The monitor connection should not disturb the circuit under test. The access point and remote test unit (RTU) also provide the capability of splitting a circuit under test. A split consists of breaking the transmission path of the circuit under test. This is done out of service. The two sides of the access point are called the Equipment (E) and Facility (F) directions. For a 4-wire or 6-wire circuit, the transmission pairs within the access point are defined as the A and B pairs. The circuit under test should be wired into the access point so the direction of transmission on the A pair is from E to F, and the transmission direction for the B pair is from F to E ( Figure 1-2).

1.9.1 Test Access Terminology

SPLTA—Split access on A path with signal detector from equipment, QRS on facility side

SPLTB—Split access on B path with signal detector from equipment, QRS on equipment side

SPLTE—Split access on A and B paths with signal detector from equipment, QRS on equipment side

SPLTF—Split access on A and B paths with signal detector from equipment, QRS on facility side

SPLTEF—Split access on A and B paths for testing in both equipment and facility directions

A—Transmission path (the direction of transmission on the A pair is from E to F)

B—Transmission path (the transmission direction for the B pair is from F to E)

1.9.2 TAP Creation and Deletion

The edit command (ED-<rr>) is used to change an existing port, STS, or VT to a TAP.

Input Format: ED-(STS_PATH):[<TID>]:<AID>:<CTAG>:::[SFBER=<SFBER>,][SDBER=<SDBER>,]
[RVRTV=<RVRTV>,][RVTM=<RVTM>,][SWPDIP=<SWPDIP>,][EXPTRC=<EXPTRC>,]
[TRC=<TRC>,][TRCMODE=<TRCMODE>,][TACC=<TACC>]:[<PST>],[<SST>];

Edit an existing port, STS, or VT and change it to a TAP so it can be used when requesting TACC connections. Includes a new optical parameter TACC=n that defines the port, STS, or VT as a TAP with a selected unique TAP number. This TAP number will be used when requesting test access connections to circuit cross-connections under test. The TAP creation will fail if there is a cross-connection already on the port, STS, or VT.

The TAP number is an integer within the range of 1-999. When TACC=0 is specified, the TAP is deleted (if already present).

1.9.2.1 ED-T1

When the ED-T1 command is issued with a specified TACC value for a given T1 port/facility, a dual facility access group (DFAD) is created by using the specified port/facility and the consecutive port/facility.

Example 1-1 ED-T1::FAC-1-1:12:::TACC=1;

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These ports/facilities cannot be used for the creation of cross-connects until the TAP is deleted.

1.9.2.2 ED-T3

When the ED-T3 command is issued with a specified TACC value for a given T3 port/facility, a DFAD is created by using the specified port/facility and the consecutive port/facility.

Example 1-2 ED-T3::FAC-2-1:12:::TACC=2;

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These ports/facilities cannot be used for the creation of cross-connects until the TAP is deleted.

1.9.2.3 ED-DS1

When the ED-DS1 command is issued with a specified TACC value for a given DS1 facility on a DS3XM, a DFAD is created by using the specified facility and the consecutive port/facility.

Example 1-3 ED-DS1::DS1-2-1-1:12:::TACC=3;

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These ports/facilities cannot be used for the creation of cross-connects until the TAP is deleted.

1.9.2.4 ED-STSn

When the ED-STSn command is issued for a TACC it assigns the STS for the first 2-way test access connection and STS+1 as the second 2-way connection. For STS3c, STS9c, STS12c, STS24c, and STS48c the next consecutive STS of same width is chosen. The TAP creation will fail if either of the consecutive STSs are not available.

Example 1-4 ED-STS1::STS-5-1:12:::TACCC=4

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These STSs cannot be used for the creation of cross-connects until the TAP is deleted.

Example 1-5 ED-STS24C::STS-6-1:12:::TACC=5:

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These STSs cannot be used for the creation of cross-connects until the TAP is deleted.

1.9.2.5 ED-VT1

When the ED-VT1 command is issued for a TACC, a VT TAP is created. The specified VT AID is taken as the first VT connection, the second VT connection is made by incrementing the VT group and keeping the VT number the same.

Example 1-6 ED-VT1-1-1-1-1:12:::TACC=6;

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Note These VTs cannot be used for the creation of cross-connects until the TAP is deleted.

1.9.3 Connect Test Access Points

The CONN-TACC command (CONN-TACC-<rr>) is used to make a connection between the TAP and the circuit or cross-connect under test.

Input Format: CONN-TACC-(T1, T3, STS1, STS3C, STS6C, STS9C, STS12C, STS24C, STS48C, VT1,
DS1):[<TID>]:<AID>:<CTAG>::<TAP>:MD=<MD>;

Connect the port/STS/VT defined by <AID> to the port/STS/VT defined by the <TAP> number. The mode of test access to the circuit/cross-connect is specified by <MD>. The modes can be either of monitor (non-intrusive), split or loop (intrusive) modes. The various modes are described in the "Test Access Mode Definitions" section.

Note The connection is maintained only for the duration of the TL1 session (non-persistent).

Note The TAP number is displayed at the output if the CONN-TACC command completes successfully.

The command in Example 1-7 creates a connection between TAP with number one and the port/facility FAC-1-3 with access mode as MONE. The various modes are described in the "Test Access Mode Definitions" section.

Example 1-7 CONN-TACC-T1::FAC-1-3:12::1:MD=MONE;

DV9-99 1970-01-02 02:51:54
M 12 COMPLD
1
;

1.9.4 Change Access Mode

Input Format: CHG-ACCMD-(T1, T3, STS1, STS3C, STS6C, STS9C, STS12C, STS24C, STS48C,
VT1, DS1):[<TID>]:<TAP>:<CTAG>::<MD>;

Change the type of test access. This may be a change from monitoring the data to inserting data into the STS. This command can only be applied to an existing TAP connection. If a TAP connection does not exist, a RTEN error is returned.

1.9.5 Disconnect Test Access Points

•

Drop the TL1 session for any reason, including logout or a dropped telnet session

The DISC-TACC command disconnects the <TAP> and puts the connection back to it's original state (no access). To issue the DISC-TACC command, follow the input format and examples shown below:

The command in Example 1-9 disconnects TAP 1 from the circuit/cross-connect under test.

1.9.6 Delete Test Access Points

1.9.7 Retrieve Test Access Point Information

<TAP> indicates the assigned numeric number for the AID being used as a test access point. The <TAP> number must be an integer with a range of 1-999. The ALL TAP value means that the command will return all the configured TACCs in the NE. <TAP> is a string and must not be null.

Example 1-11 RTRV-TACC::ALL:12;

PTLM6-454A59-52 1970-01-10 09:51:27
M 12 COMPLD
"1:STS-2-1,STS-2-2,MONE,STS-2-3,STS-2-4"
"2:VT1-1-1-1-1,VT1-1-1-2-1,MONF,VT1-1-1-3-1,VT1-1-1-4-1"
;

•

<TAP> indicates the assigned numeric number for the AID being used as a TAP; <TAP> is a string

•

<TACC_AID1> is the STS or VT AID that was designated as a test access point and assigned to the TAP; <TACC_AID1> is from the "ALL" section

•

<TACC_AID2> is the STS or VT AID that was designated as a test access point and assigned to the TAP+1; <TACC_AID2> is from the "ALL" section

•

<MD> indicates the test access mode. It identifies the status of the circuit connected to the TACC. Valid values are shown in the "TACC_MODE" section

•

<E_CONN> indicates the E side STS or VT AID of a circuit connected to the TACC or under test; <E_CONN> is from the "ALL" section and is optional

•

<F_CONN> indicates the F side STS or VT AID of a circuit connected to the TACC or under test; <F_CONN> is from the "ALL" section

1.9.8 Test Access Configurations

This command changes STS1 and STS2 on Slot 1 to a TAP. The <CTAG> is 90. Sets the TAP number
to 1.

This command connects the <AID> to the TACC defined by TAP 1 on the E side. <CTAG> is 91.

Note The connection made in the CONN-TACC command can use MONE to connect to the F side <AID>. The <AID> provided designates the E side and the other automatically becomes the F side. For example, if an <AIDF> is supplied to a MONE connection the top line would be connected to the side of the path, or what is shown in the diagram as the F side. Once a CONN-TACC is set up, these designations cannot change until a DISC-TACC or another CONN-TACC command is issued. The connection is based on the <AID> supplied.

Note In the Figure 1-3 configuration there may be a single DS3 port wired-up but configured as 14 dual FADs (28 VTs).

Example 1-14 ENT-CRS-STS1::<AID I-G>:100::2WAY; A connection, not a TAP. CTAG is 100.
ENT-CRS-STS1::<AID J-H>:101::2WAY; Second connection, not a TAP.

Assuming the path from A to B is already entered; the A and B points in the diagram refer to entry and exit points on the node or different cards. The E/F designators refer to the two 2-way connections from NE3.

Example 1-15 ED-STS1::STS-1-1:TACC=4; Creates TAP with STS-1-1 and STS-1-2 through NE1. TAP number assigned is 4.

Example 1-16 CONN-TACC-STS1::<AID A or B>:102::4:<MD> Connects TAP #4 to the circuit.

Note The I and J connections above are TAPs in Figure 1-3, but normal connections in the Figure 1-4 configuration.

1.9.9 Test Access Mode Definitions

The following diagrams show what the different test access modes <MD> refer to. Figure 1-5 shows a circuit with no access followed by all the modes. The QRS may be generated by an outside source, i.e. the empty connection of the BRTU.

1.9.9.1 MONE

Monitor E (MONE) indicates a monitor connection provided from the facility access digroup (FAD) to the A transmission path of the accessed circuit ( Figure 1-6). This is a non-intrusive mode.

1.9.9.2 MONF

Monitor F (MONF) indicates that the FAD is providing a monitor connection to the B transmission path of the accessed circuit ( Figure 1-7). This is a non-intrusive mode.

Note The MONE and SPLTA modes are applicable to unidirectional circuits from E to F. The MONF and SPLTB modes are applicable to unidirectional circuits from F to E.

1.9.9.3 MONEF

Monitor EF (MONEF) is a monitor connection provided from the FAD1 (odd pair) to a DFAD, to the A transmission path and from FAD2 (even pair) of the same DFAD, to the B transmission path of the accessed circuit. This is a non-intrusive mode.

MONEF for T3 (DS3 HCDS) indicates that the odd pair of a FAP is providing a monitor connection to the A transmission path and from the even pair of a facility access path (FAP) to the B transmission path of the accessed circuit.

1.9.9.4 SPLTE

Split E (SPLTE) indicates to split both the A and B paths and connect the E side of the accessed circuit to the FAD. Figure 1-9 through 1-11 show split E and F access modes.

1.9.9.5 SPLTF

Split F (SPLTF) indicates to split both the A and B paths and connect the F side of the accessed circuit to the FAD.

1.9.9.6 SPLTEF

Split EF (SPLTEF) for T1 (DS1 HCDS) indicates to split both the A and B paths, connect the E side of the accessed circuit to FAD1 and the dual facility access digroup (DFAD) pair, and connect the F side to the FAD2 of the same DFAD pair. SPLTEF for T3 (DS3 HCDS) indicates to split both the A and B paths and connect the E side of the accessed circuit to the odd pair of the FAP and the F side to the even pair of the FAP.

1.9.9.7 LOOPE

Loop E (LOOPE) indicates to split both the A and B paths, connect the incoming line from the E direction to the outgoing line in the E direction, and connect this looped configuration to the FAD. Loop E and F modes are basically identical to the SPLT E and F modes except that the outgoing signal is the incoming signal and not the signal from the remote test unit (RTU).

1.9.9.8 LOOPF

Loop F (LOOPF) indicates to split both the A and B paths, connect the incoming line from the F direction to the outgoing line in the F direction and connect this looped configuration to the FAD.

1.9.9.9 SPLTA

Split A (SPLTA) indicates that a connection is provided from both the E and F sides of the A transmission path of the circuit under test to the FAD and split the A transmission path. Split A and B access modes are shown in Figure 1-14 and Figure 1-15. These modes are similar to the Split E and F modes, except the signals are sent to the RTU, not the NE signal configuration.

1.9.9.10 SPLTB

Split B (SPLTB) indicates that a connection is provided from both the E and F sides of the B transmission path of the circuit under test to the FAD and split the B transmission path.

1.9.10 Unmapped AID Test Access Point Connections

The ONS 15454/15327 supports connections to unmapped AIDs (unmapped circuits). The TAPs can be connected to an unmapped AID, i.e. an AID that does not have a cross-connect on it. The access modes supported are: MONE, SPLTE, and LOOPE.

Example 1-17 ED-STS1::STS-5-1:12:::TACC=1;

DV9-99 1970-01-02 03:16:11
M 12 COMPLD
;

Example 1-18 CONN-TACC-STS1::STS-5-3:12::1:MD=MONE;

DV9-99 1970-01-02 02:51:54
M 12 COMPLD
1
;

Note STS-5-3 does not have a cross-connect on it. This command creates an unmapped AID connection with the MONE access mode. STS-5-3 becomes unusable until the connection is disconnected by the DISC-TACC command.

Table 1-3 Modes Supported by Circuit Type
	MONE	MONF	MONEF	SPLTE	SPLTF	SPLTEF	LOOPE	LOOPF	SPLTA	SPLTB
1-way (from E)	X								X
1-way (from F)		X
2-way	X	X	X	X	X	X	X	X	X	X
UPSR	X	X	X	X	X	X	X	X	X	X
UPSR_HEAD (from E)	X								X
UPSR_HEAD (from F)		X								X
UPSR_DROP UPSR_DC UPSR_EN (from E)	X								X
UPSR_DROP UPSR_DC UPSR_EN (from F)		X								X
UPSR_UPSR	X	X	X	X	X	X	X	X	X	X
Unmapped AID	X			X			X

Note The <AID> provided in the CONN-TACC command designates the E side and the other automatically becomes the F side.

Note In the case of all 1-way circuits (1-way, UPSR_HEAD, UPSR_DROP, UPSR_DC, UPSR_EN):If the <AID> specified is the source AID, the direction is designated as From E in the above table. If the <AID> specified is the destination AID or the drop side, the direction is designated as From F in the above table.

The following examples assume an STS TAP is already created with TAP number = 1.

1.9.10.1 1-Way Circuit

Example 1-19 ENT-CRS-STS1::STS-5-1,STS-5-2:12::1WAY;
DV9-99 1970-07-01 20:29:06
M 12 COMPLD;

Example 1-20 CONN-TACC-STS1::STS-5-1:12::1:MD=MONF;
DV9-99 1970-01-01 20:29:47
M 12 DENY
EANS
STS-5-1
/*INCORRECT TAP MODE*/

The <AID> specified in the above CONN-TACC command is the source AID for the 1-way circuit. In this case only MONE and SPLTA modes are allowed because there is no B path in the case of a 1-way circuit (see Table 1-3).

Example 1-21 CONN-TACC-STS1::STS-5-1:12::1:MD=MONE;
DV9-99 1970-01-01 20:30:09
M 12 COMPLD

However if the <AID> specified is the destination AID as shown below, the modes allowed are MONF and SPLTB.

Example 1-23 CONN-TACC-STS1::STS-5-2:12::1:MD=MONF;
DV9-99 1970-01-01 20:30:32
M 12 COMPLD

The same examples apply for UPSR_HEAD, UPSR_DROP, UPSR_DC and UPSR_EN which are all 1-way circuits.

The connections are made only to the working path irrespective of which path is currently active.

1.9.10.2 2-Way Circuits

For 2-way circuits all the modes are allowed as shown in Table 1-3 and the same applies for UPSR_UPSR and UPSR circuit types. In the case of UPSR_UPSR and UPSR circuits the working path is connected irrespective of which path is currently active.

1.9.10.3 Unmapped AID

1.10 TL1 PCA Provisioning

You can provision or retrieve protection channel access (PCA) cross-connections on two-fiber and four-fiber BLSR topologies at these supported OC rates: OC12 (two-fiber only), OC48, and OC192. The traffic on the protection channel is referred to as extra-traffic and has the lowest priority level. Extra-traffic will be preempted by any working traffic that requires the use of the protection channel.

In a two-fiber BLSR the extra traffic is provisioned on the upper half of the bandwidth path. In a four-fiber BLSR the extra traffic is provisioned on the protect fiber. The PCA provisioning feature allows you to establish the PCA cross-connection on the protection path of the two-fiber BLSR and protection channel of the four-fiber BLSR only when the query is an explicit request.

There are two PCA connection types: 1WAYPCA and 2WAYPCA. The PCA cross-connection is provisioned only when the user provides an explicit request using the ENT-CRS-STSp/VT1 commands. If the cross-connection is a PCA cross-connection, either 1WAYPCA or 2WAYPCA is shown in the CCT field of the RTRV-CRS-STSp/VT1 command output.

1WAYPCA and 2WAYPCA are only used in the TL1 user interface to provide usability and visibility for the user to specify a PCA cross-connection type in the TL1 cross-connection commands.

Note The network must be configured as either a two-fiber or four-fiber OC-12, OC-48, or OC-192 BLSR.

Note The STS or VT1 path cross-connection can be established with TL1 commands (ENT-CRS-xxx).

Note Because the RTRV-CSR-xxx command does not include the optional CTYPE field to specify a connection type, the output result reports the matched cross-connections based on the queried AID(s); therefore, the retrieved cross-connection inventory can be both PCA and non-PCA cross-connections.

1.10.1 Provision a PCA Cross-Connection

Example 1-24 ENT-CRS-<PATH>:[<TID>]:<FROM>,<TO>:<CTAG>::[<CCT>][::];
<PATH>::={STS_PATH | VT1}
[<CCT>]::={1WAY, 1WAYDC, 1WAYEN, 2WAY, 1WAYPCA, 2WAYPCA}, it defaults to 2WAY.
{STS_PATH}::={STS1 | STS3C | STS6C | STS9C | STS12C | STS24C | STS48C | STS192C}

Note If the [<CCT>] of this cross-connection provisioning command is either 1WAYPCA or 2WAYPCA, and the NONE of both <FROM> and <TO> AID is PCA AID, an IIAC ( Input, Invalid PCA AIDs) error message is returned.

Note If sending this command with a non-PCA connection type (CCT), and one (or two) AIDs is/are the PCA AIDs, an IIAC (The PCA AID Is Not Allowed for the Queried CCT Type) error message is returned.

1.10.2 Retrieve a PCA Cross-Connection

Example 1-26 RTRV-CRS-[<PATH>]:[<TID>]:<AID>:<CTAG>[::::];<PATH>::={STS_PATH | VT1 | STS }

If PATH is STS, it will retrieve all the STS cross-connections based on the queried AIDs.

1.11 FTP Software Download

The file transfer protocol (FTP) software download feature downloads a software package to the inactive flash partition residing on either the TCC or XTC. FTP software download provides for simplex and duplex TCC/XTC downloads, success and failure status, and in-progress status at 20% increments.

1.11.1 COPY-RFILE

The COPY-RFILE command downloads a new software package from the location specified by the FTP URL into the inactive flash partition residing on either the TCC or XTC.

•

<XFERTYPE> is the file transfer protocol; valid values can be found in the "TX_TYPE" section

•

<SRC1> specifies the source of the file to be transferred. Only the FTP URL is supported. In a non-firewall environment the format for the URL is: "FTP://FTPUSER[:FTPPASSWORD]]@FTPHOST/PACKAGE_PATH"

–

password is the password used to connect to the computer with the package file

–

hostname is the IP address of the computer with the package file. DNS lookup of hostname is not supported.

Note

Userid and password are optional if the user does not need to log into the host computer. The password may be optional if the user does not need to log in. All other portions of the URL are required, including the initial "FTP://" string.

In a firewall environment the hostname should be replaced with a list of IP addresses each separated by a "@" character. The first IP address should be for the computer where the package file is stored. Subsequent IP addresses are for firewall computers moving outward toward the edge of the network until the final IP address listed is the computer that outside users use to first access the network.

The use of the SWDL and the extended FTP URL syntax are required by the COPY-RFILE syntax.

1.11.2 APPLY

The APPLY command can activate or revert software depending on the version of software loaded on the active and protect flash. An error is returned if attempting to activate to an older software load or trying to revert to a newer software load. If this command is successful the appropriate flash is selected and the TCC/XTC will reboot.

•

<MEM_SW_TYPE> indicates memory switch action during the software upgrade. <MEM_SW_TYPE> is ACT for activate and RVRT for revert.

1.11.3 REPT EVT FXFR

REPT EVT FXFR is an autonomous message used to report the start, completion, and completed percentage status of the FTP software download. REPT EVT FXFR also reports any failure during the software upgrade including invalid package, invalid path, invalid userid/password, and loss of network connection.

Example 1-31 SID DATE TIME
A ATAG REPT EVT FXFR
"<FILENAME>,<FXFR_STATUS>,[<FXFR_RSLT>],[<BYTES_XFRD>]"
;

•

<FXFR_STATUS> indicates the file transferred status: Start, IP (in progress), or COMPLD

•

<FXFR_RSLT> indicates the file transferred result: success or failure. <FXFR_RSLT> is optional

1.11.4 Downloading New Software

Procedure: Download New Software

Step 1

Copy the new software package (15454-0340-X02E-2804.pkg) to an FTP host.

Step 4

Check the working and protect software on the NE by issuing the RTRV-NE-GEN command.

Example 1-33 VA454-94 1970-01-06 22:22:12
M 1 COMPLD
"IPADDR=1-.82.87.94,IPMASK=255.255.254.0,DEFRTR=10.82.86.1,
ETHIPADDR=10.82.87.94,ETHIPMASK=255.255.254.0,NAME=VA454-94,
SWER=3.40.00,LOAD=03.40-002G-14.21,PROTSWVER=4.00.00,
PROTLOAD=04.00-X02G-25.07,DEFDESC=\"FACTORY DEFAULTS\""
;

Step 5

Issue the COPY-RFILE command. This command will initiate the download process. Refer to the "COPY-RFILE" section for command syntax.

In the following example the package is located in "/USR/CET/VINTARA" in the host 10.77.22.199. The userid and passwords are TL1 and CISCO454. The directory path of the package is similar to what you will see during an FTP session.

Example 1-34 COPY-RFILE::RFILE-
PKG:CTAG::TYPE=SWDL,SRC="FTP://TL1:CISCO454@10.77.29.199
/USR/CET/VINTARA/15454-0340-X02E-2804.PKG";

DEV208 1970-01-10 11:51:57
M CTAG COMPLD
;

Step 6

If any of the parameters are wrong or if the host is not accessible, a REPT EVT FXFR message will report from the following list. A download failure may be due to one or more of the following:

•

Package is invalid (i.e., ONS 15454 package on an ONS 15327, vice-versa, or an invalid file type)

Example 1-35 DEV208 1970-01-10 11:52:02
A 2816.2816 REPT EVT EQPT
"SLOT-11:SFTWDOWN-FAIL,TC,,,,,,,:\"SOFTWARE DOWNLOAD FAILED\",TCC
;

Step 7

If the download is successful the REPT EVT FXFR message will report an active start:

Example 1-36 DEV208 1970-01-10 11:52:15
A 2818,2818 REPT EVT FXFR
"ACTIVE START"
;

Step 8

A SFTDOWN minor alarm is raised to indicate that the software download is in progress. The SFTDOWN alarm will clear when the download is complete.

Example 1-37 DEV208 1970-01--10 11:52:15
* 2817.2817 REPT ALM EQPT
"SLOT-7:MN,SFTWDOWN,NSA,,,,:\"SOFTWARE DOWNLOAD IN PROGRESS\",TCC"
;

Use the in-progress status at any time during the software download to verify the RTRV-NE-GEN command.

Example 1-38 RTRV-NE-GEN

VA454-94 1970-01-06 22:22;12
M 1 COMPLD
"IPADDR=10.82.87.94,IPMASK=255.255.245.0,DEFRTR=10.82.86.1,
ETHIPADDR=10.82.87.94,EHTIPMASK=255.255.254.0,NAME=VA454-94,
SWVER=3.40.00,LOAD=03.40-002G-14-21,PROTSWVER=NONE,
PROTLOAD=DOWNLOADINPROGRESS,DEFDESC=\:FACTORY DEFAULTS\""
;

Step 9

The download progress is reported by the REPT EVT FXFR message which will report a message after every 20% of download is complete as shown:

Example 1-39 DEV208 1970-01-10 11:53:12
A 2820,2820 REPT EVT FXFR
"ACTIVE,IP,,20"
;

DEV208 1970-01-10 11:53:12
A 2820,2820 REPT EVT FXFR
"ACTIVE,IP,,40"
;

DEV208 1970-01-10 11:53:12
A 2820,2820 REPT EVT FXFR
"ACTIVE,IP,,60"
;

DEV208 1970-01-10 11:53:12
A 2820,2820 REPT EVT FXFR
"ACTIVE,IP,,80"
;

Step 10

If the TL1 session times out during download or if the user terminates the TL1 session the download will continue. The download completion can be confirmed by issuing the RTRV-NE-GEN command and verifying the PROTLOAD.

Example 1-40 RTRV-NE-GEN:::1;

VA454-94 1970-01-06 22:22:12
M 1 COMPLD
"IPADDR=10.82.87.94,IPMASK=255.255.245.0,DEFRTR=10.82.86.1,
ETHIPADDR=10.82.87.94,EHTIPMASK=255.255.254.0,NAME=VA454-94,
SWVER=3.40.00,LOAD=03.40-002G-14-21,PROTSWVER=4.00.00,
PROTLOAD=03.40-X02E-28.04,DEFDESC=\:FACTORY DEFAULTS\""
;

Example 1-41 DEV208 1970-01-10 12:01:16
A 2825,2825 REPT EVT FXFR
"ACTIVE,COMPLD,SUCCESS"
;

Example 1-42 DEV208 1970-01-10 11:52:15
* 2826,2817 REPT ALM EQPT
"SLOT-7:CL,SFTWDOWN,NSA,,,,:\"SOFTWARE DOWNLOAD IN PROGRESS\",TCC"
;

1.11.5 Activating New Software

After the software is successfully downloaded, the new software which resides in the protect load must be activated to run on the NE. The APPLY command can be used to activate and revert depending on the version of the protect software and the newly downloaded software (refer to the "APPLY" section for correct APPLY syntax).

Procedure: Activate New Software

Step 1

If the protect software is newer than the working software, activate it as shown:

Step 2

If the APPLY command is successful, logout of the TL1 session using the CANC-USER command:

After a successful completion of the APPLY command the NE will reboot and the TL1 session will disconnect. When the NE comes up after the reboot it will be running the new software. Traffic switches are possible during activation.

1.11.6 Remote Software Download/Activation Using the GNE

In a network with SDCC-connected ONS 15454 and ONS 15327s, remote download and activation are possible using the GNE/ENE feature supported in TL1. The GNE must be connected by a LAN and the remaining ENEs can download the new software package through fiber from the GNE.

A maximum of 5 ENEs (an additional session through craft interface) can be contacted using the GNE sessions through the GNE by opening a single TL1 session on the GNE. For more information on TL1 Gateway, see "TL1 Gateway."

Example 1-45 ACT-USER:NODE1:CISCO15:1;
ACT-USER:NODE2:CISCO15:1;
ACT-USER:NODE3:CISCO15:1;
ACT-USER:NODE4:CISCO15:1;
ACT-USER:NODE5:CISCO15:1;

Five simultaneous software downloads can be initiated using the COPY-RFILE command with appropriate TIDs. All downloads will be independent of each other and download speeds may differ.

Example 1-46 COPY-RFILE:NODE1:RFILE-PKG:CTAG::TYPE=SWDL,SRC="FTP://TL1:
CISCO454@10.77.29.199/USR/CET/VINTARA/15454-0340-X02E-2804.PKG";

COPY-RFILE:NODE2:RFILE-PKG...
COPY-RFILE:NODE3:RFILE-PKG...
COPY-RFILE:NODE4:RFILE-PKG...
COPY-RFILE:NODE5:RFILE-PKG...

Individual REPT EVT FXFR messages can be isolated using the node names. RTRV-NE-GEN also requires the individual node names entered in the TID to see a specific download status.

Note Activate the GNE last, after activating all the ENEs or else ENE connectivity will be lost when the GNE starts to reboot for activation.

Example 1-47 APPLY:NODE1::1::ACT;
APPLY:NODE2::1::ACT;
APPLY:NODE3::1::ACT;
APPLY:NODE4::1::ACT;
APPLY:NODE5::1::ACT;

Command	Superuser	Provisioning	Maintenance	Retrieve
APPLY	X
COPY-RFILE	X
DLT-USER-SECU	X
ED-DAT	X
ED-USER-SECU	X
ENT-USER-SECU	X
DLT--	X	X
ED--	X	X
ENT--	X	X
SET--	X	X
SET-TOD	X	X
INIT--	X	X	X
OPR--	X	X	X
RLS--	X	X	X
RMV--	X	X	X
RST--	X	X	X
SW--	X	X	X
ACT--	X	X	X	X
ALW--	X	X	X	X
CANC--	X	X	X	X
ED-PID	X	X	X	X
INH--	X	X	X	X
REPT * *	X	X	X	X
RTRV--	X	X	X	X

Table Of Contents

Getting Started

1.1 Setting up TL1 Communication

1.1.1 Open a TL1 session

Procedure: Open a TL1 Session Via CTC

Procedure: Open a TL1 Session Via Telnet

Procedure: Open a TL1 Session Via Craft Interface

1.2 TL1 Command Syntax

1.3 Autonomous Messages

1.3.1 Alarm Codes

1.4 TL1 Commands by User Security

1.5 Provisioning a DS3E Card in CTC Using TL1

1.6 CTC Interoperability

1.7 Mixed Mode Timing Support

1.8 TL1 Command Completion Behavior

1.8.1 General Rules

1.8.1.1 Explicit List of AIDs - No Wildcards

1.8.1.2 Implicit List of AIDs - Single AID With Wildcard

1.8.1.3 Explicit List Grouped With Implicit List

1.8.2 Command Completion Behavior for Retrieval of Cross-Connections

1.8.2.1 Explicit List of AIDs - No Wildcards

1.8.2.2 Implicit List of AIDs - Single AID With Wildcard

1.8.2.3 Explicit List Grouped With Implicit List

1.9 Test Access

1.9.1 Test Access Terminology

1.9.2 TAP Creation and Deletion

1.9.2.1 ED-T1

1.9.2.2 ED-T3

1.9.2.3 ED-DS1

1.9.2.4 ED-STSn

1.9.2.5 ED-VT1

1.9.3 Connect Test Access Points

1.9.4 Change Access Mode

1.9.5 Disconnect Test Access Points

1.9.6 Delete Test Access Points

1.9.7 Retrieve Test Access Point Information

1.9.8 Test Access Configurations

1.9.9 Test Access Mode Definitions

1.9.9.1 MONE

1.9.9.2 MONF

1.9.9.3 MONEF

1.9.9.4 SPLTE

1.9.9.5 SPLTF

1.9.9.6 SPLTEF

1.9.9.7 LOOPE

1.9.9.8 LOOPF

1.9.9.9 SPLTA

1.9.9.10 SPLTB

1.9.10 Unmapped AID Test Access Point Connections

1.9.10.1 1-Way Circuit

1.9.10.2 2-Way Circuits

1.9.10.3 Unmapped AID

1.10 TL1 PCA Provisioning

1.10.1 Provision a PCA Cross-Connection

1.10.2 Retrieve a PCA Cross-Connection

1.11 FTP Software Download

1.11.1 COPY-RFILE

1.11.2 APPLY

1.11.3 REPT EVT FXFR

1.11.4 Downloading New Software

Procedure: Download New Software

1.11.5 Activating New Software

Procedure: Activate New Software

1.11.6 Remote Software Download/Activation Using the GNE