Any brand names and product names included in this document are trademarks, registered
trademarks, or trade names of their respective holders.
To the Holder of the Document
The contents of this document are current as of the date of publication. ADTRAN® reserves the
right to change the contents without prior notice.
In no event will ADTRAN be liable for any special, incidental, or consequential damages or
for commercial losses even if ADTRAN has been advised thereof as a result of issue of this
publication.
BAugust 2004Add STS-1 and Clock Modules and associated commands
CMarch 2005Add RADIUS documentation
DOctober 2007Add 1186002L3 and update document format and add SSH
Conventions
The following typographical conventions are used in this document:
This font indicates a cross-reference link.
This font indicates screen menus, fields, and parameters.
THISFONT indicates keyboard keys (ENTER, ESC, ALT). Keys that are to be pressed simultaneously
are shown with a plus sign (
same time
).
This font indicates references to other documentation and is also used for emphasis.
ALT+Xindicates that the ALTkey and Xkey should be pressed at the
This font indicates on-screen messages and prompts.
This font indicates text to be typed exactly as shown.
This font indicates silk-screen labels or other system label items.
This font is used for strong emphasis.
NOTE
Notes inform the user of additional, but essential, information or
features.
CAUTION
Cautions inform the user of potential damage, malfunction, or
disruption to equipment, software, or environment.
WARNING
Warnings inform the user of potential bodily pain, injury, or death.
61186003L1-35Diii
MX2820 System TL1 Reference Guide
Training
ADTRAN offers training courses on our products. These courses include overviews on product
features and functions while covering applications of ADTRAN product lines. ADTRAN
provides a variety of training options, including customized training and courses taught at our
facilities or at customer sites.
For inquiries concerning training, contact ADTRAN:
This manual provides Transaction Language 1 (TL1) reference information for the MX2820
System. This document is intended for use by operating company personnel who use TL1
commands to perform network management tasks for the MX2820 System and its associated
network equipment. For additional information about the MX2820 System, refer to the
MX2820 System Manual (P/N 61186003L1-1).
TL1 OVERVIEW
TL1 software provides an ASCII-based protocol that allows the exchange of messages between
an Operations Support System (OSS) and the MX2820 System. The TL1 software also allows
the exchange of messages between the OSS and the network equipment that connects to the
MX2820 System. An OSS is also referred to as an Operations System (OS).
Transport Methods
The TL1 software uses the following methods for transporting messages:
• X.25 packet network (Network Management)
• Transmission Control Protocol/Internet Protocol (TCP/IP) Telnet socket
There are two configurable ports for TL1 access (having default values of 2000 and 2001). The
first indicates that the connection was made and describes the MENUS command. The second
is a raw connection that will not send anything upon connection.
TL1 Sessions
The maximum number of TL1 logon sessions at one time depends on the physical and logical
interfaces to the MX2820 System Controller Unit (SCU).
The X.25 interface allows a maximum of four TL1sessions, one per Switched Virtual Circuit
(SVC) with up to four SVCs.
The Ethernet interface allows up to eight Telnet sessions. All eight sessions can be TL1 over
TCP/IP.
61186003L1-35D1-1
MX2820 System TL1 Reference Guide
TL1 Message Types
The TL1 software provides four types of operation messages:
• Input command
An input command is a message from an OS or other source to a Network Element (NE).
The message instructs or requests the NE to perform a management-related function.
• Acknowledgment
An acknowledgment is a reply from the NE that indicates an input command is being
acted upon. An NE sends an acknowledgment response if a normal response or error
response cannot be sent within two seconds. The MX2820 System supports the In
Progress (IP) acknowledgment response.
The IP acknowledgment response indicates the request has been initiated and produces
subsequent output messages which provide a termination report or a termination report
with command results.
• Output response (Response message or Error message)
An output response is a detailed reply or set of replies to an input command. It contains
information that indicates whether the command was successfully executed. The output
response also contains any data that needs to be returned to the OS/user.
• Autonomous
An autonomous message is generated by an NE either on a periodic basis or is generated
by an NE to report an alarm or an event that occurs at the NE. These messages are
normally triggered by alarm conditions and are not in response to any input command.
OPERATIONS SUPPORT SYSTEM
An OSS consists of application software that runs on a host computer and allows the host
computer to provide network management functions. The SCU provides the network
management interface for the MX2820 System and the network equipment that interconnects
to and interworks with the MX2820 System.
The SCU and the MX2820 System supports the following network management functions:
•Configuration
• Fault
• Performance Monitoring
• Security
•Test
From a network management standpoint, the MX2820 System and the network equipment are
referred to as NEs that exchange messages with the host computer of the OS.
1-261186003L1-35D
Section 1, Introduction - SCU Client Management Modes of Operations
SCU CLIENT MANAGEMENT MODES OF OPERATIONS
If an SCU is a client unit, the SCU can operate in two modes: Intelligent Network Element
(INE) and Expansion Shelf. The mode of operation has an impact on the Target Identifier (TID)
and the Access Identifier (AID) fields in a TL1 command. Refer to the “TL1 Commands” section
in this document for additional information about these fields.
If an SCU is a host unit, the client management mode is not available.
NETWORK ELEMENTS
The MX2820 System supports and/or provides the NEs shown in Table 1-1.
NOTE
This reference guide is also used for the coinciding RoHS products
not specifically mentioned. The RoHS part number uses an “E” or
“G” instead of an “L” in the part number.
Table 1-1. MX2820 Network Elements
Network ElementPart Number
System Controller Unit1186003Lx
DS3 MUX1186002Lx
Clock Card1186004Lx
STS-1 MUX1186005Lx
Note: Refer to www.adtran.com for a complete list of products.
REFERENCES
For more information, including details on each list series, refer to the MX2820 System
Manual (P/N 61186003L1-1).
61186003L1-35D1-3
MX2820 System TL1 Reference Guide
MX2820 SYSTEM TL1 COMMAND CROSS-REFERENCE
Table 1-2 lists the available TL1 commands for the MX2820 System.
Table 1-2. TL1 Commands
Common (SCU)Section-PageCommand Type
ACT-USER4-2Common
ALW-MSG7-2Surveillance
CANC-USER4-4Common
DLT-USER-SECU6-2Security
ED-rr5-2Provisioning
ED-USER-SECU6-4Security
ENT-USER-SECU6-6Security
INH-MSG7-4Surveillance
MENUS4-5Common
OPR-LPBK-rr9-2System Test
RLS-LPBK-rr9-4System Test
RTRV-rr5-4Provisioning
RTRV-ALM7-6Surveillance
RTRV-ALM-ENV7-8Surveillance
RTRV-COND7-11Surveillance
RTRV-HDR7-13Surveillance
RTRV-PM-rr7-15Surveillance
SCHED-PMREPT-rr7-25Surveillance
RTRV-PMSCHED-rr7-17Surveillance
RTRV-SYS7-19Surveillance
RTRV-TH-rr5-6Provisioning
RTRV-USER-SECU6-8Security
RTRV-VER7-21Surveillance
RTRV-VERSION7-23Surveillance
SET-DAT4-6Common
SET-TH-rr5-8Provisioning
SW-TOPROTN-rr8-2System Maintenance
SW-TOWKG-rr8-4System Maintenance
1-461186003L1-35D
Section 2
TL1 Commands
INTRODUCTION
This section provides information about the TL1 commands for the MX2820 System.
SYNTAX
The following syntax is used with TL1 commands.
• A colon (:) separates the fields of a TL1 command.
• The colon also separates unused or empty fields from required fields in a TL1 command.
• A comma (,) separates data entry items within a common data block, a specific data block,
and a state block.
• A semicolon (;) indicates the end of a TL1 command.
NOTE
The carriage return does not indicate the end of a TL1 command.
NOTE
The
BACKSPACE and DELETE keys are nonfunctional when entering
TL1 commands. To abort a command, press CTRL+X.
61186003L1-35D2-1
MX2820 System TL1 Reference Guide
NOTATIONS AND CONVENTIONS
The following notations and conventions are used for TL1 input commands:
< >Information inside of the less than and greater than symbols
indicates a data entry item for a command. The symbols are not
transmitted as part of the command.
[ ]Information inside of brackets indicates the parameter is
optional for an input command. The brackets are not transmitted as part of the command.
{|}Information inside of braces and separated by a pipe indicates
that one of the parameters must be selected from the list. The
braces and the pipes are not transmitted as part of the
command.
Unless noted otherwise, the TL1 input commands are not case sensitive. This manual
presents the commands in all uppercase as a documentation standard/convention.
GENERAL FORMAT
A TL1 input command for the MX2820 System has the following general format:
<verb>:<tid>:<aid>:<ctag>:<general block>:<common data block>:
<specific data block>:<state block>;
Table 2-1 provides a description for each field. “Appendix A, Input Commands Data
Dictionary” and “Appendix B, Response Messages Data Dictionary” contains additional infor-
mation about the parameters used with TL1 commands and response messages to the TL1
commands.
NOTE
The MX2820 System does not output an error message for data
entries in a non-supported field of a TL1 command.
FieldDescription
<verb>This field contains the TL1 command verb. The command verb indicates the
Table 2-1. TL1 Input Command General Format Descriptions
action that is to be performed at the MX2820 System shelf, or another NE. The
command verb can have up to two optional modifiers.
The valid forms are as follows:
• VERB
• VERB-MODIFIER
• VERB-MODIFIER-MODIFIER.
<tid>This field is the Target Identifier (TID). For more information, refer to the “TID”
on page 2-3 subsection.
2-261186003L1-35D
Section 2, TL1 Commands - General Format
Table 2-1. TL1 Input Command General Format Descriptions (Continued)
FieldDescription
<aid>This field is the Access Identifier (AID). For more information, refer to “Section
3, ADTRAN AID Formats”.
<ctag>The Correlation Tag (CTAG) is a one-to-six alphanumeric identifier that is ech-
oed in the response message for a TL1 command. The CTAG correlates input
commands with response messages. All response messages to a TL1 command
must have the same CTAG.
<general block>This field is not used in this application and should be left empty. This field
requires entering a field separator unless the <ctag> field is the last required
field.
<common data
block>
<specific data
block>
<state block>This field contains data that applies to specific TL1 commands. Refer to the
:The colon is used as a field separator.
;The semicolon is used as a TL1 command terminator. The command termina-
This field contains data that applies to specific TL1 commands. Refer to the
specific TL1 command sections and to applicable data dictionary appendices in
this document for additional information.
This field contains data that applies to specific TL1 commands. Refer to the
specific TL1 command sections and to applicable data dictionary appendices in
this document for additional information.
specific TL1 command sections and to applicable data dictionary appendices in
this document for additional information.
tor can be used after the last non-empty field without supplying the remaining
colon separators.
TID
The TID parameter indicates the end-target NE for a TL1 command. The client management
mode of operation for the SCU can have an impact on the value for this field. The following
subsection provides additional information.
NOTE
If the SCU functions as the host network management unit, the
client management mode of operation is not available.
SCU Client Management Operation Mode
INE
When operating in the INE mode, the SCU has a unique TID and operates as an independent
intelligent network element. TL1 commands route to this SCU if the TIDs in the commands
match the TID of this SCU. INE is the default client management mode for the SCU. With this
operation mode, the shelf number for the <aid> field is always a 1.
61186003L1-35D2-3
MX2820 System TL1 Reference Guide
Expansion Shelf
Up to thirty-two SCUs can share a common TID for systems operating in the “Expansion
Shelf” mode. TL1 commands route to the appropriate SCU based on the shelf number in the
<aid> field.
Common Language Location Identifier (CLLI)
The CLLI code is often used as the TID in TL1 commands. The CLLI code is one- to twentyalphanumeric characters that are not case sensitive. The CLLI code identifies physical
locations and equipment such as buildings, central offices, antennae, channel banks, and
shelves. CLLI codes are also used as unique identifiers for a single NE. CLLI codes are
assigned at the OS. The following example provides a CLLI code.
Example:
HTVLALEXD16
Input Parameters:
HTVLThe first four character identify the place name (Huntsville).
ALThe next two characters identify the state, region, or territory
(Alabama).
EXThe next two characters identify the central office location code.
These characters typically identify the street location of the
specific central office.
In this example, EX represents Explorer Blvd.
DThe next single alpha character is the equipment type code. The
equipment type code of D identifies general administrative
equipment.
16The last two numeric characters represent a unique identifier
number for a specific central office. These characters identify
which NE is being addressed.
ACKNOWLEDGMENT RESPONSES
If an NE cannot send a normal response or an error response to the OS/user within two
seconds of receiving a TL1 command, the NE sends an acknowledgment response of IP.
Acknowledgment Syntax
The syntax for the acknowledgment responses supported by the MX2820 System are as
follows:
NOTE
This symbol (<) represents the TL1 ready indicator.
IP[^<CTAG>] <cr> <lf>
<
2-461186003L1-35D
Section 2, TL1 Commands - Normal Response Messages
NORMAL RESPONSE MESSAGES
The standard TL1 response message for the MX2820 System has the following format:
The following TL1 commands are ADTRAN-specific commands:
• “MENUS” on page 4-5
• “RTRV-VER” on page 7-21
• “RTRV-VERSION” on page 7-23
2-661186003L1-35D
Section 2, TL1 Commands - User Account Requirements (Access Privileges)
USER ACCOUNT REQUIREMENTS (ACCESS PRIVILEGES)
The SCU provides the ability to control access to the MX2820 System with user security
accounts that require users to enter a username and password. The SCU can also control
access to the system which involves assigning command access privileges and operation privileges to user security accounts. Command access privileges determine which commands a
user is allowed to enter. Operation privileges determine which operations a user is allowed to
perform.
User accounts are created at the ADMIN level of the SCU. The pre-defined user accounts are
as follows:
ADMIN, ADTRANThese user accounts include all allowances of the READWRITE
account, add write access to all SCU and line card provision
items, and add access to provision passwords for each user
account through the General Provisioning menu. Creating user
accounts requires assigning username, password, and
command privilege level.
READONLYThis user account allows read access to any parameter in the
SCU and line cards. READONLY user accounts have no security
access.
READWRITE, TESTThese user accounts includes all allowances of the READONLY
account and adds write access to a limited number of SCU
items and all line card provision items. Changes to network
management items, such as Internet Protocol (IP) address and
TID are not allowed. A READWRITE or TEST user account can
change its own password, but has no other security access.
All accounts can be deleted and replaced with user-defined accounts. Any inactive account
(not currently logged on) can be disabled.
TL1 login accounts (TL1 sessions) require use of the ACT-USER command to access the
system.
61186003L1-35D2-7
MX2820 System TL1 Reference Guide
This page is intentionally blank.
2-861186003L1-35D
Section 3
ADTRAN AID Formats
INTRODUCTION
This section provides information about ADTRAN AID formats for the MX2820 System.
SCU OPERATION MODE
The operation mode for the SCU can affect how and when the AID parameter is entered for the
TL1 commands. In addition, a NE entity, such as the card type, being targeted by the TL1
command can affect the AID parameter.
SCU Unit
How the SCU functions in the network management configuration determines whether the
client management mode is available. If the SCU functions as a host unit, the client
management mode is not available and the AID parameter is determined by the NE entity
being targeted by the TL1 command. If the SCU functions as a client, the client management
mode is available and defaults to INE.
Intelligent Network Element
If the SCU operates in the INE mode, the shelf number for the AID parameter in a TL1
command is always one. The SCU has a unique TID when operating in the INE mode. TL1
commands route to this SCU if the TID in the command matches the TID of the SCU. INE
shelves are provisioned with a unique TID during system turnup, and the shelf number is
forced to one.
Expansion Shelf
If the SCU operates in the Expansion Shelf mode, a common TID can be shared by up to 32
SCUs. TL1 commands route to the appropriate SCU based on the shelf number in the AID.
The shelf number ranges from 1–32. The Expansion Shelf is automatically assigned the TID of
the host and is provisioned with a shelf number during system turnup.
61186003L1-35D3-1
MX2820 System TL1 Reference Guide
AID STRUCTURE
The AID parameter for the MX2820 System consists of a hierarchy-based format that includes
the following data separated by dashes: the shelf number, the category type, and one or two
additional entries. The terms “unit” or “bank” can also be used to describe the shelf number.
The shelf number is assigned by TIRKS.
For the MX2820 System, if the SCU is in the INE client mode, the shelf number is always one.
If the SCU is in the Expansion Shelf client mode, the shelf number ranges from 1 to 254.
Table 3-1 provides the AID inputs for the 19-inch chassis and Table 3-2 provides the AID
inputs for the 23-inch chassis.
Table 3-1. 19-Inch Chassis AID Inputs
ShelfCategoryEntity 1Entity 2
1 to 254T3MUX1 to
STS1
T1MUX1 to
VT1MUX1 to
EQPTMUX1 to
ENV1 to 5N/A
MUX7
MUX7
MUX7
MUX7
CLK
SCUN/A
1
1 to 28 (corresponding to individual DS1s within DS3)
1 to 28 (corresponding to individual VTs within the STS-1)
A or B
A = Working Unit
B = Protect Unit
Table 3-2. 23-Inch Chassis AID Inputs
ShelfCategoryEntity 1Entity 2
1 to 254T3MUX1 to
MUX9
STS1
1
T1MUX1 to
MUX9
VT1MUX1 to
MUX9
EQPTMUX1 to
MUX9
CLK
SCUN/A
ENV1 to 5N/A
3-261186003L1-35D
1 to 28 (corresponding to individual DS1s within DS3)
1 to 28 (corresponding to individual VTs within the STS-1)
A or B
A = Working Card
B = Protect Card
Section 3, ADTRAN AID Formats - AID Structure
There are no spaces between the parts of the AID parameter. Leading zeros are not significant.
They are ignored on input and suppressed on output.
Table 3-3 provides some examples of AID parameters.
The TL1 command sections and the data dictionaries in the appendices also contain information about the AID parameter.
61186003L1-35D3-3
MX2820 System TL1 Reference Guide
This page is intentionally blank.
3-461186003L1-35D
Section 4
Common (SCU) TL1 Commands
INTRODUCTION
The following TL1 commands apply to the SCU or apply to the MX2820 System:
• “ACT-USER” on page 4-2
• “CANC-USER” on page 4-4
• “MENUS” on page 4-5
• “SET-DAT” on page 4-6
61186003L1-35D4-1
MX2820 System TL1 Reference Guide
ACT-USER
The ACT-USER (Activate-User) command allows access to the MX2820 System from a local or
remote terminal. The user must have a valid User ID (UID) and Private ID (PID).
Minimum User Access Privilege
NONE
Input Format
ACT-USER:[<TID>]:<UID>:[<CTAG>]::<PID>;
Example:
ACT-USER:HTVLALEXD16:USER1:1::PASSWORD1;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
UIDThe UID indicates the User ID or logon name for the user. The
UID can have up to 10 alphanumeric characters.
CTAGFor the Correlation Tag (CTAG), refer to “Appendix A, Input
Commands Data Dictionary” for additional information.
PIDThe PID contains the password for the user. The password
consists of an alphanumeric character string with a maximum
length of 12 characters. The first character must be a letter.
Valid characters are as follows:
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
RADIUS Authentication
Login through TL1 occurs through the use of the ACT-USER command. When RADIUS
authentication is enabled, this command works as with local authentication.
Input Format
ACT-USER::<username>:::<password>;
If the username or password is enclosed in quotation marks it is treated as a case-sensitive
string. Otherwise, all of the characters present are shifted to upper case. If the username or
password contains a quotation mark, it must be doubled in the command string in order to
prevent unwanted string termination.
Example:
Login:AdMiN
Password:PaSs”WoRd
The proper command to login with the above combination is as follows:
ACT-USER::”AdMiN”:::”PaSs””WoRd”;
Challenge response
If the RADIUS server sends a challenge request, the initial login is denied with a PLNA error
code. Immediately after the DENY message are three lines of text. The first indicates the
challenge message sent by the server. The second and third lines are as follows:
/*REPEAT ACT-USER COMMAND. */
/*USE SAME USERNAME. USE CHALLENGE RESPONSE AS PASSWORD. */
When this challenge is received, follow the same format used prior to login, but now instead of
the password use the challenge request.
61186003L1-35D4-3
MX2820 System TL1 Reference Guide
CANC-USER
The CANC-USER (Cancel-User) command terminates a TL1 session.
Minimum User Access Privilege
READONLY
Input Format
CANC-USER:[<TID>]::[<CTAG>];
Example:
CANC-USER:HTVLALEXD16::5;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
4-461186003L1-35D
Section 4, Common (SCU) TL1 Commands - MENUS
MENUS
The MENUS command switches the interface for a TL1 session between the TL1 mode and the
Menus mode. To accomplish this, the MENUS command is entered while in a TL1 session. The
menu session can be switched back to a TL1 session by logging off the menu session.
The Local Echo should be disabled while in the Menus mode. Y-modem software updates to
the SCU or to a line access module are not supported while in the Menus mode.
Minimum User Access Privilege
READONLY
Input Format
MENUS:[<TID>];
Example:
MENUS:HTVLALEXD16;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
Response Format
Acknowledgment
The NE does not send an acknowledgment response for the MENUS command.
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D4-7
MX2820 System TL1 Reference Guide
This page is intentionally blank.
4-861186003L1-35D
Section 5
Provisioning TL1 Commands
INTRODUCTION
The Provisioning TL1 commands for the MX2820 System allow reconfiguration of an NE. The
Provisioning TL1 commands for the MX2820 System are as follows:
• “ED-rr” on page 5-2
• “RTRV-rr” on page 5-4
• “RTRV-TH-rr” on page 5-6
• “SET-TH-rr” on page 5-8
61186003L1-35D5-1
MX2820 System TL1 Reference Guide
ED-RR
The ED-rr command instructs the NE to change parameters associated with one or more facilities (transmission entities) for the specified AID type.
For the MX2820 System, the supported rr modifiers are as follows:
•EQPT
•T1
•T3
•STS1
•VT1
Minimum User Access Privilege
READWRITE
Input Format
ED-rr:[<TID>]:<AID>:[<CTAG>]::[:[<specific data block>][:<state block>]];
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D5-5
MX2820 System TL1 Reference Guide
RTRV-TH-RR
The RTRV-TH-rr (Retrieve-Threshold) command instructs an NE to send the current threshold
level of one or more monitored parameters for which violation will trigger an automatic
message. These threshold levels can apply to one or more equipment units or facilities.
The MX2820 System supports the following rr modifiers:
TIDThe “TID” on page 2-3 identifies the target NE for the command.
The TID should match the Source Identifier (SID) value
assigned to the NE, or be NULL. A NULL value matches the NE
processing the command. If not specified, a NULL value is
assigned.
AIDThe AID indicates the entity or location of the entity within the
targeted NE. For applicable AIDs, refer to “Section 3, ADTRAN
AID Formats”.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
MONTYPEThe Monitoring Type (MONTYPE) parameter indicates the type
of PM threshold being retrieved.
The MONTYPE of a given threshold is the MONTYPE of the
associated performance monitoring value (refer to “Appendix F,
Performance Monitoring Codes”) with “-HT” appended to the
end. For example, the MONTYPE for the threshold for the T1
loss-of-signal is “LOSS-L-HT”.
LOCNFor the Location (LOCN), refer to “Appendix A, Input Commands
Data Dictionary” for additional information.
TMPERFor the Time Period (TMPER) parameter, refer to “Appendix A,
Input Commands Data Dictionary” for additional information.
The (^^^"<error description>" <cr> <lf>) and (^^^/*error text*/ <cr> <lf>) error response
blocks are optional and, if desired, multiple repetitions are allowed.
Refer to “Appendix A, Input Commands Data Dictionary” for input parameter descriptions.
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D5-7
MX2820 System TL1 Reference Guide
SET-TH-RR
The SET-TH-rr (Set-Threshold) command instructs an NE to set the threshold level for a
monitored parameter that, when exceeded, can trigger an automatic message. The threshold
level can apply to one or more equipment units or facilities in the NE. Threshold setting for
multiple monitored parameters or time periods will require multiple commands from the OS.
The MX2820 System supports the following rr modifiers:
TIDThe “TID” on page 2-3 identifies the target NE for the command.
The TID should match the Source Identifier (SID) value
assigned to the NE, or be NULL. A NULL value matches the NE
processing the command. If not specified, a NULL value is
assigned.
AIDThe AID indicates the entity or location of the entity within the
targeted NE. For applicable AIDs, refer to “Section 3, ADTRAN
AID Formats”.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
MONTYPEThe MONTYPE parameter indicates the type of PM threshold
being retrieved.
The MONTYPE of a given threshold is the MONTYPE of the
associated performance monitoring value (refer to “Appendix F,
Performance Monitoring Codes”) with “-HT” appended to the
end. For example, the MONTYPE for the threshold for the T1
loss-of-signal is “LOSS-L-HT”.
THLEVThe Threshold Level (THLEV) parameter indicates the threshold
value that applies to the PM (MONTYPE) parameter. For
applicable values, refer to the “Transmission Entity Data
Parameter Tables” on page 5-10.
LOCNFor the LOCN, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
TMPERFor the TMPER parameter, refer to “Appendix A, Input
Commands Data Dictionary” for additional information.
The (^^^"<error description>" <cr> <lf>) and (^^^/*error text*/ <cr> <lf>) error response
blocks are optional and, if desired, multiple repetitions are allowed.
Refer to “Appendix A, Input Commands Data Dictionary” for input parameter descriptions.
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D5-9
MX2820 System TL1 Reference Guide
TRANSMISSION ENTITY DATA PARAMETER TABLES
Table 5-1 through Table 5-9 provide the data parameters (attributes) that apply to the
<specific data block> field for the ED-rr and RTRV-rr commands.
For the MX2820 System, the supported rr modifiers are as follows:
•EQPT
•STS1
•T1
•T3
•VT1
Table 5-1. SCU (P/N 1186003Lx) EQPT Data Provisioning Parameters
AID: 1-EQPT-SCU
ParameterOptionsDescription
Read Only
ETH_LINK_STATDOWN
UP
ERROR
FAILURE_CNT2 - 5This read-only parameter is used to indicate how
LOCKOUT_TIME3 - 60If a user is locked out, this read-only parameter
SSHKEYSIZE512 - 2048 (1024)This parameter indicates the size of current SSH
SSHGENSTATIDLE
RSA
DSS
Read/Write
ALARM_CHRONDESCENDING
ASCENDING
AUTO_LOGOFFDISABLE
ENABLE
AUTO_LOGOFF_TIME1 - 60 (30)This parameter sets how long it takes for autol-
This read only parameters indicates the state of
the Ethernet link.
many times a login has failed.
is used to indicate how many seconds the user
will remain locked out.
keys.
This parameter indicates the current status of
SSH key generation.
This parameter sets the order alarms are
displayed in the alarm log.
This parameter enables/disables the auto logoff
functionality.
ogoff to kick in if it is enabled.
AUX1_COND_CODE11-character string
(AUX1)
AUX1_DESC16-character string
(AUX #1 INPUT)
Note: Defaults are in bold type.
5-1061186003L1-35D
This parameter is the TL1 condition code for
AUX1.
This parameter is the condition description of
AUX1.
Table 5-1. SCU (P/N 1186003Lx) EQPT Data Provisioning Parameters
AID: 1-EQPT-SCU (Continued)
ParameterOptionsDescription
REM_LVLINFO
ALERT
MINOR
MAJOR
CRITICAL
SS_ENABLEDISABLE
ENABLE
SSHGENSIZE512 - 2048 (1024)This parameter sets the size of SSH keys to
TRAP_ENABLEDISABLE
ENABLE
Write Only
SSHGENKEYGENERATEThis parameter initiates the generation of SSH
Note: Defaults are in bold type.
This parameters sets the reported alarm level for
a Service Affecting card removal alarm.
This parameter allows Smart Start to be
enabled/disabled.
generate. The size must be a multiple of eight.
This parameter allows SNMP traps to be
enabled/disabled.
keys.
Table 5-2. DS3 MUX (P/N 1186002Lx) EQPT Data Provisioning Parameters
AID:1-EQPT-(MUX1-MUX9)-(A or B)
ParameterOptionsDescription
Read Only
ALARMSEVERITY0 - 31Bit assignments are as follows (where logic 1
indicates the condition is present and logic 0
indicates that the condition is not present):
Info = Bit 0 (LSB)
Alert = Bit 1
Minor = Bit 2
Major = Bit 3
Critical = Bit 4 (MSB)
APPSWCHECKSUM4-character stringThe application software checksum for the card.
APPSWVERSION8-character stringThe application software version for the card.
BOOTSWCHECKSUM4-character stringThe boot software checksum for the card.
BOOTSWVERSION8-character stringThe boot software version for the card.
DIAGBERTCOUNT0 - 0xFFFFFFFFThis variable indicates the number of errors
accumulated during a BERT-type test.
DIAGBERTSYNCNOSYNC
SYNC
Note: Defaults are in bold type.
This variable indicates the synchronization
status during a BERT-type test.
61186003L1-35D5-13
MX2820 System TL1 Reference Guide
Table 5-2. DS3 MUX (P/N 1186002Lx) EQPT Data Provisioning Parameters
AID:1-EQPT-(MUX1-MUX9)-(A or B) (Continued)
ParameterOptionsDescription
PRODCLEICODE11-character stringThe ADTRAN product CLEI code for the card.
PRODSERIALNUMBER25-character stringThe ADTRAN product serial number for the card.
PRODUCTNAME12-character stringThe ADTRAN product name for the card.
PROTECTIONMODENONE
CIRCUIT
This variable indicates the protection mode of the
card.
SELFTEST21-character stringThe software self-test results for the card.
SLOTUPTIME0 - 0xFFFFFFFFThe time (in hundredths of a second) since the
card was powered up.
SWITCHCOUNT0 - 255This variable returns the current protection
switch count that is used as a basis for the Max
Switch Threshold alarm.
Read/Write
ACTIVECARDCARDA
CARDB
AUTOSAVEDISABLE
ENABLE
This variable sets/indicates the active module in
the module pair.
This variable is used when configuring the Autosave feature. When enabled, the provisioning is
automatically saved to non-volatile memory in
response to a change in provisioning.
CARDPAIRID12-character string
(MX2820 M13)
DIAGSELECTBERTPATTQRSS
ALL1
This variable is used to identify a particular
module pair.
This variable indicates the number of errors
accumulated during a BERT-type test.
ALL0
TWOINEIGHT
ONEINEIGHT
TWOTOFIFTEENTHINV
Table 5-9. Clock Card (P/N 1186004Lx) EQPT Data Provisioning Parameters
AID: 1-EQPT-CLK-(A or B) (Continued)
ParameterOptionsDescription
CARDPAIRID12-character string
(MX2820 SMC)
PRVACTIVEREFPRIMARY
SECONDARY
This variable is used to identify a particular
module pair.
This variable sets the active card in a redundant
system.
MAXNUMSWITCHES1 - 24 (3)This variable sets the maximum number of
protection switches allowed within a 1 hour
period. If the threshold is met, then the unit
issues an alarm and suppresses automatic
protection switches for the next 24 hours.
MINSWITCHPERIOD0 - 3600 (10)This variable sets the minimum number of
seconds allowed between automatic protection
switches.
AUTOSAVEDISABLE
ENABLE
This variable is used when configuring the Auto-
save feature. When enabled, the provisioning is
automatically saved to non-volatile memory
when a change in provisioning occurs.
PRVEQUIPSERVSTATEIS
OOS
AUTOREFSWITCHENABLE
DISABLE
This variable sets the provisioned service state of
the Equipment entity.
This variable is used to enable or disable
automatic clock reference protection switching.
AUTOCARDSWITCHENABLE
DISABLE
TIMINGMODEEXTERNAL
HOLDOVER
TIMINGTYPESFESF
ALLONES
TERMINATIONMODEENABLE
DISABLE
PRICLKALARMENABLE
DISABLE
SECCLKALARMENABLE
DISABLE
Note: Defaults are in bold type.
This variable is used to enable or disable
automatic card protection switching.
This variable sets the clock card to synchronize
to either of the external clock references or
operate in hold over.
This variable enables and disabled AIS detection
on the incoming clock references. It can be used
for debugging purposes.
This variable specifies if the clock card pair will
provide line termination for the incoming bits
clock inputs or if another timing destination will
be responsible for termination.
This variable sets whether the Primary Clock
reference
failure alarm is enabled or disabled (inhibited).
This variable sets whether the Secondary Clock
reference
failure alarm is enabled or disabled (inhibited).
61186003L1-35D5-31
MX2820 System TL1 Reference Guide
Table 5-9. Clock Card (P/N 1186004Lx) EQPT Data Provisioning Parameters
AID: 1-EQPT-CLK-(A or B) (Continued)
ParameterOptionsDescription
Write Only (Used to initiate an operation)
LOADFACTORY-DEFAULT1The card's default provisioning data will be
loaded when this variable is set.
CARDRESET1Setting this variable forces the card to reboot.
SAVEPROV1This setting saves the current provisioning data
to non-volatile memory.
CLEARSWITCHCOUNT1Setting this variable will reset to zero the protec-
tion switch count that is used as a basis for the
Max Switch Threshold alarm.
Note: Defaults are in bold type.
5-3261186003L1-35D
Section 6
Security TL1 Commands
INTRODUCTION
The Security TL1 commands allow an administrator to delete, edit, enter (add), and retrieve
security information for a user account. The following Security TL1 commands apply to the
MX2820 System:
• “DLT-USER-SECU” on page 6-2
• “ED-USER-SECU” on page 6-4
• “ENT-USER-SECU” on page 6-6
• “RTRV-USER-SECU” on page 6-8
61186003L1-35D6-1
MX2820 System TL1 Reference Guide
DLT-USER-SECU
The DLT-USER-SECU (Delete-User-Security) command allows an administrator to delete the
security parameters associated with a user account.
Minimum User Access Privilege
ADMIN
Input Format
DLT-USER-SECU:[<TID>]:<UID>:[<CTAG>];
Example:
DLT-USER-SECU:HTVLALEXD16:USER1:8;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
UIDThe UID indicates the User ID or logon name for the user. The
UID takes the place of the AID for this TL1 command format.
Refer to “Appendix A, Input Commands Data Dictionary” for
additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D6-5
MX2820 System TL1 Reference Guide
ENT-USER-SECU
The ENT-USER-SECU (Enter-User-Security) command allows an administrator to enter (add)
security parameters to a user account. The command assigns a user ID, a password, and a
user access privilege for a new user to the MX2820 System.
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D6-7
MX2820 System TL1 Reference Guide
RTRV-USER-SECU
The RTRV-USER-SECU (Retrieve-User-Security) command allows an administrator to retrieve
security parameters, except for the user's password, associated with a user account.
Minimum User Access Privilege
ADMIN
Input Format
RTRV-USER-SECU:[<TID>]::[<CTAG>];
Example:
RTRV-USER-SECU:HTVLALEXD16::27;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D6-9
MX2820 System TL1 Reference Guide
This page is intentionally blank.
6-1061186003L1-35D
Section 7
Surveillance TL1 Commands
INTRODUCTION
The following Surveillance TL1 commands apply to the MX2820 System:
• “ALW-MSG” on page 7-2
• “INH-MSG” on page 7-4
• “RTRV-ALM” on page 7-6
• “RTRV-ALM-ENV” on page 7-8
• “RTRV-COND” on page 7-11
• “RTRV-HDR” on page 7-13
• “RTRV-PM-rr” on page 7-15
• “RTRV-PMSCHED-rr” on page 7-17
• “RTRV-SYS” on page 7-19
• “RTRV-VER” on page 7-21
• “RTRV-VERSION” on page 7-23
• “SCHED-PMREPT-rr” on page 7-25
61186003L1-35D7-1
MX2820 System TL1 Reference Guide
ALW-MSG
The ALW-MSG (Allow-Message) command enables a NE to transmit autonomous messages to
an Operations System (OS).
This command has the following format for the command verb:
ALW-MSG-{EQPT|rr|ALL}
The valid values for rr as the second modifier are as follows:
•T1
•T3
•STS1
•VT1
The value entered for the <NTFCNCDE> parameter determines which autonomous message
alarms are sent by the NE.
The INH-MSG (Inhibit-Message) command inhibits the transmission of Autonomous messages
to an OS. Refer to the INH-MSG commands in this section for additional information.
Refer to “Appendix E, Autonomous Messages” for additional information.
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D7-5
MX2820 System TL1 Reference Guide
RTRV-ALM
The RTRV-ALM (Retrieve-Alarm) TL1 command instructs an NE to retrieve and send the
current status of its alarm conditions associated with one or more of its entities.
The command can be used to retrieve NE information, which in turn can be used to update an
OS database when it is suspected that autonomous alarm messages issued by the NE were
not received or properly processed. This command can also be used to evaluate the system
before or after NE maintenance operations.
The command has the following format for the command verb:
RTRV-ALM-{EQPT|rr|ALL}
The valid values for rr as the second modifier are as follows:
•T1
•T3
•STS1
•VT1
Environmental alarms are not expected in response to the RTRV-ALM command. The RTRV-
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
61186003L1-35D7-7
MX2820 System TL1 Reference Guide
RTRV-ALM-ENV
The RTRV-ALM-ENV (Retrieve Alarm Environment) command requests that an NE or office
environment monitor retrieve specified, outstanding environmental alarms. The command can
be used to retrieve NE information, which in turn can be used to update an OS environmental
alarm database.
The following environmental alarms apply to the MX2820 System:
•PWRA (Power A)
•PWRB (Power B)
• AUX1 (Auxiliary Alarm Input #1)
• AUX2 (Auxiliary Alarm Input #2)
• AUX3A (Auxiliary Alarm Input #3A)
• AUX3B (Auxiliary Alarm Input #3B)
Environmental Alarm Summary
Table 7-1 provides an environmental alarm summary for the MX2820 System.
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
AIDThe AID identifies the entity within the NE or office from which
information is being retrieved. For this command, the AID
format is unit-group-slot or ALL. ALL is the default value for the
AID parameter. Refer to “Section 3, ADTRAN AID Formats” for
additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
NTFCNCDEFor the NTFCNCDE, refer to “Appendix A, Input Commands
Data Dictionary” for additional information.
ALMTYPEFor the Alarm Type (ALMTYPE), refer to “Appendix A, Input
Commands Data Dictionary” for additional information.
Response Format
Acknowledgment
IP^<CTAG> <cr> <lf>
<
Example:
IP 20
<
Normal Response
The following format applies if no outstanding alarms satisfy the request:
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
7-1061186003L1-35D
Section 7, Surveillance TL1 Commands - RTRV-COND
RTRV-COND
The RTRV-COND (Retrieve Condition) command instructs an NE to return the current
standing condition or state associated with one or more equipment units, transmission types,
or test access within the NE. An alternate use for this command is to instruct an NE to
retrieve all the AIDs associated with a specified condition or state in the <TYPEREQ>
parameter.
This command has the following format for the command verb:
RTRV-COND-{EQPT|rr|ALL}
The valid values for rr as the second modifier are as follows:
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
AIDThe AID identifies the entity within the NE or office from which
information is being retrieved. For this command, the AID
format is unit-group-slot or ALL. ALL is the default value for the
AID parameter. Refer to “Section 3, ADTRAN AID Formats” for
additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
TYPEREQFor the TYPEREQ parameter, refer to “Appendix A, Input
Commands Data Dictionary” for additional information.
LOCNFor the LOCN, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
61186003L1-35D7-11
MX2820 System TL1 Reference Guide
Response Format
Acknowledgment
IP^<CTAG> <cr> <lf>
<
Example:
IP 22
<
Normal Response
If there are no conditions to report, the format is as follows:
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
7-1261186003L1-35D
Section 7, Surveillance TL1 Commands - RTRV-HDR
RTRV-HDR
The RTRV-HDR (Retrieve-Header) command instructs the NE to reply with a normal response
that indicates COMPLD. The information of interest is the reply itself along with information
the NE has about itself that includes the <SID>, the <DATE>, the <TIME>, and the SCU
software release.
Minimum User Access Privilege
READONLY
Input Format
RTRV-HDR:[<TID>]::[<CTAG>];
Example:
RTRV-HDR:HTVLALEXD16::23;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Refer to “Appendix B, Response Messages Data Dictionary” for Normal Response and Error
Response parameter descriptions.
7-1461186003L1-35D
Section 7, Surveillance TL1 Commands - RTRV-PM-rr
RTRV-PM-rr
The RTRV-PM-rr (Retrieve Performance Monitoring rr) command instructs an NE to send its
current set of Performance Monitoring (PM) data for the type specified by rr.
The valid values for rr as the second modifier are as follows:
•T1
•T3
•STS1
•VT1
The data can be used to load an OS or audit an OS database when it is suspected that Autonomous PM messages were not received or properly processed. This command can also be used
to evaluate the system before or after NE maintenance operations.
The RTRV-PMSCHED (Retrieve Performance Monitoring Schedule) command instructs an NE
to send the PM reporting schedule that was set with the SCHED-PMREPT-rr command.
This command has the following format the command verb:
RTRV-PMSCHED-{rr|ALL}
The valid values for rr as the second modifier are as follows:
•T1
•T3
•STS1
•VT1
Minimum User Access Privilege
READONLY
Input Format
RTRV-PMSCHED-{rr|ALL}:[<TID>]:[<AID>]:[<CTAG>];
Example:
RTRV-PMSCHED-T3:HTVLALEXD16:1-T3-MUX3-1:25;
Input Parameters
TIDThe TID identifies the target NE for the command. Refer to the
“TID” on page 2-3 for additional information.
AIDThe AID parameter identifies the entity within the NE from
which the information is being retrieved. Refer to “Section 3,
ADTRAN AID Formats” for additional information.
CTAGFor the CTAG, refer to “Appendix A, Input Commands Data
Dictionary” for additional information.
Response Format
Acknowledgment
IP^<CTAG> <cr> <lf>
<
Example:
IP 25
<
61186003L1-35D7-17
MX2820 System TL1 Reference Guide
Normal Response
If a schedule does not exist, the following format applies: