Cisco ONS SDH TL1 Command Guide, Release 9.0
Chap 21: RTRV Commands

Table Of Contents

RTRV Commands

21.1  RTRV-<MOD1FCPAYLOAD>

21.2  RTRV-<MOD1FICONPAYLOAD>

21.3  RTRV-<MOD2DWDMPAYLOAD>

21.4  RTRV-<MOD_RING>

21.5  RTRV-<PATH>

21.6  RTRV-<STM_TYPE>

21.7  RTRV-10GIGE

21.8  RTRV-ALM-<MOD2ALM>

21.9  RTRV-ALMTYPE

21.10  RTRV-ALM-ALL

21.11  RTRV-ALM-BITS

21.12  RTRV-ALM-ENV

21.13  RTRV-ALM-EQPT

21.14  RTRV-ALM-SYNCN

21.15  RTRV-ALMTH-<MOD2>

21.16  RTRV-ALMTH-EQPT

21.17  RTRV-ALS

21.18  RTRV-APC

21.19  RTRV-ATTR-CONT

21.20  RTRV-ATTR-ENV

21.21  RTRV-AUDIT-LOG

21.22  RTRV-BITS

21.23  RTRV-BULKROLL-<STM_TYPE>

21.24  RTRV-BWP-ETH

21.25  RTRV-CMD-SECU

21.26  RTRV-COND-<MOD2ALM>

21.27  RTRV-COND-ALL

21.28  RTRV-COND-BITS

21.29  RTRV-COND-ENV

21.30  RTRV-COND-EQPT

21.31  RTRV-COND-SYNCN

21.32  RTRV-CONSOLE-PORT

21.33  RTRV-COS-ETH

21.34  RTRV-CRS

21.35  RTRV-CRS-<PATH>

21.36  RTRV-CRS-ETH

21.37  RTRV-DFLT-SECU

21.38  RTRV-DS3I

21.39  RTRV-E1

21.40  RTRV-E3

21.41  RTRV-E4

21.42  RTRV-T3

21.43  RTRV-EQPT

21.44  RTRV-ESCON

21.45  RTRV-ETH

21.46  RTRV-EXT-CONT

21.47  RTRV-FAC

21.48  RTRV-FFP

21.49  RTRV-FFP-<MOD2DWDMPAYLOAD>

21.50  RTRV-FFP-<STM_TYPE>

21.51  RTRV-FFP-OCH

21.52  RTRV-FFP-OTS

21.53  RTRV-FSTE

21.54  RTRV-FTPSERVER

21.55  RTRV-G1000

21.56  RTRV-GFP

21.57  RTRV-GIGE

21.58  RTRV-HDLC

21.59  RTRV-HDR

21.60  RTRV-INV

21.61  RTRV-L2-ETH

21.62  RTRV-LMP

21.63  RTRV-LMP-CTRL

21.64  RTRV-LMP-TLINK

21.65  RTRV-LMP-DLINK

21.66  RTRV-LNK

21.67  RTRV-LNKTERM

21.68  RTRV-LOG

21.69  RTRV-MAP-NETWORK

21.70  RTRV-MCAST

21.71  RTRV-NE-APC

21.72  RTRV-NE-GEN

21.73  RTRV-NE-IPMAP

21.74  RTRV-NE-PATH

21.75  RTRV-NE-SYNCN

21.76  RTRV-NE-WDMANS

21.77  RTRV-NETYPE

21.78  RTRV-NNI-ETH

21.79  RTRV-OCH

21.80  RTRV-OCHCC

21.81  RTRV-OCHNC

21.82  RTRV-OMS

21.83  RTRV-OPM

21.84  RTRV-OTS

21.85  RTRV-PATH-OCH

21.86  RTRV-PM-<MOD2>

21.87  RTRV-PM-ALL

21.88  RTRV-PMMODE-<VC_PATH>

21.89  RTRV-PMSCHED-<MOD2>

21.90  RTRV-PMSCHED-ALL

21.91  RTRV-POS

21.92  RTRV-PROTNSW-<MOD2DWDMPAYLOAD>

21.93  RTRV-PROTNSW-<STM_TYPE>

21.94  RTRV-PROTNSW-<PATH>

21.95  RTRV-PROTNSW-OCH

21.96  RTRV-PROTNSW-OTS

21.97  RTRV-PROTOCOL

21.98  RTRV-PTHTRC-<PATH>

21.99  RTRV-QNQ-ETH

21.100  RTRV-RAMAN

21.101  RTRV-RMONTH-<MOD2_RMON>

21.102  RTRV-ROLL-<MOD_PATH>

21.103  RTRV-ROUTE

21.104  RTRV-ROUTE-GRE

21.105  RTRV-SLV-WDMANS

21.106  RTRV-STM1E

21.107  RTRV-SYNCN

21.108  RTRV-TACC

21.109  RTRV-TADRMAP

21.110  RTRV-TH-<MOD2>

21.111  RTRV-TH-ALL

21.112  RTRV-TOD

21.113  RTRV-TRAPTABLE

21.114  RTRV-TRC-<STM_MSSPR>

21.115  RTRV-TRC-OCH

21.116  RTRV-TUNNEL-FIREWALL

21.117  RTRV-TUNNEL-PROXY

21.118  RTRV-USER-SECU

21.119  RTRV-VC

21.120  RTRV-VCG

21.121  RTRV-VLAN

21.122  RTRV-VLAN-ETH

21.123  RTRV-WDMANS

21.124  RTRV-WDMSIDE

21.125  RTRV-WLEN


RTRV Commands


This chapter provides retrieve (RTRV) commands for the Cisco ONS 15454 SDH, Cisco ONS 15600 SDH, and Cisco ONS 15310 MA SDH.

21.1  RTRV-<MOD1FCPAYLOAD>


Note The RTRV-<MOD1FCPAYLOAD> command does not apply to the Cisco ONS 15600 SDH and Cisco ONS 15310 MA SDH platforms.


(Cisco ONS 15454 SDH) The Retrieve 1GFC, 2GFC, 4 GFC, or 10 GFC (RTRV-<MOD1FCPAYLOAD>) command retrieves the attributes related with the Fibre Channel port. SeeTable 27-1 on page 27-1 for supported modifiers by platform.

Usage Guidelines

None

Category

Ports

Security

Retrieve

Input Format

RTRV-<MOD1FCPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];

Input Example

RTRV-1GFC:CISCO:FAC-6-1:888;

Input Parameters

<AID>

