About TL1 Commands

This chapter describes some reference information about using the TL1 commands supported by the Cisco ONS 15216 EDFA3.

note.gif

Noteblank.gif TL1 commands that are not entered correctly will not be completed. Each TL1 command terminates with a semicolon (;).


This chapter contains the following information:

6.1 TL1 Command Rules

The following rules apply to all TL1 commands:

  • All TL1 commands end with a semicolon (;).
  • When you type a TL1 command, the command will return one of two responses:

blank.gif COMPLD (The command was completed.)

blank.gif DENY (Something was wrong with the command, and it was denied.)

  • Ethernet TL1 sessions are available from TCP/IP port 3082 (for raw TL1 with no echo)
  • Telnet TL1 sessions are available from TCP/IP port 3083

A list of TL1 errors is contained in the “TL1 Error Format” section.

6.2 Parameter Persistence

The ONS 15216 EDFA3 can save all configurable parameters and the alarm log files in a persistent area (EEPROM or Configuration File in FFS).

The ONS 15216 EDFA3 recovers with all configurable parameters set at values before the event occurrence in the following cases:

  • Power failure
  • Reset
  • Software download

Configurable parameters will be reset to manufacturer's default values only in the following cases:

  • When a reset equipment command (STA-LOCL-RST) has been issued by the administrative user
  • When the configuration file has been deleted by the administrative user
  • When the configuration file has been corrupted. In this case an alarm/trap DATAFLT is emitted to signal the abnormal condition. The alarm is cleared as soon as a correct file has been loaded.
note.gif

Noteblank.gif A checksum test on the downloaded configuration file is performed to prevent to load wrong or corrupted files from being loaded on the ONS 15216 EDFA3.


The user can restore the configurable parameters even if saved in another ONS 15216 EDFA3.

The configuration file is composed of two sections. The first one (the header) shows the file type, description, software name, node name, and IP address parameters in a readable format, as reported in the following example:

FileType=CISCO ONS 15216 EDFA3 Database File
Description=CISCO ONS 15216
ActiveSoftwareName=ONS 15216Edfa3_01.00.00_003L_12.23
Node Name=Monza
IP-Address=10.51.100.95
 

Note that the active software name and IP address contained in the configuration file header might be different from the ones present in the node, if the configuration file has been created in one ONS 15216 EDFA3and then exported to another ONS 15216 EDFA3. These parameters must be updated with the information contained in the second ONS 15216 EDFA3 after the first unit reset. The node name in the header file is aligned with the name parameter contained in the second file section.

The second file section provides the configuration parameters and the information related to the accounts and passwords for TL1 and Simple Network Management Protocol (SNMP) Interfaces in an encrypted format. The configuration parameters are listed below:

  • CTRLMODE
  • GAINSP
  • PWROFFSET
  • LINE1TXPWRSP
  • LINE1TXPWRTHFL
  • LINE1RXPWRTHFL
  • LINE2RXPWRTHFL
  • TILTSP
  • TILTOFFSET
  • OSRI
  • PWRBUSMODE
  • NAME
  • LONGITUDE
  • LATITUDE
  • DESCR
  • PWRBUSMIN
  • PWRBUSMAX
  • MAXCTMP
  • MINCTMP

When the configuration file is being backed up or restored, the ONS 15216 EDFA3 prevents any management operation that might change the current setting. In order to prevent this, the ONS 15216 EDFA3 generates an alarm (BACKUPREST) to signal that the backup/restore operation is in progress. When this happens, the ONS 15216 EDFA will complete the following:

1.blank.gif Refuse any operations that change the configuration.

2.blank.gif Perform the backup/restore.

3.blank.gif Clear the BACKUPREST alarm and enable the configuration change.

6.3 Parameter Saving

When the user performs a setting operation using the TL1 or the SNMP interface, the parameters are automatically saved in persistent memory without requiring a further command.

6.4 Alarm Correlation

Typically, only the alarms that correspond to faults at the root level are relevant for system management. The alarm correlation processes try to eliminate all the alarms that are symptomatic effects of the fault root alarm.

