-
Cisco ONS SONET TL1 Command Guide, Release 6.0
-
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 Messages
-
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
-
Feedback
Table Of Contents
21.42 RTRV-FFP-<MOD2DWDMPAYLOAD>
21.74 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 RTRV (retrieve) commands for the Cisco ONS 15454, ONS 15327, ONS 15600 and ONS 15310-CL.
21.1 RTRV-<MOD1FCPAYLOAD>
Retrieve (1GFC, 2GFC)
Usage Guidelines
Cisco ONS 15454
This command retrieves the attributes related with the Fibre Channel port.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
Ports
Security
Retrieve
Related Commands
Input Format
RTRV-<MOD1FCPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-1GFC:CISCO:FAC-6-1:888;
Input Parameters
Table 21-1 RTRV-<MOD1FCPAYLOAD> Input Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28. Must not be null
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
Table 21-2 RTRV-<MOD1FCPAYLOAD> Output Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28
ROLE
The port role in Y-cable protection (WORK or PROT). Optional
Parameter type is SIDE—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
A port status in Y-cable protection (ACT or STBY). Optional
Parameter type is STATUS—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
Parameter type is LINKRATE—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
Parameter type is DIRN—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
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
DISTEXTN
Distance extension. Optional
Parameter type is DISTANCE_EXTENSION—distance extension
•
Buffer to buffer flow control
•
No distance extension
LINKCREDITS
Number of link credits. Integer. Optional
MFS
Maximum frame size. Integer. Optional
ENCAP
Frame encapsulation type. Optional
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
Identifies the port name. String. Optional
SOAK
OOS-AINS to IS transition soak time as measured in 15-minute intervals. Integer. Optional
SOAKLEFT
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. Optional
Rules for <SOAKLEFT> are as follows:•
•
•
FREQ
Optional. Parameter type is OPTICAL_WLEN—optical wavelength
•
Wavelength 1
•
Wavelength 2
•
Wavelength 3
•
Wavelength 4
•
Wavelength 5
•
Wavelength 6
•
Wavelength 7
•
Wavelength 8
•
Wavelength 9
•
Wavelength 10
•
Wavelength 11
•
Wavelength 12
•
Wavelength 13
•
Wavelength 14
•
Wavelength 15
•
Wavelength 16
•
Wavelength 17
•
Wavelength 18
•
Wavelength 19
•
Wavelength 20
•
Wavelength 21
•
Wavelength 22
•
Wavelength 23
•
Wavelength 24
•
Wavelength 25
•
Wavelength 26
•
Wavelength 27
•
Wavelength 28
•
Wavelength 29
•
Wavelength 30
•
Wavelength 31
•
Wavelength 32
•
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
Parameter type is PST_PSTQ—service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SST
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.2 RTRV-<MOD1FICONPAYLOAD>
Retrieve (1GFICON, 2GFICON)
Usage Guidelines
Cisco ONS 15454
This command returns fibre channel-specific settings for ports which have been configured to carry FICON traffic using the ENT-FICON command. 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
Related Commands
Input Format
RTRV-<MOD1FICONPAYLOAD>:[<TID>]:<AID>:<CTAG>;
Input Example
RTRV-1GFICON:CISCO:FAC-1-1:123;
Input Parameters
Table 21-3 RTRV-<MOD1FICONPAYLOAD> Input Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28. Must not be null
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
Table 21-4 RTRV-<MOD1FICONPAYLOAD> Output Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28
ROLE
The port role in Y-cable protection (WORK or PROT). Optional
Parameter type is SIDE—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
A port status in Y-cable protection (ACT or STBY). Optional
Parameter type is STATUS—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
Parameter type is LINKRATE—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
Parameter type is DIRN—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
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
DISTEXTN
Distance extension. Optional
Parameter type is DISTANCE_EXTENSION—distance extension
•
Buffer to buffer flow control
•
No distance extension
LINKCREDITS
Number of link credits. Integer. Optional
MFS
Maximum frame size. Integer. Optional
ENCAP
Frame encapsulation type. Optional
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
Identifies the port name. String. Optional
SOAK
OOS-AINS to IS transition soak time as measured in 15-minute intervals. Integer. Optional
SOAKLEFT
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. Optional
Rules for <SOAKLEFT> are as follows:•
•
•
FREQ
Optional. Parameter type is OPTICAL_WLEN—optical wavelength
•
Wavelength 1
•
Wavelength 2
•
Wavelength 3
•
Wavelength 4
•
Wavelength 5
•
Wavelength 6
•
Wavelength 7
•
Wavelength 8
•
Wavelength 9
•
Wavelength 10
•
Wavelength 11
•
Wavelength 12
•
Wavelength 13
•
Wavelength 14
•
Wavelength 15
•
Wavelength 16
•
Wavelength 17
•
Wavelength 18
•
Wavelength 19
•
Wavelength 20
•
Wavelength 21
•
Wavelength 22
•
Wavelength 23
•
Wavelength 24
•
Wavelength 25
•
Wavelength 26
•
Wavelength 27
•
Wavelength 28
•
Wavelength 29
•
Wavelength 30
•
Wavelength 31
•
Wavelength 32
•
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
Parameter type is PST_PSTQ—service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SST
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.3 RTRV-<MOD2DWDMPAYLOAD>
Retrieve (10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, D1VIDEO, DV6000, ETRCLO, GIGE, HDTV, ISC1, ISC3, PASSTHRU)
Usage Guidelines
Cisco ONS 15454
This command retrieves the configuration parameter of a DWDM client.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
DWDM
Security
Retrieve
Related Commands
Input Format
RTRV-<MOD2DWDMPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-HDTV:MILAN:FAC-1-1:100;
Input Parameters
Table 21-5 RTRV-<MOD2DWDMPAYLOAD> Input Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28. Must not be null
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
Table 21-6 RTRV-<MOD2DWDMPAYLOAD> Output Parameters
AIDUNIONID
Access identifier from the "25.1.2 AidUnionId" section on page 25-9
AIDTYPE
A type of access identifier
Parameter type is MOD2DWDMPAYLOAD—payload types applicable to DWDM ports
•
10 gigabit fibre channel payload
•
10 gigabit Ethernet
•
1 gigabit fibre channel payload
•
1 gigabit FICON payload
•
2 gigabit fibre channel payload
•
2 gigabit FICON payload
•
D1Video payload
•
DV6000 payload
•
ETR_CLO payload
•
Gigabit Ethernet payload
•
HDTV payload
•
ISC1 payload
•
ISC3 payload
•
Any pass through (2R) payload
ROLE
The port role in Y-cable protection (WORK or PROT). Optional
Parameter type is SIDE—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
A port status in Y-cable protection (ACT or STBY). Optional
Parameter type is STATUS—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
Identifies the port name. String. Optional
LBCL
Displays the current value of the laser current. Float. Optional
OPT
Displays the current value of the transmitted optical power. Float. Optional
OPR
Displays the current value of the received optical power. Float. Optional
FREQ
Optional. Parameter type is OPTICAL_WLEN—optical wavelength
•
Wavelength 1
•
Wavelength 2
•
Wavelength 3
•
Wavelength 4
•
Wavelength 5
•
Wavelength 6
•
Wavelength 7
•
Wavelength 8
•
Wavelength 9
•
Wavelength 10
•
Wavelength 11
•
Wavelength 12
•
Wavelength 13
•
Wavelength 14
•
Wavelength 15
•
Wavelength 16
•
Wavelength 17
•
Wavelength 18
•
Wavelength 19
•
Wavelength 20
•
Wavelength 21
•
Wavelength 22
•
Wavelength 23
•
Wavelength 24
•
Wavelength 25
•
Wavelength 26
•
Wavelength 27
•
Wavelength 28
•
Wavelength 29
•
Wavelength 30
•
Wavelength 31
•
Wavelength 32
•
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
Parameter type is PST_PSTQ—service state of the entity described by the primary state (PST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SST
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.4 RTRV-<MOD_RING>
Retrieve Bidirectional Line Switched Ring
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600
This command retrieves the BLSR information of the NE. A two-fiber or four-fiber BLSR can be retrieved.
Note
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"The following actions will return error messages:
•
•
•
Note
•
•
Category
BLSR
Security
Retrieve
Related Commands
Input Format
RTRV-<MOD_RING>:[<TID>]:[<AID>]:<CTAG>[::::];
Input Example
RTRV-BLSR:PETALUMA:ALL:123;
Input Parameters
Table 21-7 RTRV-<MOD_RING> Input Parameters
AID
Access identifier from the "25.1.3 AidUnionId1" section on page 25-12. Identifies the BLSR of the NE. Only ALL, null or a list of BLSR-# in AID are 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
Table 21-8 RTRV-<MOD_RING> Output Parameters
AID
Access identifier from the "25.1.3 AidUnionId1" section on page 25-12. Identifies the BLSR of the NE. Optional
RINGID
The BLSR ID of the NE up to six characters. Valid characters are A-Z and 0-9. String. Optional
NODEID
The BLSR node ID of the NE. NODEID ranges from 0 to 31. String. Optional
MODE
Mode with which the command is to be implemented. Identifies the BLSR mode; either two-fiber or four-fiber. Optional
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
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
Parameter type is REVERTIVE_TIME—revertive time
•
Revertive time is 0.5 to 12.0 minutes
SRVRTV
The span revertive mode for four-fiber BLSR only
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
Parameter type is REVERTIVE_TIME—revertive time
•
Revertive time is 0.5 to 12.0 minutes
EASTWORK
East working facility. AID from the "25.1.14 FACILITY" section on page 25-28
WESTWORK
West working facility. AID from the "25.1.14 FACILITY" section on page 25-28
EASTPROT
East protecting facility. AID from the "25.1.14 FACILITY" section on page 25-28
WESTPROT
West protecting facility. AID from the "25.1.14 FACILITY" section on page 25-28
21.5 RTRV-<OCN_TYPE>
Retrieve (OC3, OC12, OC48, OC192)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the attributes (for example, service parameters) and the state of an OC-N facility.
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, OC-192 ports within a BLSR connection. The RTRV-<MOD_RING> command with the AID BLSR-RINGID, can provide more information on this BLSR.
Note
UNI-C DCC provisioning notes:
1.
2.
3.
4.
5.
6.
7.
8.
Category
BLSR
Security
Retrieve
Related Commands
Input Format
RTRV-<OCN_TYPE>:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-OC48:PENNGROVE:FAC-6-1:236;
Input Parameters
Table 21-9 RTRV-<OCN_TYPE> Input Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28. Must not be null
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=SONET,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
Table 21-10 RTRV-<OCN_TYPE> Output Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28
ROLE
An OCn port role. Optional
Parameter type is SIDE—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
An OCn port status. Optional
Parameter type is STATUS—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
Indicates whether or not the section DCC is to be used. Optional
Parameter type is EXT_RING—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
AREA
Area ID. Shows up only if the DCC is enabled. String. Optional
TMGREF
The termination to be used, whether primary or secondary. Identifies if an OCn port has a timing reference. Defaults to N. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
SYNCMSG
Synchronization status message
Parameter type is EXT_RING—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
SENDDUS
The facility will send the DUS (Don't use for Synchronization) value in 0x0f bits pattern as the sync status message for that facility. Defaults to N. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
PJMON
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
An OCn port signal failure threshold. Defaults to 1E-4. Optional
Parameter type is SF_BER—the threshold for declaring signal failure on a facility or path
•
SFBER is 1E-3
•
SFBER is 1E-4
•
SFBER is 1E-5
SDBER
An OCn port signal degrade threshold. Defaults 1E-7. Optional
Parameter type is SD_BER—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
OCn port mode. Defaults to SONET. Optional
Parameter type is OPTICAL_MODE—the facility's optical mode
•
SDH/ETSI optical mode using European/International format
•
SONET/ANSI optical mode using the American format
WVLEN
An OCn port wavelength in nanometers. For example, WVLEN=1310.00 means it operates at 1310 nm in the DWDM application. Float. Optional
RINGID
The BLSR RINGID with which the port is connected. RINGID ranges from 0 to 9999. Integer. Optional
BLSRTYPE
The BLSR type with which the port is connected. Optional
Parameter type is BLSR_TYPE—BLSR type of an OCn port
•
The OCn port is an east protecting port
•
The OCn port is an east working port
•
The OCn port is an west protecting port
•
The OCn port is an west working port
MUX
BLSR extension byte. Optional
Parameter type is MUX_TYPE—BLSR extension byte
•
E2 byte (orderwire)
•
F1 byte (user)
•
K3 byte
•
Z2 byte
UNIC
Indicates if the port connects to the UCP. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
SOAK
OOS-AINS to IS transition soak time as measured in 15-minute intervals. Integer. Optional
SOAKLEFT
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. Optional
Rules for <SOAKLEFT> are as follows:•
•
•
SSMRCV
Displays the quality of the individual port. Optional
Parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL—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
The open shortest path first protocol. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
LDCC
The line DCC connection on the port. Optional
Parameter type is EXT_RING—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
Name. String. Optional
LBCL
Displays the current value of the laser current. Float. Optional
OPT
Displays the current value of the transmitted optical power. OPT is only displayed for DWDM cards. Float. Optional
OPR
Received optical power. Float. Optional
EXPTRC
Expected path trace content. String. Optional
TRC
Path trace message to be transmitted. String. Optional
TRCMODE
Path trace mode. Applicable only to STS-level Paths in SONET. Defaults to the OFF mode. Optional
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 AIS and RDI if TIMP 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 TIMP is detected
•
Turn off path trace capability. Nothing will be reported
TRCFORMAT
Trace message size. Optional
Parameter type is TRCFORMAT—trace format
•
1-byte trace message
•
16-byte trace message
•
64-byte trace message
•
Enable an attribute
ADMSSM
SSM selectable value. Only displayed when SSM is disabled. Optional
Parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL—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
Indicates that the facility will send the DUS (Don't use for synchronization) value in 0xff bits pattern as the sync status message for that facility. Defaults to N. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
AISONLPBK
AIS on loopback. Optional
Parameter type is AIS_ON_LPBK—Indicates if 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 1
•
Wavelength 2
•
Wavelength 3
•
Wavelength 4
•
Wavelength 5
•
Wavelength 6
•
Wavelength 7
•
Wavelength 8
•
Wavelength 9
•
Wavelength 10
•
Wavelength 11
•
Wavelength 12
•
Wavelength 13
•
Wavelength 14
•
Wavelength 15
•
Wavelength 16
•
Wavelength 17
•
Wavelength 18
•
Wavelength 19
•
Wavelength 20
•
Wavelength 21
•
Wavelength 22
•
Wavelength 23
•
Wavelength 24
•
Wavelength 25
•
Wavelength 26
•
Wavelength 27
•
Wavelength 28
•
Wavelength 29
•
Wavelength 30
•
Wavelength 31
•
Wavelength 32
•
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
Indicates whether the far-end NE on the DCC is a foreign NE. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
FOREIGNIPADDRESS
The IP address of the far-end NE on the DCC. Used only if FOREIGNFEND is Y. String. Optional
PST_PSTQ
Admin state in the PST_PSTQ format
Parameter type is PST_PSTQ—service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SSTQ
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.6 RTRV-<PATH>
Retrieve (STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, VT1, VT2)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the attributes associated with an STS/VT path.
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.
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 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
Related Commands
Input Format
RTRV-<PATH>:[<TID>]:<AID>:<CTAG>[:::BLSRPTHTYPE=<BLSRPTHTYPE>][:];
Input Example
RTRV-STS3C:FERNDALE:STS-2-1-4:238:::BLSRPTHTYPE=NON-PCA;
Input Parameters
Table 21-11 RTRV-<PATH> Input Parameters
AID
Access identifier from the "25.1.10 CrossConnectId1" section on page 25-20. Must not be null
BLSRPTHTYPE
The BLSR path type only if the port is on the BLSR. Defaults to NON-PCA. Applicable only to STS-level paths in SONET. A null value defaults to NON-PCA
Parameter type is BLSR_PTH_TYPE—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
Table 21-12 RTRV-<PATH> Output Parameters
AID
Access identifier from the "25.1.10 CrossConnectId1" section on page 25-20
LEVEL
The rate of the cross-connect. Indicates the rate of the cross-connected channel. Applicable only to STS path in SONET. Optional
Parameter type is PATH—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
An STS path signal failure threshold which only applies to path protection. Applicable only to STS-level paths in SONET. Defaults to 1E-4. Optional
Parameter type is SF_BER—the threshold for declaring signal failure on a facility or path
•
SFBER is 1E-3
•
SFBER is 1E-4
•
SFBER is 1E-5
SDBER
An STS path signal degrade threshold which only applies to path protection. Applicable only to STS-level paths in SONET. Defaults 1E-6. Optional
Parameter type is SD_BER—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
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
RVTM
Revertive time. Only applies to path protection
Parameter type is REVERTIVE_TIME—revertive time
•
Revertive time is 0.5 to 12.0 minutes
SWPDIP
Switch on PDI-P. Applicable only to STS-level paths in SONET. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
HOLDOFFTIMER
Hold off timer. Integer. Optional
EXPTRC
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 path protection path is created. Supported on the CE-100T-8 card (ONS 15310-CL) provisioned in mapper mode. String. Optional
TRC
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. String. Optional
INCTRC
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. String. Optional
TRCMODE
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. Optional
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 TIMP 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 TIMP detected
•
Turn off path trace capability. Nothing will be reported
TRCFORMAT
Trace message size. Optional
Parameter type is TRCFORMAT—trace format
•
1-byte trace message
•
16-byte trace message
•
64-byte trace message
•
Enable an attribute
TACC
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. Optional
TAPTYPE
TAP type. Not applicable to the ONS 15310-CL. Optional
Parameter type is TAPTYPE—test access point type
•
Dual FAD
•
Single FAD
UPSRPTHSTATE
Indicates whether a given AID is the working or standby path of a path protection cross-connect. Optional
Parameter type is STATUS—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
The c2 byte hex code. Applicable only to STS-level paths in SONET (STSn). Optional
Parameter type is C2_BYTE—c2 byte hex code
•
Unequipped
•
Equipped-Non Specific payload
•
VT-Structured STS-1 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 AIS-L is being generated by an optical card or cross-connect downstream
BLSRPTHSTATE
The BLSR path state only if the port is on the BLSR. Applicable only to STS-level paths in SONET (STSn). Optional
Parameter type is BLSR_PTH_STATE—the BLSR path state only if the port is on the BLSR
•
Indicates the BLSR is un-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
Admin state in the PST_PSTQ format
Parameter type is PST_PSTQ—service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SSTQ
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.7 RTRV-10GIGE
Retrieve 10GIGE
Usage Guidelines
Cisco ONS 15454
This command retrieves the 10 Gbps-specific parameters for a port that has been configured to support the gigabyte Ethernet payload with the ENT-10GIGE command.
Category
Ports
Security
Retrieve
Related Commands
Input Format
RTRV-10GIGE:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-10GIGE:TID:FAC-1-1:100;
Input Parameters
Table 21-13 RTRV-10GIGE Input Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28. Must not be null
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
Table 21-14 RTRV-10GIGE Output Parameters
AID
Access identifier from the "25.1.14 FACILITY" section on page 25-28
ROLE
The port role in Y-cable protection (WORK or PROT). Optional
Parameter type is SIDE—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
A port status in Y-cable protection (ACT or STBY). Optional
Parameter type is STATUS—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
Port name. String. Optional
MACADDR
The MAC address for the 10 gigabyte Ethernet payload. String. Optional
LBCL
Displays the current value of the laser current. Float. Optional
OPT
Displays the current value of the transmitted optical power. Float. Optional
OPR
Displays the current value of the received optical power. Float. Optional
FREQ
Optional. Parameter type is OPTICAL_WLEN—optical wavelength
•
Wavelength 1
•
Wavelength 2
•
Wavelength 3
•
Wavelength 4
•
Wavelength 5
•
Wavelength 6
•
Wavelength 7
•
Wavelength 8
•
Wavelength 9
•
Wavelength 10
•
Wavelength 11
•
Wavelength 12
•
Wavelength 13
•
Wavelength 14
•
Wavelength 15
•
Wavelength 16
•
Wavelength 17
•
Wavelength 18
•
Wavelength 19
•
Wavelength 20
•
Wavelength 21
•
Wavelength 22
•
Wavelength 23
•
Wavelength 24
•
Wavelength 25
•
Wavelength 26
•
Wavelength 27
•
Wavelength 28
•
Wavelength 29
•
Wavelength 30
•
Wavelength 31
•
Wavelength 32
•
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
Admin state in the PST_PSTQ format
Parameter type is PST_PSTQ—service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SSTQ
Secondary state of the entity. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.8 RTRV-ALM-<MOD2ALM>
Retrieve Alarm (1GFC, 1GFICON, 2GFC, 2GFICON, CLNT, DS1, E100, E1000, E3, E4, EC1, FSTE, G1000, GFPOS, GIGE, OC12, OC192, OC3, OC48, OCH, OMS, OTS, POS, STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, T1, T3, UDCDCC, UDCF, VC12, VC3, VCG, VT1, VT2, WLEN)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This 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.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Note
Note
Category
Fault
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-<MOD2ALM>:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<CONDTYPE>],
[<SRVEFF>][,,,];Input Example
RTRV-ALM-OC12:ELDRIDGE:FAC-5-1:225::MN,SD,SA;
Input Parameters
Table 21-15 RTRV-ALM-<MOD2ALM> Input Parameters
AID
Access identifier from the "25.1.2 AidUnionId" section on page 25-9. Must not be null
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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. A null value is equivalent to ALL
Parameter type is CONDITION—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
Parameter type is SERV_EFF—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
"FAC-5-1,OC12:MJ,SD,SA,09-05,12-30-20,,:\"BER AT SIGNAL DEGRADE LEVEL\","
;Output Parameters
Table 21-16 RTRV-ALM-<MOD2ALM> Output Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1
AIDTYPE
Type of access identifier. Optional
Parameter type is MOD2ALM—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
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
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
UDCDCC alarm
•
UCDF alarm
•
Virtual Concatenation Group alarm
•
VT1 alarm
•
VT2 alarm
•
Wavelength Path Provisioning
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
21.9 RTRV-ALM-ALL
Retrieve Alarm All
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves and sends the current status of all active alarm conditions. The alarm condition or severity to be retrieved is specified using the input parameters as a filter.
According to GR-833, the RTRV-ALM-ALL command only reports EQPT, COM, and rr (T1, T3, OCN, EC1, STSN, VT1, DS1, E100, E1000, G1000, ML-Series, TXP and MXP) alarms.
To retrieve all the NE alarms, issue all of the following commands:
RTRV-ALM-ALL
RTRV-ALM-BITS
RTRV-ALM-ENV
RTRV-ALM-SYNCNCategory
Fault
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-ALL:[<TID>]:[<AID>]:<CTAG>::[<NTFCNCDE>],[<CONDITION>],
[<SRVEFF>][,,,];Input Example
RTRV-ALM-ALL:COTATI:ALL:229::MN,PWRRESTART,NSA;
Input Parameters
Table 21-17 RTRV-ALM-ALL Input Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1. A null value is equivalent to ALL. String
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
CONDITION
The type of alarm condition. A null value is equivalent to ALL
Parameter type is CONDITION—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
Parameter type is SERV_EFF—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>,,,,:[<DESC>],[<AIDDET>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"SLOT-2,EQPT:MN,PWRRESTART,NSA,,,,:\"POWER FAIL RESTART\",DS1-14"
;Output Parameters
Table 21-18 RTRV-ALM-ALL Output Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1. Optional
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
DESC
A condition description. String. Optional
AIDDET
AIDDET uses the same addressing rules as the AID, but specifies AID type and additional details about the entity being managed. The supplementary equipment identification. Optional
21.10 RTRV-ALM-BITS
Retrieve Alarm Building Integrated Timing Supply
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves and sends the current status of alarm conditions associated with the BITS facility. The alarm condition or severity retrieved is specified using the input parameters as a filter.
Category
Synchronization
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-BITS:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<CONDTYPE>],[<SRVEFF>][,,,];
Input Example
RTRV-ALM-BITS:ELVERANO:BITS-1:228::CR,LOS,SA;
Input Parameters
Table 21-19 RTRV-ALM-BITS Input Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13. Must not be null
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
The condition type for an alarm or reported event. A null value is equivalent to ALL
Parameter type is CONDITION—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
Parameter type is SERV_EFF—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>,,,,:[<DESC>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"BITS-1,BITS:CR,LOS,SA,,,,:\"LOSS OF SIGNAL\","
;Output Parameters
Table 21-20 RTRV-ALM-BITS Output Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13. Optional
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
DESC
A condition description. String. Optional
21.11 RTRV-ALM-ENV
Retrieve Alarm Environment
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the environmental alarms.
Category
Environment
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-ENV:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<ALMTYPE>];
Input Example
RTRV-ALM-ENV:CISCO:ENV-IN-1:123::MJ,OPENDR;
Input Parameters
Table 21-21 RTRV-ALM-ENV Input Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Must not be null
Note
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
ALMTYPE
The alarm type for the environmental alarm. A null value is equivalent to ALL
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnected bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:<NTFCNCDE>,<ALMTYPE>,[<OCRDAT>],[<OCRTM>],[<DESC>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"ENV-IN-1:MJ,OPENDR,08-01,14-25-59,\"OPEN DOOR\""
;Output Parameters
Table 21-22 RTRV-ALM-ENV Output Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
ALMTYPE
The alarm type for the environmental alarm. A null value is equivalent to ALL
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnected bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
OCRDAT
Date. Optional
OCRTM
Time. Optional
DESC
A condition description. String. Optional
21.12 RTRV-ALM-EQPT
Retrieve Alarm Equipment
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves and sends the current status of alarm conditions associated with the equipment units. The alarm condition or severity to be retrieved is specified using the input parameters as a filter.
Category
Equipment
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-EQPT:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<CONDTYPE>],[<SRVEFF>][,,,];
Input Example
RTRV-ALM-EQPT:TWOROCK:SLOT-7:227::MJ,HITEMP,NSA;
Input Parameters
Table 21-23 RTRV-ALM-EQPT Input Parameters
AID
Access identifier from the "25.1.13 EQPT" section on page 25-27. Must not be null
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
The condition type for an alarm or a reported event. A null value is equivalent to ALL
Parameter type is CONDITION—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
Parameter type is SERV_EFF—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
"SLOT-7,EQPT:MJ,HITEMP,NSA,08-01,14-25-59,,:\"HI TEMPERATURE\","
;Output Parameters
Table 21-24 RTRV-ALM-EQPT Output Parameters
AID
Access identifier from the "25.1.13 EQPT" section on page 25-27. Optional
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date. Optional
OCRTM
Time. Optional
DESC
A condition description. String. Optional
21.13 RTRV-ALM-SYNCN
Retrieve Alarm Synchronization
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves and sends the current status of alarm conditions associated with a synchronization facility. The alarm condition or severity to be retrieved can be specified by using the input parameters as a filter.
Category
Synchronization
Security
Retrieve
Related Commands
Input Format
RTRV-ALM-SYNCN:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<CONDTYPE>],
[<SRVEFF>][,,,];Input Example
RTRV-ALM-SYNCN:FULTON:SYNC-NE:226::CR,FAILTOSW,SA;
Input Parameters
Table 21-25 RTRV-ALM-SYNCN Input Parameters
AID
Access identifier from the "25.1.25 SYNC_REF" section on page 25-40. Must not be null
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
The condition type for an alarm or a reported event. A null value is equivalent to ALL
Parameter type is CONDITION—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
Parameter type is SERV_EFF—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
"SYNC-NE,SYNCN:CR,FAILTOSW,SA,08-01,
14-25-59,,:\"FAILURE TO SWITCH TO PROTECTION\","
;Output Parameters
Table 21-26 RTRV-ALM-SYNCN Output Parameters
AID
Access identifier from the "25.1.23 SYN" section on page 25-39
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
Parameter type is CONDITION—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
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date. Optional
OCRTM
Time. Optional
DESC
A condition description. String. Optional
21.14 RTRV-ALMTH-<MOD2>
Retrieve Alarm Threshold (10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, CLNT, D1VIDEO, DS1, DV6000, E1, E3, E4, EC1, ESCON, ETRCLO, FSTE, G1000, GFPOS, GIGE, HDTV, ISC1, OC12, OC192, OC3, OC48, OCH, OMS, OTS, POS, STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, T1, T3, VC12, VC3, VT1, VT2)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15310-CL
This command retrieves the alarm threshold values. The only applicable MOD2 values are OC3, OC12, OC48, OC192, OCH, OMS, and OTS.
Category
DWDM
Security
Retrieve
Related Commands
Input Format
RTRV-ALMTH-<MOD2>:[<TID>]:<AID>:<CTAG>::[<CONDTYPE>][,,::];
Input Example
RTRV-ALMTH-{MOD2}::CHAN-2-2:1::OPT-HIGH;
Input Parameters
Table 21-27 RTRV-ALMTH-<MOD2> Input Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1. Must not be null
CONDTYPE
Alarm threshold. A null value is equivalent to ALL
Parameter type is ALM_THR—alarm threshold list for MXP_2.5G_10G, TXP_MR_10G, OSCM, OSC-CSM, OPT-PRE, OPT-BST, 4MD-xx.x, 32MUX-O, 32DMX-O, AD-1C-xx.x, AD-2C-xx.x, AD-4C-xx.x, AD-1B-xx.x, and AD-4B-xx.x cards
•
Battery Voltage - Extremely High
•
Battery Voltage - Extremely Low
•
Battery Voltage - High
•
Battery Voltage - Low
•
Gain not reached—High Degrade Threshold
•
Gain not reached—High Failure Threshold
•
Gain not reached—Low Degrade Threshold
•
Gain not reached—Low Failure Threshold
•
Laser Bias current in uA as 1/10% High Warning Threshold, Low Warning Threshold Measured value [0.0%, 100.0%]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Optical Power—High Degrade Threshold
•
Optical Power—High Failure Threshold
•
Optical Power—Low Degrade Threshold
•
Optical Power—Low Failure Threshold
•
VOA Attenuation—High Degrade Threshold
•
VOA Attenuation—High Failure Threshold
•
VOA Attenuation—Low Degrade Threshold
•
VOA Attenuation—Low Failure Threshold
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,<MOD>:<CONDTYPE>,,,<THLEVEL>";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"CHAN-2-2,OCH:OPT-HIGH,,,20"
;Output Parameters
Table 21-28 RTRV-ALMTH-<MOD2> Output Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1
MOD
AID type
Parameter type is MOD2—line/path modifier
•
10 Gigabit fibre channel
•
10 Gigabit Ethernet
•
1 Gigabit fibre channel
•
1 Gigabit FICON
•
2 Gigabit fibre channel
•
2 Gigabit FICON
•
D1 Video
•
DS1 line of a DS3XM card
•
DS3I line
•
DV6000
•
EC1 facility
•
ESCON
•
ETR_CLO
•
FSTE facility
•
G1000 facility
•
Generic Framing Protocol over Packet Over SONET. Virtual Ports partitioned using GFP's Multiplexing Capability
•
GIG Ethernet
•
HDTV
•
ISC1
•
OC3 facility
•
OC12 facility
•
OC48 facility
•
OC192 facility
•
Optical channel
•
Optical Multiplex Section
•
Optical Transport Section
•
POS port
•
STS1 path
•
STS3C path
•
STS6C path
•
STS9C path
•
STS18C path
•
STS12C path
•
STS24C path
•
STS36C path
•
STS48C path
•
STS192C path
•
T1/DS1 facility/line
•
T1/DS1 facility/line
•
VT1 Path
•
VT2 Path
CONDTYPE
Condition type for an alarm or a reported event
Parameter type is ALM_THR—alarm threshold list for MXP_2.5G_10G, TXP_MR_10G, OSCM, OSC-CSM, OPT-PRE, OPT-BST, 4MD-xx.x, 32MUX-O, 32DMX-O, AD-1C-xx.x, AD-2C-xx.x, AD-4C-xx.x, AD-1B-xx.x, and AD-4B-xx.x cards
•
Battery Voltage - Extremely High
•
Battery Voltage - Extremely Low
•
Battery Voltage - High
•
Battery Voltage - Low
•
Gain not reached—High Degrade Threshold
•
Gain not reached—High Failure Threshold
•
Gain not reached—Low Degrade Threshold
•
Gain not reached—Low Failure Threshold
•
Laser Bias current in uA as 1/10% High Warning Threshold, Low Warning Threshold Measured value [0.0%, 100.0%]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Optical Power—High Degrade Threshold
•
Optical Power—High Failure Threshold
•
Optical Power—Low Degrade Threshold
•
Optical Power—Low Failure Threshold
•
VOA Attenuation—High Degrade Threshold
•
VOA Attenuation—High Failure Threshold
•
VOA Attenuation—Low Degrade Threshold
•
VOA Attenuation—Low Failure Threshold
THLEVEL
Threshold level. Float
21.15 RTRV-ALMTH-EQPT
Retrieve Alarm Threshold Equipment
Usage Guidelines
Cisco ONS 15454
This command retrieves the alarm thresholds for the power level monitoring on an NE.
Category
Equipment
Security
Retrieve
Related Commands
Input Format
RTRV-ALMTH-EQPT:[<TID>]:<AID>:<CTAG>::[<CONDTYPE>][,,::];
Input Example
RTRV-ALMTH-EQPT:::1::BATV-HIGH;
Input Parameters
Table 21-29 RTRV-ALMTH-EQPT Input Parameters
AID
Access identifier from the "25.1.7 CHANNEL" section on page 25-14
CONDTYPE
Must not be null
Parameter type is ALM_THR—alarm threshold list for MXP_2.5G_10G, TXP_MR_10G, OSCM, OSC-CSM, OPT-PRE, OPT-BST, 4MD-xx.x, 32MUX-O, 32DMX-O, AD-1C-xx.x, AD-2C-xx.x, AD-4C-xx.x, AD-1B-xx.x, and AD-4B-xx.x cards
•
Battery Voltage - Extremely High
•
Battery Voltage - Extremely Low
•
Battery Voltage - High
•
Battery Voltage - Low
•
Gain not reached—High Degrade Threshold
•
Gain not reached—High Failure Threshold
•
Gain not reached—Low Degrade Threshold
•
Gain not reached—Low Failure Threshold
•
Laser Bias current in uA as 1/10% High Warning Threshold, Low Warning Threshold Measured value [0.0%, 100.0%]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm]
•
Receive power in 1/10 uW Measured value [-40.0 dBm,+30.0 dBm
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Transmit power in 1/10 uW. Measured value [-40.0 dBm,+30.0 dBm]
•
Optical Power—High Degrade Threshold
•
Optical Power—High Failure Threshold
•
Optical Power—Low Degrade Threshold
•
Optical Power—Low Failure Threshold
•
VOA Attenuation—High Degrade Threshold
•
VOA Attenuation—High Failure Threshold
•
VOA Attenuation—Low Degrade Threshold
•
VOA Attenuation—Low Failure Threshold
Output Format
SID DATE TIME
M CTAG COMPLD
",<MOD2B>:<CONDTYPE>,,,<DNFIELD>";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
",EQPT:BATV-HIGH,,,-52.0,"
;Output Parameters
21.16 RTRV-ALS
Retrieve Automatic Laser Shutoff
Usage Guidelines
Cisco ONS 15454, 15310-CL
This command retrieves the ALS attributes of an OC-N facility and all the facilities that support the ALS feature. This command is used to retrieve the ALS parameter of the OC48 and OC192 ports on the MXP_2.5G_10E, TXP_MR_10E, TXP_MR_2.5G, TXPP_MR_2.5G, MXP_2.5G_10G, and TXP_MR_10G cards
Category
Ports
Security
Retrieve
Related Commands
Input Format
RTRV-ALS:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-ALS:PENNGROVE:FAC-1-1:1;
Related Commands
Table 21-31 RTRV-ALS Input Parameters
AID
Access identifier from the "25.1.2 AidUnionId" section on page 25-9. Must not be null
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,<AIDTYPE>::[ALSMODE=<ALSMODE>],[ALSRCINT=<ALSRCINT>],
[ALSRCPW=<ALSRCPW>],[LSRSTAT=<LSRSTAT>]";
Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-6-1,OC192::ALSMODE=DISABLED,ALSRCINT=100,ALSRCPW=2.0,LSRSTAT=ON:"
;Output Parameters
Table 21-32 RTRV-ALS Output Parameters
AID
Access identifier from the "25.1.2 AidUnionId" section on page 25-9
AIDTYPE
Type of access identifier
Parameter type is MOD2—line/path modifier
•
10 Gigabit fibre channel
•
10 Gigabit Ethernet
•
1 Gigabit fibre channel
•
1 Gigabit FICON
•
2 Gigabit fibre channel
•
2 Gigabit FICON
•
D1 Video
•
DS1 line of a DS3XM card
•
DS3I line
•
DV6000
•
EC1 facility
•
ESCON
•
ETR_CLO
•
FSTE facility
•
G1000 facility
•
Generic Framing Protocol over Packet Over SONET. Virtual Ports partitioned using GFP's Multiplexing Capability
•
GIG Ethernet
•
HDTV
•
ISC1
•
OC3 facility
•
OC12 facility
•
OC48 facility
•
OC192 facility
•
Optical channel
•
Optical Multiplex Section
•
Optical Transport Section
•
POS port
•
STS1 path
•
STS3C path
•
STS6C path
•
STS9C path
•
STS18C path
•
STS12C path
•
STS24C path
•
STS36C path
•
STS48C path
•
STS192C path
•
T1/DS1 facility/line
•
T1/DS1 facility/line
•
VT1 Path
•
VT2 Path
ALSMODE
ALS is enabled or disabled
Parameter type is ALS_MODE—the working mode for automatic laser shutdown
•
Automatic
•
Disabled
•
Manual
•
Manual restart for test
ALSRCINT
ALS recovery interval. The range is 60 to 300 seconds. Integer. Optional
ALSRCPW
ALS recovery pulse width. The range is 2.0 to 100.00 seconds, in increments of 100 ms. Float. Optional
LSRSTAT
Status of the laser. Optional
Parameter type is LASER_STATUS—laser status
•
Laser is switched on but is working automatic power reduction
•
Laser is switched off
•
Laser is switched on
21.17 RTRV-APC
Operate Amplification Power Control
Usage Guidelines
Cisco ONS 15454
This command retrieves the APC application attributes.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
RTRV-APC:[<TID>]::<CTAG>;
Input Example
RTRV-APC:PENNGROVE::114;
Input Parameters
Output Format
SID DATE TIME
M CTAG COMPLD
"::[APCENABLE=<APCENABLE>],[APCSTATE=<APCSTATE>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"::APCENABLE=Y,APCSTATE=WORKING"
;Output Parameters
21.18 RTRV-ATTR-CONT
Retrieve Attribute Control
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves and sends the attributes associated with an external control. These attributes are used when an external control is operated or released. To set these attributes, use the SET-ATTR-CONT command.
Category
Environment
Security
Retrieve
Related Commands
OPR-ACO-ALL
OPR-EXT-CONT
REPT ALM ENV
REPT EVT ENV
RLS-EXT-CONT
RTRV-ALM-ENV
RTRV-ATTR-ENV
RTRV-COND-ENV
RTRV-EXT-CONT
SET-ATTR-CONT
SET-ATTR-ENV
SET-ATTR-SECUDFLT
Input Format
RTRV-ATTR-CONT:[<TID>]:<AID>:<CTAG>[::<CONTTYPE>];
Input Example
RTRV-ATTR-CONT:CISCO:ENV-OUT-2:123::AIRCOND;
Input Parameters
Table 21-35 RTRV-ATTR-CONT Input Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Identifies the external control for which attributes are being set. Must not be null
CONTTYPE
Environmental control type. A null value is equivalent to ALL
Parameter type is CONTTYPE—Environmental control types
•
Air conditioning
•
Engine
•
Fan
•
Generator
•
Heat
•
Light
•
Miscellaneous
•
Sprinkler
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:[<CONTTYPE>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"ENV-OUT-2:AIRCOND"
;Output Parameters
Table 21-36 RTRV-ATTR-CONT Output Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Identifies the external control for which attributes are being set. Must not be null
CONTTYPE
Environmental control type. A null value is equivalent to ALL
Parameter type is CONTTYPE—Environmental control types
•
Air conditioning
•
Engine
•
Fan
•
Generator
•
Heat
•
Light
•
Miscellaneous
•
Sprinkler
21.19 RTRV-ATTR-ENV
Retrieve Attribute Environment
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the attributes associated with an environmental alarm.
Category
Environment
Security
Retrieve
Related Commands
OPR-ACO-ALL
OPR-EXT-CONT
REPT ALM ENV
REPT EVT ENV
RLS-EXT-CONT
RTRV-ALM-ENV
RTRV-ATTR-CONT
RTRV-COND-ENV
RTRV-EXT-CONT
SET-ATTR-CONT
SET-ATTR-ENV
SET-ATTR-SECUDFLT
Input Format
RTRV-ATTR-ENV:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<ALMTYPE>];
Input Example
RTRV-ATTR-ENV:CISCO:ENV-IN-1:123::MJ,OPENDR;
Input Parameters
Table 21-37 RTRV-ATTR-ENV Input Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Must not be null
NTFCNCDE
Two-letter notification code
Parameter type is NOTIF_CODE—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
ALMTYPE
The alarm type for the environmental alarm. A null value is equivalent to ALL
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail, or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnect bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:[<NTFCNCDE>],[<ALMTYPE>],[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"ENV-IN-1:MJ,OPENDR,\"OPEN DOOR\""
;Output Parameters
Table 21-38 RTRV-ATTR-ENV Output Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Must not be null
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
ALMTYPE
The alarm type for the environmental alarm. Optional
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnect bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
DESC
Alarm description. String. Optional
21.20 RTRV-AUDIT-LOG
Retrieve Audit Log
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the contents of the audit log stored in the NE. Audit records contain information for user operations such as login, logout, change of provisioning parameters and other changes a user might make when connected to the NE. Audit records do not store operations related to parameter retrieval.
Category
Log
Security
Superuser
Related Commands
Input Format
RTRV-AUDIT-LOG:[<TID>]::<CTAG>;
Input Example
RTRV-AUDIT-LOG:::1;
Input Parameters
Output Format
SID DATE TIME
M CTAG COMPLD
" <ENTRYNUM>,<OCRDAT>,<OCRTM>,<TASKID>,<TXSTATUS>,<DESCRIPTION>"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
" 17172,2004-10-05,09-52-44, TPROVMGR,COMPLD,
\17172,2004-10-05,09-52-44, TPROVMGR,COMPLD,\"DESCRIPTION\""
;Output Parameters
21.21 RTRV-BFDLPM-<MOD2>
Retrieve BFDL Performance Monitoring (DS1, T1)
Usage Guidelines
Cisco ONS 15454
This command retrieves the BFDL (enhanced 24-hour ES, UAS, BES, CSS and LOFC) performance monitoring parameters and applies to the DS3XM-12 card DS1 under BFDL mode. This command returns the current 15-minute and current 24-hour BFDL PMs and the 96 15-minute history requested type PMs.
For example:
Input:
RTRV-BFDLPM-DS1::DS1-14-1-1:1:::REQTYPE=ENH-24HR-ES;
Output:
DS1-14-1-1:ES,30,CURR-15MIN-INV DS1-14-1-1:UAS,40,CURR-15MIN-INV DS1-14-1-1:BES,50,CURR-15MIN-INV DS1-14-1-1:SES,60,CURR-15MIN-INV DS1-14-1-1:CSS,70,CURR-15MIN-INV DS1-14-1-1:LOFC,80,CURR-15MIN-INV DS1-14-1-1:ES,30,CURR-24HR-INV DS1-14-1-1:UAS,40,CURR-24HR-INV DS1-14-1-1:BES,50,CURR-24HR-INV DS1-14-1-1:SES,60,CURR-24HR-INV DS1-14-1-1:CSS,70,CURR-24HR-INV DS1-14-1-1:LOFC,80,CURR-24HR-INV DS1-14-1-1:ES,30,1-15MIN-INV DS1-14-1-1:ES,40,2-15MIN-INV
DS1-14-1-1:ES,50,3-15MIN-INV
DS1-14-1-1:ES,80,96-15MIN-INVSending this command with a REQTYPE of ENH-24HR-CSS-AND-LOFC will retrieve 96 15-minute PMs for both CSS and LOFC. The command is applied on the DS3XM-12 DS1 under BFDL mode, ESF frame format, C-BIT IS port with an IS VT circuit configuration.
Category
Performance
Security
Retrieve
Related Commands
Input Format
RTRV-BFDLPM-<MOD2>:[<TID>]:<AID>:<CTAG>:::REQTYPE=<REQTYPE>;
Input Example
RTRV-BFDLPM-DS1:TID:DS1-14-1-1:123:::REQTYPE=ENH-24HR-ES;
Input Parameters
Table 21-41 RTRV-BFDLPM-<MOD2> Input Parameters
AID
Access identifier from the "25.1.11 DS1" section on page 25-26. Must not be null
REQTYPE
Indicates requested BFDL PM type. Must not be null
Parameter type is REQTYPE—requested PM type
•
The enhanced 24-hour BES performance data
•
The enhanced 24-hour CSS-AND-LOFC performance data
•
The enhanced 24-hour ES performance data
•
The enhanced 24-hour SES performance data
•
The enhanced 24-hour UAS performance data
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:<MONTYPE>,<MONVAL>,<BUCKET>"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"DS1-14-1-1:ES,55,CURR-15MIN-INV"
;Output Parameters
Table 21-42 RTRV-BFDLPM-<MOD2> Output Parameters
AID
Access identifier from the "25.1.11 DS1" section on page 25-26
MONTYPE
Monitored type which includes: BES, CSS, ES, LOFC, SES, UAS. String
MONVAL
The value to which the register identified by MONTYPE is to be initialized to or the measured value of a monitored parameter. The value is in the form of numeric counts or rates. String
BUCKET
The BIN of each BFDL PM. String
21.22 RTRV-BITS
Retrieve Building Integrated Timing Supply
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the BITS configuration command. For BITS facility, 64 K and 6 MHz are only applicable to the ONS 15454. SSM selectable (ADMSSM) is not applicable to the ONS 15600.
Category
Synchronization
Security
Retrieve
Related Commands
ED-BITS
ED-NE-SYNCN
ED-SYNCN
OPR-SYNCNSW
REPT ALM BITS
REPT ALM SYNCN
REPT EVT BITS
REPT EVT SYNCN
RLS-SYNCNSW
RTRV-ALM-BITS
RTRV-ALM-SYNCN
RTRV-COND-BITS
RTRV-COND-SYNCN
RTRV-NE-SYNCN
RTRV-SYNCN
Input Format
RTRV-BITS:[<TID>]:<AID>:<CTAG>[::::];
Input Example
RTRV-BITS:SONOMA:BITS-1:782;
Input Parameters
Table 21-43 RTRV-BITS Input Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13. Must not be null
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>::[LINECDE=<LINECDE>],[FMT=<FMT>],[LBO=<LBO>],
[SYNCMSG=<SYNCMSG>],[AISTHRSHLD=<AISTHRSHLD>],[SABIT=<SABIT>],
[IMPEDANCE=<IMPEDANCE>],[BITSFAC=<BITSFAC>],[ADMSSM=<ADMSSM>]:[<PST>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"BITS-1::LINECDE=AMI,FMT=ESF,LBO=0-133,SYNCMSG=N,AISTHRSHLD=PRS,
SABIT=BYTE-4,IMPEDANCE=120-OHM,BITSFAC=T1,ADMSSM=PRS:IS"
;Output Parameters
Table 21-44 RTRV-BITS Output Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13
LINECDE
Line code. Optional
Parameter type is LINE_CODE—line code
•
Line code value is AMI
•
Line code value is B8ZS (bipolar with three-zero substitution)
FMT
Digital signal frame format. Optional
Parameter type is FRAME_FORMAT—frame format for a T1 port
•
Frame format is D4
•
Frame format is ESF
•
Frame format is unframed
LBO
Line build out settings. BITS line build out. Default value is 0 to 133. Integer. Optional
Parameter type is BITS_LineBuildOut—BITS line buildout
•
BITS line buildout range is 0-133
•
BITS line buildout range is 134-266
•
BITS line buildout range is 267-399
•
BITS line buildout range is 400-533
•
BITS line buildout range is 534-655
SYNCMSG
Indicates if the BITS facility supports synchronization status message. Default is on (Y)
Parameter type is EXT_RING—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
AISTHRSHLD
Alarm indication signal threshold. Optional
Parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL—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)
SABIT
When the frame format selection is E1, SABIT is the BIT used to receive and transmit the SSM. Optional
Parameter type is SABITS—SA BITS
•
SABIT is BYTE-4
•
SABIT is BYTE-5
•
SABIT is BYTE-6
•
SABIT is BYTE-7
•
SABIT is BYTE-8
IMPEDANCE
When the frame format selection is E1, IMPEDANCE is the terminal impedance of the BITS-IN port. Optional
Parameter type is IMPEDANCE—the terminal impedance of the BITS-IN port
•
Impedance of 120 ohms
•
Impedance of 75 ohms
BITSFAC
BITS facility settings. Optional
Parameter type is BITS_FAC—BITS facility rate. 64 K and 6 MHz are only applicable to the ONS 15454
•
2 MHz rate
•
64 K rate
•
6 MHz rate
•
E1 rate
•
T1 rate
ADMSSM
SSM selectable. Only applicable to BITS-IN when SSM is disabled. Optional
Note
Parameter type is SYNC_CLOCK_REF_QUALITY_LEVEL—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)
PST
Primary state. Optional
Parameter type is PST—indicates the current overall service condition of an entity
•
In service
•
Out of service
21.23 RTRV-BULKROLL<OCN_TYPE>
Retrieve Bulkroll (OC12, OC192, OC3, OC48)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600
This command retrieves roll data parameters on a line.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
Bridge and Roll
Security
Provisioning
Related Commands
Input Format
RTRV-BULKROLL-<OCN_TYPE>:[<TID>]:<SRC>:<CTAG>;
Input Example
RTRV-BULKROLL-OC12:CISCO:FAC-3-1:1;
Input Parameters
Table 21-45 RTRV-BULKROLL-<OCN_TYPE> Input Parameters
SRC
Source AID from the "25.1.14 FACILITY" section on page 25-28. Must not be null
Output Format
SID DATE TIME
M CTAG COMPLD
"<FROM>:RFROM=<RFROM>,RTO=<RTO>,[RMODE=<RMODE>],VLDSIG=<VLDSIG>"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"STS-3-1-1:RFROM=STS-3-1-1,RTO=STS-5-1-1,RMODE=AUTO,VLDSIG=Y"
;Output Parameters
Table 21-46 RTRV-BULKROLL-<OCN_TYPE> Output Parameters
FROM
One of the end points. Access identifier from the "25.1.14 FACILITY" section on page 25-28 for line level rolling and bulk rolling
RFROM
The termination point of the existing cross-connect that is to be rolled. The AID is from the "25.1.10 CrossConnectId1" section on page 25-20 (except VCM and FACILITY)
RTO
The termination point that will become a leg of the new cross-connection. The AID is from the "25.1.10 CrossConnectId1" section on page 25-20 (except VCM and FACILITY)
RMODE
The rolling mode of operation. Optional
Parameter type is ALS_MODE—specifies the working mode for the automatic laser shutdown (ALS) functionality
•
Automatic
•
Disabled
•
Manual
•
Manual Restart for Test
VLDSIG
The rolling mode of operation. Optional
Parameter type is ON_OFF—disable or enable an attribute
•
Disable an attribute
•
Enable an attribute
21.24 RTRV-CMD-SECU
Retrieve Command Security
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the current command security level of the command specified in the AID field.
Category
Security
Security
Superuser
Related Commands
Input Format
RTRV-CMD-SECU:[<TID>]:<AID>:<CTAG>;
Input Example
RTRV-CMD-SECU::INIT-REG:1;
Input Parameters
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:<CAP>"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"INIT-REG:PROV"
;Output Parameters
21.25 RTRV-COND-<MOD2ALM>
Retrieve Condition (1GFC, 1GFICON, 2GFC, 2GFICON, CLNT, DS1, E100, E1000, E3, E4, EC1, FSTE, G1000, GFPOS, GIGE, OC12, OC192, OC3, OC48, OCH, OMS, OTS, POS, STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, T1, T3, UDCDCC, UDCF, VC12, VC3, VCG, VT1, VT2, WLEN)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the current standing condition and state associated with an entity.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Category
Fault
Security
Retrieve
Related Commands
Input Format
RTRV-COND-<MOD2ALM>:[<TID>]:<AID>:<CTAG>::[<TYPEREQ>][,,,];
Input Example
RTRV-COND-T3:TID:FAC-2-1:229::LOS;
Input Parameters
Table 21-49 RTRV-COND-<MOD2ALM> Input Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1. Must not be null
TYPEREQ
The type of condition to be retrieved. A null value is equivalent to ALL
Parameter type is CONDITION—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
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:[<NTFCNCDE>],<TYPEREP>,[<SRVEFF>],[<OCRDAT>],
[<OCRTM>],,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-2-1,T3:CR,LOS,SA,01-01,16-00-20,,,\"LOS OF SIGNAL\""
;Output Parameters
Table 21-50 RTRV-COND-<MOD2ALM> Output Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1
AIDTYPE
Type of access identifier. Specifies the type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2ALM—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
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
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
UDCDCC alarm
•
UCDF alarm
•
Virtual Concatenation Group alarm
•
VT1 alarm
•
VT2 alarm
•
Wavelength Path Provisioning
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
TYPEREP
The condition itself
Parameter type is CONDITION—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, Optional
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.26 RTRV-COND-ALL
Retrieve Condition All
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the current standing condition for all entities.
According to GR-833, the RTRV-COND-ALL command only reports EQPT, COM, and rr (T1, T3, OCn, EC1, STSn, VT1, DS1, E100, E1000, G1000, ML-Series, TXP and MXP) alarms.
This command does not return all conditions that are returned by other, more specific RTRV-COND commands; RTRV-COND-ALL returns a subset of these conditions. GR-253-CORE, Section 6.2.1.8.4 states a retrieval that returns ALL conditions from a node (RTRV-COND-ALL) must omit any conditions that are "same root cause" as other raised conditions. The section also states any retrieval of a subset of the conditions from a node, regardless of how the subsetting occurs, should not omit these "same root cause" conditions.
RTRV-COND-STS1, for example, includes "same root cause" conditions in the set it returns and RTRV-COND-ALL does not.
To retrieve all the NE conditions, issue all of the following commands:
RTRV-COND-ALL
RTRV-COND-ENV
RTRV-COND-BITS
RTRV-COND-SYNCNCategory
Fault
Security
Retrieve
Related Commands
Input Format
RTRV-COND-ALL:[<TID>]:[<AID>]:<CTAG>::[<TYPEREQ>][,,,];
Input Example
RTRV-COND-ALL:TID:ALL:229::LOS;
Input Parameters
Table 21-51 RTRV-COND-ALL Input Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1. String. A null value is equivalent to ALL
TYPEREQ
The type of condition to be retrieved. A null value is equivalent to ALL
Parameter type is CONDITION—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
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:[<NTFCNCDE>],<TYPEREP>,[<SRVEFF>],[<OCRDAT>],
[<OCRTM>],,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-2-1,OC3:CR,LOS,SA,01-01,16-02-15,,,\"LOS OF SIGNAL\""
;Output Parameters
Table 21-52 RTRV-COND-ALL Output Parameters
AID
Access identifier from the "25.1.1 ALL" section on page 25-1 that has an alarm condition
AIDTYPE
Type of access identifier. Specifies the type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
TYPEREP
The type of condition to be retrieved
Parameter type is CONDITION—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, Optional
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.27 RTRV-COND-BITS
Retrieve Condition Building Integrated Timing Supply
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the standing conditions on BITS.
Category
Synchronization
Security
Retrieve
Related Commands
Input Format
RTRV-COND-BITS:[<TID>]:<AID>:<CTAG>::[<TYPEREQ>][,,,];
Input Example
RTRV-COND-BITS:TID:BITS-1:229::LOS;
Input Parameters
Table 21-53 RTRV-COND-BITS Input Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13. Must not be null
TYPEREQ
The type of condition to be retrieved. A null value is equivalent to ALL
Parameter type is CONDITION—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
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:[<NTFCNCDE>],<TYPEREP>,[<SRVEFF>],[<OCRDAT>],
[<OCRTM>],,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"BITS-1,BITS:CR,LOS,SA,01-01,16-02-15,,,\"LOS OF SIGNAL\""
;Output Parameters
Table 21-54 RTRV-COND-BITS Output Parameters
AID
Access identifier from the "25.1.5 BITS" section on page 25-13 that has an alarm condition
AIDTYPE
Type of access identifier. Specifies the type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS2I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
TYPEREP
The type of condition to be retrieved
Parameter type is CONDITION—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, Optional
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.28 RTRV-COND-ENV
Retrieve Environmental Condition
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the environmental conditions.
Category
Environment
Security
Retrieve
Related Commands
Input Format
RTRV-COND-ENV:[<TID>]:<AID>:<CTAG>::[<NTFCNCDE>],[<ALMTYPE>][,,,];
Input Example
RTRV-COND-ENV:CISCO:ENV-IN-1:123::MJ,OPENDR;
Input Parameters
Table 21-55 RTRV-COND-ENV Input Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26. Must not be null
Note
NTFCNCDE
Two-letter notification code. A null value is equivalent to ALL
Parameter type is NOTIF_CODE—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
ALMTYPE
The alarm type for the environmental alarm. A null value is equivalent to ALL
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnect bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>:<NTFCNCDE>,<ALMTYPE>,[<OCRDAT>],[<OCRTM>],,,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"ENV-IN-1:MJ,OPENDR,01-01,16-02-15,,,,\"OPEN DOOR\""
;Output Parameters
Table 21-56 RTRV-COND-ENV Output Parameters
AID
Access identifier from the "25.1.12 ENV" section on page 25-26
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
ALMTYPE
The alarm type for the environmental alarm
Parameter type is ENV_ALM—environmental alarm types
•
Air compressor failure
•
Air conditioning failure
•
Air dryer failure
•
Battery discharging
•
Battery failure
•
Cooling fan failure
•
Centralized power major failure
•
Centralized power minor failure
•
Engine failure
•
Engine operating
•
Standby engine transfer
•
Explosive gas
•
Fire detector failure
•
Fire
•
Flood
•
Fuel leak
•
Fuse failure
•
Explosive gas, toxic gas, ventilation fail or gas monitor fail
•
CEV hatch fail
•
Generator failure
•
High airflow
•
High humidity
•
High temperature
•
High water
•
Intrusion
•
Level converter
•
Secondary ADSL low voltage disconnect
•
Low voltage disconnect bypass
•
Low battery voltage
•
Low fuel
•
Low humidity
•
Low cable pressure
•
Low temperature
•
Low water
•
Miscellaneous
•
Open door
•
Commercial power failure
•
Pump failure
•
48V power supply failure
•
-139V power converter
•
-190V power converter
•
Power supply major
•
Power supply minor
•
Rectifier failure
•
Rectifier high voltage
•
Rectifier low voltage
•
Ringing generator major
•
Ringing generator minor
•
AC or AC/rectifier power fail ADSL equipment
•
AC or AC/rectifier power fail DCL equipment critical site
•
AC or AC/rectifier power fail DCL equipment
•
Commercial AC fail, site equipped with standby engine
•
AC power loss distributed power RT bay
•
Retrieve standby engine, commercial AC restored
•
Smoke
•
High-low temperature
•
Toxic gas
•
T-repeater shelf
•
Ventilation system failure
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.29 RTRV-COND-EQPT
Retrieve Condition Equipment
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the equipment conditions.
Category
Equipment
Security
Retrieve
Related Commands
Input Format
RTRV-COND-EQPT:[<TID>]:<AID>:<CTAG>::[<TYPEREQ>][,,,];
Input Example
RTRV-COND-EQPT:TID:SLOT-1:229::LOS;
Input Parameters
Table 21-57 RTRV-COND-EQPT Input Parameters
AID
Access identifier from the "25.1.13 EQPT" section on page 25-27 that has an alarm condition. Must not be null
TYPEREQ
The type of condition to be retrieved. A null value is equivalent to ALL
Parameter type is CONDITION—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
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:[<NTFCNCDE>],<TYPEREP>,[<SRVEFF>],[<OCRDAT>],
[<OCRTM>],,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"SLOT-1,EQPT:CR,LOS,SA,01-01,16-02-15,,,\"LOS OF SIGNAL\""
;Output Parameters
Table 21-58 RTRV-COND-EQPT Output Parameters
AID
Access identifier from the "25.1.13 EQPT" section on page 25-27 that has an alarm condition
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
TYPEREP
The type of condition to be retrieved
Parameter type is CONDITION—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, Optional
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.30 RTRV-COND-SYNCN
Retrieve Condition Synchronization
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves the synchronization condition.
Category
Synchronization
Security
Retrieve
Related Commands
Input Format
RTRV-COND-SYNCN:[<TID>]:<AID>:<CTAG>::[<TYPEREQ>][,,,];
Input Example
RTRV-COND-SYNCN:TID:SYNC-NE:229::LOS;
Input Parameters
Table 21-59 RTRV-COND-SYNCN Input Parameters
AID
Access identifier from the "25.1.25 SYNC_REF" section on page 25-40 that has an alarm condition. Must not be null
TYPEREQ
The type of condition to be retrieved. A null value is equivalent to ALL
Parameter type is CONDITION—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
Output Format
SID DATE TIME
M CTAG COMPLD
"<AID>,[<AIDTYPE>]:[<NTFCNCDE>],<TYPEREP>,[<SRVEFF>],[<OCRDAT>],
[<OCRTM>],,,[<DESC>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"SYNC-NE,SYNCN:MJ,FRNGSYNC,SA,01-01,16-02-15,,,
\"FREE RUNNING SYNCHRONIZATION MODE\""
;Output Parameters
Table 21-60 RTRV-COND-SYNCN Output Parameters
AID
Access identifier from the "25.1.23 SYN" section on page 25-39 that has an alarm condition
AIDTYPE
Type of facility, link or other addressable entity targeted by the message. The value is always SYNCN. Optional
Parameter type is MOD2B—alarm type
•
1 Gigabit fibre channel alarm
•
1 Gigabit FICON alarm
•
2 Gigabit fibre channel alarm
•
2 Gigabit FICON alarm
•
BITS alarm
•
Client facility for MXP/TXP cards
•
Common alarm
•
DS1 alarm
•
DS3I alarm
•
E100 alarm
•
E1000 alarm
•
EC1 alarm
•
ENV alarm
•
EQPT alarm
•
Fast Ethernet Port alarm
•
G1000 alarm
•
GIG Ethernet port alarm
•
MIC alarm (ONS 15327)
•
MIC-EXT (ONS 15327)
•
OC3 alarm
•
OC12 alarm
•
OC48 alarm
•
OC192 alarm
•
Optical channel
•
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
•
SYNCN alarm
•
T1 alarm
•
T3 alarm
•
TCC alarm
•
VT1 alarm
•
VT2 alarm
•
XTC alarm (ONS 15327)
NTFCNCDE
Two-letter notification code. Optional
Parameter type is NOTIF_CODE—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
TYPEREP
The type of condition to be retrieved
Parameter type is CONDITION—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, Optional
Parameter type is SERV_EFF—the effect of the alarm on service
•
The condition is non-service affecting
•
The condition is service affecting
OCRDAT
Date when the specific event or violation occurred. Optional
OCRTM
Time when the specific event or violation occurred. Optional
DESC
Condition description. String. Optional
21.31 RTRV-CONSOLE-PORT
Retrieve Console Port
Usage Guidelines
Cisco ONS 15454, 15310
This command retrieves the status of the console port from the ML-Series cards.
Category
Security
Security
Retrieve
Related Commands
Input Format
RTRV-CONSOLE-PORT:[<TID>]:<AID>:<CTAG>;
Input Example
RTRV-CONSOLE-PORT:CISCONODE:SLOT-2:123;
Input Parameters
Table 21-61 RTRV-CONSOLE-PORT Input Parameters
AID
Access identifier from the "25.1.13 EQPT" section on page 25-27. Must not be null
Output Format
SID DATE TIME
M CTAG COMPLD
"<EQPT>:[PORT=<PORT>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"SLOT-2:PORT=ENABLED"
;Output Parameters
21.32 RTRV-CRS
Retrieve Cross-Connect
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves all the cross-connections based on the required PATH types.
Note
•
•
•
•
•
Category
Cross Connections
Security
Retrieve
Related Commands
Input Format
RTRV-CRS:[<TID>]:[<AID>]:<CTAG>:::[CRSTYPE=<CRSTYPE>][:];
Input Example
RTRV-CRS:CISCO:ALL:123:::CRSTYPE=STS;
Input Parameters
Table 21-63 RTRV-CRS Input Parameters
AID
Access identifier from the "25.1.10 CrossConnectId1" section on page 25-20 that can be facility, STS, VT or ALL. The ALL AID defaults to NE, which means it reports all the existing cross-connections on the NE. A null value is equivalent to ALL
CRSTYPE
The cross-connection type. Defaults to all existing cross-connections. A null value is equivalent to ALL
Parameter type is PATH—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)
•
Virtual Tributary 1 (SONET). Virtual Channel 11 (SDH)
•
Virtual Tributary 2 (SONET). Virtual Channel 12 (SDH)
Output Format
SID DATE TIME
M CTAG COMPLD
"<SRC>,<DST>:<CCT>,<CRSTYPE>:[DRITYPE=<DRITYPE>],[DRINODE=<SYNCSW>],
[CKTID=<CKTID>]:<PST_PSTQ>,[<SSTQ>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"STS-5-1-2&STS-6-1-2,STS-12-1-2&STS-13-1-2:1WAYDC,STS1:DRITYPE=BLSR,
DRINODE=PRI,CKTID=CKTID:OOS-AU,AINS"
;Output Parameters
Table 21-64 RTRV-CRS Output Parameters
SRC
Source access identifier from the "25.1.9 CrossConnectId" section on page 25-15. Indicates the source AID(s) of the cross-connection. Listable
DST
Destination AID of the cross-connection from the "25.1.9 CrossConnectId" section on page 25-15. Listable
CCT
Type of connection. Used for specifying one or two-way connections
Parameter type is CCT—type of cross-connect to be created
•
A unidirectional connection from a source tributary to a destination tributary
•
Path Protection multicast drop with (1-way) continue
•
Path Protection multicast end node (1-way continue)
•
A bidirectional connection between the two tributaries
Note
•
A unidirectional connection from a source tributary to a destination tributary on the protection path/fiber
•
A bidirectional connection between the two tributaries
•
A Bidirectional Drop and Continue connection applicable only to Path Protection Traditional and Integrated Dual Ring InterConnections
•
A bidirectional connection between the two tributaries on the extra protection path/fiber
•
Diagnostics cross-connect. Supports BERT (BLSR PCA diagnostics cross-connect)
CRSTYPE
The cross-connection type
Parameter type is CRS_TYPE—cross-connection type
•
Indicates all the STS cross-connections
•
STS1 cross-connect
•
STS3C cross-connect
•
STS6C cross-connect
•
STS9C cross-connect
•
STS12C cross-connect
•
STS18C cross-connect
•
STS24C cross-connect
•
STS36C cross-connect
•
STS48C cross-connect
•
STS192C cross-connect
•
Indicates all the VT1 cross-connections
•
VT1 cross-connect
•
VT2 cross-connect
DRITYPE
The DRI connection type. It is applied only if the cross-connection is a drop-and-continue connection type (1WAYDC or 2WAYDC), and defaults to path protection for the DRI configuration. Optional
Parameter type is DRITYPE—DRI type
•
BLSR DRI type
•
Path Protection DRI type
•
Path Protection-BLSR hand off DRI type
SYNCSW
Synchronization switch AID from the "25.1.26 SYNCSW" section on page 25-40. Optional
CKTID
Circuit identification parameter that contains a common language ID or other alias of the circuit being provisioned. It cannot contain blank spaces. String. Optional
PST_PSTQ
Primary state and primary state qualifier separated by a colon
Parameter type is PST_PSTQ—service state of the entity described by the primary state (SST) and a primary state qualifier (PSTQ)
•
In service - normal
•
Out of service - autonomous
•
Out of service - autonomous and management
•
Out of service - management
SSTQ
One or more secondary states separated by "&", in alphabetical order. Optional
Parameter type is SST—provides additional information pertaining to PST and PSTQ
•
Automatic in service
•
Disabled
•
Loopback
•
Mismatch of equipment and attributes
•
Maintenance mode
•
Out of group
•
Software downloading
•
Unassigned
•
Unequipped
21.33 RTRV-CRS-<PATH>
Retrieve Cross-Connect (STS1, STS12C, STS18C, STS192C, STS24C, STS36C, STS3C, STS48C, STS6C, STS9C, VT1, VT2)
Usage Guidelines
Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL
This command retrieves any connections associated with the entered AID(s) or AID range. The information on both ends is returned along with the type of connection.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Note
–
from points: F1, F2
to points: T1
the output will be:
1-way
"F1&F2,T1:CCT,STS3C"
2-way
If retrieved on point F1 or F2, the output format is the same as the 1-way output.
If retrieved on point T1, the output will be:
"T1,F1&F2:CCT,STS3C"
–
from point: F1
to points: T1, T2
the output will be:
1-way
"F1,T1&T2:CCT,STS3C"
2-way
"T1&T2,F1:CCT,STS3C"
–
from point: F1, F2
to points: T1, T2
the output will be:
1-way:
"F1&F2,T1&T2:CCT,STS3C"
2-way:
If retrieved on point F1 or F2, the output format is the same as the 1-way output.
If retrieved on point T1 or T2, the output will be:
"T1&T2,F1&F2:CCT,STS3C"
–
ENT-CRS-<PATH>::F1&F2,S1&S2:<CTAG>::2WAY;
from points: F1, F2 (F1 is the working side, F2 is the protect side)
selector: S1, S2 (S1 is the working side, S2 is the protect side)
the output will be:
If retrieved on point F1 or F2, the output will be:
"F1&F2,S1&S2:CCT,STS3C"
If retrieved on selector S1 or S2, the output will be:
"S1&S2,F1&F2:CCT,STS3C"
–
from points: F1, F2
to points: T1, T2
the output will be:
"F1&F2,T1&T2:CCT,STS3C"
–
from points: F1, F2
to points: T1
the output will be:
"F1&F2,T1:CCT,STS3C"
•
•
•
•
•
•
•
Category
Cross Connections
Security
Retrieve
Related Commands
Input Format
RTRV-CRS-<PATH>:[<TID>]:<SRC>:<CTAG>[::::];
Input Example
RTRV-CRS-STS3C:KENWOOD:STS-6-1-1:223;
Input Parameters
Table 21-65 RTRV-CRS-<PATH> Input Parameters
SRC
Source access identifier from the "25.1.10 CrossConnectId1" section on page 25-20. Must not be null
Output Format
SID DATE TIME
M CTAG COMPLD
"<SRC>,<DST>:<CCT>,<MOD>:[DRITYPE=<DRITYPE>],[DRINODE=<SYNCSW>],
[CKTID=<CKTID>]:<PST_PSTQ>,[<SSTQ>]"
;Output Example
TID-000 1998-06-20 14:30:00
M 001 COMPLD
"STS-5-1-2&STS-6-1-2,STS-12-1-2&STS-13-1-2:1WAYDC,STS1:DRITYPE=BLSR,
DRINODE=PRI,CKTID=CKTID:OOS-AU,AINS"
;Output Parameters
Table 21-66 RTRV-CRS-<PATH> Output Parameters
SRC
Source access identifier from the "25.1.9 CrossConnectId" section on page 25-15. Indicates the source AID(s) of the cross-connection. Listable
DST
Destination AID of the cross-connection from the "25.1.9 CrossConnectId" section on page 25-15. Listable
CCT
Type of connection. Used for specifying one or two-way connections
Parameter type is CCT—type of cross-connect to be created
•
A unidirectional connection from a source tributary to a destination tributary
•
Path Protection multicast drop with (1-way) continue
•
Path Protection multicast end node (1-way continue)
•
A bidirectional connection between the two tributaries
Note
•
A unidirectional connection from a source tributary to a destination tributary on the protection path/fiber
•
A bidirectional connection between the two tributaries
•
A Bidirectional Drop and Continue connection applicable only to Path Protection Traditional and Integrated Dual Ring InterConnections
•
A bidirectional connection between the two tributaries on the extra protection path/fiber
•
Diagnostics cross-connect. Supports BERT (BLSR PCA diagnostics cross-connect)
MOD
The connection path bandwidth
Parameter type is MOD2—line/path modifier
•
10 Gigabit fibre channel
•
10 Gigabit Ethernet
•
1 Gigabit fibre channel
•
1 Gigabit FICON
•
2 Gigabit fibre channel
•
2 Gigabit FICON
•
D1 Video
•
DS1 line of a DS3XM card
•
DS3I line
•
DV6000
•
EC1 facility
•
ESCON
•
ETR_CLO
•
FSTE facility
•
G1000 facility
•
Generic Framing Protocol over Packet Over SONET. Virtual Ports partitioned using GFP's Multiplexing Capability
•
GIG Ethernet
•
HDTV
•
ISC1
•
OC3 facility
•
OC12 facility
•