Access identifier from the 25.13  FACILITY, page 25-22.


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>]:
<PSTPSTQ>,[<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:LOCKED-ENABLED,MAINTENANCE"
;

Table 21-1 RTRV-<MOD1FCPAYLOAD> Command - Output Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.

Y

N/A

N/A

<ROLE>

(Optional) The port role in a Y-cable protection scheme. The parameter type is SIDE, which is the role the unit is playing in the protection group.

Y

N/A

N/A

PROT

The entity is a protection unit in the protection group.

Y

N/A

N/A

WORK

The entity is a working unit in the protection group.

Y

N/A

N/A

<STATUS>

(Optional) The port status in a Y-cable protection scheme. The parameter type is STATUS, which is the status of the unit in the protection pair.

Y

N/A

N/A

ACT

The entity is the active unit in the shelf.

Y

N/A

N/A

NA

Status is unavailable.

Y

N/A

N/A

STBY

The entity is the standby unit in the shelf.

Y

N/A

N/A

<LINKRATE>

(Optional) The actual rate running on the Fibre Channel port. It can differ from the payload type provisioned. The parameter type is LINKRATE, which is the link rate on a Fibre Channel port.

Y

N/A

N/A

1GFC

1-Gigabit Fibre Channel payload

Y

N/A

N/A

1GFICON

1-Gigabit fiber connectivity payload

Y

N/A

N/A

2GFC

2-Gigabit Fibre Channel payload

Y

N/A

N/A

2GFICON

2-Gigabit fiber connectivity payload

Y

N/A

N/A

UNKNOWN

The rate is unknown.

Y

N/A

N/A

UNPLUGGED

The Small Form-factor Pluggable (SFP) is not plugged into the Fibre Channel port so the link rate cannot be detected.

Y

N/A

N/A

<LINKSTATE>

(Optional) Link state. The parameter type is DIRN, which specifies the discriminating level for the requested monitored parameter.

Y

N/A

N/A

DN

Monitored parameter with values equal to or greater than the level of LEV will be reported.

Y

N/A

N/A

UP

Monitored parameter with values equal or less than the value of LEV will be reported.

Y

N/A

N/A

<LINKRCVRY>

(Optional) Link recovery. The parameter type is ON_OFF (disable or enable an attribute).

Y

N/A

N/A

N

Disable an attribute.

Y

N/A

N/A

Y

Enable an attribute.

Y

N/A

N/A

<DISTEXTN>

(Optional) Distance extension. The parameter type is DISTANCE_EXTENSION (distance extension)

Y

N/A

N/A

B2B

Buffer to buffer flow control

Y

N/A

N/A

NONE

No distance extension

Y

N/A

N/A

LINKCREDITS

(Optional) Number of link credits. LINKCREDITS is an integer.

Y

N/A

N/A

MFS

(Optional) Maximum frame size. MFS is an integer.

Y

N/A

N/A

ENCAP

(Optional) Frame encapsulation type. The parameter type is ENCAP, which is the frame encapsulation type.

Y

N/A

N/A

GFP_F

Generic framing procedure (GFP) frame mode

Y

N/A

N/A

GFP_T

GFP transparent mode

Y

N/A

N/A

HDLC

High-level data link control (HDLC) frame mode

Y

N/A

N/A

HDLC_LEX

HDLC LAN extension frame mode

Y

N/A

N/A

HDLC_X86

HDLC X.86 frame mode

Y

N/A

N/A

<NAME>

(Optional) Identifies the port name. NAME is a string.

Y

N/A

N/A

<SOAK>

(Optional) Locked-Automatic In Service to Unlocked transition soak time as measured in 15-minute intervals. SOAK is an integer.

Y

N/A

N/A

<SOAKLEFT>

(Optional) Time remaining for the transition from Locked-Automatic In Service to Unlocked measured in 1 minute intervals. The format is HH-MM where HH ranges from 00 to 48 and MM ranges from 00 to 59. The rules for SOAKLEFT are:

When the port is in Locked, Locked_Maintenance or Unlocked state, the parameter will not appear.

When the port is in Locked_AutomaticInService but the countdown has not started due to fault signal, the value will be SOAKLEFT=NOT-STARTED.

When the port is in Locked_AutomaticInService state and the countdown has started, the value will be shown in HH-MM format.

Y

N/A

N/A

<FREQ>

(Optional) The parameter type is OPTICAL_WLEN, which is the optical wavelength.

Y

N/A

N/A

1310

Wavelength 1310

Y

N/A

N/A

1470

Wavelength 1470

Y

N/A

N/A

1490

Wavelength 1490

Y

N/A

N/A

1510

Wavelength 1510

Y

N/A

N/A

1529.55

Wavelength 1529.55

Y

N/A

N/A

1529.94

Wavelength 1529.94

Y

N/A

N/A

1530

Wavelength 1530

Y

N/A

N/A

1530.33

Wavelength 1530.33

Y

N/A

N/A

1530.73

Wavelength 1530.73

Y

N/A

N/A

1531.12

Wavelength 1531.12

Y

N/A

N/A

1531.51

Wavelength 1531.51

Y

N/A

N/A

1531.90

Wavelength 1531.90

Y

N/A

N/A

1532.29

Wavelength 1532.29

Y

N/A

N/A

1532.68

Wavelength 1532.68

Y

N/A

N/A

1533.07

Wavelength 1533.07

Y

N/A

N/A

1533.47

Wavelength 1533.47

Y

N/A

N/A

1533.86

Wavelength 1533.86

Y

N/A

N/A

1534.25

Wavelength 1534.25

Y

N/A

N/A

1534.64

Wavelength 1534.64

Y

N/A

N/A

1535.04

Wavelength 1535.04

Y

N/A

N/A

1535.43

Wavelength 1535.43

Y

N/A

N/A

1535.82

Wavelength 1535.82

Y

N/A

N/A

1536.22

Wavelength 1536.22

Y

N/A

N/A

1536.61

Wavelength 1536.61

Y

N/A

N/A

1537

Wavelength 1537

Y

N/A

N/A

1537.40

Wavelength 1537.40

Y

N/A

N/A

1537.79

Wavelength 1537.79

Y

N/A

N/A

1538.19

Wavelength 1538.19

Y

N/A

N/A

1538.58

Wavelength 1538.58

Y

N/A

N/A

1538.98

Wavelength 1538.98

Y

N/A

N/A

1539.37

Wavelength 1539.37

Y

N/A

N/A

1539.77

Wavelength 1539.77

Y

N/A

N/A

1540.16

Wavelength 1540.16

Y

N/A

N/A

1540.56

Wavelength 1540.56

Y

N/A

N/A

1540.95

Wavelength 1540.95

Y

N/A

N/A

1541.35

Wavelength 1541.35

Y

N/A

N/A

1541.75

Wavelength 1541.75

Y

N/A

N/A

1542.14

Wavelength 1542.14

Y

N/A

N/A

1542.35

Wavelength 1542.35

Y

N/A

N/A

1542.54

Wavelength 1542.54

Y

N/A

N/A

1542.94

Wavelength 1542.94

Y

N/A

N/A

1543.33

Wavelength 1543.33

Y

N/A

N/A

1543.73

Wavelength 1543.73

Y

N/A

N/A

1544.13

Wavelength 1544.13

Y

N/A

N/A

1544.53

Wavelength 1544.53

Y

N/A

N/A

1544.92

Wavelength 1544.92

Y

N/A

N/A

1545.32

Wavelength 1545.32

Y

N/A

N/A

1545.72

Wavelength 1545.72

Y

N/A

N/A

1546.12

Wavelength 1546.12

Y

N/A

N/A

1546.52

Wavelength 1546.52

Y

N/A

N/A

1546.92

Wavelength 1546.92

Y

N/A

N/A

1547.32

Wavelength 1547.32

Y

N/A

N/A

1547.72

Wavelength 1547.72

Y

N/A

N/A

1548.12

Wavelength 1548.12

Y

N/A

N/A

1548.51

Wavelength 1548.51

Y

N/A

N/A

1548.92

Wavelength 1548.92

Y

N/A

N/A

1549.32

Wavelength 1549.32

Y

N/A

N/A

1549.71

Wavelength 1549.71

Y

N/A

N/A

1550

Wavelength 1500

Y

N/A

N/A

1550.12

Wavelength 1550.12

Y

N/A

N/A

1550.52

Wavelength 1550.52

Y

N/A

N/A

1550.92

Wavelength 1550.92

Y

N/A

N/A

1551.32

Wavelength 1551.32

Y

N/A

N/A

1551.72

Wavelength 1551.72

Y

N/A

N/A

1552.12

Wavelength 1552.12

Y

N/A

N/A

1552.52

Wavelength 1552.52

Y

N/A

N/A

1552.93

Wavelength 1552.93

Y

N/A

N/A

1553.33

Wavelength 1553.33

Y

N/A

N/A

1553.73

Wavelength 1553.73

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.94

Wavelength 1554.94

Y

N/A

N/A

1555.34

Wavelength 1555.34

Y

N/A

N/A

1555.75

Wavelength 1555.75

Y

N/A

N/A

1556.15

Wavelength 1556.15

Y

N/A

N/A

1556.55

Wavelength 1556.55

Y

N/A

N/A

1556.96

Wavelength 1556.96

Y

N/A

N/A

1557.36

Wavelength 1557.36

Y

N/A

N/A

1557.77

Wavelength 1557.77

Y

N/A

N/A

1558.17

Wavelength 1558.17

Y

N/A

N/A

1558.58

Wavelength 1558.58

Y

N/A

N/A

1558.98

Wavelength 1558.98

Y

N/A

N/A

1559.39

Wavelength 1559.39

Y

N/A

N/A

1559.79

Wavelength 1559.79

Y

N/A

N/A

1560.20

Wavelength 1560.20

Y

N/A

N/A

1560.61

Wavelength 1560.61

Y

N/A

N/A

1561.01

Wavelength 1561.01

Y

N/A

N/A

1561.42

Wavelength 1561.42

Y

N/A

N/A

1561.83

Wavelength 1561.83

Y

N/A

N/A

1570

Wavelength 1570

Y

N/A

N/A

1570.83

Wavelength 1570.83

Y

N/A

N/A

1571.24

Wavelength 1571.24

Y

N/A

N/A

1571.65

Wavelength 1571.65

Y

N/A

N/A

1572.06

Wavelength 1572.06

Y

N/A

N/A

1572.48

Wavelength 1572.48

Y

N/A

N/A

1572.89

Wavelength 1572.89

Y

N/A

N/A

1573.30

Wavelength 1573.30

Y

N/A

N/A

1573.71

Wavelength 1573.71

Y

N/A

N/A

1574.13

Wavelength 1574.13

Y

N/A

N/A

1574.54

Wavelength 1574.54

Y

N/A

N/A

1574.95

Wavelength 1574.95

Y

N/A

N/A

1575.37

Wavelength 1575.37

Y

N/A

N/A

1575.78

Wavelength 1575.78

Y

N/A

N/A

1576.20

Wavelength 1576.20

Y

N/A

N/A

1576.61

Wavelength 1576.61

Y

N/A

N/A

1577.03

Wavelength 1577.03

Y

N/A

N/A

1577.44

Wavelength 1577.44

Y

N/A

N/A

1577.86

Wavelength 1577.86

Y

N/A

N/A

1578.27

Wavelength 1578.27

Y

N/A

N/A

1578.69

Wavelength 1578.69

Y

N/A

N/A

1579.10

Wavelength 1579.10

Y

N/A

N/A

1579.52

Wavelength 1579.52

Y

N/A

N/A

1579.93

Wavelength 1579.93

Y

N/A

N/A

1580.35

Wavelength 1580.35

Y

N/A

N/A

1580.77

Wavelength 1580.77

Y

N/A

N/A

1581.18

Wavelength 1581.18

Y

N/A

N/A

1581.60

Wavelength 1581.60

Y

N/A

N/A

1582.02

Wavelength 1582.02

Y

N/A

N/A

1582.44

Wavelength 1582.44

Y

N/A

N/A

1582.85

Wavelength 1582.85

Y

N/A

N/A

1583.27

Wavelength 1583.27

Y

N/A

N/A

1583.69

Wavelength 1583.69

Y

N/A

N/A

1584.11

Wavelength 1584.11

Y

N/A

N/A

1584.53

Wavelength 1584.53

Y

N/A

N/A

1584.95

Wavelength 1584.95

Y

N/A

N/A

1585.36

Wavelength 1585.36

Y

N/A

N/A

1585.78

Wavelength 1585.78

Y

N/A

N/A

1586.20

Wavelength 1586.20

Y

N/A

N/A

1586.62

Wavelength 1586.62

Y

N/A

N/A

1587.04

Wavelength 1587.04

Y

N/A

N/A

1587.46

Wavelength 1587.46

Y

N/A

N/A

1587.88

Wavelength 1587.88

Y

N/A

N/A

1588.30

Wavelength 1588.30

Y

N/A

N/A

1588.73

Wavelength 1588.73

Y

N/A

N/A

1589.15

Wavelength 1589.15

Y

N/A

N/A

1589.57

Wavelength 1589.57

Y

N/A

N/A

1589.99

Wavelength 1589.99

Y

N/A

N/A

1590

Wavelength 1590

Y

N/A

N/A

1590.41

Wavelength 1590.41

Y

N/A

N/A

1590.83

Wavelength 1590.83

Y

N/A

N/A

1591.26

Wavelength 1591.26

Y

N/A

N/A

1591.68

Wavelength 1591.68

Y

N/A

N/A

1592.10

Wavelength 1592.10

Y

N/A

N/A

1592.52

Wavelength 1592.52

Y

N/A

N/A

1592.95

Wavelength 1592.95

Y

N/A

N/A

1593.37

Wavelength 1593.37

Y

N/A

N/A

1593.79

Wavelength 1593.79

Y

N/A

N/A

1594.22

Wavelength 1594.22

Y

N/A

N/A

1594.64

Wavelength 1594.64

Y

N/A

N/A

1595.06

Wavelength 1595.06

Y

N/A

N/A

1595.49

Wavelength 1595.49

Y

N/A

N/A

1596.34

Wavelength 1596.34

Y

N/A

N/A

1596.76

Wavelength 1596.76

Y

N/A

N/A

1597.19

Wavelength 1597.19

Y

N/A

N/A

1597.62

Wavelength 1597.62

Y

N/A

N/A

1598.04

Wavelength 1598.04

Y

N/A

N/A

1598.47

Wavelength 1598.47

Y

N/A

N/A

1598.89

Wavelength 1598.89

Y

N/A

N/A

1599.32

Wavelength 1599.32

Y

N/A

N/A

1599.75

Wavelength 1599.75

Y

N/A

N/A

1600.06

Wavelength 1600.06

Y

N/A

N/A

1601.03

Wavelength 1601.03

Y

N/A

N/A

1601.46

Wavelength 1601.46

Y

N/A

N/A

1601.88

Wavelength 1601.88

Y

N/A

N/A

1602.31

Wavelength 1602.31

Y

N/A

N/A

1602.74

Wavelength 1602.74

Y

N/A

N/A

1603.17

Wavelength 1603.17

Y

N/A

N/A

1603.60

Wavelength 1603.60

Y

N/A

N/A

1604.03

Wavelength 1604.03

Y

N/A

N/A

1610

Wavelength 1610

Y

N/A

N/A

USE-TWL1

Use Tunable Wavelength 1

Y

N/A

N/A

<LOSSB>

The parameter type is REACH, which is the reach value.

Y

N/A

N/A

AUTOPROV

Autoprovisioning

Y

N/A

N/A

CX

Reach CX

Y

N/A

N/A

DX

Reach DX

Y

N/A

N/A

HX

Reach HX

Y

N/A

N/A

I1

Reach I1

Y

N/A

N/A

IR-1

Reach IR-1

Y

N/A

N/A

IR-2

Reach IR-2

Y

N/A

N/A

L1

Reach L1

Y

N/A

N/A

L2

Reach L2

Y

N/A

N/A

L3

Reach L3

Y

N/A

N/A

LR-1

Reach LR-1

Y

N/A

N/A

LR-2

Reach LR-2

Y

N/A

N/A

LR-3

Reach LR-3

Y

N/A

N/A

LX

Reach LX

Y

N/A

N/A

S1

Reach S1

Y

N/A

N/A

S2

Reach S2

Y

N/A

N/A

SR

Reach SR

Y

N/A

N/A

SR-1

Reach SR-1

Y

N/A

N/A

SX

Reach SX

Y

N/A

N/A

T

Reach T

Y

N/A

N/A

VX

Reach VX

Y

N/A

N/A

ZX

Reach ZX

Y

N/A

N/A

<PSTPSTQ>

Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the primary state (PST) and primary state qualifier (PSTQ).

Y

N/A

N/A

Unlocked-Enabled

In service and normal

Y

N/A

N/A

Unlocked-Disabled

Out of service and autonomous

Y

N/A

N/A

Locked-Disabled

Out of service, autonomous and management

Y

N/A

N/A

Locked-Enabled

Out of service and management

Y

N/A

N/A

<SST>

(Optional) Secondary state of the entity. The parameter type is secondary state (SST), which provides additional information pertaining to PST and PSTQ.

Y

N/A

N/A

AutomaticInService

Automatic in service

Y

N/A

N/A

Disabled

Disabled

Y

N/A

N/A

Loopback

Loopback

Y

N/A

N/A

MismatchofEquipmentAlarm

Mismatch of equipment and attributes

Y

N/A

N/A

Maintenance

Maintenance mode

Y

N/A

N/A

OutOfGroup

Out of group

Y

N/A

N/A

SoftwareDownload

Software downloading

Y

N/A

N/A

Unassigned

Unassigned

Y

N/A

N/A

NotInstalled

Unequipped

Y

N/A

N/A


21.2  RTRV-<MOD1FICONPAYLOAD>


Note The RTRV-<MOD1FICONPAYLOAD> command does not apply to the Cisco ONS 15600 SDH and Cisco ONS 15310 MA SDH platforms.


(Cisco ONS 15454 SDH) The Retrieve 1GFICON, 2GFICON, or 4GFICON (RTRV-MOD1FICONPAYLOAD>) command returns Fibre-Channel-specific settings for ports that have been configured to carry fiber connectivity (FICON) traffic using the ENT-FICON command. The MXP_MR_2.5G and MXPP_MR_2.5G cards only support the GFP-T frame type. See Table 27-1 for supported modifiers by platform.

Usage Guidelines

None

Category

Ports

Security

Retrieve

Input Format

RTRV-<MOD1FICONPAYLOAD>:[<TID>]:<AID>:<CTAG>;

Input Example

RTRV-1GFICON:CISCO:FAC-1-1:123;

Input Parameters

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.


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>]:
<PSTPSTQ>,<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:LOCKED-ENABLED,
MAINTENANCE"
;