An alarm filtering method is implemented in the ONS 15216 EDFA3. When one alarm at the root level causes a symptomatic effect on other alarms, only the root alarm will be notified.

To describe the rules implemented in the ONS 15216 EDFA3, we use a table like the one shown in Table 6-1 . In Table 6-1 , Alarm N (root), if present, masks Alarm M (symptomatic).

 

Table 6-1 Alarm Correlation Example

Alarm 1
Alarm M

Alarm 1

 

 

Alarm N

 

X

Table 6-2 shows the ONS 15216 EDFA3 alarm correlation information. Using Table 6-2 , you can see the masking rules. Where an “x” is present, the alarms listed in the rows will mask the alarms listed in the columns. Where a “–” is present, the combination is invalid (for example, the L1TMP alarm cannot mask itself, so a dash is placed in that cell.

 

Table 6-2 ONS 15216 EDFA3 Alarm Correlation Table

L1TMP
L2TMP
L1BIASD
L2BIASD
L1BIASF
L2BIASF
LINE1RXPWRFL
LINE2RXPWRFL
LINE1TXPWRFL
LINE1TXPWRDL
LINE1TXPWRDH
FTMP
CTMP
VOADL
VOADH
VOAFH
GAINDL
GAINDH
EQPT
COMFAIL
PWRBUSA
PWRBUSB
MEMLOW
FFSFULL
DATAFLT
SFTWDOWN
BACKUPREST

L1TMP

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

L2TMP

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

L1BIASD

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

L2BIASD

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

L1BIASF

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

L2BIASF

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LINE1RXPWRFL

 

 

 

x

 

x

x

x

 

 

 

 

 

 

x

x

x

 

 

 

 

 

 

 

 

 

LINE2RXPWRFL

 

 

 

x

 

x

 

x

 

 

 

 

 

 

x

x

x

 

 

 

 

 

 

 

 

 

LINE1TXPWRFL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

x

x

x

 

 

 

 

 

 

 

 

 

LINE1TXPWRDL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

LINE1TXPWRDH

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

FTMP

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

CTMP

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

VOADL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

VOADH

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

VOAFH

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

GAINDL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

GAINDH

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

EQPT

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

 

 

 

 

 

 

 

COMFAIL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PWRBUSA

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PWRBUSB

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

MEMLOW

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

FFSFULL

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

DATAFLT

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

SFTDOWN

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

BACKUPREST

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

6.5 TL1 Help

After logging in, a TL1 command list can be displayed by typing a question mark, as shown in the following example.

Example 6-1 Displaying TL1 Commands

> ?

ACT-USER

ALW-MSG-ALL

APPLY

CANC-USER

COPY-RFILE

CPY-MEM

DLT-RFILE

DLT-USER-SECU

ED-DAT

---Type ? to continue or CTRL-Q to quit---

The number of commands displayed in the window depends on the size of the window.

To display the syntax of a command, type that command followed by a question mark. For example, typing ACT-USER? returns:

> ACT-USER?

ACT-USER:[<TID>]:<uid>:<ctag>::<pid>;

>

6.6 Explanation of TL1 Command Parameters

TL1 messages are grouped into autonomous and nonautonomous types.

Autonomous messages are generated as a result of activity on the network elements. This activity includes:

  • Alarms
  • Thresholds
  • Alerts
  • Status information

No request is required in order to receive autonomous messages.

Nonautonomous messages consist of a request command from the user and a response from the ONS 15216 EDFA3. Autonomous messages and nonautonomous commands use a common set of parameters. Some of the most common parameters are defined in the following sections.

6.6.1 Source Identifier (sid) and Target Identifier (tid) for TL1

The source identifier (sid) or target identifier (tid) parameters uniquely identify an ONS 15216 EDFA3. Each sid/tid can be up to twenty ASCII characters in length, limited to digits, letters, and hyphens. The tid can remain null (represented by two successive colons [::]).

6.6.2 TL1 Command Code Modifier (ccm)

The command code modifier (ccm) identifies the object of the action being applied by the verb of the TL1 command.

Some command code modifiers for the ONS 15216 EDFA3 are described in the Table 6-3 .

 

Table 6-3 Command Code Modifiers

ccm
Description

DWDM

Optical parameters

EQPT

General parameters of the ONS 15216 EDFA3

INV

Inventory parameters

NE-GEN

IP communications parameters

6.6.3 Access Identifier (aid)

The access identifier (aid) parameter uniquely identifies a specific object within the ONS 15216 EDFA3. For the ONS 15216 EDFA3, there are four specific access identifiers. In addition, there is one nonspecific identifier.

  • 1
  • PWR-A
  • PWR-B
  • EQPT
  • <IP address>

As well, there is an additional ALL aid, described in the Table 6-4 .

All autonomous messages identify their specific aid in the message. For all command inputs that require an aid as a mandatory parameter, the ALL aid is accepted along with any relevant specific aids. If the ALL aid is used in a command, the response contains the appropriate specific aid. For the commands RTRV-ALM-EQPT and RTRV-COND-EQPT, inputting a specific aid filters the response to information relevant to that aid.

 

Table 6-4 Access Identifiers

aid
Description

1

Directly affecting the optical signal.

PWR-A

Affecting Power Bus A (or both A and B).

PWR-B

Affecting Power Bus B.

EQPT

General parameters of the ONS 15216 EDFA3 (not directly affecting optical signal or power bus).

ALL

Any or all of the preceding (command input only).

<IP address>

Addresses a specific row of an SNMP Trap Destination Table.

6.6.4 TL1 Correlation Tag (ctag)

The correlation tag (ctag) is a unique user-specified tag associated with a command. If the user specifies a ctag while entering a command, the response of that command from the ONS 15216 EDFA3 TL1 agent carries the same ctag value. The ctag consists of no more than six alphanumeric characters. For example, the ctag in the following example is 123, which will be returned in any response to this command to correlate the command to the response.

ALW-MSG-ALL:TID:ALL:123::MJ,PWRBUSA,;
 

6.6.5 Automatic Tag (atag)

An automatic tag (atag) is a numeric transaction identifier in the range 0 through 999999. The value of the atag is automatically generated by a TL1 agent and is used as a sequence number for automated messages. When the atag value reaches 999999, the value wraps back to 0. The initial atag value is 0.

6.6.6 Notification Code (ntfcncode)

A notification code (ntfcncode) specifies the type of notification to be generated by the ONS 15216 EDFA3 on the occurrence of an event described by the condition. Notification codes are described in Table 6-5 .

 

Table 6-5 Notification Code Descriptions

Notification Code Value
Description

CL

Cleared alarm—Indicates an alarm that is no longer present.

CR

Critical alarm—Indicates a severe, service-affecting alarm that needs immediate correction.

MJ

Major alarm—Serious alarm, but the failure has less impact on the network than a critical notification.

MN

Minor alarm—No serious affect on service.

NA

Not alarmed—Used to indicate a not alarmed object.

NR

Not reported—This is an alarm retained in the NE. It is recorded internally but is not reported when an event occurs.

6.6.7 Condition Effect (condeff)

A condition effect (condeff) indicates the effect of an event on the condition of the NE. Table 6-6 shows the possible condeff values used by the ONS 15216 EDFA3.

 

Table 6-6 Condition Effect Descriptions

Condition Effect Value
Description

CL

Standing condition cleared

SC

Standing condition raised

TC

Transient condition

6.6.8 Service Effect (serveff)

A service effect (serveff) indicates the effect of a reported alarm on the operation of the equipment.

Table 6-7 reports the possible values used by the ONS 15216 EDFA3.

 

Table 6-7 Service Effect Descriptions

Service Effect Value
Description

NSA

Non service affecting condition

SA

Service affecting condition

A service affecting (SA) failure affects a provided service or affects the network's ability to provide a service.

6.6.9 Private Identifier (pid)

A private identifier (pid) is the user password. It must be a string of up to 10 characters, where at least two are nonalphabetic characters and at least one is a special character. Special characters are +, #, %. The minimum length is six, except for the default password which is a null string.

The following security rules are implemented:

  • The password identifier (pid) must not be the same as or contain the userid (uid). For example, if the userid is CISCO15, the password cannot be CISCO15#.
  • There is no password identifier (pid) toggling. This means that if the current password is CISCO15#, the new password cannot be CISCO15#.
  • The password is case sensitive.

6.6.10 User Identifier (uid)

The user identifier (uid) is a string consisting of any combination of up to ten alphanumeric characters. The minimum length of a uid is six.

6.6.11 User Access Privilege (uap)

The user access privilege (uap) is one of three levels of user access privileges:

  • R: Read only privileges
  • RW: Read and write privileges
  • RWA: Read, write, and administrative privileges

6.6.12 Alarm Code (almcode)

An alarm code (almcode) indicates the severity of an automatic message. Table 10 reports the possible values.

 

Table 6-8 Alarm Code Descriptions

Alarm Code
Description

*C

Critical alarm

**

Major alarm

*^

Minor alarm

A^

Automatic message or no alarm

6.6.13 Date

The date parameter indicates the date of the event. The syntax is yyyy-mm-dd.

6.6.14 Time

The time parameter indicates the time of the event. The syntax is hh-mm-ss.

6.6.15 Occurrence Date (ocrdat)

An occurrence date (ocrdat) indicates the date (month-day) of an event occurrence. The format for ocrdat is MOY-DOM, where:

  • MOY represents month of year and has a range of 1 to 12.
  • DOM represents day of month and has a range of 1 to 31.

6.6.16 Occurrence Time (ocrtm)

An occurrence time (ocrtm) indicates the time (hour-minute-second) of an event occurrence. The format for ocrtm is HOD-MOH-SOM, where:

  • HOD represents hour of day and has a range of 0 to 23.
  • MOH represents minute of hour and has a range of 0 to 59.
  • SOM represents second of minute and has a range of 0 to 59.

6.7 TL1 Notation Symbols

The commands described in this document use the symbols shown in the following table to describe the command format. These symbols are derived from the Telcordia Network Maintenance: Network Element and Transport Surveillance Messages Manual (Generic Requirements, GR-833-CORE).

 

Table 6-9 TL1 Notation Symbols

Symbol
Meaning
Description

[ ]

Optional expression

Square brackets indicate that the parameters are optional. An optional parameter means that if a user inputs an empty field for an optional parameter, then a default value (or a default action) will be substituted automatically in the transmitted input field. The default value, or null value, is defined in the parameter descriptions of the messages.

< >

Variable expression

Angle brackets enclose one or more variable items in the command line (for example, <date>, <time>, <aid>).

+

More than one time

A plus sign indicates that the preceding symbol or group of symbols (enclosed in parentheses) can occur one or more times.

text

Indent of three spaces

An indented line indicates an entry of three spaces in the command line.

6.8 Summary of TL1 Autonomous Alarms and Messages

Table 6-10 summarizes the ONS 15216 EDFA3 autonomous alarms.

For every alarm, the following fields are provided:

  • Condition type (condtype)
  • Condition descriptor (conddescr)
  • Access identifier (aid)
  • Notification code (ntfcncde)
  • Service effect (sereff)

See the tables in the “Explanation of TL1 Command Parameters” section for descriptions of the column values in Table 6-10 .

 

Table 6-10 TL1 Autonomous Alarms

TL1 Autonomous Message
Condition Type (condtype)
Condition Descriptor (conddescr)
Access Identifier (aid)
Notification Code (ntfcncde)
Service Effect (sereff)

REPT ALM EQPT

PWRBUSA

Power Bus A Alarm

PWR-A

MN

NSA

REPT ALM EQPT

PWRBUSB

Power Bus B Alarm

PWR-B

MN

NSA

REPT ALM EQPT

MEMLOW

Free Memory on System Very Low

EQPT

MN

NSA

REPT ALM EQPT

FFSSLOW

Flash File System Capacity Very Low

EQPT

MN

NSA

REPT ALM EQPT

DATAFLT

Data Integrity Fault

EQPT

MJ

SA

REPT ALM EQPT

BACKUPREST

BackUp/Restore ConfFile In Progress

EQPT

MN

NSA

REPT ALM EQPT

SFTWDOWN

Software Download In Progress

EQPT

MN

NSA

REPT ALM EQPT

EQPT

Equipment Failure

EQPT

CR

SA

REPT ALM EQPT

COMFAIL

Module Communication Failure

EQPT

MN

NSA

REPT ALM EQPT

CTMP

Case Temperature Out Of Range

EQPT

MN

NSA

REPT ALM EQPT

FTMP

Fiber Temperature Out Of Range

EQPT

MN

NSA

REPT ALM EQPT

L1TMP

Excessive Pump 1 Temperature

EQPT

MN

NSA

REPT ALM EQPT

L1BIASD

Laser 1 Bias Degrade

EQPT

MN

NSA

REPT ALM EQPT

L1BIASF

Laser 1 Bias Fail

EQPT

MJ

NSA

REPT ALM EQPT

L2TMP

Excessive Pump 2 Temperature

EQPT

MN

NSA

REPT ALM EQPT

L2BIASD

Laser 2 Bias Degrade

EQPT

MN

NSA

REPT ALM EQPT

L2BIASF

Laser 2 Bias Fail

EQPT

MJ

NSA

REPT ALM DWDM

LINE1RXPWRFL

Power Fail Low LINE1RX Port

1

CR

SA

REPT ALM DWDM

GAINDH

Gain Degrade High

1

MN

NSA

REPT ALM DWDM

GAINDL

Gain Degrade Low

1

MN

NSA

REPT ALM DWDM

LINE1TXPWRFL

Power Fail Low LINE1TX Port

1

CR

SA

REPT ALM DWDM

LINE1TXPWRDH

Power Degrade High LINE1TX Port

1

MN

NSA

REPT ALM DWDM

LINE1TXPWRDL

Power Degrade Low LINE1TX Port

1

MN

NSA

REPT ALM DWDM

LINE2RXPWRFL

Power Fail Low LINE2RX Port

1

CR

SA

REPT ALM DWDM

VOADH

VOA Degrade High

1

MN

NSA

REPT ALM DWDM

VOADL

VOA Degrade Low

1

MN

NSA

REPT ALM DWDM

VOAFH

VOA Fail High

1

CR

SA

6.8.1 Equipment Failure Alarms

The unit will generate the EQPT (Equipment Failure) alarm in either of the following cases:

  • Retrieving or setting problem related to the setpoints, thresholds, and values.
  • An unrecoverable communication problem between the unit and a plug-in interface.

The Unit software generates a Communication Failure alarm in the case of a communication problem between the unit and the plug-in interface. The unit software implements the following behavior:

1.blank.gif The software tries to recover the communication, sending the command to module.

2.blank.gif If the command answers fail, the Communication Failure alarm is raised, which resets the plug-in module.

3.blank.gif If the reset command fails, the Hardware Failure alarm is generated.

4.blank.gif In case of a Hardware Failure, every TL1/SNMP command relating to the module setting/retrieval, is refused.

The Fiber Temperature Fail High (FTMP) alarm is generated in the case of degrade high or low. The FTMP alarm is mapped on an EQPT alarm.

6.8.2 Other Alarms

The following additional alarms are possible:

  • The L1TMP alarm is provided in case of degrade high or low of laser 1.
  • The L2TMP alarm is provided in case of degrade high or low of laser 2.
  • The L1BIASD alarm is provided in case of Laser Bias degrade high or low of laser 1.
  • The L2BIASD alarm is provided in case of Laser Bias degrade high or low of laser 2.
  • The L1BIASF is provided in case of Laser Bias Fail of laser 1.
  • The L2BIASF is provided in case of Laser BIas Fail of laser 2.
  • The CTMP alarm is generated in the case of degrade high or low.
  • The GAINDH and GAINDL alarms are sent to the EM only if the EDFA3 control mode is set to Gain Control. If the user changes the EDFA3 control mode to Output Power Control, the alarms are cleared and resent (only if active) after subsequent changes to the EDFA3 control mode.
note.gif

Noteblank.gif The LINE1TXPWRDH and LINE1TXPWRDL alarms have a similar behavior. They will be generated only if the EDFA3 control mode is set to Power Control.


  • The Unit software generates a Communication Failure alarm if a communication problem exists between the unit and the plug-in interface.
  • The MEMLOW alarm is generated if the memory usage reaches 90 percent of its capacity. The clear alarm is generated when the problem condition disappears.
  • The FFSFULL alarm is generated if the flash file system (FFS) memory usage reach the 90 percent of its capacity.
  • The clear alarm is generated when the problem condition disappear.

In the case of a communication failure, the unit software implements the following behavior:

1.blank.gif The unit attempts to recover the communication, sending the command to the module.

2.blank.gif If the command fails, the Communication Failure alarm is raised.

3.blank.gif The module resets.

4.blank.gif If the reset command fails, the Hardware Failure alarm is generated.

5.blank.gif If the Hardware Failure alarm is generated, all TL1/SNMP commands related to the module setting/retrieval will be refused.

6.8.3 Autonomous Events

Table 6-11 summarizes the ONS 15216 EDFA3 autonomous events. In the Condition Effect column, TC indicates that this is a transient condition.

 

Table 6-11 TL1 Autonomous Events

TL1 Autonomous Message
Condition Type (condtype)
Condition Descriptor (conddescr)
Access Identifier (aid)
Condition Effect (condeff)

REPT EVT DWDM

CTRLMODE

Control Mode Changed

1

TC

REPT EVT DWDM

GAINCHGD

Gain Setpoint Changed

1

TC

REPT EVT DWDM

GAINTHDLCHGD

Gain Degrade Low Threshold Changed

1

TC

REPT EVT DWDM

GAINTHDHCHGD

Gain Degrade High Threshold Changed

1

TC

REPT EVT DWDM

OPOFFSET

Output Power Offset Changed

1

TC

REPT EVT DWDM

LINE1TXPWRCHGD

Power Setpoint Changed LINE1TX Port

1

TC

REPT EVT DWDM

LINE1TXPWRTHDLCHGD

Power Degrade Low Threshold Changed LINE1TX Port

1

TC

REPT EVT DWDM

LINE1TXPWRTHDHCHGD

Power Degrade High Threshold Changed LINE1TX Port

1

TC

REPT EVT DWDM

LINE1TXPWRTHFLCHGD

Power Fail Low Threshold Changed LINE1TX Port

1

TC

REPT EVT DWDM

LINE1RXPWRTHFLCHGD

Power Fail Low Threshold Changed LINE1RX Port

1

TC

REPT EVT DWDM

LINE2RXPWRTHFLCHGD

Power Fail Low Threshold Changed LINE2RX Port

1

TC

REPT EVT DWDM

TILTCHGD

Tilt Setpoint Changed

1

TC

REPT EVT DWDM

TILTOFFSETCHGD

Tilt Offset Changed

1

TC

REPT EVT DWDM

LASERCHGD

Laser Status Changed

1

TC

REPT EVT DWDM

OSRICHGD

OSRI Changed

1

TC

REPT EVT EQPT

CUTOVERRESET

Reset After Cutover

EQPT

TC

REPT EVT EQPT

SOFTWARERESET

Software Reset

EQPT

TC

REPT EVT EQPT

PWRBUSMODE

Power Bus Mode Changed

PWR-A/ PWR-B

TC

REPT EVT EQPT

SEVERITYCHGD

Severity Changed

EQPT

TC

REPT EVT EQPT

PWRBUSMAXCHGD

Power Bus Max (voltage) Changed

PWR-A/ PWR-B

TC

REPT EVT EQPT

PWRBUSMINCHGD

Power Bus Min (voltage) Changed

PWR-A/ PWR-B

TC

REPT EVT EQPT

MAXCTMPCHGD

Max Case Temperature Changed

EQPT

TC

REPT EVT EQPT

MINCTMPCHGD

Min Case Temperature Changed

EQPT

TC

6.8.4 File Transfer Events

Table 6-12 summarizes the ONS 15216 EDFA3 file transfer events.

 

Table 6-12 TL1 Autonomous File Transfer Events

Autonomous TL1 Message
File Transfer Status (fxfr_status)
File Transfer Result (fxfr_rslt)
Access Identifier (aid)

REPT EVT FXFR

START

EQPT

REPT EVT FXFR

COMPLD

EQPT

SUCCESS

EQPT

FAILURE

EQPT

Table 6-13 summarizes the ONS 15216 EDFA3 clear alarms.

 

Table 6-13 TL1 Autonomous Clear Alarms

TL1 Autonomous Message
Condition Type (condtype)
Condition Descriptor (conddescr)
Access Identifier (aid)
Notification Code (ntfcncde)
Service Effect (srveff)

REPT ALM DWDM

LOS

Loss Of Signal (input power)

1

CL

SA

REPT ALM DWDM

GAIN

Gain Out Of Range

1

CL

SA

REPT ALM DWDM

LPOUT

Loss Of Output Power

1

CL

SA

REPT ALM EQPT

CTMP

Case Temperature Out of Range

EQPT

CL

NSA

REPT ALM EQPT

LCRNT1

Excessive Pump1 Current

EQPT

CL

NSA

REPT ALM EQPT

LCRNT2

Excessive Pump2 Current

EQPT

CL

NSA

REPT ALM EQPT

LTMP1

Excessive Pump1 Temperature

EQPT

CL

NSA

REPT ALM EQPT

LTMP2

Excessive Pump2 Temperature

EQPT

CL

NSA

6.9 Summary of TL1 Command Security Permissions

Table 6-14 summarizes the security permissions (access levels) for each available TL1 command and autonomous message.

 

Table 6-14 Security Permissions for TL1 Commands

Command or Message
Description
User Access Levels
R
RW
RWA

ACT-USER

Activates user session (login).
See ACT-USER.

Yes

Yes

Yes

ALW-MSG-ALL

Allows automatic (REPT) messages.
See ALW-MSG-ALL.

Yes

Yes

Yes

APPLY

Applies software cutover.
See APPLY.

No

No

Yes

CANC

Session is cancelled. See CANC.

Yes

Yes

Yes

CANC-USER

Cancels user session (logoff).
See CANC-USER.

Yes

Yes

Yes

COPY-RFILE

Copies remote or local file to FFS.
See COPY-RFILE.

No

No

Yes

CPY-MEM

Copies log file from RAM to FFS.
See CPY-MEM.

No

Yes

Yes

DLT-RFILE

Deletes file from FFS.
See DLT-RFILE.

No

No

Yes

DLT-TRAPTABLE

Deletes a specific row or all rows in the traptable.
See DLT-TRAPTABLE.

No

No

Yes

DLT-USER-SECU

Deletes a user.
See DLT-USER-SECU.

No

No

Yes

ED-DAT

Edits date and time.
See ED-DAT.

No

Yes

Yes

ED-DWDM

Edits optical parameters.
See ED-DWDM.

No

Yes

Yes

ED-EQPT

Edits equipment parameters.
See ED-EQPT.

No

Yes

Yes

ED-NE-GEN

Edits general IP-related parameters.
See ED-NE-GEN.

No

Yes

Yes

ED-PID

Edits user password.
See ED-PID.

Yes
(own UID)

Yes
(own UID)

Yes
(all UIDs)

ED-TRAPTABLE

Edit the Trap Table values.
See ED-TRAPTABLE.

No

No

Yes

ED-USER-SECU

Edits a user name and parameters.
See ED-USER-SECU.

No

No

Yes

ENT-TRAPTABLE

Add an entry in the SNMP Trap Destination Table. See ENT-TRAPTABLE.

No

No

Yes

ENT-USER-SECU

Enters new user.
See ENT-USER-SECU.

No

No

Yes

INH-MSG-ALL

Inhibits some automatic messages.
See INH-MSG-ALL.

Yes

Yes

Yes

INIT-SYS

Initializes (reboots) system.
See INIT-SYS.

No

No

Yes

REPT ALM DWDM

Reports optical alarm activation/clearing.
See REPT ALM DWDM.

Yes

Yes

Yes

REPT ALM EQPT

Reports general alarm activation/clearing.
See REPT ALM EQPT.

Yes

Yes

Yes

REPT EVT DWDM

Reports when a dense wavelength division multiplexing (DWDM) alarm is generated or cleared. See REPT EVT DWDM.

Yes

Yes

Yes

REPT EVT EQPT

Reports changes related to equipment threshold settings. See REPT EVT EQPT.

Yes

Yes

Yes

REPT EVT FXFR

Reports FTP file transfer.
See REPT EVT FXFR.

Yes

Yes

Yes

RTRV-ALM-ALL

Retrieves all current alarms.
See RTRV-ALM-ALL.

Yes

Yes

Yes

RTRV-ALM-DWDM

Retrieves current optical alarms.
See RTRV-ALM-DWDM.

Yes

Yes

Yes

RTRV-ALM-EQPT

Retrieves current general alarms.
See RTRV-ALM-EQPT.

Yes

Yes

Yes

RTRV-ATTR-ALL

Retrieves alarm severity.
See RTRV-ATTR-ALL.

Yes

Yes

Yes

RTRV-ATTR-DWDM

Retrieves the severity associated with an optical alarm. See RTRV-ATTR-DWDM.

Yes

Yes

Yes

RTRV-ATTR-EQPT

Retrieves the severity associated with an equipment alarm. See RTRV-ATTR-EQPT.

Yes

Yes

Yes

RTRV-AO

Retrieves most-recent autonomous output (REPT) messages. See RTRV-AO.

Yes

Yes

Yes

RTRV-COND-ALL

Retrieves condition (state) of all current alarms.
See RTRV-COND-ALL.

Yes

Yes

Yes

RTRV-COND-DWDM

Retrieves condition (state) of current optical alarms.
See RTRV-COND-DWDM.

Yes

Yes

Yes

RTRV-COND-EQPT

Retrieves condition (state) of current general alarms.
See RTRV-COND-EQPT.

Yes

Yes

Yes

RTRV-DFLT-SECU

Retrieves timeouts for access levels.
See RTRV-DFLT-SECU.

No

No

Yes

RTRV-DWDM

Retrieves optical parameters.
See RTRV-DWDM.

Yes

Yes

Yes

RTRV-EQPT

Retrieves the Power Bus mode. See RTRV-EQPT.

Yes

Yes

Yes

RTRV-HDR

Retrieves header (pings NE).
See RTRV-HDR.

Yes

Yes

Yes

RTRV-INV

Retrieves inventory parameters.
See RTRV-INV.

Yes

Yes

Yes

RTRV-NE-GEN

Retrieves general IP-related parameters.
See RTRV-NE-GEN.

Yes

Yes

Yes

RTRV-RFILE

Retrieves files on FFS.
See RTRV-RFILE.

Yes

Yes

Yes

RTRV-STATUS

Retrieves the user logged on status. See RTRV-STATUS.

Yes

Yes

Yes

RTRV-TH-DWDM

Retrieves optical thresholds.
See RTRV-TH-DWDM.

Yes

Yes

Yes

RTRV-TH-EQPT

Retrieves general thresholds.
See RTRV-TH-EQPT.

Yes

Yes

Yes

RTRV-TOD

Retrieves date and time.
See RTRV-TOD.

Yes

Yes

Yes

RTRV-TRAPTABLE

Provides information about the trap table. See RTRV-TRAPTABLE.

Yes

Yes

Yes

RTRV-USER-SECU

Retrieves access level of user(s).
See RTRV-USER-SECU.

Yes
(own UID)

Yes
(own UID)

Yes
(all UIDs)

SET-ATTR-DWDM

Permits changes to the severity associated with an optical alarm. See SET-ATTR-DWDM.

No

Yes

Yes

SET-ATTR-EQPT

Permits changes to the severity associated with an equipment alarm. See SET-ATTR-EQPT.

No

Yes

Yes

SET-ATTR-SECUDFLT

Sets timeout values for access levels.
See SET-ATTR-SECUDFLT.

No

No

Yes

SET-TH-DWDM

Sets optical thresholds.
See SET-TH-DWDM.

No

Yes

Yes

SET-TH-EQPT

Sets general threshold values.
See SET-TH-EQPT.

No

Yes

Yes

STA-LOCL-RST

Resets all parameters to manufacturer default values. See STA-LOCL-RST.

No

No

Yes