About TL1 Commands
This chapter describes some reference information about using the TL1 commands supported by the Cisco ONS 15216 EDFA3.
Note 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:
– COMPLD
(The command was completed.)
– 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 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
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. Refuse any operations that change the configuration.
2. Perform the backup/restore.
3. 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 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 |
|
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
*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
|
|
|
[ ] |
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
|
Condition Type (condtype)
|
Condition Descriptor (conddescr)
|
|
Notification Code (ntfcncde)
|
|
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. The software tries to recover the communication, sending the command to module.
2. If the command answers fail, the Communication Failure alarm is raised, which resets the plug-in module.
3. If the reset command fails, the Hardware Failure alarm is generated.
4. 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 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. The unit attempts to recover the communication, sending the command to the module.
2. If the command fails, the Communication Failure alarm is raised.
3. The module resets.
4. If the reset command fails, the Hardware Failure alarm is generated.
5. 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
|
Condition Type (condtype)
|
Condition Descriptor (conddescr)
|
|
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
|
File Transfer Status (fxfr_status)
|
File Transfer Result (fxfr_rslt)
|
|
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
|
Condition Type (condtype)
|
Condition Descriptor (conddescr)
|
|
Notification Code (ntfcncde)
|
|
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
|
|
|
|
|
|
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 |