Table 21-2 RTRV-<MOD1FICONPAYLOAD> Command - Output Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.

Y

N/A

N/A

<ROLE>

(Optional) The port role in a Y-cable protection scheme. The parameter type is SIDE, which is the role the unit is playing in the protection group.

Y

N/A

N/A

PROT

The entity is a protection unit in the protection group.

Y

N/A

N/A

WORK

The entity is a working unit in the protection group.

Y

N/A

N/A

<STATUS>

(Optional) Port status in a Y-cable protection scheme. The parameter type is STATUS, which is the status of the unit in the protection pair.

Y

N/A

N/A

ACT

The entity is the active unit in the shelf.

Y

N/A

N/A

NA

Status is unavailable.

Y

N/A

N/A

STBY

The entity is the standby unit in the shelf.

Y

N/A

N/A

<LINKRATE>

(Optional) The actual rate running on the Fibre Channel port. It can differ from the payload type provisioned. The parameter type is LINKRATE, which is the link rate on a Fibre Channel port.

Y

N/A

N/A

1GFC

1-Gigabit Fibre Channel payload

Y

N/A

N/A

1GFICON

1-Gigabit fiber connectivity payload

Y

N/A

N/A

2GFC

2-Gigabit Fibre Channel payload

Y

N/A

N/A

2GFICON

2-Gigabit fiber connectivity payload

Y

N/A

N/A

UNKNOWN

The rate is unknown.

Y

N/A

N/A

UNPLUGGED

The SFP is not plugged into the Fibre Channel port, so the link rate cannot be detected.

Y

N/A

N/A

<LINKSTATE>

(Optional) Link state. The parameter type is DIRN, which specifies the discriminating level for the requested monitored parameter.

Y

N/A

N/A

DN

Monitored parameter with values equal to or greater than the level of LEV will be reported.

Y

N/A

N/A

UP

Monitored parameter with values equal or less than the value of LEV will be reported.

Y

N/A

N/A

<LINKRCVRY>

(Optional) Link recovery. The parameter type is ON_OFF (disable or enable an attribute).

Y

N/A

N/A

N

Disable an attribute.

Y

N/A

N/A

Y

Enable an attribute.

Y

N/A

N/A

<DISTEXTN>

(Optional) Distance extension. The parameter type is DISTANCE_EXTENSION (distance extension).

Y

N/A

N/A

B2B

Buffer-to-buffer flow control

Y

N/A

N/A

NONE

No distance extension

Y

N/A

N/A

<LINKCREDITS>

(Optional) Number of link credits. LINKCREDITS is an integer.

Y

N/A

N/A

<MFS>

(Optional) Maximum frame size. MFS is an integer.

Y

N/A

N/A

<ENCAP>

(Optional) Frame encapsulation type. The parameter type is ENCAP, which is the frame encapsulation type.

Y

N/A

N/A

GFP_F

GFP frame mode

Y

N/A

N/A

GFP_T

GFP transparent mode

Y

N/A

N/A

HDLC

HDLC frame mode

Y

N/A

N/A

HDLC_LEX

HDLC LAN extension frame mode

Y

N/A

N/A

HDLC_X86

HDLC X.86 frame mode

Y

N/A

N/A

<NAME>

(Optional) Identifies the port name. NAME is a string.

Y

N/A

N/A

<SOAK>

(Optional) Locked-AutomaticInService to Unlocked transition soak time as measured in 15-minute intervals. SOAK is an integer.

Y

N/A

N/A

<SOAKLEFT>

(Optional) Time remaining for the transition from Locked-AutomaticInService to Unlocked measured in 1 minute intervals. The format is HH-MM where HH ranges from 00 to 48 and MM ranges from 00 to 59. Rules for <SOAKLEFT> are:

When the port is in Locked, Locked_Maintenance or Unlocked state, the parameter will not appear.

When the port is in Locked_AutomaticInService, but the countdown has not started due to fault signal, the value will be SOAKLEFT=NOT-STARTED.

When the port is in Locked_AutomaticInService state and the countdown has started, the value will be shown in HH-MM format.

Y

N/A

N/A

<FREQ>

(Optional) The parameter type is OPTICAL_WLEN, which is the optical wavelength.

Y

N/A

N/A

1310

Wavelength 1310

Y

N/A

N/A

1470

Wavelength 1470

Y

N/A

N/A

1490

Wavelength 1490

Y

N/A

N/A

1510

Wavelength 1510

Y

N/A

N/A

1529.55

Wavelength 1529.55

Y

N/A

N/A

1529.94

Wavelength 1529.94

Y

N/A

N/A

1530

Wavelength 1530

Y

N/A

N/A

1530.33

Wavelength 1530.33

Y

N/A

N/A

1530.73

Wavelength 1530.73

Y

N/A

N/A

1531.12

Wavelength 1531.12

Y

N/A

N/A

1531.51

Wavelength 1531.51

Y

N/A

N/A

1531.90

Wavelength 1531.90

Y

N/A

N/A

1532.29

Wavelength 1532.29

Y

N/A

N/A

1532.68

Wavelength 1532.68

Y

N/A

N/A

1533.07

Wavelength 1533.07

Y

N/A

N/A

1533.47

Wavelength 1533.47

Y

N/A

N/A

1533.86

Wavelength 1533.86

Y

N/A

N/A

1534.25

Wavelength 1534.25

Y

N/A

N/A

1534.64

Wavelength 1534.64

Y

N/A

N/A

1535.04

Wavelength 1535.04

Y

N/A

N/A

1535.43

Wavelength 1535.43

Y

N/A

N/A

1535.82

Wavelength 1535.82

Y

N/A

N/A

1536.22

Wavelength 1536.22

Y

N/A

N/A

1536.61

Wavelength 1536.61

Y

N/A

N/A

1537

Wavelength 1537

Y

N/A

N/A

1537.40

Wavelength 1537.40

Y

N/A

N/A

1537.79

Wavelength 1537.79

Y

N/A

N/A

1538.19

Wavelength 1538.19

Y

N/A

N/A

1538.58

Wavelength 1538.58

Y

N/A

N/A

1538.98

Wavelength 1538.98

Y

N/A

N/A

1539.37

Wavelength 1539.37

Y

N/A

N/A

1539.77

Wavelength 1539.77

Y

N/A

N/A

1540.16

Wavelength 1540.16

Y

N/A

N/A

1540.56

Wavelength 1540.56

Y

N/A

N/A

1540.95

Wavelength 1540.95

Y

N/A

N/A

1541.35

Wavelength 1541.35

Y

N/A

N/A

1541.75

Wavelength 1541.75

Y

N/A

N/A

1542.14

Wavelength 1542.14

Y

N/A

N/A

1542.35

Wavelength 1542.35

Y

N/A

N/A

1542.54

Wavelength 1542.54

Y

N/A

N/A

1542.94

Wavelength 1542.94

Y

N/A

N/A

1543.33

Wavelength 1543.33

Y

N/A

N/A

1543.73

Wavelength 1543.73

Y

N/A

N/A

1544.13

Wavelength 1544.13

Y

N/A

N/A

1544.53

Wavelength 1544.53

Y

N/A

N/A

1544.92

Wavelength 1544.92

Y

N/A

N/A

1545.32

Wavelength 1545.32

Y

N/A

N/A

1545.72

Wavelength 1545.72

Y

N/A

N/A

1546.12

Wavelength 1546.12

Y

N/A

N/A

1546.52

Wavelength 1546.52

Y

N/A

N/A

1546.92

Wavelength 1546.92

Y

N/A

N/A

1547.32

Wavelength 1547.32

Y

N/A

N/A

1547.72

Wavelength 1547.72

Y

N/A

N/A

1548.12

Wavelength 1548.12

Y

N/A

N/A

1548.51

Wavelength 1548.51

Y

N/A

N/A

1548.92

Wavelength 1548.92

Y

N/A

N/A

1549.32

Wavelength 1549.32

Y

N/A

N/A

1549.71

Wavelength 1549.71

Y

N/A

N/A

1550

Wavelength 1500

Y

N/A

N/A

1550.12

Wavelength 1550.12

Y

N/A

N/A

1550.52

Wavelength 1550.52

Y

N/A

N/A

1550.92

Wavelength 1550.92

Y

N/A

N/A

1551.32

Wavelength 1551.32

Y

N/A

N/A

1551.72

Wavelength 1551.72

Y

N/A

N/A

1552.12

Wavelength 1552.12

Y

N/A

N/A

1552.52

Wavelength 1552.52

Y

N/A

N/A

1552.93

Wavelength 1552.93

Y

N/A

N/A

1553.33

Wavelength 1553.33

Y

N/A

N/A

1553.73

Wavelength 1553.73

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.94

Wavelength 1554.94

Y

N/A

N/A

1555.34

Wavelength 1555.34

Y

N/A

N/A

1555.75

Wavelength 1555.75

Y

