Transaction Language 1

'''Transaction Language 1''' (TL1) is a widely used management protocol in [[telecommunications]]. It is a cross-vendor, cross-technology [[MML (language)|man-machine language]], and is widely used to manage optical ([[SONET]]) and broadband access infrastructure in [[North America]]. TL1 is used in the input and output messages that pass between Operations Systems (OSs) and Network Elements (NEs). Operations domains such as surveillance, memory administration, and access and testing define and use TL1 messages to accomplish specific functions between the OS and the NE. TL1 is defined in [[Telcordia Technologies]] (formerly [[Bellcore]]) Generic Requirements document [http://telecom-info.telcordia.com/site-cgi/ido/docs.cgi?ID=SEARCH&DOCUMENT=GR-831& GR-831-CORE].

== History ==

TL1 was developed by [[Bellcore]] in [[1984]] as a standard man-machine language to manage [[network element]]s for the [[Regional Bell Operating Companies]] (RBOCs). It is based on Z.300 series man machine language standards. TL1 was designed as a standard protocol readable by machines as well as humans to replace the diverse [[ASCII]] based protocols used by different Network Element (NE) vendors. It is extensible to incorporate vendor specific commands.

Telcordia [[Operations_Support_System|OSS]]s such as NMA (Network Monitoring and Analysis) used TL1 as the element management ([[Element management system|EMS]]) protocol. This drove network element vendors to implement TL1 in their devices.

== Language overview ==

=== TL1 Messages ===

The TL1 language consists of a set of messages. There are 4 kinds of messages:

# ''Input message'' - This is the command sent by the user or the OSS.

# ''Output/Response message'' - This is reply sent by the NE(Network Element) in response to an input message.

# ''Acknowledgment message'' - This is an acknowledgment of the receipt of a TL1 input message and is sent if the response message will be delayed by more than 2 seconds.

# ''Autonomous message'' - These are asynchronous messages (usually events or alarms) sent by the NE.

=== TL1 message structure ===

TL1 messages follow a fixed structure, and all commands must conform to it. However, the commands themselves are extensible and new commands can be added by NE vendors.

These are some of the message components:

* Target identifier (TID) & Source identifier (SID) - TID/SID is a unique name assigned to each NE. TID is used to route the message to an NE, SID is used to identify the source of an autonomous message.

* Access identifier (AID) - AID identifies an entity within an NE.

* Correlation tag (CTAG) & Autonomous correlation tag (ATAG) - CTAG/ATAG are numbers used to correlate messages.

====TL1 input message====

'''Example''':

{|

|-

ENT-USER-SECU:MyNE:sridev:101::password;

|}

'''Structure''':

{| border=1 cellspacing=0

|-

| colspan=8 align=center | '''TL1 input message'''

|-

| colspan=3 align=center | Command code

| colspan=4 align=center | Staging block

| colspan=1 align=center | Payload block

|-

| Verb||modifier1||modifier2

| TID||AID||CTAG||General block

| Data block

|-

| ''ENT''||''USER''||''SECU''

| ''MyNE''||''sridev''||''101''||

| ''password''

|}

====TL1 output message====

'''Example''':

{|

|-

| MyNE 04-08-14 09:12:04

|-

| M 101 COMPLD

|-

| "UID=sridev:CID=CRAFT,UAP=1:"

|-

|;

|}

'''Structure''':

{| border=1 cellspacing=0

|-

| colspan=8 align=center | '''TL1 output message'''

|-

| colspan=3 align=center | Response Header

| colspan=3 align=center | Response Id

| colspan=1 align=center | Response block

| colspan=1 align=center | Terminators

|-

| SID||Date||Time

| M||CTAG||Completion code

|

|

|-

| ''MyNE''||''04-08-14''||''09:12:04''

| ''M''||''101''||''COMPLD''

| ''"UID=sridev:CID=CRAFT,UAP=1:"''

| '';''

|}

====TL1 acknowledgment message====

'''Example''':

{|

|-

| OK 101

|-

| >

|}

'''Structure''':

{| border=1 cellspacing=0

|-

| colspan=3 align=center | '''TL1 acknowledgment message'''

|-

| Acknowledgment code||CTAG||Terminator||

|-

| ''OK''||''101''||''>''

|}

====TL1 autonomous message====

'''Example''':

{|

|-

| MyNE 04-08-14 09:12:04

|-

| A 101 REPT EVT SESSION

|-

| "root:NO,"

|-

| ;