-
Cisco ONS 15454 SDH 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
16.8 OPR-PROTNSW-<MOD2DWDMPAYLOAD>
OPR Commands
This chapter provides OPR (operate) commands for the Cisco ONS 15454 SDH.
16.1 OPR-ACO-ALL
Operate Alarm Cutoff All
Usage Guidelines
This command cuts off the office audible alarm indication without changing the local alarm indications.
This command does not have any effect on future alarms at the network element (NE). It directs the NE to provide conditioning only on those alarms that are currently active.
The ACO retires the Central Office (CO) alarm audible indicators without clearing the indicators that show the trouble still exists. There is no need for a RLS-ACO command.
Category
Environment
Security
Maintenance
Related Commands
OPR-EXT-CONT
REPT ALM ENV
REPT EVT ENV
RLS-EXT-CONT
RTRV-ALM-ENV
RTRV-ATTR-CONT
RTRV-ATTR-ENV
RTRV-COND-ENV
RTRV-EXT-CONT
SET-ATTR-CONT
SET-ATTR-ENV
SET-ATTR-SECUDFLT
Input Format
OPR-ACO-ALL:[<TID>]::<CTAG>;
Input Example
OPR-ACO-ALL:CISCO::123;
Input Parameters
16.2 OPR-ALS
Operate Automatic Laser Shutoff
Usage Guidelines
This command is used to restart the laser of an STM facility and in general for all of the facilities that support the ALS feature.
Category
Ports
Security
Maintenance
Related Commands
Input Format
OPR-ALS:[<TID>]:<AID>:<CTAG>[::::];
Input Example
OPR-ALS:CISCO:FAC-1-1:100;
Input Parameters
Table 16-2 OPR-ALS Input Parameters
AID
Access identifier from the "25.1.1 AidUnionId" section on page 25-6
16.3 OPR-APC
Operate Amplification Power Control
Usage Guidelines
This command permits the APC application inside the NE to force regulation of the optical power to the entire (dense wavelength division multiplex) DWDM ring.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-APC:[<TID>]::<CTAG>[::::];
Input Example
OPR-APC:VA454-22::116;
16.4 OPR-EXT-CONT
Operate External Control
Usage Guidelines
This command operates an external control and closes the external control contact. The control can be operated momentarily or continuously.
Note
•
–
–
•
•
•
•
•
Caution
Category
Environment
Security
Maintenance
Related Commands
OPR-ACO-ALL
REPT ALM ENV
REPT EVT ENV
RLS-EXT-CONT
RTRV-ALM-ENV
RTRV-ATTR-CONT
RTRV-ATTR-ENV
RTRV-COND-ENV
RTRV-EXT-CONT
SET-ATTR-CONT
SET-ATTR-ENV
SET-ATTR-SECUDFLT
Input Format
OPR-EXT-CONT:[<TID>]:<AID>:<CTAG>::[<CONTTYPE>],[<DURATION>];
Input Example
OPR-EXT-CONT:CISCO:ENV-OUT-2:123::AIRCOND,CONTS;
Input Parameters
Table 16-3 OPR-EXTR-CONT Input Parameters
AID
Access identifier from the "25.1.9 ENV" section on page 25-14. 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
DURATION
Duration. A null value is equivalent to ALL
Parameter type is DURATION—Duration
•
Continuous duration
•
Momentary duration
16.5 OPR-LASER-OTS
Operate Laser Optical Transport Section
Usage Guidelines
This command instructs a laser to switch on.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-LASER-OTS:[<TID>]:<AID>:<CTAG>;
Input Example
OPR-LASER-OTS::LINE-5-2-TX:3;
Input Parameters
Table 16-4 OPR-LASER-OTS Input Parameters
AID
Access identifier of an optical facility supporting laser from the "25.1.13 LINE" section on page 25-17
16.6 OPR-LNK
Operate Link
Usage Guidelines
This command operates the optical link (OLNK) application inside the NE to calculate all the automatic optical links between endpoints that can be univocally identified by the NE.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-LNK:[<TID>]::<CTAG>;
Input Example
OPR-LNK:PENNGROVE::114;
Input Parameters
16.7 OPR-LPBK-<MOD2>
Operate Loopback (10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, CLNT, D1VIDEO, DS3I, DV6000, E1, E3, E4, ESCON, ETRCLO, FSTE, G1000, GFPOS, GIGE, HDTV, ISC1, STM4, STM64, STM1, STM16, OCH, OMS, OTS, POS, STM1E, VC3, VC44C, VC38C, VC464C, VC48C, STS36C, VC4, VC416C, VC42C, VC43C, VC12, VC3, VC12)
Usage Guidelines
This command operates a signal loopback on an input/output (I/O) card or on a cross-connect.
The optional [<LPBKTYPE>] defaults to FACILITY in this command if it is given to a port entity. It defaults to CRS if given to an VC entity.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Note
•
•
•
•
•
Category
Troubleshooting and Test Access
Security
Maintenance
Related Commands
Input Format
OPR-LPBK-<MOD2>:[<TID>]:<AID>:<CTAG>::[<LOCATION>],,,[<LPBKTYPE>];
Input Example
OPR-LPBK-DS1:PTREYES:DS1-4-1-2-13:203::NEND,,,FACILITY;
Input Parameters
Table 16-6 OPR-LPBK-<MOD2> Input Parameters
AID
Access identifier from the "25.1 ALL" section on page 25-1. The valid values for AID are FACILITY and VC
LOCATION
The location where the operation is to be carried out. LOCATION defaults to NEND
Parameter type is LOCATION—location where the action is to take place
•
Action occurs on the far end of the facility
•
Action occurs on the near end of the facility
LPBKTYPE
Type of loopback signal
Parameter type is LPBK_TYPE—indicates the type of loopback that is to be operated or released
•
Path level loopback that is established at the cross-connect matrix level. A VC level cross-connect loopback causes an AIS-P to be sent on the outgoing direction of transmission
•
Type of loopback that connects the incoming received signal immediately following the optical-to-electrical conversion (after descrambling) to the associated transmitter in the return direction
•
A loopback that connects the signal that is about to be transmitted (after scrambling but before the electrical-to-optical conversion) and is connected to the associated, incoming receiver
16.8 OPR-PROTNSW-<MOD2DWDMPAYLOAD>
Operate Protection Switch (10GFC, 10GIGE, 1GFC, 1GFICON, 2GFC, 2GFICON, D1VIDEO, DV6000, ETRCLO, GIGE, HDTV, ISC1, ISC3, PASSTHRU)
Usage Guidelines
This command initiates a Y-cable protection switch request. User switch requests initiated with this command remain active until they are released by the RLS-PROTNSW-<MOD2DWDMPAYLOAD> command or are overridden by a higher priority protection switch request.
See Table 27-1 on page 27-1 for supported modifiers by platform.
The switch commands MAN (Manual Switch), FRCD (Forced Switch), and LOCKOUT (Lockout) are supported by the ONS 15454 SDH; however, you must have Provisioning or higher privilege to execute FRCD and LOCKOUT operations.
Manual Switch of Protection Line (to Working Line). If the AID identifies the protection line, then (only in the 1+1 architecture) service will be transferred from the protection line to the working line, unless a request of equal or higher priority is in effect.
Manual Switch of Working Line (to Protection Line). If the AID identifies a working line, then service will be switched from the working line to the protection line unless a request of equal or higher priority is in effect.
Force Switch of Protection Line (to Working Line). If the AID identifies the protection line, then service will be transferred from the protection line to the working line unless a request of equal or higher priority is in effect.
Force Switch of Working Line (to Protection Line). If the AID identifies a working line, then service will be transferred from the working line to the protection line unless a request of equal or higher priority is in effect. A lockout of protection and a signal fail of protection line have higher priority than this switch command.
Lockout of Protection Line. If the AID identifies the protection line, this switch command will prevent the working line from switching to protection line. If the working line is already on protection, then the working line will be switched back to its original working line.
Lockout of Working Line. If the AID identifies the working line, this switch command will prevent the working line from switching to protection line. If the working line is already on protection, then the working line will be switched back from protection line to its original working line.
If the command is used against preprovisioned cards, the SROF (Protection Switching Failed) error is returned.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-PROTNSW-<MOD2DWDMPAYLOAD>:[<TID>]:<SRC>:<CTAG>::<SC>[:];
Input Example
OPR-PROTNSW-HDTV:CISCO:FAC-1-1-1:100::FRCD;
Input Parameters
Table 16-7 OPR-PROTNSW-<MOD2DWDMPAYLOAD> Input Parameters
SRC
Access identifier from the "25.1.11 FACILITY" section on page 25-16
SC
Switch command that is to be initiated on the paths
Parameter type is SW—the type of switch to be initiated
•
APS-CLEAR switch state. It is a read-only switch state and is not allowed in the OPR-PROTNSW-xxx commands
•
CLEAR switch state. CLEAR switch state is not allowed in the OPR-PROTNSW-xxx commands
•
EXERCISE switch state. EXERCISE switch state is not allowed in the OPR-PROTNSW-xxx commands
•
Forces a switch unless another FRCD or LOCKOUT is in effect
•
Locks the facility out of switching. The system cannot switch to this facility to carry service
•
Requests a manual switch of the facility
16.9 OPR-PROTNSW-<STM_TYPE>
Operate Protection Switch (STM1, STM4, STM16, STM64)
Usage Guidelines
This command initiates a SDH line protection switch request. User switch requests initiated with this command remain active until they are released by the RLS-PROTNSW-STM command or are overridden by a higher priority protection switch request.
See Table 27-1 on page 27-1 for supported modifiers by platform.
The switch commands MAN (Manual Switch), FRCD (Forced Switch), and LOCKOUT (Lockout) are supported by the ONS 15454 SDH.
Manual Switch of Protection Line (to Working Line). If the AID identifies the protection line, then (only in the 1+1 architecture) service will be transferred from the protection line to the working line, unless a request of equal or higher priority is in effect.
Manual Switch of Working Line (to Protection Line). If the AID identifies a working line, then service will be switched from the working line to the protection line unless a request of equal or higher priority is in effect.
Force Switch of Protection Line (to Working Line). If the AID identifies the protection line, then (only in the 1+1 architecture) service will be transferred from the protection line to the working line unless a request of equal or higher priority is in effect.
Force Switch of Working Line (to Protection Line). If the AID identifies a working line, then service will be transferred from the working line to the protection line unless a request of equal or higher priority is in effect. A lockout of protection and a signal fail of protection line have higher priority than this switch command.
Lockout of Protection Line. If the AID identifies the protection line, this switch command will prevent the working line from switching to protection line. If the working line is already on protection, then the working line will be switched back to its original working line.
Lockout of Working Line. If the AID identifies the working line, this switch command will prevent the working line from switching to protection line. If the working line is already on protection, then the working line will be switched back from protection line to its original working line.
Note
•
•
•
–
–
•
•
•
•
•
•
The following actions will return error messages:
•
•
•
•
•
•
•
•
Category
Protection
Security
Maintenance
Related Commands
Input Format
OPR-PROTNSW-<STM_TYPE>:[<TID>]:<AID>:<CTAG>::<SC>,[<SWITCHTYPE>][:<DIRN>];
Input Example
OPR-PROTNSW-STM16:PETALUMA:FAC-6-1:204::LOCKOUT,SPAN:BTH;
Input Parameters
Table 16-8 OPR-PROTNSW-<STM_TYPE> Input Parameters
AID
Access identifier from the "25.1.11 FACILITY" section on page 25-16. Identifies the facility in the NE to which the switch request is directed
SC
Switch command that is to be initiated on the paths
Parameter type is SW—the type of switch to be initiated
•
APS-CLEAR switch state. It is a read-only switch state and is not allowed in the OPR-PROTNSW-xxx commands
•
CLEAR switch state. CLEAR switch state is not allowed in the OPR-PROTNSW-xxx commands
•
EXERCISE switch state. EXERCISE switch state is not allowed in the OPR-PROTNSW-xxx commands
•
Forces a switch unless another FRCD or LOCKOUT is in effect
•
Locks the facility out of switching. The system cannot switch to this facility to carry service
•
Requests a manual switch of the facility
SWITCHTYPE
MS-SPRing switch type
Parameter type is SWITCH_TYPE—switch type
•
MS-SPRing switch type
•
MS-SPRing span switch type
DIRN
The direction relative to the entity defined in the AID field. The direction of the switching. DIRN defaults to RCV
Parameter type is DIRECTION—transmit and receive directions
•
Both transmit and receive directions
•
Receive direction only
•
Transmit direction only
16.10 OPR-PROTNSW-<PATH>
Operate Protection Switch (VC3, VC44C, VC38C, VC464C, VC48C, STS36C, VC4, VC416C, VC42C, VC43C, VC12)
Usage Guidelines
This command initiates a SDH path protection (SNCP) switch request. User switch requests initiated with this command (forced switch, lockout, and manual switch) remain active until they are released through the RLS-PROTNSW-<PATH> command or overridden by a higher priority protection switch request.
See Table 27-1 on page 27-1 for supported modifiers by platform.
Note
•
•
•
The following actions will return error messages:
•
•
•
Category
Protection
Security
Maintenance
Related Commands
DLT-CRS-<PATH>
ED-<MOD_PATH>
ED-CRS-<PATH>
ED-NE-PATH
ENT-CRS-<PATH>
RLS-PROTNSW-<PATH>
RTRV-<PATH>
RTRV-CRS-<PATH>
RTRV-NE-PATH
RTRV-PROTNSW-<PATH>
RTRV-PTHTRC-<PATH>
Input Format
OPR-PROTNSW-<PATH>:[<TID>]:<SRC>:<CTAG>::<SC>[:];
Input Example
OPR-PROTNSW-VC3:CISCO:VC4-2-1-1:123::MAN;
Input Parameters
Table 16-9 OPR-PROTNSW-<PATH> Input Parameters
SRC
Source access identifier from the "25.1.8 CrossConnectId1" section on page 25-11
SC
The switch command that is to be initiated on the paths
Parameter type is SW—the type of switch to be initiated
•
APS-CLEAR switch state. It is a read-only switch state and is not allowed in the OPR-PROTNSW-xxx commands
•
CLEAR switch state. CLEAR switch state is not allowed in the OPR-PROTNSW-xxx commands
•
EXERCISE switch state. EXERCISE switch state is not allowed in the OPR-PROTNSW-xxx commands
•
Forces a switch unless another FRCD or LOCKOUT is in effect
•
Locks the facility out of switching. The system cannot switch to this facility to carry service
•
Requests a manual switch of the facility
16.11 OPR-PROTNSW-OCH
Operate Protection Switch Optical Channel
Usage Guidelines
This command performs a protection switch on the trunk port of a card that has splitter protection.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-PROTNSW-OCH:[<TID>]:<AID>:<CTAG>::<SW>;
Input Example
OPR-PROTNSW-OCH:VA454-22:CHAN-2-2:100::FRCD;
Input Parameters
Table 16-10 OPR-PROTNSW-OCH Input Parameters
AID
Access identifier from the "25.1.5 CHANNEL" section on page 25-8. Indicates the trunk port
SW
Switch operation
Parameter type is SW—the type of switch to be initiated
•
APS-CLEAR switch state. It is a read-only switch state and is not allowed in the OPR-PROTNSW-xxx commands
•
CLEAR switch state. CLEAR switch state is not allowed in the OPR-PROTNSW-xxx commands
•
EXERCISE switch state. EXERCISE switch state is not allowed in the OPR-PROTNSW-xxx commands
•
Forces a switch unless another FRCD or LOCKOUT is in effect
•
Locks the facility out of switching. The system cannot switch to this facility to carry service
•
Requests a manual switch of the facility
16.12 OPR-SLV-WDMANS
Operate Span Loss Verification Wavelength Division Multiplexing Automatic Node Set Up
Usage Guidelines
This command performs the calculation of the expected span loss verification.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-SLV-WDMANS:[<TID>]:<AID>:<CTAG>;
Input Example
OPR-SLV-WDMANS:VA454-22:WDMANS-E:116;
Input Parameters
Table 16-11 OPR-SLV-WDMANS Input Parameters
AID
Access identifier from the "25.1.26 WDMANS" section on page 25-23
16.13 OPR-SYNCNSW
Operate Synchronization Switch
Usage Guidelines
This command initiates a switch to the reference specified by the synchronization reference number if the reference supplied is valid and of the same quality.
For manual types of switches, the reference to which you want to switch should be of the same quality as the active reference source; otherwise the command will fail.
If you want to switch to a reference of lower quality, use the forced switch option.
The Operate Synchronization Switches are released by the RLS-SYNCNSW command or are overridden by a synchronization reference failure.
When the switch is effective, a minor alarm, MANSWTOPRI (Manual Switch to Primary or Secondary Reference...) will be raised.
Category
Synchronization
Security
Maintenance
Related Commands
ED-BITS
ED-NE-SYNCN
ED-SYNCN
REPT ALM BITS
REPT ALM SYNCN
REPT EVT BITS
REPT EVT SYNCN
RLS-SYNCNSW
RTRV-ALM-BITS
RTRV-ALM-SYNCN
RTRV-BITS
RTRV-COND-BITS
RTRV-COND-SYNCN
RTRV-NE-SYNCN
RTRV-SYNCN
Input Format
OPR-SYNCNSW:[<TID>]:[<AID>]:<CTAG>::<SWITCHTO>,[<SC>];
Input Example
OPR-SYNCNSW:CISCO:SYNC-NE:3::PRI,MAN;
Input Parameters
Table 16-12 OPR-SYNCSW Input Parameters
AID
Access identifier from the "25.1.22 SYNC_REF" section on page 25-20 Defaults to SYNC-NE
SWITCHTO
Access identifier from the "25.1.23 SYNCSW" section on page 25-21. Identifies the new synchronization reference that will be used
SC
Switch command to be initiated on the paths. Only MAN and FRCD switches are allowed for this command
Parameter type is SW—the type of switch to be initiated
•
APS-CLEAR switch state. It is a read-only switch state and is not allowed in the OPR-PROTNSW-xxx commands
•
CLEAR switch state. CLEAR switch state is not allowed in the OPR-PROTNSW-xxx commands
•
EXERCISE switch state. EXERCISE switch state is not allowed in the OPR-PROTNSW-xxx commands
•
Forces a switch unless another FRCD or LOCKOUT is in effect
•
Requests a manual switch of the facility
16.14 OPR-WDMANS
Operate Wavelength Division Multiplexing Automatic Node Set Up
Usage Guidelines
This command initiates the Automatic Optical Node Setup (AONS) application inside the NE to force a recompute of the value to be assigned to all variable optical attenuators (VOAs) representing the optical path inside the node.
Category
DWDM
Security
Maintenance
Related Commands
Input Format
OPR-WDMANS:[<TID>]::<CTAG>;
Input Example
OPR-WDMANS:PENNGROVE::114;
Input Parameters