N/A

N/A

1556.15

Wavelength 1556.15

Y

N/A

N/A

1556.55

Wavelength 1556.55

Y

N/A

N/A

1556.96

Wavelength 1556.96

Y

N/A

N/A

1557.36

Wavelength 1557.36

Y

N/A

N/A

1557.77

Wavelength 1557.77

Y

N/A

N/A

1558.17

Wavelength 1558.17

Y

N/A

N/A

1558.58

Wavelength 1558.58

Y

N/A

N/A

1558.98

Wavelength 1558.98

Y

N/A

N/A

1559.39

Wavelength 1559.39

Y

N/A

N/A

1559.79

Wavelength 1559.79

Y

N/A

N/A

1560.20

Wavelength 1560.20

Y

N/A

N/A

1560.61

Wavelength 1560.61

Y

N/A

N/A

1561.01

Wavelength 1561.01

Y

N/A

N/A

1561.42

Wavelength 1561.42

Y

N/A

N/A

1561.83

Wavelength 1561.83

Y

N/A

N/A

1570

Wavelength 1570

Y

N/A

N/A

1570.83

Wavelength 1570.83

Y

N/A

N/A

1571.24

Wavelength 1571.24

Y

N/A

N/A

1571.65

Wavelength 1571.65

Y

N/A

N/A

1572.06

Wavelength 1572.06

Y

N/A

N/A

1572.48

Wavelength 1572.48

Y

N/A

N/A

1572.89

Wavelength 1572.89

Y

N/A

N/A

1573.30

Wavelength 1573.30

Y

N/A

N/A

1573.71

Wavelength 1573.71

Y

N/A

N/A

1574.13

Wavelength 1574.13

Y

N/A

N/A

1574.54

Wavelength 1574.54

Y

N/A

N/A

1574.95

Wavelength 1574.95

Y

N/A

N/A

1575.37

Wavelength 1575.37

Y

N/A

N/A

1575.78

Wavelength 1575.78

Y

N/A

N/A

1576.20

Wavelength 1576.20

Y

N/A

N/A

1576.61

Wavelength 1576.61

Y

N/A

N/A

1577.03

Wavelength 1577.03

Y

N/A

N/A

1577.44

Wavelength 1577.44

Y

N/A

N/A

1577.86

Wavelength 1577.86

Y

N/A

N/A

1578.27

Wavelength 1578.27

Y

N/A

N/A

1578.69

Wavelength 1578.69

Y

N/A

N/A

1579.10

Wavelength 1579.10

Y

N/A

N/A

1579.52

Wavelength 1579.52

Y

N/A

N/A

1579.93

Wavelength 1579.93

Y

N/A

N/A

1580.35

Wavelength 1580.35

Y

N/A

N/A

1580.77

Wavelength 1580.77

Y

N/A

N/A

1581.18

Wavelength 1581.18

Y

N/A

N/A

1581.60

Wavelength 1581.60

Y

N/A

N/A

1582.02

Wavelength 1582.02

Y

N/A

N/A

1582.44

Wavelength 1582.44

Y

N/A

N/A

1582.85

Wavelength 1582.85

Y

N/A

N/A

1583.27

Wavelength 1583.27

Y

N/A

N/A

1583.69

Wavelength 1583.69

Y

N/A

N/A

1584.11

Wavelength 1584.11

Y

N/A

N/A

1584.53

Wavelength 1584.53

Y

N/A

N/A

1584.95

Wavelength 1584.95

Y

N/A

N/A

1585.36

Wavelength 1585.36

Y

N/A

N/A

1585.78

Wavelength 1585.78

Y

N/A

N/A

1586.20

Wavelength 1586.20

Y

N/A

N/A

1586.62

Wavelength 1586.62

Y

N/A

N/A

1587.04

Wavelength 1587.04

Y

N/A

N/A

1587.46

Wavelength 1587.46

Y

N/A

N/A

1587.88

Wavelength 1587.88

Y

N/A

N/A

1588.30

Wavelength 1588.30

Y

N/A

N/A

1588.73

Wavelength 1588.73

Y

N/A

N/A

1589.15

Wavelength 1589.15

Y

N/A

N/A

1589.57

Wavelength 1589.57

Y

N/A

N/A

1589.99

Wavelength 1589.99

Y

N/A

N/A

1590

Wavelength 1590

Y

N/A

N/A

1590.41

Wavelength 1590.41

Y

N/A

N/A

1590.83

Wavelength 1590.83

Y

N/A

N/A

1591.26

Wavelength 1591.26

Y

N/A

N/A

1591.68

Wavelength 1591.68

Y

N/A

N/A

1592.10

Wavelength 1592.10

Y

N/A

N/A

1592.52

Wavelength 1592.52

Y

N/A

N/A

1592.95

Wavelength 1592.95

Y

N/A

N/A

1593.37

Wavelength 1593.37

Y

N/A

N/A

1593.79

Wavelength 1593.79

Y

N/A

N/A

1594.22

Wavelength 1594.22

Y

N/A

N/A

1594.64

Wavelength 1594.64

Y

N/A

N/A

1595.06

Wavelength 1595.06

Y

N/A

N/A

1595.49

Wavelength 1595.49

Y

N/A

N/A

1596.34

Wavelength 1596.34

Y

N/A

N/A

1596.76

Wavelength 1596.76

Y

N/A

N/A

1597.19

Wavelength 1597.19

Y

N/A

N/A

1597.62

Wavelength 1597.62

Y

N/A

N/A

1598.04

Wavelength 1598.04

Y

N/A

N/A

1598.47

Wavelength 1598.47

Y

N/A

N/A

1598.89

Wavelength 1598.89

Y

N/A

N/A

1599.32

Wavelength 1599.32

Y

N/A

N/A

1599.75

Wavelength 1599.75

Y

N/A

N/A

1600.06

Wavelength 1600.06

Y

N/A

N/A

1601.03

Wavelength 1601.03

Y

N/A

N/A

1601.46

Wavelength 1601.46

Y

N/A

N/A

1601.88

Wavelength 1601.88

Y

N/A

N/A

1602.31

Wavelength 1602.31

Y

N/A

N/A

1602.74

Wavelength 1602.74

Y

N/A

N/A

1603.17

Wavelength 1603.17

Y

N/A

N/A

1603.60

Wavelength 1603.60

Y

N/A

N/A

1604.03

Wavelength 1604.03

Y

N/A

N/A

1610

Wavelength 1610

Y

N/A

N/A

USE-TWL1

Use Tunable Wavelength 1

Y

N/A

N/A

<LOSSB>

(Optional) The parameter type is REACH, which is the reach value.

Y

N/A

N/A

AUTOPROV

Autoprovisioning

Y

N/A

N/A

CX

Reach CX

Y

N/A

N/A

DX

Reach DX

Y

N/A

N/A

HX

Reach HX

Y

N/A

N/A

I1

Reach I1

Y

N/A

N/A

IR-1

Reach IR-1

Y

N/A

N/A

IR-2

Reach IR-2

Y

N/A

N/A

L1

Reach L1

Y

N/A

N/A

L2

Reach L2

Y

N/A

N/A

L3

Reach L3

Y

N/A

N/A

LR-1

Reach LR-1

Y

N/A

N/A

LR-2

Reach LR-2

Y

N/A

N/A

LR-3

Reach LR-3

Y

N/A

N/A

LX

Reach LX

Y

N/A

N/A

S1

Reach S1

Y

N/A

N/A

S2

Reach S2

Y

N/A

N/A

SR

Reach SR

Y

N/A

N/A

SR-1

Reach SR-1

Y

N/A

N/A

SX

Reach SX

Y

N/A

N/A

T

Reach T

Y

N/A

N/A

VX

Reach VX

Y

N/A

N/A

ZX

Reach ZX

Y

N/A

N/A

<PSTPSTQ>

Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the PST and PSTQ.

Y

N/A

N/A

Unlocked-Enabled

In service and normal

Y

N/A

N/A

Unlocked-Disabled

Out of service and autonomous

Y

N/A

N/A

Locked-Disabled

Out of service, autonomous and management

Y

N/A

N/A

Locked-Enabled

Out of service and management

Y

N/A

N/A

<SST>

Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.

Y

N/A

N/A

AutomaticInService

Automatic in service

Y

N/A

N/A

Disabled

Disabled

Y

N/A

N/A

Loopback

Loopback

Y

N/A

N/A

MismatchofEquipmentAlarm

Mismatch of equipment and attributes

Y

N/A

N/A

Maintenance

Maintenance mode

Y

N/A

N/A

OutOfGroup

Out of group

Y

N/A

N/A

SoftwareDownload

Software downloading

Y

N/A

N/A

Unassigned

Unassigned

Y

N/A

N/A

NotInstalled

Unequipped

Y

N/A

N/A


21.3  RTRV-<MOD2DWDMPAYLOAD>


Note The RTRV-<MOD2DWDMPAYLOAD> command does not apply to the Cisco ONS 15600 SDH and Cisco ONS 15310 MA SDH platforms.


(Cisco ONS 15454 SDH) The Retrieve D1VIDEO, DV6000, ETRCLO, HDTV, ISCCOMPAT, ISC3PEER2R, ISC3PEER1G, ISC3PEER2G and PASSTHRU (RTRV-<MOD2DWDMPAYLOAD>) command retrieves the configuration parameter of a dense wavelength division multiplexing (DWDM) client. See Table 27-1 on page 27-1 for supported modifiers by platform.

Usage Guidelines

None

Category

DWDM

Security

Retrieve

Input Format

RTRV-<MOD2DWDMPAYLOAD>:[<TID>]:<AID>:<CTAG>[::::];

Input Example

RTRV-HDTV:MILAN:FAC-1-1:100;

Input Parameters

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.


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:UNLOCKED-DISABLED,AUTOMATICINSERVICE"
;

Table 21-3 RTRV-<MOD2DWDMPAYLOAD> Command - Output Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AIDUNIONID>

Access identifier from the "25.2  AidUnionId" section on page 25-11.

Y

N/A

N/A

<AIDTYPE>

A type of access identifier. The parameter type is MOD2DWDMPAYLOAD, which is the payload types applicable to DWDM ports.

Y

N/A

N/A

10GFC

10-Gigabit Fibre Channel payload

Y

N/A

N/A

10GIGE

10-Gigabit Ethernet

Y

N/A

N/A

1GFC

1-Gigabit Fibre Channel payload

Y

N/A

N/A

1GFICON

1-Gigabit fiber connectivity payload

Y

N/A

N/A

2GFC

2-Gigabit Fibre Channel payload

Y

N/A

N/A

2GFICON

2-Gigabit fiber connectivity payload

Y

N/A

N/A

D1VIDEO

D1Video payload

Y

N/A

N/A

DV6000

DV6000 payload

Y

N/A

N/A

ETRCLO

ETRCLO payload

Y

N/A

N/A

GIGE

Gigabit Ethernet payload

Y

N/A

N/A

HDTV

HDTV payload

Y

N/A

N/A

ISC1

ISC1 payload

Y

N/A

N/A

ISC3

ISC3 payload

Y

N/A

N/A

PASSTHRU

Any pass-through (2R) payload

Y

N/A

N/A

<ROLE>

(Optional) The port role in a Y-cable protection scheme. The parameter type is SIDE, which is the role the unit has in the protection group.

Y

N/A

N/A

PROT

The entity is a protection unit in the protection group.

Y

