-
Cisco ONS SONET TL1 Command Guide, Release 7.2
-
About this Guide
-
Chapter 1, ACT Commands
-
Chapter 2, ALW Commands
-
Chapter 3, APPLY Commands
-
Chapter 4, CANC Commands
-
Chapter 5, CHG Commands
-
Chapter 6, CLR Commands
-
Chapter 7, CONN Commands
-
Chapter 8, COPY Commands
-
Chapter 9, DISC Commands
-
Chapter 10, DLT Commands
-
Chapter 11, ED Commands
-
Chapter 12, ENT Commands
-
Chapter 13, EX Commands
-
Chapter 14, INH Commands
-
Chapter 15, INIT Commands
-
Chapter 16, OPR Commands
-
Chapter 17, REPT Commands
-
Chapter 18, RLS Commands
-
Chapter 19, RMV Commands
-
Chapter 20, RST Commands
-
Chapter 21, RTRV Commands
-
Chapter 22, SCHED Commands
-
Chapter 23, SET Commands
-
Chapter 24, SW Commands
-
Chapter 25, Access Identifiers
-
Chapter 26, Conditions
-
Chapter 27, Modifiers
-
Table Of Contents
21.23 RTRV-BULKROLL-<OCN_TYPE>
21.42 RTRV-FFP-<MOD2DWDMPAYLOAD>
21.82 RTRV-PROTNSW-<MOD2DWDMPAYLOAD>
RTRV Commands
Note
The terms "Unidirectional Path Switched Ring" and "UPSR" may appear in Cisco literature. These terms do not refer to using Cisco ONS 15xxx products in a unidirectional path switched ring configuration. Rather, these terms, as well as "Path Protected Mesh Network" and "PPMN," refer generally to Cisco's path protection feature, which may be used in any topological network configuration. Cisco does not recommend using its path protection feature in any particular topological network configuration.
This chapter provides retrieve (RTRV) commands for the Cisco ONS 15454, ONS 15327, ONS 15310-CL, ONS 15310-MA, and ONS 15600.
21.1 RTRV-<MOD1FCPAYLOAD>
(Cisco ONS 15454) The Retrieve 1GFC or 2GFC (RTRV-<MOD1FCPAYLOAD>) command retrieves the attributes related with the Fibre Channel port.
Usage Guidelines
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
Ports
Security
Retrieve
Input Format
RTRV-<MOD1FCPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-1GFC:CISCO:FAC-6-1:888;
Input Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:LINKRATE=<LINKRATE>,LINKSTATE=<LINKSTATE>,
[LINKRCVRY=<LINKRCVRY>],[DISTEXTN=<DISTEXTN>],
[LINKCREDITS=<LINKCREDITS>],[MFS=<MFS>],[ENCAP=<ENCAP>],[NAME=<NAME>],
[SOAK=<SOAK>],[SOAKLEFT=<SOAKLEFT>],[FREQ=<FREQ>],[LOSSB=<LOSSB>]:
<PST_PSTQ>,[<SST>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-1-1:,,WORK,ACT:LINKRATE=1GFC,LINKSTATE=UP,LINKRCVRY=Y,
DISTEXTN=NONE,LINKCREDITS=0,MFS=2148,ENCAP=GFP-T,
NAME=\"FC PORT\",SOAK=32,SOAKLEFT=\"12-25\",FREQ=1550,
LOSSB=LR-1:OOS-MA,MT"
;Output Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
<ROLE>
(Optional) The port role in Y-cable protection (WORK or PROT). The parameter type is SIDE, which is the role the unit is playing in the protection group
•
The entity is a protection unit in the protection group.
•
The entity is a working unit in the protection group.
<STATUS>
(Optional) A port status in Y-cable protection (ACT or STBY). The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<LINKRATE>
The actual rate running on the Fibre Channel port. It can differ from the payload type provisioned. The parameter type is LINKRATE, which is the link rate on a Fibre Channel port.
•
The rate is 1 G Fibre Channel.
•
The rate is 1 G FICON.
•
The rate is 2 G Fibre Channel.
•
The rate is 2 G FICON.
•
The rate is unknown.
•
The Small Form-factor Pluggable (SFP) is not plugged into the Fibre Channel port, so the link rate cannot be detected.
<LINKSTATE>
Link state. The parameter type is DIRN, which specifies the discriminating level for the requested monitored parameter.
•
Monitored parameter with values equal to or greater than the level of LEV will be reported.
•
Monitored parameter with values equal or less than the value of LEV will be reported.
<LINKRCVRY>
Link recovery. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<DISTEXTN>
(Optional) Distance extension. The parameter type is DISTANCE_EXTENSION (distance extension).
•
Buffer to buffer flow control
•
No distance extension
<LINKCREDITS>
(Optional) Number of link credits. LINKCREDITS is an integer.
<MFS>
(Optional) Maximum frame size. MFS is an integer.
<ENCAP>
(Optional) Frame encapsulation type. The parameter type is ENCAP (frame encapsulation type).
•
Generic framing procedure (GFP) frame mode
•
GFP transparent mode
•
High-level data link control (HDLC) frame mode
•
HDLC LAN extension frame mode
•
HDLC X.86 frame mode
<NAME>
(Optional) Identifies the port name. NAME is a string.
<SOAK>
(Optional) OOS-AINS to IS transition soak time as measured in 15-minute intervals. SOAK is an integer.
<SOAKLEFT>
(Optional) Time remaining for the transition from OOS-AINS to IS measured in 1 minute intervals. The format is HH-MM where HH ranges from 00 to 48 and MM ranges from 00 to 59. Rules for <SOAKLEFT> are as follows:
•
•
•
<FREQ>
(Optional) Parameter type is OPTICAL_WLEN (optical wavelength).
•
Wavelength 1310
•
Wavelength 1470
•
Wavelength 1490
•
Wavelength 1510
•
Wavelength 1529.55
•
Wavelength 1529.94
•
Wavelength 1530
•
Wavelength 1530.33
•
Wavelength 1530.73
•
Wavelength 1531.12
•
Wavelength 1531.51
•
Wavelength 1531.90
•
Wavelength 1532.29
•
Wavelength 1532.68
•
Wavelength 1533.07
•
Wavelength 1533.47
•
Wavelength 1533.86
•
Wavelength 1534.25
•
Wavelength 1534.64
•
Wavelength 1535.04
•
Wavelength 1535.43
•
Wavelength 1535.82
•
Wavelength 1536.22
•
Wavelength 1536.61
•
Wavelength 1537
•
Wavelength 1537.40
•
Wavelength 1537.79
•
Wavelength 1538.19
•
Wavelength 1538.58
•
Wavelength 1538.98
•
Wavelength 1539.37
•
Wavelength 1539.77
•
Wavelength 1540.16
•
Wavelength 1540.56
•
Wavelength 1540.95
•
Wavelength 1541.35
•
Wavelength 1541.75
•
Wavelength 1542.14
•
Wavelength 1542.35
•
Wavelength 1542.54
•
Wavelength 1542.94
•
Wavelength 1543.33
•
Wavelength 1543.73
•
Wavelength 1544.13
•
Wavelength 1544.53
•
Wavelength 1544.92
•
Wavelength 1545.32
•
Wavelength 1545.72
•
Wavelength 1546.12
•
Wavelength 1546.52
•
Wavelength 1546.92
•
Wavelength 1547.32
•
Wavelength 1547.72
•
Wavelength 1548.12
•
Wavelength 1548.51
•
Wavelength 1548.92
•
Wavelength 1549.32
•
Wavelength 1549.71
•
Wavelength 1500
•
Wavelength 1550.12
•
Wavelength 1550.52
•
Wavelength 1550.92
•
Wavelength 1551.32
•
Wavelength 1551.72
•
Wavelength 1552.12
•
Wavelength 1552.52
•
Wavelength 1552.93
•
Wavelength 1553.33
•
Wavelength 1553.73
•
Wavelength 1554.13
•
Wavelength 1554.13
•
Wavelength 1554.94
•
Wavelength 1555.34
•
Wavelength 1555.75
•
Wavelength 1556.15
•
Wavelength 1556.55
•
Wavelength 1556.96
•
Wavelength 1557.36
•
Wavelength 1557.77
•
Wavelength 1558.17
•
Wavelength 1558.58
•
Wavelength 1558.98
•
Wavelength 1559.39
•
Wavelength 1559.79
•
Wavelength 1560.20
•
Wavelength 1560.61
•
Wavelength 1561.01
•
Wavelength 1561.42
•
Wavelength 1561.83
•
Wavelength 1570
•
Wavelength 1570.83
•
Wavelength 1571.24
•
Wavelength 1571.65
•
Wavelength 1572.06
•
Wavelength 1572.48
•
Wavelength 1572.89
•
Wavelength 1573.30
•
Wavelength 1573.71
•
Wavelength 1574.13
•
Wavelength 1574.54
•
Wavelength 1574.95
•
Wavelength 1575.37
•
Wavelength 1575.78
•
Wavelength 1576.20
•
Wavelength 1576.61
•
Wavelength 1577.03
•
Wavelength 1577.44
•
Wavelength 1577.86
•
Wavelength 1578.27
•
Wavelength 1578.69
•
Wavelength 1579.10
•
Wavelength 1579.52
•
Wavelength 1579.93
•
Wavelength 1580.35
•
Wavelength 1580.77
•
Wavelength 1581.18
•
Wavelength 1581.60
•
Wavelength 1582.02
•
Wavelength 1582.44
•
Wavelength 1582.85
•
Wavelength 1583.27
•
Wavelength 1583.69
•
Wavelength 1584.11
•
Wavelength 1584.53
•
Wavelength 1584.95
•
Wavelength 1585.36
•
Wavelength 1585.78
•
Wavelength 1586.20
•
Wavelength 1586.62
•
Wavelength 1587.04
•
Wavelength 1587.46
•
Wavelength 1587.88
•
Wavelength 1588.30
•
Wavelength 1588.73
•
Wavelength 1589.15
•
Wavelength 1589.57
•
Wavelength 1589.99
•
Wavelength 1590
•
Wavelength 1590.41
•
Wavelength 1590.83
•
Wavelength 1591.26
•
Wavelength 1591.68
•
Wavelength 1592.10
•
Wavelength 1592.52
•
Wavelength 1592.95
•
Wavelength 1593.37
•
Wavelength 1593.79
•
Wavelength 1594.22
•
Wavelength 1594.64
•
Wavelength 1595.06
•
Wavelength 1595.49
•
Wavelength 1596.34
•
Wavelength 1596.76
•
Wavelength 1597.19
•
Wavelength 1597.62
•
Wavelength 1598.04
•
Wavelength 1598.47
•
Wavelength 1598.89
•
Wavelength 1599.32
•
Wavelength 1599.75
•
Wavelength 1600.06
•
Wavelength 1601.03
•
Wavelength 1601.46
•
Wavelength 1601.88
•
Wavelength 1602.31
•
Wavelength 1602.74
•
Wavelength 1603.17
•
Wavelength 1603.60
•
Wavelength 1604.03
•
Wavelength 1610
•
Use Tunable Wavelength 1
<LOSSB>
(Optional) Parameter type is REACH (reach values).
•
Autoprovisioning
•
Reach CX
•
Reach DX
•
Reach HX
•
Reach I1
•
Reach IR-1
•
Reach IR-2
•
Reach L1
•
Reach L2
•
Reach L3
•
Reach LR-1
•
Reach LR-2
•
Reach LR-3
•
Reach LX
•
Reach S1
•
Reach S2
•
Reach SR
•
Reach SR-1
•
Reach SX
•
Reach T
•
Reach VX
•
Reach ZX
<PST_PSTQ>
Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SST>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.2 RTRV-<MOD1FICONPAYLOAD>
(Cisco ONS 15454) The Retrieve 1GFICON or 2GFICON (RTRV-<MOD1FICONPAYLOAD>) command returns Fibre Channel-specific settings for ports that have been configured to carry FICON traffic using the ENT-FICON command.
Usage Guidelines
The MXPP_MR_2.5G card only supports the GFP-T frame type.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
Ports
Security
Retrieve
Input Format
RTRV-<MOD1FICONPAYLOAD>:[<TID>]:<AID>:<CTAG>;
Input Example
RTRV-1GFICON:CISCO:FAC-1-1:123;
Input Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:[LINKRATE=<LINKRATE>],[LINKSTATE=<LINKSTATE>],
[LINKRCVRY=<LINKRCVRY>],[DISTEXTN=<DISTEXTN>],
[LINKCREDITS=<LINKCREDITS>],[MFS=<MFS>],[ENCAP=<ENCAP>],[NAME=<NAME>],
[SOAK=<SOAK>],[SOAKLEFT=<SOAKLEFT>],[FREQ=<FREQ>],[LOSSB=<LOSSB>]:
<PST_PSTQ>,<SST>"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-1-1:,,WORK,ACT:LINKRATE=1GFICON,LINKSTATE=UP,LINKRCVRY=Y,
DISTEXTN=NONE,LINKCREDITS=0,MFS=2148,ENCAP=GFP-T,NAME=\"FC PORT\",
SOAK=32,SOAKLEFT=\"12-25\",FREQ=1550,LOSSB=LR-1:OOS-MA,MT"
;Output Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
<ROLE>
(Optional) The port role in Y-cable protection (WORK or PROT). The parameter type is SIDE, which is the role that the unit is playing in the protection group.
•
The entity is a protection unit in the protection group.
•
The entity is a working unit in the protection group.
<STATUS>
(Optional) A port status in Y-cable protection (ACT or STBY). The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<LINKRATE>
The actual rate running on the Fibre Channel port. It can differ from the payload type provisioned. The parameter type is LINKRATE, which is the link rate on a Fibre Channel port.
•
The rate is 1 G Fibre Channel.
•
The rate is 1 G FICON.
•
The rate is 2 G Fibre Channel.
•
The rate is 2 G FICON.
•
The rate is unknown.
•
The SFP is not plugged into the Fibre Channel port so the link rate cannot be detected.
<LINKSTATE>
Link state. The parameter type is DIRN, which specifies the discriminating level for the requested monitored parameter.
•
Monitored parameter with values equal to or greater than the level of LEV will be reported.
•
Monitored parameter with values equal or less than the value of LEV will be reported.
<LINKRCVRY>
Link recovery. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<DISTEXTN>
(Optional) Distance extension. The parameter type is DISTANCE_EXTENSION (distance extension).
•
Buffer to buffer flow control
•
No distance extension
<LINKCREDITS>
(Optional) Number of link credits. LINKCREDITS is an integer.
<MFS>
(Optional) Maximum frame size. MFS is an integer.
<ENCAP>
(Optional) Frame encapsulation type. The parameter type is ENCAP (frame encapsulation type).
•
GFP frame mode
•
GFP transparent mode
•
HDLC frame mode
•
HDLC LAN extension frame mode
•
HDLC X.86 frame mode
<NAME>
(Optional) Identifies the port name. NAME is a string.
<SOAK>
(Optional) OOS-AINS to IS transition soak time as measured in 15-minute intervals. SOAK is an integer.
<SOAKLEFT>
(Optional) Time remaining for the transition from OOS-AINS to IS measured in 1 minute intervals. The format is HH-MM where HH ranges from 00 to 48 and MM ranges from 00 to 59. Rules for <SOAKLEFT> are as follows:
•
•
•
<FREQ>
(Optional) Parameter type is OPTICAL_WLEN (optical wavelength).
•
Wavelength 1310
•
Wavelength 1470
•
Wavelength 1490
•
Wavelength 1510
•
Wavelength 1529.55
•
Wavelength 1529.94
•
Wavelength 1530
•
Wavelength 1530.33
•
Wavelength 1530.73
•
Wavelength 1531.12
•
Wavelength 1531.51
•
Wavelength 1531.90
•
Wavelength 1532.29
•
Wavelength 1532.68
•
Wavelength 1533.07
•
Wavelength 1533.47
•
Wavelength 1533.86
•
Wavelength 1534.25
•
Wavelength 1534.64
•
Wavelength 1535.04
•
Wavelength 1535.43
•
Wavelength 1535.82
•
Wavelength 1536.22
•
Wavelength 1536.61
•
Wavelength 1537
•
Wavelength 1537.40
•
Wavelength 1537.79
•
Wavelength 1538.19
•
Wavelength 1538.58
•
Wavelength 1538.98
•
Wavelength 1539.37
•
Wavelength 1539.77
•
Wavelength 1540.16
•
Wavelength 1540.56
•
Wavelength 1540.95
•
Wavelength 1541.35
•
Wavelength 1541.75
•
Wavelength 1542.14
•
Wavelength 1542.35
•
Wavelength 1542.54
•
Wavelength 1542.94
•
Wavelength 1543.33
•
Wavelength 1543.73
•
Wavelength 1544.13
•
Wavelength 1544.53
•
Wavelength 1544.92
•
Wavelength 1545.32
•
Wavelength 1545.72
•
Wavelength 1546.12
•
Wavelength 1546.52
•
Wavelength 1546.92
•
Wavelength 1547.32
•
Wavelength 1547.72
•
Wavelength 1548.12
•
Wavelength 1548.51
•
Wavelength 1548.92
•
Wavelength 1549.32
•
Wavelength 1549.71
•
Wavelength 1500
•
Wavelength 1550.12
•
Wavelength 1550.52
•
Wavelength 1550.92
•
Wavelength 1551.32
•
Wavelength 1551.72
•
Wavelength 1552.12
•
Wavelength 1552.52
•
Wavelength 1552.93
•
Wavelength 1553.33
•
Wavelength 1553.73
•
Wavelength 1554.13
•
Wavelength 1554.13
•
Wavelength 1554.94
•
Wavelength 1555.34
•
Wavelength 1555.75
•
Wavelength 1556.15
•
Wavelength 1556.55
•
Wavelength 1556.96
•
Wavelength 1557.36
•
Wavelength 1557.77
•
Wavelength 1558.17
•
Wavelength 1558.58
•
Wavelength 1558.98
•
Wavelength 1559.39
•
Wavelength 1559.79
•
Wavelength 1560.20
•
Wavelength 1560.61
•
Wavelength 1561.01
•
Wavelength 1561.42
•
Wavelength 1561.83
•
Wavelength 1570
•
Wavelength 1570.83
•
Wavelength 1571.24
•
Wavelength 1571.65
•
Wavelength 1572.06
•
Wavelength 1572.48
•
Wavelength 1572.89
•
Wavelength 1573.30
•
Wavelength 1573.71
•
Wavelength 1574.13
•
Wavelength 1574.54
•
Wavelength 1574.95
•
Wavelength 1575.37
•
Wavelength 1575.78
•
Wavelength 1576.20
•
Wavelength 1576.61
•
Wavelength 1577.03
•
Wavelength 1577.44
•
Wavelength 1577.86
•
Wavelength 1578.27
•
Wavelength 1578.69
•
Wavelength 1579.10
•
Wavelength 1579.52
•
Wavelength 1579.93
•
Wavelength 1580.35
•
Wavelength 1580.77
•
Wavelength 1581.18
•
Wavelength 1581.60
•
Wavelength 1582.02
•
Wavelength 1582.44
•
Wavelength 1582.85
•
Wavelength 1583.27
•
Wavelength 1583.69
•
Wavelength 1584.11
•
Wavelength 1584.53
•
Wavelength 1584.95
•
Wavelength 1585.36
•
Wavelength 1585.78
•
Wavelength 1586.20
•
Wavelength 1586.62
•
Wavelength 1587.04
•
Wavelength 1587.46
•
Wavelength 1587.88
•
Wavelength 1588.30
•
Wavelength 1588.73
•
Wavelength 1589.15
•
Wavelength 1589.57
•
Wavelength 1589.99
•
Wavelength 1590
•
Wavelength 1590.41
•
Wavelength 1590.83
•
Wavelength 1591.26
•
Wavelength 1591.68
•
Wavelength 1592.10
•
Wavelength 1592.52
•
Wavelength 1592.95
•
Wavelength 1593.37
•
Wavelength 1593.79
•
Wavelength 1594.22
•
Wavelength 1594.64
•
Wavelength 1595.06
•
Wavelength 1595.49
•
Wavelength 1596.34
•
Wavelength 1596.76
•
Wavelength 1597.19
•
Wavelength 1597.62
•
Wavelength 1598.04
•
Wavelength 1598.47
•
Wavelength 1598.89
•
Wavelength 1599.32
•
Wavelength 1599.75
•
Wavelength 1600.06
•
Wavelength 1601.03
•
Wavelength 1601.46
•
Wavelength 1601.88
•
Wavelength 1602.31
•
Wavelength 1602.74
•
Wavelength 1603.17
•
Wavelength 1603.60
•
Wavelength 1604.03
•
Wavelength 1610
•
Use Tunable Wavelength 1
<LOSSB>
(Optional) Parameter type is REACH (reach values).
•
Autoprovisioning
•
Reach CX
•
Reach DX
•
Reach HX
•
Reach I1
•
Reach IR-1
•
Reach IR-2
•
Reach L1
•
Reach L2
•
Reach L3
•
Reach LR-1
•
Reach LR-2
•
Reach LR-3
•
Reach LX
•
Reach S1
•
Reach S2
•
Reach SR
•
Reach SR-1
•
Reach SX
•
Reach T
•
Reach VX
•
Reach ZX
<PST_PSTQ>
Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SST>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.3 RTRV-<MOD2DWDMPAYLOAD>
(Cisco ONS 15454) The Retrieve 10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, D1VIDEO, DV6000, ETRCLO, GIGE, HDTV, ISC1, ISC3, or PASSTHRU (RTRV-<MOD2DWDMPAYLOAD>) command retrieves the configuration parameter of a dense wavelength division multiplexing (DWDM) client.
Usage Guidelines
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
DWDM
Security
Retrieve
Input Format
RTRV-<MOD2DWDMPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-HDTV:MILAN:FAC-1-1:100;
Input Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AIDUNIONID>,<AIDTYPE>:,,[<ROLE>],[<STATUS>]:[NAME=<NAME>],[LBCL=<LBCL>],
[OPT=<OPT>],[OPR=<OPR>],[FREQ=<FREQ>],[LOSSB=<LOSSB>]:<PSTPSTQ>,[<SST>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-1-1-1,HDTV:,,WORK,ACT:NAME=\"NY PORT\",LBCL=10.0,OPT=10.0,OPR=10.0,
FREQ=1550,LOSSB=LR-1:OOS-AU,AINS"
;Output Parameters
<AIDUNIONID>
Access identifier from the "25.2 AidUnionId" section on page 25-12
<AIDTYPE>
A type of access identifier. The parameter type is MOD2DWDMPAYLOAD, which contains the payload types applicable to DWDM ports.
•
10-Gigabit Fibre Channel payload
•
10-Gigabit Ethernet
•
1-Gigabit Fibre Channel payload
•
1-Gigabit fiber connectivity (FICON) payload
•
2-Gigabit Fibre Channel payload
•
2-Gigabit FICON payload
•
D1Video payload
•
DV6000 payload
•
ETR_CLO payload
•
Gigabit Ethernet payload
•
High definition television (HDTV) payload
•
ISC1 payload
•
ISC3 payload
•
Any pass-through (2R) payload
<ROLE>
(Optional) The port role in Y-cable protection (WORK or PROT). The parameter type is SIDE, which is the role the unit is playing in the protection group.
•
The entity is a protection unit in the protection group.
•
The entity is a working unit in the protection group.
<STATUS>
(Optional) A port status in Y-cable protection (ACT or STBY). The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<NAME>
(Optional) Identifies the port name. NAME is a string.
<LBCL>
(Optional) Displays the current value of the laser current. LBCL is a float.
<OPT>
(Optional) Displays the current value of the transmitted optical power. OPT is a float.
<OPR>
(Optional) Displays the current value of the received optical power. OPR is a float.
<FREQ>
(Optional) Parameter type is OPTICAL_WLEN (optical wavelength).
•
Wavelength 1310
•
Wavelength 1470
•
Wavelength 1490
•
Wavelength 1510
•
Wavelength 1529.55
•
Wavelength 1529.94
•
Wavelength 1530
•
Wavelength 1530.33
•
Wavelength 1530.73
•
Wavelength 1531.12
•
Wavelength 1531.51
•
Wavelength 1531.90
•
Wavelength 1532.29
•
Wavelength 1532.68
•
Wavelength 1533.07
•
Wavelength 1533.47
•
Wavelength 1533.86
•
Wavelength 1534.25
•
Wavelength 1534.64
•
Wavelength 1535.04
•
Wavelength 1535.43
•
Wavelength 1535.82
•
Wavelength 1536.22
•
Wavelength 1536.61
•
Wavelength 1537
•
Wavelength 1537.40
•
Wavelength 1537.79
•
Wavelength 1538.19
•
Wavelength 1538.58
•
Wavelength 1538.98
•
Wavelength 1539.37
•
Wavelength 1539.77
•
Wavelength 1540.16
•
Wavelength 1540.56
•
Wavelength 1540.95
•
Wavelength 1541.35
•
Wavelength 1541.75
•
Wavelength 1542.14
•
Wavelength 1542.35
•
Wavelength 1542.54
•
Wavelength 1542.94
•
Wavelength 1543.33
•
Wavelength 1543.73
•
Wavelength 1544.13
•
Wavelength 1544.53
•
Wavelength 1544.92
•
Wavelength 1545.32
•
Wavelength 1545.72
•
Wavelength 1546.12
•
Wavelength 1546.52
•
Wavelength 1546.92
•
Wavelength 1547.32
•
Wavelength 1547.72
•
Wavelength 1548.12
•
Wavelength 1548.51
•
Wavelength 1548.92
•
Wavelength 1549.32
•
Wavelength 1549.71
•
Wavelength 1500
•
Wavelength 1550.12
•
Wavelength 1550.52
•
Wavelength 1550.92
•
Wavelength 1551.32
•
Wavelength 1551.72
•
Wavelength 1552.12
•
Wavelength 1552.52
•
Wavelength 1552.93
•
Wavelength 1553.33
•
Wavelength 1553.73
•
Wavelength 1554.13
•
Wavelength 1554.13
•
Wavelength 1554.94
•
Wavelength 1555.34
•
Wavelength 1555.75
•
Wavelength 1556.15
•
Wavelength 1556.55
•
Wavelength 1556.96
•
Wavelength 1557.36
•
Wavelength 1557.77
•
Wavelength 1558.17
•
Wavelength 1558.58
•
Wavelength 1558.98
•
Wavelength 1559.39
•
Wavelength 1559.79
•
Wavelength 1560.20
•
Wavelength 1560.61
•
Wavelength 1561.01
•
Wavelength 1561.42
•
Wavelength 1561.83
•
Wavelength 1570
•
Wavelength 1570.83
•
Wavelength 1571.24
•
Wavelength 1571.65
•
Wavelength 1572.06
•
Wavelength 1572.48
•
Wavelength 1572.89
•
Wavelength 1573.30
•
Wavelength 1573.71
•
Wavelength 1574.13
•
Wavelength 1574.54
•
Wavelength 1574.95
•
Wavelength 1575.37
•
Wavelength 1575.78
•
Wavelength 1576.20
•
Wavelength 1576.61
•
Wavelength 1577.03
•
Wavelength 1577.44
•
Wavelength 1577.86
•
Wavelength 1578.27
•
Wavelength 1578.69
•
Wavelength 1579.10
•
Wavelength 1579.52
•
Wavelength 1579.93
•
Wavelength 1580.35
•
Wavelength 1580.77
•
Wavelength 1581.18
•
Wavelength 1581.60
•
Wavelength 1582.02
•
Wavelength 1582.44
•
Wavelength 1582.85
•
Wavelength 1583.27
•
Wavelength 1583.69
•
Wavelength 1584.11
•
Wavelength 1584.53
•
Wavelength 1584.95
•
Wavelength 1585.36
•
Wavelength 1585.78
•
Wavelength 1586.20
•
Wavelength 1586.62
•
Wavelength 1587.04
•
Wavelength 1587.46
•
Wavelength 1587.88
•
Wavelength 1588.30
•
Wavelength 1588.73
•
Wavelength 1589.15
•
Wavelength 1589.57
•
Wavelength 1589.99
•
Wavelength 1590
•
Wavelength 1590.41
•
Wavelength 1590.83
•
Wavelength 1591.26
•
Wavelength 1591.68
•
Wavelength 1592.10
•
Wavelength 1592.52
•
Wavelength 1592.95
•
Wavelength 1593.37
•
Wavelength 1593.79
•
Wavelength 1594.22
•
Wavelength 1594.64
•
Wavelength 1595.06
•
Wavelength 1595.49
•
Wavelength 1596.34
•
Wavelength 1596.76
•
Wavelength 1597.19
•
Wavelength 1597.62
•
Wavelength 1598.04
•
Wavelength 1598.47
•
Wavelength 1598.89
•
Wavelength 1599.32
•
Wavelength 1599.75
•
Wavelength 1600.06
•
Wavelength 1601.03
•
Wavelength 1601.46
•
Wavelength 1601.88
•
Wavelength 1602.31
•
Wavelength 1602.74
•
Wavelength 1603.17
•
Wavelength 1603.60
•
Wavelength 1604.03
•
Wavelength 1610
•
Use Tunable Wavelength 1
<LOSSB>
(Optional) Parameter type is REACH (reach values).
•
Autoprovisioning
•
Reach CX
•
Reach DX
•
Reach HX
•
Reach I1
•
Reach IR-1
•
Reach IR-2
•
Reach L1
•
Reach L2
•
Reach L3
•
Reach LR-1
•
Reach LR-2
•
Reach LR-3
•
Reach LX
•
Reach S1
•
Reach S2
•
Reach SR
•
Reach SR-1
•
Reach SX
•
Reach T
•
Reach VX
•
Reach ZX
<PST_PSTQ>
Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SST>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.4 RTRV-<MOD_RING>
(Cisco ONS 15454, ONS 15327, ONS 15600) The Retrieve Bidirectional Line Switched Ring (RTRV-<MOD_RING>) command retrieves the bidirectional line switched ring (BLSR) information of the NE. A two-fiber or four-fiber BLSR can be retrieved.
Note
Usage Guidelines
Output examples:
4F BLSR:
"BLSR-N43AB::RINGID=N43AB,NODEID=3,MODE=4F,RVRTV=Y,RVTM=5.0,SRVRTV=Y,
SRVTM=5.0,EASTWORK=FAC-5-1,WESTWORK=FAC-6-1,EASTPROT=FAC-12-1,
WESTPROT=FAC-13-1"2F BLSR:
"BLSR-N12EF::RINGID=N12EF,NODEID=2,MODE=2F,RVRTV=Y,RVTM=5.0,
EASTWORK=FAC-5-1,WESTWORK=FAC-6-1"•
–
–
–
•
•
•
Category
BLSR
Security
Retrieve
Input Format
RTRV-<MOD_RING>:[<TID>]:[<AID>]:<CTAG>[::::];
Input Example
RTRV-BLSR:PETALUMA:ALL:123;
Input Parameters
<AID>
Access identifier from the "25.3 AidUnionId1" section on page 25-17. Identifies the BLSR of the NE. Only ALL, null, or a list of BLSR-# is allowed. A null value is equivalent to ALL.
Output Format
SID DATE TIME
M CTAG COMPLD
"[<AID>]::[RINGID=<RINGID>],[NODEID=<NODEID>],[MODE=<MODE>],
[RVRTV=<RVRTV>],[RVTM=<RVTM>],[SRVRTV=<SRVRTV>],[SRVTM=<SRVTM>],
[EASTWORK=<EASTWORK>],[WESTWORK=<WESTWORK>],[EASTPROT=<EASTPROT>],
[WESTPROT=<WESTPROT>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"BLSR-43::RINGID=43,NODEID=3,MODE=4F,RVRTV=Y,RVTM=5.0,SRVRTV=Y,SRVTM=5.0,
EASTWORK=FAC-5-1,WESTWORK=FAC-6-1,EASTPROT=FAC-12-1,WESTPROT=FAC-13-1"
;Output Parameters
<AID>
(Optional) Access identifier from the "25.3 AidUnionId1" section on page 25-17. Identifies the BLSR of the NE.
<RINGID>
(Optional) The BLSR ID of the NE. String of up to six characters. Valid characters are A-Z and 0-9.
<NODEID>
(Optional) The BLSR node ID of the NE. NODEID is a string and ranges from 0 to 31.
<MODE>
(Optional) Mode with which the command is to be implemented. Identifies the BLSR mode; either two-fiber or four-fiber. The parameter type is BLSR_MODE (BLSR mode).
•
Two-fiber BLSR
•
Four-fiber BLSR
<RVRTV>
Revertive mode. The value Y indicates that the protection switching system reverts service to the original line after restoration. The value N indicates that the protection switching system does not revert service to the original line after restoration. RVRTV is applicable only for 1+1 protection switching. Null defaults to N. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<RVTM>
Revertive time. RVTM is not allowed to be set while RVRTV is N. The parameter type is REVERTIVE_TIME.
•
Revertive time is 0.5 to 12.0 minutes.
<SRVRTV>
The span revertive mode for four-fiber BLSR only. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<SRVTM>
The span revertive time for four-fiber BLSR only. SRVTM is not allowed to be set while SRVRTV is N. The parameter type is REVERTIVE_TIME.
•
Revertive time is 0.5 to 12.0 minutes.
<EASTWORK>
East working facility. AID from the "25.15 FACILITY" section on page 25-35.
<WESTWORK>
West working facility. AID from the "25.15 FACILITY" section on page 25-35.
<EASTPROT>
East protecting facility. AID from the "25.15 FACILITY" section on page 25-35.
<WESTPROT>
West protecting facility. AID from the "25.15 FACILITY" section on page 25-35.
21.5 RTRV-<OCN_TYPE>
(Cisco ONS 15454, ONS 15327, ONS 15310-CL, ONS 15310-MA, ONS 15600) The Retrieve OC3, OC12, OC48, or OC192 command retrieves the attributes (for example, service parameters) and the state of an OC-N facility.
Usage Guidelines
See Table 27-1 on page 27-1 for supported modifiers by platform.
Both RINGID and BLSRTYPE identify the OC-N port connected with a BLSR. These attributes are only presented for the OC-12, OC-48, and OC-192 ports within a BLSR connection. The RTRV-<MOD_RING> command with the AID BLSR-RINGID can provide more information about a BLSR.
Note
UNI-C DCC provisioning notes:
•
•
•
•
•
•
•
•
Category
Ports
Security
Retrieve
Input Format
RTRV-<OCN_TYPE>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-OC48:PENNGROVE:FAC-6-1:236;
Input Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:[DCC=<DCC>],[AREA=<AREA>],[TMGREF=<TMGREF>],
[SYNCMSG=<SYNCMSG>],[SENDDUS=<SENDDUS>],[PJMON=<PJMON>],
[SFBER=<SFBER>],[SDBER=<SDBER>],[MODE=<MODE>],[WVLEN=<WVLEN>],
[RINGID=<RINGID>],[BLSRTYPE=<BLSRTYPE>],[MUX=<MUX>],[UNIC=<UNIC>],
[SOAK=<SOAK>],[SOAKLEFT=<SOAKLEFT>],[SSMRCV=<SSMRCV>],[OSPF=<OSPF>],
[LDCC=<LDCC>],[NAME=<NAME>],[LBCL=<LBCL>],[OPT=<OPT>],[OPR=<OPR>],
[EXPTRC=<EXPTRC>],[TRC=<TRC>],[TRCMODE=<TRCMODE>],
[TRCFORMAT=<TRCFORMAT>],[ADMSSM=<ADMSSM>],
[SENDDUSFF=<SENDDUSFF>],[AISONLPBK=<AISONLPBK>],
[FREQ=<FREQ>],[LOSSB=<LOSSB>],[FOREIGNFEND=<FOREIGNFEND>],
[FOREIGNIPADDRESS=<FOREIGNIPADDRESS>],:<PSTPSTQ>,[<SSTQ>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-6-1:,,WORK,ACT:DCC=Y,AREA=10.92.63.1,TMGREF=N,SYNCMSG=N,SENDDUS=N,
PJMON=48,SFBER=1E-4,SDBER=1E-6,MODE=SINGLESHELF,WVLEN=1310.00,RINGID=43,
BLSRTYPE=WESTWORK,MUX=E2,UNIC=Y,
SOAKLEFT=\"12-25\",SSMRCV=STU,OSPF=Y,LDCC=Y,NAME=\"OCN PORT\",LBCL=10.0,
OPT=10.0,OPR=10.0,EXPTRC=\"AAA\",TRC=\"AAA\",TRCMODE=MAN,
TRCFORMAT=16-BYTE,ADMSSM=PRS,SENDDUSFF=N,AISONLPBK=AIS_ON_LPBK_ALL,
FREQ=1550,LOSSB=LR-1,FOREIGNFEND=Y,
FOREIGNIPADDRESS=10.92.63.44,:OOS-AU,AINS"
;Output Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
<ROLE>
(Optional) An OC-N port role. The parameter type is SIDE, which is the role the unit is playing in the protection group.
•
The entity is a protection unit in the protection group.
•
The entity is a working unit in the protection group.
<STATUS>
(Optional) An OC-N port status. The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<DCC>
(Optional) Indicates whether or not the Section data communications channel (DCC) is to be used. The parameter type is EXT_RING, which indicates whether the ring supports the extended K1/K2/K3 protocol.
•
The ring does not support the extended K1/K2/K3 protocol.
•
The ring does support the extended K1/K2/K3 protocol.
<AREA>
(Optional) Area ID. Shows up only if the DCC is enabled. AREA is a string.
<TMGREF>
(Optional) The termination to be used, whether primary or secondary. Identifies if an OC-N port has a timing reference. Defaults to N. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<SYNCMSG>
Synchronization status message. The parameter type is EXT_RING, which indicates whether the ring supports the extended K1/K2/K3 protocol.
•
The ring does not support the extended K1/K2/K3 protocol.
•
The ring does support the extended K1/K2/K3 protocol.
<SENDDUS>
(Optional) The facility will send the DUS (Do not use for Synchronization) value in 0x0f bits pattern as the synchronization status message for that facility. Defaults to N. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<PJMON>
(Optional) Identifies an OC-N port PJMON. PJMON is an integer. It defaults to 0 (zero). Set a valid STS number of the optical port.
Note
<SFBER>
(Optional) An OC-N port signal failure threshold. Defaults to 1E-4. The parameter type is SF_BER, which is the threshold for declaring signal failure on a facility or path.
•
SFBER is 1E-3.
•
SFBER is 1E-4.
•
SFBER is 1E-5.
<SDBER>
(Optional) An OC-N port signal degrade threshold. Defaults 1E-7. The parameter type is SD_BER, which is the threshold for declaring signal degrade on a facility or path.
•
SDBER is 1E-5.
•
SDBER is 1E-6.
•
SDBER is 1E-7.
•
SDBER is 1E-8.
•
SDBER is 1E-9.
<MODE>
(Optional) OC-N port mode. Defaults to SONET. The parameter type is OPTICAL_MODE, which is the facility's optical mode.
•
The NE contains only one shelf and the AID representation does not consider the shelf identifier for command requests/response and autonomous reports.
•
The AID representation considers the shelf identifier for command requests/response and autonomous reports. This means the NE has more than one shelf configured or the user wants to use the new AID style.
•
The AID representation considers the shelf identifier for command requests/response and autonomous reports. This means the NE has more than one shelf configured or the user wants to use the new AID style. The shelves are connected by means of an external Ethernet switch.
<WVLEN>
(Optional) An OC-N port wavelength in nanometers. For example, WVLEN=1310.00 means it operates at 1310 nm in the DWDM application. WVLEN is a float.
<RINGID>
(Optional) The BLSR RINGID with which the port is connected. RINGID ranges from 0 to 9999. RINGID is an integer.
<BLSRTYPE>
(Optional) The BLSR type with which the port is connected. The parameter type is BLSR_TYPE, which is the BLSR type of an OC-N port.
•
The OC-N port is an east protecting port.
•
The OC-N port is an east working port.
•
The OC-N port is an west protecting port.
•
The OC-N port is an west working port.
<MUX>
(Optional) BLSR extension byte. The parameter type is MUX_TYPE, which is the BLSR extension byte.
•
E2 byte (orderwire)
•
F1 byte (user)
•
K3 byte
•
Z2 byte
<UNIC>
(Optional) Indicates if the port connects to the UCP. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<SOAK>
(Optional) OOS-AINS to IS transition soak time as measured in 15-minute intervals. SOAK is an integer.
<SOAKLEFT>
(Optional) Time remaining for the transition from OOS-AINS to IS measured in 1-minute intervals. The format is HH-MM where HH ranges from 00 to 48 and MM ranges from 00 to 59. Rules for <SOAKLEFT> are as follows:
•
•
•
<SSMRCV>
(Optional) Displays the quality of the individual port. The parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL, which is the clock source quality level for SONET.
•
Do Not Use For Synchronization
•
Primary Reference Source, Stratum 1 Traceable
•
Reserved For Network Synchronization Use
•
SONET Minimum Clock Traceable
•
Stratum 2 Traceable
•
Stratum 3 Traceable
•
Stratum 3E Traceable
•
Stratum 4 Traceable
•
Synchronized, Traceability Unknown
•
Transit Node Clock (2nd Generation Only)
<OSPF>
(Optional) The Open Shortest Path First protocol. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<LDCC>
(Optional) The Line DCC connection on the port. The parameter type is EXT_RING, which indicates if the ring supports the extended K1/K2/K3 protocol.
•
The ring does not support the extended K1/K2/K3 protocol.
•
The ring does support the extended K1/K2/K3 protocol.
<NAME>
(Optional) Name. NAME is a string.
<LBCL>
(Optional) Displays the current value of the laser current. LBCL is a float.
<OPT>
(Optional) Displays the current value of the transmitted optical power. OPT is only displayed for DWDM cards. OPT is a float.
<OPR>
Received optical power. OPR is a float.
<EXPTRC>
(Optional) Expected path trace content. EXPTRC is a string.
<TRC>
(Optional) Path trace message to be transmitted. TRC is a string.
<TRCMODE>
(Optional) Path trace mode. Applicable only to STS-level Paths in SONET. Defaults to the OFF mode. The parameter type is TRCMODE (trace mode).
•
Use the previously received path trace string as the expected string. Not applicable to MXP/TXP cards.
•
Use the previously received path trace string as the expected string and do not turn on alarm indication signal (AIS) and remote defect indication (RDI) if TIM-P is detected.
•
Use the provisioned expected string as the expected string.
•
Use the provisioned expected string as the expected string and do not turn on AIS and RDI if TIM-P is detected.
•
Turn off path trace capability. Nothing will be reported.
<TRCFORMAT>
(Optional) Trace message size. The parameter type is TRCFORMAT (trace format).
•
1-byte trace message
•
16-byte trace message
•
64-byte trace message
•
Enable an attribute.
<ADMSSM>
(Optional) SSM selectable value. Only displayed when SSM is disabled. The parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL, which is the clock source quality level for SONET.
•
Do Not Use For Synchronization
•
Primary Reference Source, Stratum 1 Traceable
•
Reserved For Network Synchronization Use
•
SONET Minimum Clock Traceable
•
Stratum 2 Traceable
•
Stratum 3 Traceable
•
Stratum 3E Traceable
•
Stratum 4 Traceable
•
Synchronized, Traceability Unknown
•
Transit Node Clock (2nd Generation Only)
<SENDDUSFF>
(Optional) Indicates that the facility will send the DUS value in 0xff bits pattern as the synchronization status message for that facility. Defaults to N. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<AISONLPBK>
(Optional) AIS on loopback. The parameter type is AIS_ON_LPBK, which indicates whether AIS is sent on a loopback.
•
AIS is sent on facility loopbacks.
•
AIS is sent on all loopbacks.
•
AIS is not sent on loopbacks.
•
AIS is sent on terminal loopbacks.
<FREQ>
(Optional) Parameter type is OPTICAL_WLEN (optical wavelength).
•
Wavelength 1310
•
Wavelength 1470
•
Wavelength 1490
•
Wavelength 1510
•
Wavelength 1529.55
•
Wavelength 1529.94
•
Wavelength 1530
•
Wavelength 1530.33
•
Wavelength 1530.73
•
Wavelength 1531.12
•
Wavelength 1531.51
•
Wavelength 1531.90
•
Wavelength 1532.29
•
Wavelength 1532.68
•
Wavelength 1533.07
•
Wavelength 1533.47
•
Wavelength 1533.86
•
Wavelength 1534.25
•
Wavelength 1534.64
•
Wavelength 1535.04
•
Wavelength 1535.43
•
Wavelength 1535.82
•
Wavelength 1536.22
•
Wavelength 1536.61
•
Wavelength 1537
•
Wavelength 1537.40
•
Wavelength 1537.79
•
Wavelength 1538.19
•
Wavelength 1538.58
•
Wavelength 1538.98
•
Wavelength 1539.37
•
Wavelength 1539.77
•
Wavelength 1540.16
•
Wavelength 1540.56
•
Wavelength 1540.95
•
Wavelength 1541.35
•
Wavelength 1541.75
•
Wavelength 1542.14
•
Wavelength 1542.35
•
Wavelength 1542.54
•
Wavelength 1542.94
•
Wavelength 1543.33
•
Wavelength 1543.73
•
Wavelength 1544.13
•
Wavelength 1544.53
•
Wavelength 1544.92
•
Wavelength 1545.32
•
Wavelength 1545.72
•
Wavelength 1546.12
•
Wavelength 1546.52
•
Wavelength 1546.92
•
Wavelength 1547.32
•
Wavelength 1547.72
•
Wavelength 1548.12
•
Wavelength 1548.51
•
Wavelength 1548.92
•
Wavelength 1549.32
•
Wavelength 1549.71
•
Wavelength 1500
•
Wavelength 1550.12
•
Wavelength 1550.52
•
Wavelength 1550.92
•
Wavelength 1551.32
•
Wavelength 1551.72
•
Wavelength 1552.12
•
Wavelength 1552.52
•
Wavelength 1552.93
•
Wavelength 1553.33
•
Wavelength 1553.73
•
Wavelength 1554.13
•
Wavelength 1554.13
•
Wavelength 1554.94
•
Wavelength 1555.34
•
Wavelength 1555.75
•
Wavelength 1556.15
•
Wavelength 1556.55
•
Wavelength 1556.96
•
Wavelength 1557.36
•
Wavelength 1557.77
•
Wavelength 1558.17
•
Wavelength 1558.58
•
Wavelength 1558.98
•
Wavelength 1559.39
•
Wavelength 1559.79
•
Wavelength 1560.20
•
Wavelength 1560.61
•
Wavelength 1561.01
•
Wavelength 1561.42
•
Wavelength 1561.83
•
Wavelength 1570
•
Wavelength 1570.83
•
Wavelength 1571.24
•
Wavelength 1571.65
•
Wavelength 1572.06
•
Wavelength 1572.48
•
Wavelength 1572.89
•
Wavelength 1573.30
•
Wavelength 1573.71
•
Wavelength 1574.13
•
Wavelength 1574.54
•
Wavelength 1574.95
•
Wavelength 1575.37
•
Wavelength 1575.78
•
Wavelength 1576.20
•
Wavelength 1576.61
•
Wavelength 1577.03
•
Wavelength 1577.44
•
Wavelength 1577.86
•
Wavelength 1578.27
•
Wavelength 1578.69
•
Wavelength 1579.10
•
Wavelength 1579.52
•
Wavelength 1579.93
•
Wavelength 1580.35
•
Wavelength 1580.77
•
Wavelength 1581.18
•
Wavelength 1581.60
•
Wavelength 1582.02
•
Wavelength 1582.44
•
Wavelength 1582.85
•
Wavelength 1583.27
•
Wavelength 1583.69
•
Wavelength 1584.11
•
Wavelength 1584.53
•
Wavelength 1584.95
•
Wavelength 1585.36
•
Wavelength 1585.78
•
Wavelength 1586.20
•
Wavelength 1586.62
•
Wavelength 1587.04
•
Wavelength 1587.46
•
Wavelength 1587.88
•
Wavelength 1588.30
•
Wavelength 1588.73
•
Wavelength 1589.15
•
Wavelength 1589.57
•
Wavelength 1589.99
•
Wavelength 1590
•
Wavelength 1590.41
•
Wavelength 1590.83
•
Wavelength 1591.26
•
Wavelength 1591.68
•
Wavelength 1592.10
•
Wavelength 1592.52
•
Wavelength 1592.95
•
Wavelength 1593.37
•
Wavelength 1593.79
•
Wavelength 1594.22
•
Wavelength 1594.64
•
Wavelength 1595.06
•
Wavelength 1595.49
•
Wavelength 1596.34
•
Wavelength 1596.76
•
Wavelength 1597.19
•
Wavelength 1597.62
•
Wavelength 1598.04
•
Wavelength 1598.47
•
Wavelength 1598.89
•
Wavelength 1599.32
•
Wavelength 1599.75
•
Wavelength 1600.06
•
Wavelength 1601.03
•
Wavelength 1601.46
•
Wavelength 1601.88
•
Wavelength 1602.31
•
Wavelength 1602.74
•
Wavelength 1603.17
•
Wavelength 1603.60
•
Wavelength 1604.03
•
Wavelength 1610
•
Use Tunable Wavelength 1
<LOSSB>
(Optional) Parameter type is REACH (reach values).
•
Autoprovisioning
•
Reach CX
•
Reach DX
•
Reach HX
•
Reach I1
•
Reach IR-1
•
Reach IR-2
•
Reach L1
•
Reach L2
•
Reach L3
•
Reach LR-1
•
Reach LR-2
•
Reach LR-3
•
Reach LX
•
Reach S1
•
Reach S2
•
Reach SR
•
Reach SR-1
•
Reach SX
•
Reach T
•
Reach VX
•
Reach ZX
<FOREIGNFEND>
(Optional) Indicates whether the far-end NE on the DCC is a foreign NE. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<FOREIGNIPADDRESS>
(Optional) The IP address of the far-end NE on the DCC. Used only if FOREIGNFEND is Y. FOREIGNIPADDRESS is a string.
<PST_PSTQ>
Administrative state in the PST_PSTQ format. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SSTQ>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.6 RTRV-<PATH>
(Cisco ONS 15454, ONS 15327, ONS 15310-CL, ONS 15310-MA, ONS 15600) The Retrieve STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, VT1, or VT2 (RTRV-<PATH>) command retrieves the attributes associated with an STS/VT path.
Usage Guidelines
See Table 27-1 on page 27-1 for supported modifiers by platform.
Supported AIDs are: ALL, SLOT-N (N=1,2,...,ALL), and STS/VT-specific AIDs.
The SFBER, SDBER, RVRTV, RVTM, SWPDIP, HOLDOFFTIMER, and UPSRPTHSTATE parameters only apply to path protection configurations.
The path trace message is a 64 character string including the terminating CR (carriage return) and LF (line feed) that is transported in the J1 byte of the SONET STS Path overhead.
The EXPTRC indicates that the contents of the expected incoming path trace are provisioned by the user in the ED-STS_PATH command. The TRC indicates the contents of the outgoing path trace message. The INCTRC indicates the contents of the incoming path trace message.
The path trace mode has three modes: OFF, MANUAL, and AUTO. The mode defaults to OFF. 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.
J1 (EXPTRC) is implemented on the DS1/DS1N, DS3E/DS3NE, DS3XM, EC1, DS3/EC1-48, OC3, OC48AS, OC192, MRC-12, and OC192-XFP cards.
TRC and INCTRC are supported on DS1N, DS3NE, DS3/EC1-48, and DS3XM cards.
The following actions will result in error messages:
•
•
Note
•
•
•
•
•
•
•
•
Category
Paths
Security
Retrieve
Input Format
RTRV-<PATH>:[<TID>]:<AID>:<CTAG>[:::BLSRPTHTYPE=<BLSRPTHTYPE>][:];
Input Example
RTRV-STS3C:FERNDALE:STS-2-1-4:238:::BLSRPTHTYPE=NON-PCA;
Input Parameters
<AID>
Access identifier from the "25.11 CrossConnectId1" section on page 25-26.
<BLSRPTHTYPE>
The BLSR path type only if the port is on the BLSR. No value or a null value defaults to NON-PCA. Applicable only to STS-level paths in SONET. The parameter type is BLSR_PTH_TYPE, which is the BLSR path type only if the port is on the BLSR.
•
The AID is on the working path, or the cross-connection card protection path.
•
The AID is on the BLSR PCA path.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>::[LEVEL=<LEVEL>],[SFBER=<SFBER>],[SDBER=<SDBER>],[RVRTV=<RVRTV>],
[RVTM=<RVTM>],[SWPDIP=<SWPDIP>],[HOLDOFFTIMER=<HOLDOFFTIMER>],
[EXPTRC=<EXPTRC>],[TRC=<TRC>],[INCTRC=<INCTRC>],[TRCMODE=<TRCMODE>],
[TRCFORMAT =<TRCFORMAT>],[TACC=<TACC>],[TAPTYPE=<TAPTYPE>],
[UPSRPTHSTATE=<UPSRPTHSTATE>],[C2=<C2>],
[BLSRPTHSTATE=<BLSRPTHSTATE>]:<PST_PSTQ>,[<SSTQ>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"STS-2-1-4::LEVEL=STS1,SFBER=1E-3,SDBER=1E-5,RVRTV=Y,RVTM=1.0,SWPDIP=Y,
HOLDOFFTIMER=2000,EXPTRC="EXPTRCSTRING",TRC="TRCSTRING",
INCTRC="INCTRCSTRING",TRCMODE=AUTO,TRCFORMAT=64-BYTE,TACC=8,
TAPTYPE=DUAL,UPSRPTHSTATE=ACT,C2=0X04,
BLSRPTHSTATE=PROTPTHACT:OOS-AU,AINS"
;Output Parameters
<AID>
Access identifier from the "25.11 CrossConnectId1" section on page 25-26.
<LEVEL>
(Optional) The rate of the cross-connect. Indicates the rate of the cross-connected channel. Applicable only to the STS path in SONET. The parameter type is PATH, which is the modifier for path commands.
•
Synchronous transport signal/module level 1 (51.84 Mbps)
•
Synchronous transport signal/module level 3 concatenated (155.52 Mbps)
•
Synchronous transport signal/module level 6 (311.04 Mbps)
•
Synchronous transport signal/module level 9 concatenated (466.56 Mbps)
•
Synchronous transport signal/module level 12 concatenated (622.08 Mbps)
•
Synchronous transport signal/module level 18 concatenated (933.12 Mbps)
•
Synchronous transport signal/module level 24 concatenated (1244.16 Mbps)
•
Synchronous transport signal/module level 36 concatenated (1866.24 Mbps)
•
Synchronous transport signal/module level 48 concatenated (2488.32 Mbps)
•
Synchronous transport signal/module level 192 concatenated (9953.28 Mbps)
<SFBER>
(Optional) An STS path signal failure threshold that only applies to path protection. Applicable only to STS-level paths in SONET. Defaults to 1E-4. The parameter type is SF_BER, which is the threshold for declaring signal failure on a facility or path.
•
SFBER is 1E-3.
•
SFBER is 1E-4.
•
SFBER is 1E-5.
<SDBER>
(Optional) An STS path signal degrade threshold that only applies to path protection. Applicable only to STS-level paths in SONET. Defaults 1E-6. The parameter type is SD_BER, which is the threshold for declaring signal degrade on a facility or path.
•
SDBER is 1E-5.
•
SDBER is 1E-6.
•
SDBER is 1E-7.
•
SDBER is 1E-8.
•
SDBER is 1E-9.
<RVRTV>
Revertive mode. Only applies to path protection. The value Y indicates that the protection switching system reverts service to the original line after restoration. The value N indicates that the protection switching system does not revert service to the original line after restoration. RVRTV is applicable only for 1+1 protection switching. Null defaults to N. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<RVTM>
Revertive time. Only applies to path protection. The parameter type is REVERTIVE_TIME.
•
Revertive time is 0.5 to 12.0 minutes.
<SWPDIP>
(Optional) Switch on PDI-P. Applicable only to STS-level paths in SONET. The parameter type is ON_OFF (disable or enable an attribute).
•
Disable an attribute.
•
Enable an attribute.
<HOLDOFFTIMER>
(Optional) Hold off timer. HOLDOFFTIMER is an integer.
<EXPTRC>
(Optional) Expected path trace content. Indicates the expected path trace message (J1) contents. EXPTRC is any 64-character ASCII string, including the terminating CR (carriage return) and LF (line feed). Applicable to STS-level paths in SONET. Defaults to NULL when a path protection path is created. Supported on the CE-100T-8 card (ONS 15310-CL) provisioned in mapper mode. EXPTRC is a string.
<TRC>
(Optional) The path trace message to be transmitted. The trace byte (J1) continuously transmits a 64-byte, fixed length ASCII string, one byte at a time. A null value defaults to the NE transmitting 62 null characters (hex 00) and CR and LF. A null value defaults to the NE transmitting null characters (Hex 00). Applicable to STS-level paths in SONET. Applicable to VT-level paths for the DS3XM-12 card on the ONS 15454. Supported on the CE-100T-8 card (ONS 15310-CL) provisioned in mapper mode. TRC is a string.
<INCTRC>
(Optional) The incoming path trace message contents. INCTRC is any combination of 64 characters. Applicable only to STS-level paths in SONET (STSn). Defaults to null when a path protection path is created. Supported on the CE-100T-8 card (ONS 15310-CL) provisioned in mapper mode. INCTRC is a string.
<TRCMODE>
(Optional) Path trace mode. Applicable only to STS-level paths in SONET (STSn). Defaults to OFF when a path protection path is created. Supported on the CE-100T-8 card (ONS 15310-CL) provisioned in mapper mode. The parameter type is TRCMODE (trace mode).
•
Use the previously received path trace string as the expected string (not applicable to MXP_2.5G_10G and TXP_MR_10G cards).
•
Use the previously received path trace string as the expected string and do not turn on AIS and RDI if TIM-P detected.
•
Use the provisioned expected string as the expected string.
•
Use the provisioned expected string as the expected string and do not turn on AIS and RDI if TIM-P detected.
•
Turn off path trace capability. Nothing will be reported.
<TRCFORMAT>
(Optional) Trace message size. The parameter type is TRCFORMAT (trace format).
•
1-byte trace message
•
16-byte trace message
•
64-byte trace message
•
Enable an attribute.
<TACC>
(Optional) Test access. Indicates whether the digroup being provisioned is to be used as a test access digroup. Defaults to N. Not applicable to the ONS 15310-CL.
<TAPTYPE>
(Optional) TAP type. Not applicable to the ONS 15310-CL. The parameter type is TAPTYPE, which is the test access point type
•
Dual FAD
•
Single FAD
<UPSRPTHSTATE>
(Optional) Indicates whether a given AID is the working or standby path of a path protection cross-connect. The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<C2>
(Optional) The C2 byte hex code. Applicable only to STS-level paths in SONET (STSn). The parameter type is C2_BYTE, which is the C2 byte hex code.
•
Unequipped
•
Equipped Non-Specific payload
•
VT-Structured STS-1 synchronous payload envelope (SPE)
•
Locked VT Mode
•
Asynchronous Mapping for DS3
•
Asynchronous Mapping for DS4NA
•
Mapping for ATM
•
Mapping for DQDB
•
Asynchronous Mapping for FDDI
•
HDLC-Over-SONET Mapping
•
VT-structured STS-1 SPE with 1VTx payload defect
•
VT-structured STS-1 SPE with 2VTx payload defects
•
VT-structured STS-1 SPE with 3VTx payload defects
•
VT-structured STS-1 SPE with 4VTx payload defects
•
VT-structured STS-1 SPE with 5VTx payload defects
•
VT-structured STS-1 SPE with 6VTx payload defects
•
VT-structured STS-1 SPE with 7VTx payload defects
•
VT-structured STS-1 SPE with 8VTx payload defects
•
VT-structured STS-1 SPE with 9VTx payload defects
•
VT-structured STS-1 SPE with 10VTx payload defects
•
VT-structured STS-1 SPE with 11VTx payload defects
•
VT-structured STS-1 SPE with 12VTx payload defects
•
VT-structured STS-1 SPE with 13VTx payload defects
•
VT-structured STS-1 SPE with 14VTx payload defects
•
VT-structured STS-1 SPE with 15VTx payload defects
•
VT-structured STS-1 SPE with 16VTx payload defects
•
VT-structured STS-1 SPE with 17VTx payload defects
•
VT-structured STS-1 SPE with 18VTx payload defects
•
VT-structured STS-1 SPE with 19VTx payload defects
•
VT-structured STS-1 SPE with 20VTx payload defects
•
VT-structured STS-1 SPE with 21VTx payload defects
•
VT-structured STS-1 SPE with 22VTx payload defects
•
VT-structured STS-1 SPE with 23VTx payload defects
•
VT-structured STS-1 SPE with 24VTx payload defects
•
VT-structured STS-1 SPE with 25VTx payload defects
•
VT-structured STS-1 SPE with 26VTx payload defects
•
VT-structured STS-1 SPE with 27VTx payload defects
•
VT-structured STS-1 SPE with 28VTx payload defects
•
O.181 Test Signal (TSS1 to TSS3) Mapping
•
Reserved, however, C2 is 0XFF if an AIS-L is being generated by an optical card or cross-connect downstream.
<BLSRPTHSTATE>
(Optional) The BLSR path state only if the port is on the BLSR. Applicable only to STS-level paths in SONET (STSn). The parameter type is BLSR_PTH_STATE, which is the BLSR path state only if the port is on the BLSR.
•
Indicates the BLSR is not switched and its PCA path is in the active state.
•
Indicates the BLSR is switched and its PCA path is in the standby state.
•
Indicates the BLSR is switched and its protection path is in the active state.
•
Indicates the BLSR is not switched and its working path is in the active state.
•
Indicates the BLSR is switched and its working path is in the standby state.
<PST_PSTQ>
Administrative state in the PST_PSTQ format. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SSTQ>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.7 RTRV-10GIGE
(Cisco ONS 15454) The Retrieve 10GIGE (RTRV-10GIGE) command retrieves the 10 Gbps-specific parameters for a port that has been configured to support the Gigabit Ethernet payload with the ENT-10GIGE command.
Usage Guidelines
None
Category
Ports
Security
Retrieve
Input Format
RTRV-10GIGE:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-10GIGE:TID:FAC-1-1:100;
Input Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:[NAME=<NAME>],[MACADDR=<MACADDR>],
[LBCL=<LBCL>],[OPT=<OPT>],[OPR=<OPR>],[FREQ=<FREQ>],
[LOSSB=<LOSSB>]:<PSTPSTQ>,[<SST>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-6-1:,,WORK,ACT:NAME=\"NY PORT\",MACADDR=00-0E-AA-BB-CC-FF,LBCL=10.0,
OPT=10.0,OPR=10.0,FREQ=1550,LOSSB=SX:OOS-AU,AINS"
;Output Parameters
<AID>
Access identifier from the "25.15 FACILITY" section on page 25-35.
<ROLE>
(Optional) The port role in Y-cable protection (WORK or PROT). The parameter type is SIDE, which is the role the unit is playing in the protection group.
•
The entity is a protection unit in the protection group.
•
The entity is a working unit in the protection group.
<STATUS>
(Optional) A port status in Y-cable protection (ACT or STBY). The parameter type is STATUS, which is the status of the unit in the protection pair.
•
The entity is the active unit in the shelf.
•
Status is unavailable.
•
The entity is the standby unit in the shelf.
<NAME>
(Optional) Port name. NAME is a string.
<MACADDR>
(Optional) The MAC address for the 10-Gigabit Ethernet payload. MACADDR is a string.
<LBCL>
(Optional) Displays the current value of the laser current. LBCL is a float.
<OPT>
(Optional) Displays the current value of the transmitted optical power. OPT is a float.
<OPR>
(Optional) Displays the current value of the received optical power. OPR is a float.
<FREQ>
(Optional) Parameter type is OPTICAL_WLEN (optical wavelength).
•
Wavelength 1310
•
Wavelength 1470
•
Wavelength 1490
•
Wavelength 1510
•
Wavelength 1529.55
•
Wavelength 1529.94
•
Wavelength 1530
•
Wavelength 1530.33
•
Wavelength 1530.73
•
Wavelength 1531.12
•
Wavelength 1531.51
•
Wavelength 1531.90
•
Wavelength 1532.29
•
Wavelength 1532.68
•
Wavelength 1533.07
•
Wavelength 1533.47
•
Wavelength 1533.86
•
Wavelength 1534.25
•
Wavelength 1534.64
•
Wavelength 1535.04
•
Wavelength 1535.43
•
Wavelength 1535.82
•
Wavelength 1536.22
•
Wavelength 1536.61
•
Wavelength 1537
•
Wavelength 1537.40
•
Wavelength 1537.79
•
Wavelength 1538.19
•
Wavelength 1538.58
•
Wavelength 1538.98
•
Wavelength 1539.37
•
Wavelength 1539.77
•
Wavelength 1540.16
•
Wavelength 1540.56
•
Wavelength 1540.95
•
Wavelength 1541.35
•
Wavelength 1541.75
•
Wavelength 1542.14
•
Wavelength 1542.35
•
Wavelength 1542.54
•
Wavelength 1542.94
•
Wavelength 1543.33
•
Wavelength 1543.73
•
Wavelength 1544.13
•
Wavelength 1544.53
•
Wavelength 1544.92
•
Wavelength 1545.32
•
Wavelength 1545.72
•
Wavelength 1546.12
•
Wavelength 1546.52
•
Wavelength 1546.92
•
Wavelength 1547.32
•
Wavelength 1547.72
•
Wavelength 1548.12
•
Wavelength 1548.51
•
Wavelength 1548.92
•
Wavelength 1549.32
•
Wavelength 1549.71
•
Wavelength 1500
•
Wavelength 1550.12
•
Wavelength 1550.52
•
Wavelength 1550.92
•
Wavelength 1551.32
•
Wavelength 1551.72
•
Wavelength 1552.12
•
Wavelength 1552.52
•
Wavelength 1552.93
•
Wavelength 1553.33
•
Wavelength 1553.73
•
Wavelength 1554.13
•
Wavelength 1554.13
•
Wavelength 1554.94
•
Wavelength 1555.34
•
Wavelength 1555.75
•
Wavelength 1556.15
•
Wavelength 1556.55
•
Wavelength 1556.96
•
Wavelength 1557.36
•
Wavelength 1557.77
•
Wavelength 1558.17
•
Wavelength 1558.58
•
Wavelength 1558.98
•
Wavelength 1559.39
•
Wavelength 1559.79
•
Wavelength 1560.20
•
Wavelength 1560.61
•
Wavelength 1561.01
•
Wavelength 1561.42
•
Wavelength 1561.83
•
Wavelength 1570
•
Wavelength 1570.83
•
Wavelength 1571.24
•
Wavelength 1571.65
•
Wavelength 1572.06
•
Wavelength 1572.48
•
Wavelength 1572.89
•
Wavelength 1573.30
•
Wavelength 1573.71
•
Wavelength 1574.13
•
Wavelength 1574.54
•
Wavelength 1574.95
•
Wavelength 1575.37
•
Wavelength 1575.78
•
Wavelength 1576.20
•
Wavelength 1576.61
•
Wavelength 1577.03
•
Wavelength 1577.44
•
Wavelength 1577.86
•
Wavelength 1578.27
•
Wavelength 1578.69
•
Wavelength 1579.10
•
Wavelength 1579.52
•
Wavelength 1579.93
•
Wavelength 1580.35
•
Wavelength 1580.77
•
Wavelength 1581.18
•
Wavelength 1581.60
•
Wavelength 1582.02
•
Wavelength 1582.44
•
Wavelength 1582.85
•
Wavelength 1583.27
•
Wavelength 1583.69
•
Wavelength 1584.11
•
Wavelength 1584.53
•
Wavelength 1584.95
•
Wavelength 1585.36
•
Wavelength 1585.78
•
Wavelength 1586.20
•
Wavelength 1586.62
•
Wavelength 1587.04
•
Wavelength 1587.46
•
Wavelength 1587.88
•
Wavelength 1588.30
•
Wavelength 1588.73
•
Wavelength 1589.15
•
Wavelength 1589.57
•
Wavelength 1589.99
•
Wavelength 1590
•
Wavelength 1590.41
•
Wavelength 1590.83
•
Wavelength 1591.26
•
Wavelength 1591.68
•
Wavelength 1592.10
•
Wavelength 1592.52
•
Wavelength 1592.95
•
Wavelength 1593.37
•
Wavelength 1593.79
•
Wavelength 1594.22
•
Wavelength 1594.64
•
Wavelength 1595.06
•
Wavelength 1595.49
•
Wavelength 1596.34
•
Wavelength 1596.76
•
Wavelength 1597.19
•
Wavelength 1597.62
•
Wavelength 1598.04
•
Wavelength 1598.47
•
Wavelength 1598.89
•
Wavelength 1599.32
•
Wavelength 1599.75
•
Wavelength 1600.06
•
Wavelength 1601.03
•
Wavelength 1601.46
•
Wavelength 1601.88
•
Wavelength 1602.31
•
Wavelength 1602.74
•
Wavelength 1603.17
•
Wavelength 1603.60
•
Wavelength 1604.03
•
Wavelength 1610
•
Use Tunable Wavelength 1
<LOSSB>
(Optional) The parameter type is REACH (reach values).
•
Autoprovisioning
•
Reach CX
•
Reach DX
•
Reach HX
•
Reach I1
•
Reach IR-1
•
Reach IR-2
•
Reach L1
•
Reach L2
•
Reach L3
•
Reach LR-1
•
Reach LR-2
•
Reach LR-3
•
Reach LX
•
Reach S1
•
Reach S2
•
Reach SR
•
Reach SR-1
•
Reach SX
•
Reach T
•
Reach VX
•
Reach ZX
<PST_PSTQ>
Administrative state in the PST_PSTQ format. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ).
•
In Service and Normal
•
Out of Service and Autonomous
•
Out of Service and Autonomous Management
•
Out of Service and Management
<SSTQ>
(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.
•
Automatic In-Service
•
Disabled
•
Loopback
•
Mismatch of Equipment
•
Maintenance
•
Out of Group
•
Software Download
•
Unassigned
•
Unequipped
21.8 RTRV-ALM-<MOD2ALM>
(Cisco ONS 15454, ONS 15327, ONS 15310-CL, ONS 15310-MA, ONS 15600) The Retrieve Alarm for (10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, 4GFC, 4GFICON, DS1, DS3I, E1, E100, E1000, E3, E4, EC1, FSTE, G1000, GFPOS, GIGE, ILK, ISCCOMPAT, ISC3PEER2R, ISC3PEER1G, ISC3PEER2G, OC12, OC192, OC3, OC48, OCH, OMS, OTS, OTU2, POS, RPRIF, STM1, STM4, STM16, STM64, STM1E, STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, T1, T3, UDCDCC, UDCF, VC3,VC4,VC4-2c,VC4-3c,VC4-4c,VC4-16c,VC4-64c, VC11, VC12, VC3, VCG, VT1, VT2, or WLEN (RTRV-ALM-<MOD2ALM>) command retrieves and sends the current status of alarm conditions. The alarm condition or severity to be retrieved can be specified by using the input parameters as a filter.
Usage Guidelines
See Table 27-1 on page 27-1 for supported modifiers by platform.
Note
Note
Category
Fault
Security
Retrieve
Input Format
RTRV-ALM-<MOD2ALM>:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<CONDTYPE>],
[<SRVEFF>][,,,];Input Example
RTRV-ALM-RPRIF::RPRIF-2-0:225:MJ,FORCE-REQ,SA;
Input Parameters
<AID>
Access identifier from the "25.2 AidUnionId" section on page 25-12.
<NTFCNCDE>
Two-letter notification code. A null value is equivalent to ALL. The parameter type is NOTIF_CODE, which is the two-character notification code associated with an autonomous message.
•
The condition causing the alarm has cleared.
•
A critical alarm.
•
A major alarm.
•
A minor alarm.
•
The condition is not alarmed.
•
The alarm is not reported.
<CONDTYPE>
Condition type for an alarm or a reported event. The parameter type is CONDITION, which is any problem detected on an ONS 15454, ONS 15327, ONS 15310-CL, or ONS 15600 shelf, whether or not the problem is reported (that is, whether or not it generates a trouble notification). Reported conditions include alarms, Not-Alarmed conditions (NA), and Not-Reported (NR) conditions. See Chapter 26, "Conditions" for a list of conditions.
<SRVEFF>
The effect on service caused by the standing alarm or condition. The parameter type is SERV_EFF, which is the effect of the alarm on service. A null value is equivalent to ALL.
•
The condition is non-service affecting.
•
The condition is service affecting.
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:<NTFCNCDE>,<CONDTYPE>,<SRVEFF>,[<OCRDAT>],
[<OCRTM>],,:[<DESC>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"RPRIF-2-0,ML1000-2:MJ,FORCE-REQ,SA,09-05,12-30-20,,:\"FORCE SWITCH REQUEST\","
;Output Parameters
<AID>
Access identifier from the "25.1 ALL" section on page 25-1.
<AIDTYPE>
(Optional) Type of access identifier. The parameter type is MOD2ALM (alarm type).
•
1 Gigabit Fibre Channel alarm
•
1 Gigabit FICON alarm
•
1 Gbps ISC3 compatible
•
2 Gigabit Fibre Channel alarm
•
2 Gigabit FICON alarm
•
4 Gbps Fibre Channel
•
4 Gbps fiber connection
•
Client facility for MXP/TXP cards
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
Generic framing protocol over packet over SONET virtual port alarm
•
GIG Ethernet port alarm
•
1 Gbps ISC3 Peer
•
2 Gbps ISC3 Peer
•
1 Gbps or 2 Gbps ISC3 peer used in transparent (2R) mode
•
1 Gbps ISC1, ISC2, and ISC3 compatibility
•
(ONS 15454) ML-Series two port gigabit Ethernet card
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
OCH termination
•
Optical Multiplex Section
•
Optical Transport Section
•
POS port alarm
•
STS1 alarm
•
STS3c alarm
•
STS6c alarm
•
STS9c alarm
•
STS18c alarm
•
STS12c alarm
•
STS24c alarm
•
STS36c alarm
•
STS48c alarm
•
STS192c alarm
•
T1 alarm
•
T3 alarm
•
UDC-DCC alarm
•
UCD-F alarm
•
Virtual concatenation group alarm
•
VT1 alarm
•
VT2 alarm
•
Wavelength path provisioning
<NTFCNCDE>
Two-letter notification code. The parameter type is NOTIF_CODE, which is the two-character notification code associated with an autonomous message.
•
The condition causing the alarm has cleared.
•
A critical alarm.
•
A major alarm.
•
A minor alarm.
•
The condition is not alarmed.
•
The alarm is not reported.
<CONDTYPE>
Condition type for an alarm or a reported event. The parameter type is CONDITION, which is any problem detected on an ONS 15454, ONS 15327, ONS 15310-CL, or ONS 15600 shelf, whether or not the problem is reported (that is, whether or not it generates a trouble notification). Reported conditions include alarms, Not-Alarmed conditions (NA), and Not-Reported (NR) conditions. See Chapter 26, "Conditions"
