Specifications
3-164
Cisco ONS 15454 and Cisco ONS 15327 TL1 Command Guide, R3.3
May 2002
Chapter 3 TL1 Command Descriptions
TL1 Commands
3.5.115 RTRV-PTHTRC-<STS_PATH>: Retrieve Path Trace (STS1, STS3C, STS6C,
STS9C, STS12C, STS24C, STS48C, STS192C)
(STS192C supported for ONS 15454 only)
This command instructs a SONET NE to retrieve the contents of the SONET path trace message that is
transported in the J1 byte of the SONET STS Path.
The path trace message is a 64-character string with the last two characters reserved for the terminating
CR (carriage return) and the LF (line feed). The message can be an incoming path trace message, an
expected incoming path trace message, or an outgoing path trace message which is inserted into the path
overhead of the outgoing signal.
The path trace mode has three modes: OFF, MANUAL, and AUTO. The path trace mode defaults to OFF
mode. The MANUAL mode performs the comparison of the received string with the user-entered
expected string. The AUTO mode performs the comparison of the present received string with an
expected string set to a previously received string. If there is a mismatch, the TIM-P alarm is raised.
When the path trace mode is in OFF mode, there is no path trace processing, and all the alarm and state
conditions are reset.
When the expected string is queried under the OFF path trace mode, the expected string is a copy of the
provisioned string or NULL. When an expected string is queried under the MANUAL path trace mode,
the expected string is a copy of the user-entered string. When an expected string is queried under the
AUTO path trace mode, the expected string is a copy of the acquired received string or NULL if the
string has not been acquired.
When the incoming string is queried under the OFF path trace mode, the incoming string is NULL. When
an incoming string is queried under the MANUAL or AUTO path trace mode, the incoming string is a
copy of the received string or NULL if the string has not been received.
Output Format SID DATE TIME
M CTAG COMPLD
“<AID>:[<LOCN>],<MODETYPE>”
;
where:
• <AID> identifies the entity from where the PM mode is being retrieved; <AID>
is from the “STS” section on page 4-12
• <LOCN> identifies the location from where the PM mode is being retrieved;
valid values for <LOCN> are shown in the “LOCATION” section on page 4-42.
<LOCN> is optional.
• <MODETYPE> identifies whether or not the PM mode type is turned on or off;
valid values for <MODETYPE> are shown in the “PM_MODE” section on
page 4-52
Output
Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
“STS-4-2:NEND,P”
;
Errors This message generates all the default errors
Section RTRV-PMMODE-<STS_PATH> Description (continued)