N/A

N/A

WORK

The entity is a working unit in the protection group.

Y

N/A

N/A

<STATUS>

(Optional) Port status in a Y-cable protection scheme. The parameter type is STATUS, which is the status of the unit in the protection pair.

Y

N/A

N/A

ACT

The entity is the active unit in the shelf.

Y

N/A

N/A

NA

Status is unavailable.

Y

N/A

N/A

STBY

The entity is the standby unit in the shelf.

Y

N/A

N/A

<NAME>

(Optional) Identifies the port name. NAME is a string.

Y

N/A

N/A

<LBCL>

(Optional) Displays the current value of the laser current. LBCL is a float.

Y

N/A

N/A

<OPT>

(Optional) Displays the current value of the transmitted optical power. OPT is a float.

Y

N/A

N/A

<OPR>

(Optional) Displays the current value of the received optical power. OPR is a float.

Y

N/A

N/A

<FREQ>

(Optional) The parameter type is OPTICAL_WLEN, which is the optical wavelength.

Y

N/A

N/A

1310

Wavelength 1310

Y

N/A

N/A

1470

Wavelength 1470

Y

N/A

N/A

1490

Wavelength 1490

Y

N/A

N/A

1510

Wavelength 1510

Y

N/A

N/A

1529.55

Wavelength 1529.55

Y

N/A

N/A

1529.94

Wavelength 1529.94

Y

N/A

N/A

1530

Wavelength 1530

Y

N/A

N/A

1530.33

Wavelength 1530.33

Y

N/A

N/A

1530.73

Wavelength 1530.73

Y

N/A

N/A

1531.12

Wavelength 1531.12

Y

N/A

N/A

1531.51

Wavelength 1531.51

Y

N/A

N/A

1531.90

Wavelength 1531.90

Y

N/A

N/A

1532.29

Wavelength 1532.29

Y

N/A

N/A

1532.68

Wavelength 1532.68

Y

N/A

N/A

1533.07

Wavelength 1533.07

Y

N/A

N/A

1533.47

Wavelength 1533.47

Y

N/A

N/A

1533.86

Wavelength 1533.86

Y

N/A

N/A

1534.25

Wavelength 1534.25

Y

N/A

N/A

1534.64

Wavelength 1534.64

Y

N/A

N/A

1535.04

Wavelength 1535.04

Y

N/A

N/A

1535.43

Wavelength 1535.43

Y

N/A

N/A

1535.82

Wavelength 1535.82

Y

N/A

N/A

1536.22

Wavelength 1536.22

Y

N/A

N/A

1536.61

Wavelength 1536.61

Y

N/A

N/A

1537

Wavelength 1537

Y

N/A

N/A

1537.40

Wavelength 1537.40

Y

N/A

N/A

1537.79

Wavelength 1537.79

Y

N/A

N/A

1538.19

Wavelength 1538.19

Y

N/A

N/A

1538.58

Wavelength 1538.58

Y

N/A

N/A

1538.98

Wavelength 1538.98

Y

N/A

N/A

1539.37

Wavelength 1539.37

Y

N/A

N/A

1539.77

Wavelength 1539.77

Y

N/A

N/A

1540.16

Wavelength 1540.16

Y

N/A

N/A

1540.56

Wavelength 1540.56

Y

N/A

N/A

1540.95

Wavelength 1540.95

Y

N/A

N/A

1541.35

Wavelength 1541.35

Y

N/A

N/A

1541.75

Wavelength 1541.75

Y

N/A

N/A

1542.14

Wavelength 1542.14

Y

N/A

N/A

1542.35

Wavelength 1542.35

Y

N/A

N/A

1542.54

Wavelength 1542.54

Y

N/A

N/A

1542.94

Wavelength 1542.94

Y

N/A

N/A

1543.33

Wavelength 1543.33

Y

N/A

N/A

1543.73

Wavelength 1543.73

Y

N/A

N/A

1544.13

Wavelength 1544.13

Y

N/A

N/A

1544.53

Wavelength 1544.53

Y

N/A

N/A

1544.92

Wavelength 1544.92

Y

N/A

N/A

1545.32

Wavelength 1545.32

Y

N/A

N/A

1545.72

Wavelength 1545.72

Y

N/A

N/A

1546.12

Wavelength 1546.12

Y

N/A

N/A

1546.52

Wavelength 1546.52

Y

N/A

N/A

1546.92

Wavelength 1546.92

Y

N/A

N/A

1547.32

Wavelength 1547.32

Y

N/A

N/A

1547.72

Wavelength 1547.72

Y

N/A

N/A

1548.12

Wavelength 1548.12

Y

N/A

N/A

1548.51

Wavelength 1548.51

Y

N/A

N/A

1548.92

Wavelength 1548.92

Y

N/A

N/A

1549.32

Wavelength 1549.32

Y

N/A

N/A

1549.71

Wavelength 1549.71

Y

N/A

N/A

1550

Wavelength 1500

Y

N/A

N/A

1550.12

Wavelength 1550.12

Y

N/A

N/A

1550.52

Wavelength 1550.52

Y

N/A

N/A

1550.92

Wavelength 1550.92

Y

N/A

N/A

1551.32

Wavelength 1551.32

Y

N/A

N/A

1551.72

Wavelength 1551.72

Y

N/A

N/A

1552.12

Wavelength 1552.12

Y

N/A

N/A

1552.52

Wavelength 1552.52

Y

N/A

N/A

1552.93

Wavelength 1552.93

Y

N/A

N/A

1553.33

Wavelength 1553.33

Y

N/A

N/A

1553.73

Wavelength 1553.73

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.13

Wavelength 1554.13

Y

N/A

N/A

1554.94

Wavelength 1554.94

Y

N/A

N/A

1555.34

Wavelength 1555.34

Y

N/A

N/A

1555.75

Wavelength 1555.75

Y

N/A

N/A

1556.15

Wavelength 1556.15

Y

N/A

N/A

1556.55

Wavelength 1556.55

Y

N/A

N/A

1556.96

Wavelength 1556.96

Y

N/A

N/A

1557.36

Wavelength 1557.36

Y

N/A

N/A

1557.77

Wavelength 1557.77

Y

N/A

N/A

1558.17

Wavelength 1558.17

Y

N/A

N/A

1558.58

Wavelength 1558.58

Y

N/A

N/A

1558.98

Wavelength 1558.98

Y

N/A

N/A

1559.39

Wavelength 1559.39

Y

N/A

N/A

1559.79

Wavelength 1559.79

Y

N/A

N/A

1560.20

Wavelength 1560.20

Y

N/A

N/A

1560.61

Wavelength 1560.61

Y

N/A

N/A

1561.01

Wavelength 1561.01

Y

N/A

N/A

1561.42

Wavelength 1561.42

Y

N/A

N/A

1561.83

Wavelength 1561.83

Y

N/A

N/A

1570

Wavelength 1570

Y

N/A

N/A

1570.83

Wavelength 1570.83

Y

N/A

N/A

1571.24

Wavelength 1571.24

Y

N/A

N/A

1571.65

Wavelength 1571.65

Y

N/A

N/A

1572.06

Wavelength 1572.06

Y

N/A

N/A

1572.48

Wavelength 1572.48

Y

N/A

N/A

1572.89

Wavelength 1572.89

Y

N/A

N/A

1573.30

Wavelength 1573.30

Y

N/A

N/A

1573.71

Wavelength 1573.71

Y

N/A

N/A

1574.13

Wavelength 1574.13

Y

N/A

N/A

1574.54

Wavelength 1574.54

Y

N/A

N/A

1574.95

Wavelength 1574.95

Y

N/A

N/A

1575.37

Wavelength 1575.37

Y

N/A

N/A

1575.78

Wavelength 1575.78

Y

N/A

N/A

1576.20

Wavelength 1576.20

Y

N/A

N/A

1576.61

Wavelength 1576.61

Y

N/A

N/A

1577.03

Wavelength 1577.03

Y

N/A

N/A

1577.44

Wavelength 1577.44

Y

N/A

N/A

1577.86

Wavelength 1577.86

Y

N/A

N/A

1578.27

Wavelength 1578.27

Y

N/A

N/A

1578.69

Wavelength 1578.69

Y

N/A

N/A

1579.10

Wavelength 1579.10

Y

N/A

N/A

1579.52

Wavelength 1579.52

Y

N/A

N/A

1579.93

Wavelength 1579.93

Y

N/A

N/A

1580.35

Wavelength 1580.35

Y

N/A

N/A

1580.77

Wavelength 1580.77

Y

N/A

N/A

1581.18

Wavelength 1581.18

Y

N/A

N/A

1581.60

Wavelength 1581.60

Y

N/A

N/A

1582.02

Wavelength 1582.02

Y

N/A

N/A

1582.44

Wavelength 1582.44

Y

N/A

N/A

1582.85

Wavelength 1582.85

Y

N/A

N/A

1583.27

Wavelength 1583.27

Y

N/A

N/A

1583.69

Wavelength 1583.69

Y

N/A

N/A

1584.11

Wavelength 1584.11

Y

N/A

N/A

1584.53

Wavelength 1584.53

Y

N/A

N/A

1584.95

Wavelength 1584.95

Y

N/A

N/A

1585.36

Wavelength 1585.36

Y

N/A

N/A

1585.78

Wavelength 1585.78

Y

N/A

N/A

1586.20

Wavelength 1586.20

Y

N/A

N/A

1586.62

Wavelength 1586.62

Y

N/A

N/A

1587.04

Wavelength 1587.04

Y

N/A

N/A

1587.46

Wavelength 1587.46

Y

N/A

N/A

1587.88

Wavelength 1587.88

Y

N/A

N/A

1588.30

Wavelength 1588.30

Y

N/A

N/A

1588.73

Wavelength 1588.73

Y

N/A

N/A

1589.15

Wavelength 1589.15

Y

N/A

N/A

1589.57

Wavelength 1589.57

Y

N/A

N/A

1589.99

Wavelength 1589.99

Y

N/A

N/A

1590

Wavelength 1590

Y

N/A

N/A

1590.41

Wavelength 1590.41

Y

N/A

N/A

1590.83

Wavelength 1590.83

Y

N/A

N/A

1591.26

Wavelength 1591.26

Y

N/A

N/A

1591.68

Wavelength 1591.68

Y

N/A

N/A

1592.10

Wavelength 1592.10

Y

N/A

N/A

1592.52

Wavelength 1592.52

Y

N/A

N/A

1592.95

Wavelength 1592.95

Y

N/A

N/A

1593.37

Wavelength 1593.37

Y

N/A

N/A

1593.79

Wavelength 1593.79

Y

N/A

N/A

1594.22

Wavelength 1594.22

Y

N/A

N/A

1594.64

Wavelength 1594.64

Y

N/A

N/A

1595.06

Wavelength 1595.06

Y

N/A

N/A

1595.49

Wavelength 1595.49

Y

N/A

N/A

1596.34

Wavelength 1596.34

Y

N/A

N/A

1596.76

Wavelength 1596.76

Y

N/A

N/A

1597.19

Wavelength 1597.19

Y

N/A

N/A

1597.62

Wavelength 1597.62

Y

N/A

N/A

1598.04

Wavelength 1598.04

Y

N/A

N/A

1598.47

Wavelength 1598.47

Y

N/A

N/A

1598.89

Wavelength 1598.89

Y

N/A

N/A

1599.32

Wavelength 1599.32

