Specifications
1-4
Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Guide, R3.3
May 2002
Chapter 1 Getting Started
TL1 Command Syntax
1.2 TL1 Command Syntax
TL1 commands conform to the following syntax:
a:b:c:d:e: ... z;
where:
“a” is the command code
“b” is the target identifier (TID)
“c” is the access identifier (AID) or the user identifier (UID)
“d” is the correlation tag (CTAG)
“e: ... z;” are other positions required for various commands
The TID, AID, and CTAG route and control the TL1 command. Other parameters provide additional
information required to complete the action requested by the command. TL1 command codes, parameter
names and parameter values can be either uppercase or lowercase exclusively or any combination of the
two, unless specifically noted in the command description.
The TID is a unique name given to each system when it is installed. The name identifies the particular
NE (in this case, the ONS 15454 or ONS 15327), to which each command is directed. Each TID can have
a maximum of 20 ASCII characters limited to letters, digits, and hyphens, but each TID must start with
an alphabetic character. The presence of the TID is required in all input commands, but its value can be
null (represented by two successive colons). The TID can be null when the operating system directly
communicates with the target NE. The recommended value for the TID, when it is used, is the target’s
CLLI code. To establish the TID for an ONS 15454/15327 node, use the Provisioning > General tabs in
CTC.
Note If the TID contains any characters other than letters and digits, such as spaces, the text string form
(enclosed in double quotes) must be used.
The AID is an access code used to identify and address specific objects within the ONS
15454/ONS 15327. These objects include individual pieces of equipment, transport spans, access
tributaries, and other objects.
The CTAG is a unique identifier given to each input command by the operator. When the
ONS 15454/ONS 15327 system responds to a specific command, it includes the command’s CTAG in
the reply. Including the CTAG eliminates discrepancies about which response corresponds to which
command. Valid CTAG values include strings of up to six characters comprised of identifiers
(alphanumeric, beginning with a letter) or decimal numerals (a string of decimal digits with an optional
non-trailing “.”).
The following specification characters are used throughout this document as a vehicle for defining the
syntax:
• < > enclose a symbol specifier, for example <CTAG>.
• [ ] enclose an optional symbol, for example [<TID>].
• “ ” enclose a literal character, for example an output format
“SLOT-7:PLUGIN,TC,,,,,,,:\“EQUIPMENT PLUG-IN\”,TCC”
• ^ is a space, a literal blank character used only in examples of messages.