Y

N/A

N/A

1599.75

Wavelength 1599.75

Y

N/A

N/A

1600.06

Wavelength 1600.06

Y

N/A

N/A

1601.03

Wavelength 1601.03

Y

N/A

N/A

1601.46

Wavelength 1601.46

Y

N/A

N/A

1601.88

Wavelength 1601.88

Y

N/A

N/A

1602.31

Wavelength 1602.31

Y

N/A

N/A

1602.74

Wavelength 1602.74

Y

N/A

N/A

1603.17

Wavelength 1603.17

Y

N/A

N/A

1603.60

Wavelength 1603.60

Y

N/A

N/A

1604.03

Wavelength 1604.03

Y

N/A

N/A

1610

Wavelength 1610

Y

N/A

N/A

USE-TWL1

Use Tunable Wavelength 1

Y

N/A

N/A

<LOSSB>

(Optional) The parameter type is REACH, which is the reach value.

Y

N/A

N/A

AUTOPROV

Autoprovisioning

Y

N/A

N/A

CX

Reach CX

Y

N/A

N/A

DX

Reach DX

Y

N/A

N/A

HX

Reach HX

Y

N/A

N/A

I1

Reach I1

Y

N/A

N/A

IR-1

Reach IR-1

Y

N/A

N/A

IR-2

Reach IR-2

Y

N/A

N/A

L1

Reach L1

Y

N/A

N/A

L2

Reach L2

Y

N/A

N/A

L3

Reach L3

Y

N/A

N/A

LR-1

Reach LR-1

Y

N/A

N/A

LR-2

Reach LR-2

Y

N/A

N/A

LR-3

Reach LR-3

Y

N/A

N/A

LX

Reach LX

Y

N/A

N/A

S1

Reach S1

Y

N/A

N/A

S2

Reach S2

Y

N/A

N/A

SR

Reach SR

Y

N/A

N/A

SR-1

Reach SR-1

Y

N/A

N/A

SX

Reach SX

Y

N/A

N/A

T

Reach T

Y

N/A

N/A

VX

Reach VX

Y

N/A

N/A

ZX

Reach ZX

Y

N/A

N/A

<PSTPSTQ>

Primary state of the entity. The parameter type is PST_PSTQ, which is the service state of the entity described by the PST and PSTQ.

Y

N/A

N/A

Unlocked-Enabled

In service and normal

Y

N/A

N/A

Unlocked-Disabled

Out of service and autonomous

Y

N/A

N/A

Locked-Disabled

Out of service, autonomous and management

Y

N/A

N/A

Locked-Enabled

Out of service and management

Y

N/A

N/A

<SST>

(Optional) Secondary state of the entity. The parameter type is SST, which provides additional information pertaining to PST and PSTQ.

Y

N/A

N/A

AutomaticInService

Automatic in service

Y

N/A

N/A

Disabled

Disabled

Y

N/A

N/A

Loopback

Loopback

Y

N/A

N/A

MismatchofEquipmentAlarm

Mismatch of equipment and attributes

Y

N/A

N/A

Maintenance

Maintenance mode

Y

N/A

N/A

OutOfGroup

Out of group

Y

N/A

N/A

SoftwareDownload

Software downloading

Y

N/A

N/A

Unassigned

Unassigned

Y

N/A

N/A

NotInstalled

Unequipped

Y

N/A

N/A


21.4  RTRV-<MOD_RING>


Note The RTRV-<MOD_RING> command does not apply to the Cisco ONS 15310 MA SDH platform.


(Cisco ONS 15454 SDH and Cisco ONS 15600 SDH) The Retrieve Multiplex Section Shared Protection Ring (RTRV-<MOD_RING>) command retrieves the multiplex section-shared protection ring (MS-SPRing) information of the network element (NE). A two-fiber or four-fiber MS-SPRing can be retrieved.

Usage Guidelines

Error conditions:

Only ALL, NULL, MSSPR-ALL, or MSSPR-RINGID is allowed for this command.

A NULL AID defaults to the AID ALL.

The list AID format is supported.

If the system fails on getting information object repository (IOR), a Get IOR Failed (SROF) error message is returned.

If the AID is invalid, an Invalid AID (IIAC) error message is returned.

If the MS-SPRing does not exist, a MSSPR Does Not Exist (SRQN) error message is returned.

Category

MS-SPRing

Security

Retrieve

Input Format

RTRV-<MOD_RING>:[<TID>]:[<AID>]:<CTAG>[::::];

Input Example

RTRV-MSSPR:PETALUMA:ALL:123;

Input Parameters

<AID>

(Optional) Access identifier from the "25.3  AidUnionId1" section on page 25-12. Identifies the MS-SPRing of the NE. Only ALL, null or a list of MSSPR-# 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

4F MS-SPRing

TID-000 1998-06-20 14:30:00
M 001 COMPLD
"MSSPR-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"
;

2F MS-SPRing

TID-000 1998-06-20 14:30:00
M 001 COMPLD
"MSSPR-N12EF::RINGID=N12EF,NODEID=2,MODE=2F,RVRTV=Y,RVTM=5.0,
EASTWORK=FAC-5-1,WESTWORK=FAC-6-1"
;

Table 21-4 RTRV-<MOD_RING> Command - Output Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

(Optional) Access identifier from the "25.3  AidUnionId1" section on page 25-12. Identifies the MS-SPRing of the NE.

Y

Y

N/A

<RINGID>

(Optional) The MS-SPRing ID of the NE up to six characters. Valid characters are A-Z and 0-9. RINGID is a string.

Y

Y

N/A

<NODEID>

(Optional) The MS-SPRing node ID of the NE. NODEID ranges from 0 to 31. NODEID is a string.

Y

Y

N/A

<MODE>

(Optional) Mode with which the command is to be implemented. Identifies the MS-SPRing mode; either two-fiber or four-fiber. The parameter type is MSSPR_MODE, which is the MS-SPRing mode.

Y

Y

N/A

2F

Two-fiber MS-SPRing

Y

Y

N/A

4F

Four-fiber MS-SPRing

Y

Y

N/A

<RVRTV>

(Optional) Revertive mode. The value Y indicates that protection switching system reverts service to the original line after restoration. The value N indicates that protection switching system does not revert service to the original line after restoration. RVRTV is applicable only for 1+1 protection switching. Null defaults to N. The parameter type is ON_OFF (disable or enable an attribute).

Y

Y

N/A

N

Does not revert service to original line after restoration.

Y

Y

N/A

Y

Reverts service to original line after restoration.

Y

Y

N/A

<RVTM>

(Optional) Revertive time. RVTM is not allowed to be set while RVRTV is N. The parameter type is REVERTIVE_TIME (revertive time).

Y

Y

N/A

0.5 to 12.0

Revertive time is 0.5 to 12.0 minutes.

Y

Y

N/A

<SRVRTV>

(Optional) The span revertive mode for four-fiber MS-SPRing only. The parameter type is ON_OFF (disable or enable an attribute).

Y

Y

N/A

N

Disable an attribute.

Y

Y

N/A

Y

Enable an attribute.

Y

Y

N/A

<SRVTM>

(Optional) The span revertive time for four-fiber MS-SPRing only. SRVTM is not allowed to be set while SRVRTV is N. The parameter type is REVERTIVE_TIME (revertive time).

Y

Y

N/A

0.5 to 12.0

Revertive time is 0.5 to 12.0 minutes.

Y

Y

N/A

<EASTWORK>

(Optional) East working facility. AID from the "25.13  FACILITY" section on page 25-22.

Y

Y

N/A

<WESTWORK>

(Optional) West working facility. AID from the "25.13  FACILITY" section on page 25-22.

Y

Y

N/A

<EASTPROT>

(Optional) East protecting facility. AID from the "25.13  FACILITY" section on page 25-22.

Y

Y

N/A

<WESTPROT>

(Optional) West protecting facility. AID from the "25.13  FACILITY" section on page 25-22.

Y

Y

N/A


21.5  RTRV-<PATH>

(Cisco ONS 15454 SDH, Cisco ONS 15600 SDH, and Cisco ONS 15310 MA SDH) The Retrieve VC3, VC44C, VC38C, VC464C, VC48C, VC4-12C, VC4, VC416C, VC42C, VC43C, VC11, or VC12 (RTRV-<PATH>) command retrieves the attributes associated with an VC path. See Table 27-1 on page 27-1 for supported modifiers by platform.


Note The VC11, VC38C, and VC464C modifiers are not supported on the Cisco ONS 15310 MA SDH platform.


Usage Guidelines

Supported AIDs are: ALL, SLOT-N (N=1,2,...,ALL), and VC-specific AIDs.

The SFBER, SDBER, RVRTV, RVTM, HOLDOFFTIMER, and SNCPPTHSTATE parameters only apply to subnetwork connection protection (SNCP).

The path trace message is a 64 character string including the terminating carriage return (CR) and line feed (LF) that is transported in the J1 byte of the SDH VC path overhead.

The EXPTRC indicates the contents of the expected incoming path trace that are provisioned by the user in the ED-VC_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 compares the received string with the user-entered expected string. The AUTO mode compares 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 either 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 either a copy of the received string, or NULL if the string has not been received.

J1 (EXPTRC) is implemented on the STM1, STM16AS, STM64, MRC-12, and STM64-XFP cards.

J1 is implemented on E1, E3, T3, and STM facilities on the Cisco ONS 15310 MA SDH platform.

The optional parameter MSSPRPTHTYPE provides more options to retrieve J1/C2 of a particular MS-SPRing path. This field is valid only if the queried AID port has MS-SPRing. The MSSPRPTHTYPE defaults to NON-PCA path type if the MS-SPRing is switched, or defaults to PCA if there is no MS-SPRing switching.

Sending this command while MSSPRPTHTYPE=PCA, whether there is MS-SPRing switch or not, the protection channel access (PCA) path J1/C2 data will be returned (if there is PCA circuit on the AID). Sending this command with a VC AID without circuits and no MS-SPRing switched on the VC, will return and error message.

An optional output parameter MSSPRPTHSTATE is introduced into this command output on the Cisco ONS 15454 SDH and Cisco ONS 15600 SDH platforms only. Each J1/C2 output data of this command will include the MS-SPRing path state information.

After the MS-SPRing switching, the J1/IPPM/C2 data can be retrieved over the protection path. Provisioning J1 trace string, trace mode, or threshold is not allowed on the protection path.

HOLDOFFTIMER is not specific to a path. Instead, it is applicable to the SNCP selector.

To retrieve either the cross-connect points or the test access points (TAPs) on the DS3i-N-12 card, the RTRV-VC3 command with the appropriate AID must be used.

Category

Paths

Security

Retrieve

Input Format

RTRV-<PATH>:[<TID>]:<AID>:<CTAG>:::[MSSPRPTHTYPE=<MSSPRPTHTYPE>][:];

Input Example

Cisco ONS 15454 SDH and Cisco ONS 15600 SDH

RTRV-VC4:FERNDALE:VC4-2-1-4:238:::MSSPRPTHTYPE=NON-PCA;

Cisco ONS 15310 MA SDH

RTRV-VC3::VC3-3-1-1-1-1:29;

Table 21-5 RTRV-<PATH> Command - Input Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

Access identifier from the "25.10  CrossConnectId1" section on page 25-17.

Y

Y

Y

<MSSPRPTHTYPE>

(Optional) The MS-SPRing path type (only if the port is on the MS-SPRing). Defaults to NON-PCA. Applicable only to VC-level paths in SDH. A null value defaults to NON-PCA. The parameter type is MSSPR_PTH_TYPE, which is the MS-SPRing path type only if the port is on the MS-SPRing.

Y

Y

N

NON-PCA

The AID is on the working path, or the cross-connection card protection path.

Y

Y

N

PCA

The AID is on the MS-SPRing PCA path.

Y

Y

N


Output Format

SID DATE TIME
M CTAG COMPLD
"<AID>::[LEVEL=<LEVEL>],[SFBER=<SFBER>],[SDBER=<SDBER>],[RVRTV=<RVRTV>],
[RVTM=<RVTM>],[HOLDOFFTIMER=<HOLDOFFTIMER>],
[EXPTRC=<EXPTRC>],[TRC=<TRC>],[INCTRC=<INCTRC>],
[TRCMODE=<TRCMODE>],[TACC=<TACC>],[TAPTYPE=<TAPTYPE>],
[SNCPPTHSTATE=<SNCPPTHSTATE>],[C2=<C2>],
[MSSPRPTHSTATE=<MSSPRPTHSTATE>]:<PSTPSTQ>,[<SSTQ>]"
;

Output Example

Cisco ONS 15454 SDH and Cisco ONS 15600 SDH

TID-000 1998-06-20 14:30:00
M 001 COMPLD
"VC4-2-1-4::LEVEL=VC4,SFBER=1E-3,SDBER=1E-5,RVRTV=Y,RVTM=1.0,
HOLDOFFTIMER=2000,EXPTRC="EXPTRCSTRING",TRC="TRCSTRING",
INCTRC="INCTRCSTRING",TRCMODE=AUTO,TACC=8,TAPTYPE=DUAL,
SNCPPTHSTATE=ACT,C2=0X04,
MSSPRPTHSTATE=PROTPTHACT:UNLOCKED-DISABLED,AUTOMATICINSERVICE"

Cisco ONS 15310 MA SDH

NODE-310MADH 2008-02-06 06:31:00

M 29 COMPLD

"VC3-3-1-1-1-1::LEVEL=VC3,RVRTV=N,RVTM=5.0,HOLDOFFTIMER=0,SNCPPTHSTATE=ACT,:unlocked-disabled,automaticInService"

;

Table 21-6 RTRV-<PATH> Command - Output Parameter Support

Parameter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

Access identifier from the "25.10  CrossConnectId1" section on page 25-17.

Y

Y

Y

<LEVEL>

(Optional) The rate of the cross-connected channel. Applicable only to High-Order paths (VC4). The parameter type is PATH, which is the modifier for path commands.

Y

Y

Y

VC3

Synchronous Transport Signal/Module Level-1 (51 Mbps)

Y

Y

Y

VC44C

Synchronous Transport Signal/Module Level-12 Concatenated (622 Mbps)

Y

Y

Y

VC38C

Synchronous Transport Signal/Module Level-18 Concatenated (933 Mbps)

Y

Y

Y

VC464C

Synchronous Transport Signal/Module Level-192 Concatenated (9952 Mbps)

Y

Y

N

VC48C

Synchronous Transport Signal/Module Level-24 Concatenated (1240 Mbps)

Y

Y

Y

VC4

Synchronous Transport Signal/Module Signal Level-3 Concatenated (155 Mbps)

Y

Y

Y

VC416C

Synchronous Transport Signal/Module Level-48 Concatenated (2488 Mbps)

Y

Y

Y

VC42C

Synchronous Transport Signal/Module level-6 (310 Mbps)

Y

Y

Y

VC43C

Synchronous Transport Signal/Module Level-9 Concatenated (465 Mbps)

Y

Y

Y

VC12

Virtual Tributary 2. Virtual Channel 12

Y

Y

Y

VC11

Virtual Tributary 1. Virtual Channel 11

Y

Y

N

<SFBER>

(Optional) A VC path signal failure threshold that only applies to SNCP. Applicable only to High-Order paths. Defaults to 1E-4. The parameter type is SF_BER, which is the threshold for declaring signal failure on a facility or path.

Y

Y

Y

1E-3

SFBER is 1E-3.

Y

Y

Y

1E-4

SFBER is 1E-4.

Y

Y

Y

1E-5

SFBER is 1E-5.

Y

Y

Y

<SDBER>

(Optional) A VC path signal degrade threshold that only applies to SNCP. Applicable only High-Order paths. Defaults 1E-6. The parameter type is SD_BER, which is the threshold for declaring signal degrade on a facility or path.

Y

Y

Y

1E-5

SDBER is 1E-5.

Y

Y

Y

1E-6

SDBER is 1E-6.

Y

Y

Y

1E-7

SDBER is 1E-7.

Y

Y

Y

1E-8

SDBER is 1E-8.

Y

Y

Y

1E-9

SDBER is 1E-9.

Y

Y

Y

<RVRTV>

(Optional) Revertive mode. The value Y indicates that protection switching system reverts service to the original line after restoration. The value N indicates that protection switching system does not revert service to the original line after restoration. RVRTV is applicable only for 1+1 protection switching. Null defaults to N. The parameter type is ON_OFF (disable or enable an attribute).

Y

Y

Y

N

Does not revert service to original line after restoration.

Y

Y

Y

Y

Reverts service to original line after restoration.

Y

Y

Y

RVTM

(Optional) Revertive time. Only applies to SNCP. The parameter type is REVERTIVE_TIME (revertive time).

Y

Y

Y

0.5 to 12.0

Revertive time is 0.5 to 12.0 minutes.

Y

Y

Y

N

Disable an attribute.

Y

Y

Y

Y

Enable an attribute.

Y

Y

Y

<HOLDOFFTIMER>

(Optional) Hold off timer. HOLDOFFTIMER is an integer.

Y

Y

Y

<EXPTRC>

(Optional) Expected path trace content. Indicates the expected path trace message (J1) contents. EXPTRC is any 64-character ASCII string, including the terminating CR and LF. Applicable to VC-level paths (VCn). Defaults to NULL when SNCP path is created. EXPTRC is a string.

Y

Y

Y

<TRC>

(Optional) The path trace message to be transmitted. The trace byte (J1) continuously transmits a 64-byte, fixed length ASCII string, one byte at a time. A null value defaults to the NE transmitting 62 null characters (hex 00) and CR and LF. A null value defaults to the NE transmitting null characters (Hex 00). Applicable to VC-level paths (VCn). TRC is a string.

Y

Y

Y

<INCTRC>

(Optional) The incoming path trace message contents. INCTRC is any combination of 64 characters. Applicable only to VC-level paths in (VCn). Defaults to Null when a SNCP path is created. INCTRC is a string.

Y

Y

Y

<TRCMODE>

(Optional) Path trace mode. Applicable only to VC-level paths (VCn). Defaults to OFF when a SNCP path is created. The parameter type is TRCMODE, which is the trace mode.

Y

Y

Y

AUTO

Use the previously received path trace string as the expected string (not applicable to MXP_2.5G_10G and TXP_MR_10G cards).

Y

Y

Y

AUTO-NO-AIS

Use the previously received path trace string as the expected string and do not turn on AIS and RDI if TIMP detected.

Y

Y

Y

MAN

Use the provisioned expected string as the expected string.

Y

Y

Y

MAN-NO-AIS

Use the provisioned expected string as the expected string and do not turn on AIS and RDI if TIMP detected.

Y

Y

Y

OFF

Turn off path trace capability. Nothing will be reported.

Y

Y

Y

<TACC>

(Optional) Test access. Indicates whether the digroup being provisioned is to be used as a test access digroup. Defaults to N.

Y

Y

Y

<TAPTYPE>

(Optional) TAP type. The parameter type is TAPTYPE, which is the test access point type.

Y

Y

Y

DUAL

Dual facility access digroup (FAD).

Y

Y

Y

SINGLE

Single FAD

Y

Y

Y

<SNCPPTHSTATE>

(Optional) Indicates whether a given AID is the working or standby path of a SNCP cross-connect. The parameter type is STATUS, which is the status of the unit in the protection pair.

Y

Y

Y

ACT

The entity is the active unit in the shelf.

Y

Y

Y

NA

Status is unavailable.

Y

Y

Y

STBY

The entity is the standby unit in the shelf.

Y

Y

Y

<C2>

(Optional) The C2 byte hex code. Applicable only to VC-level paths (VCn). The parameter type is C2_BYTE, which is the C2 byte hex code.

Y

Y

Y

0X00

Unequipped

Y

Y

Y

0X01

Equipped-Non Specific payload

Y

Y

Y

0X02

VT-Structured VC-1 synchronous payload envelope (SPE)

Y

Y

Y

0X03

Locked Virtual Tributary (VT) mode

Y

Y

Y

0X04

Asynchronous Mapping for DS3

Y

Y

Y

0X12

Asynchronous Mapping for DS4 North American (NA)

Y

Y

Y

0X13

Mapping for asynchronous transfer mode (ATM)

Y

Y

Y

0X14

Mapping for distributed queue dual bus (DQDB)

Y

Y

Y

0X15

Asynchronous Mapping for fiber distributed data interface (FDDI)

Y

Y

Y

0X16

High-level data link control (HDLC)-Over-SDH Mapping

Y

Y

Y

0XE1

VT-structured VC4-1 SPE with 1VTx payload defect

Y

Y

Y

0XE2

VT-structured VC4-1 SPE with 2VTx payload defects

Y

Y

Y

0XE3

VT-structured VC4-1 SPE with 3VTx payload defects

Y

Y

Y

0XE4

VT-structured VC4-1 SPE with 4VTx payload defects

Y

Y

Y

0XE5

VT-structured VC4-1 SPE with 5VTx payload defects

Y

Y

Y

0XE6

VT-structured VC4-1 SPE with 6VTx payload defects

Y

Y

Y

0XE7

VT-structured VC4-1 SPE with 7VTx payload defects

Y

Y

Y

0XE8

VT-structured VC4-1 SPE with 8VTx payload defects

Y

Y

Y

0XE9

VT-structured VC4-1 SPE with 9VTx payload defects

Y

Y

Y

0XEA

VT-structured VC4-1 SPE with 10VTx payload defects

Y

Y

Y

0XEB

VT-structured VC4-1 SPE with 11VTx payload defects

Y

Y

Y

0XEC

VT-structured VC4-1 SPE with 12VTx payload defects

Y

Y

Y

0XED

VT-structured VC4-1 SPE with 13VTx payload defects

Y

Y

Y

0XEE

VT-structured VC4-1 SPE with 14VTx payload defects

Y

Y

Y

0XEF

VT-structured VC4-1 SPE with 15VTx payload defects

Y

Y

Y

0XF0

VT-structured VC4-1 SPE with 16VTx payload defects

Y

Y

Y

0XF1

VT-structured VC4-1 SPE with 17VTx payload defects

Y

Y

Y

0XF2

VT-structured VC4-1 SPE with 18VTx payload defects

Y

Y

Y

0XF3

VT-structured VC4-1 SPE with 19VTx payload defects

Y

Y

Y

0XF4

VT-structured VC4-1 SPE with 20VTx payload defects

Y

Y

Y

0XF5

VT-structured VC4-1 SPE with 21VTx payload defects

Y

Y

Y

0XF6

VT-structured VC4-1 SPE with 22VTx payload defects

Y

Y

Y

0XF7

VT-structured VC4-1 SPE with 23VTx payload defects

Y

Y

Y

0XF8

VT-structured VC4-1 SPE with 24VTx payload defects

Y

Y

Y

0XF9

VT-structured VC4-1 SPE with 25VTx payload defects

Y

Y

Y

0XFA

VT-structured VC4-1 SPE with 26VTx payload defects

Y

Y

Y

0XFB

VT-structured VC4-1 SPE with 27VTx payload defects

Y

Y

Y

0XFC

VT-structured VC4-1 SPE with 28VTx payload defects

Y

Y

Y

0XFE

O.181 Test Signal (TSS1 to TSS3) Mapping

Y

Y

Y

0XFF

Reserved. C2 is 0XFF if AIS-L is being generated by an optical card or cross-connect downstream.

Y

Y

Y

<MSSPRPTHSTATE>

(Optional) The MS-SPRing path state only if the port is on the MS-SPRing. Applicable only to VC-level paths in SDH (VCn). The parameter type is MSSPR_PTH_STATE, which is the MS-SPRing path state only if the port is on the MS-SPRing.

Y

Y

N

PCAPTHACT

Indicates that the MS-SPRing switched and its PCA path is in the active state.

Y

Y

N

PCAPTHSTB

Indicates that the MS-SPRing switched and its PCA path is in the standby state.

Y

Y

N

PROTPTHACT

Indicates that the MS-SPRing switched and its protection path is in the active state.

Y

Y

N

WKGPTHACT

Indicates that the MS-SPRing switched and its working path is in the active state.

Y

Y

N

WKGPTHSTB

Indicates that the MS-SPRing switched and its working path is in the standby state.

Y

Y

N

<PSTPSTQ>

Administrative state in the PST_PSTQ format. The parameter type is PST_PSTQ, which is the service state of the entity described by the PST and the PSTQ.

Y

Y

Y

Unlocked-Enabled

In service and normal

Y

Y

Y

Unlocked-Disabled

Out of service and autonomous

Y

Y

Y

Locked-Disabled

Out of service, autonomous and management

Y

Y

Y

Locked-Enabled

Out of service and management

Y

Y

Y

<SSTQ>

(Optional) Secondary state of the entity. the parameter type is SST, which provides additional information pertaining to PST and PSTQ.

Y

Y

Y

AutomaticInService

Automatic in service

Y

Y

Y

Disabled

Disabled

Y

Y

Y

Loopback

Loopback

Y

Y

Y

MismatchofEquipmentAlarm

Mismatch of equipment and attributes

Y

Y

Y

Maintenance

Maintenance mode

Y

Y

Y

OutOfGroup

Out of group

Y

Y

Y

SoftwareDownload

Software downloading

Y

Y

Y

Unassigned

Unassigned

Y

Y

Y

NotInstalled

Unequipped

Y

Y

Y


21.6  RTRV-<STM_TYPE>

(Cisco ONS 15454 SDH, Cisco ONS 15600 SDH, and Cisco ONS 15310 MA SDH) The Retrieve (STM1, STM4, STM16, STM64) command retrieves the attributes (such as service parameters) and the state of an STM facility. See Table 27-1 on page 27-1 for supported modifiers by platform.


Note The STM64 modifier is not supported on the Cisco ONS 15310 MA SDH platform.


Usage Guidelines

Both RINGID and MSSPRTYPE identify the STM port connected with a MS-SPRing. These attributes are only presented for the STM4, STM16, and STM64 ports within a MS-SPRing connection. The RTRV-<MOD_RING> command with the AID MSSPR-RINGID, can provide more information on this MS-SPRing.

This command does not show the WVLEN attribute if the STM port has zero value on WVLEN.

Category

Ports

Security

Retrieve

Input Format

RTRV-<STM_TYPE>:[<TID>]:<AID>:<CTAG>[::::];

Input Example

RTRV-STM16:PENNGROVE:FAC-6-1:236;

Cisco ONS 15310 MA SDH

RTRV-STM1::STM1-3-1-1:25;

Input Parameters

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.


Output Format

Cisco ONS 15454 SDH and Cisco ONS 15600 SDH

SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:[RSDCC=<RSDCC>],[AREA=<AREA>],
[TMGREF=<TMGREF>],[SYNCMSG=<SYNCMSG>],[SENDDUS=<SENDDUS>],
[PJMON=<PJMON>],[SFBER=<SFBER>],[SDBER=<SDBER>],[MODE=<MODE>],
[WVLEN=<WVLEN>],[RINGID=<RINGID>],[MSSPRTYPE=<MSSPRTYPE>],
[MUX=<MUX>],[UNIC=<UNIC>],[CCID=<CCID>],[NBRIX=<NBRIX>],[SOAK=<SOAK>],
[SOAKLEFT=<SOAKLEFT>],[SSMRCV=<SSMRCV>],[OSPF=<OSPF>],
[MSDCC=<MSDCC>],[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>]"
;

Cisco ONS 15310 MA SDH

SID DATE TIME
M CTAG COMPLD
"<AID>:,,[<ROLE>],[<STATUS>]:[RSDCC=<RSDCC>],[AREA=<AREA>],
[TMGREF=<TMGREF>],[SYNCMSG=<SYNCMSG>],[SENDDUS=<SENDDUS>],
[PJMON=<PJMON>],[SFBER=<SFBER>],[SDBER=<SDBER>],
[WVLEN=<WVLEN>],[UNIC=<UNIC>],[CCID=<CCID>],[SOAK=<SOAK>],
[SOAKLEFT=<SOAKLEFT>],[SSMRCV=<SSMRCV>],[OSPF=<OSPF>],
[MSDCC=<MSDCC>],[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

Cisco ONS 15454 SDH and Cisco ONS 15600 SDH

TID-000 1998-06-20 14:30:00
M 001 COMPLD
"FAC-6-1:,,WORK,ACT:RSDCC=Y,AREA=10.92.63.1,TMGREF=N,SYNCMSG=N,SENDDUS=N,
PJMON=48,SFBER=1E-4,SDBER=1E-6,MODE=SINGLESHELF,WVLEN=1310.00,RINGID=43,
MSSPRTYPE=WESTWORK,MUX=E2,UNIC=Y,CCID=8,NBRIX=2,SOAK=52,
SOAKLEFT=12-25,SSMRCV=STU_SDH,OSPF=Y,MSDCC=Y,NAME=\"STM PORT\",
LBCL=10.0,OPT=10.0,OPR=10.0, EXPTRC="AAA",TRC="AAA",TRCMODE=MAN,
TRCFORMAT=16-BYTE,ADMSSM=G811, SENDDUSFF=N,
AISONLPBK=AIS_ON_LPBK_ALL,FREQ=1550,LOSSB=LR-1,FOREIGNFEND=Y,
FOREIGNIPADDRESS=10.92.63.44,UNLOCKED-DISABLED,AUTOMATICINSERVICE";

Cisco ONS 15310 MA SDH

NODE-310MASDH 2008-02-06 08:59:38

M 25 COMPLD

"STM1-3-1-1:,,,:DCC=N,AREA=0.0.0.0,TMGREF=N,SYNCMSG=Y,SENDDUS=N,PJMON=0,
SFBER=1E-4,SDBER=1E-7,MODE=SDH,UNIC=N,SOAK=32,SSMRCV=STU,OSPF=Y,
MSDCC=Y,LBCL=7.364,OPT=-5.275,OPR=-5.342,TRCMODE=OFF,TRCFORMAT=16-BYTE,
SENDDUSFF=N,AISONLPBK=OFF,FOREIGNFEND=N,FREQ=1310,LOSSB=I1,OSISDCC=N,
OSILDCC=N,:unlocked-enabled";

Table 21-7 RTRV-<STM_TYPE> Command - Output Parameter Support

Paramter
Description
Cisco ONS 15454 SDH
Cisco ONS 15600 SDH
Cisco ONS 15310 MA SDH

<AID>

Access identifier from the "25.13  FACILITY" section on page 25-22.

Y

Y

Y

<ROLE>

(Optional) An STM port role. The parameter type is SIDE, which is the role the unit is playing in the protection group.

Y

Y

Y

PROT

The entity is a protection unit in the protection group.

Y

Y

Y

ACT

The entity is the active unit in the shelf.

Y

Y

Y

NA

Status is unavailable.

Y

Y

Y

STBY

The entity is the standby unit in the shelf.

Y

Y

Y

<RSDCC>

(Optional) Indicates whether or not the regenerator section DCC (RS-DCC) is to be used. The parameter type is EXT_RING, which indicates if the ring supports the extended K1/K2/K3 protocol.

Y

Y

Y

N

The ring does not support the extended K1/K2/K3 protocol.

Y

Y

Y

Y

The ring does support the extended K1/K2/K3 protocol.

Y

Y

Y

<AREA>

(Optional) Area ID. Shows up only if the DCC is enabled. AREA is a string.

Y

Y

Y

<TMGREF>

(Optional) The termination to be used, whether primary or secondary. Identifies if an STM port has a timing reference. Defaults to N. The parameter type is ON_OFF (disable or enable an attribute)

Y

Y

Y

N

Disable an attribute.

Y

Y

Y

Y

Enable an attribute.

Y

Y

Y

<SYNCMSG>

(Optional) Synchronization status message. The parameter type is EXT_RING, which indicates if the ring supports the extended K1/K2/K3 protocol.

Y

Y

Y

N

The ring does not support the extended K1/K2/K3 protocol.

Y

Y

Y

Y

The ring does support the extended K1/K2/K3 protocol.

Y

Y

Y

<SENDDUS>

(Optional) The facility will send the Do Not Use for Synchronization (DUS) value in 0x0f bit pattern as the synchronization status message for that facility. Defaults to N. The parameter type is ON_OFF (disable or enable an attribute)

Y

Y

Y

N

Disable an attribute.

Y

Y

Y

Y

Enable an attribute.

Y

Y

Y

<PJMON>

(Optional) Identifies an STM port PJMON. Defaults to 0 (zero). PJMON is an integer. Set a valid VC4 number of the optical port.

Note The PJMON number displayed in TL1 interface does not correspond to the PJVC4MON number in CTC, but instead corresponds to the VC4 number of the optical port.

Y

Y

Y

<SFBER>

(Optional) An STM port signal failure threshold. Defaults to 1E-4. The parameter type is SF_BER, which is the threshold for declaring signal failure on a facility or path.

Y

Y

Y

1E-3

SFBER is 1E-3.

Y

Y

Y

1E-4

SFBER is 1E-4.

Y

Y

Y

1E-5

SFBER is 1E-5.

Y

Y

Y

<SDBER>

(Optional) An STM port signal degrade threshold. Defaults 1E-7. The parameter type is SD_BER, which is the threshold for declaring signal degrade on a facility or path.

Y

Y

Y

1E-5

SDBER is 1E-5.

Y

Y

Y

1E-6

SDBER is 1E-6.

Y

Y

Y

1E-7

SDBER is 1E-7.

Y

Y

Y

1E-8

SDBER is 1E-8.

Y

Y

Y

1E-9

SDBER is 1E-9.

Y

Y

Y

<MODE>

(Optional) STM port mode. Defaults to SDH. The parameter type is OPTICAL_MODE, which is the facility's optical mode.

Y

Y

N

SINGLESHELF

The NE contains only one shelf and the AID representation does not consider the shelf identifier for command requests/response and autonomous reports.

Y