- Preface
- Cisco ONS Documentation Roadmap for Releases 9.2.1 and 9.2.2
- Chapter 1, ACT Commands
- Chapter 2, ALW Commands
- Chapter 3, APPLY Commands
- Chapter 4, CANC Commands and Messages
- 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, TST Commands
- Chapter 26, Access Identifiers
- Chapter 27, Conditions
- Chapter 28, Modifiers
ALW Commands
This chapter provides allow (ALW) commands for the Cisco ONS 15454, Cisco ONS 15600, Cisco ONS 15454 M2, and Cisco ONS 15454 M6.
Note All commands supported on the Cisco ONS 15454 platform are also supported on Cisco ONS 15454 M2 and Cisco ONS 15454 M6 platforms.
2.1 ALW-CONSOLE-PORT
(Cisco ONS 15454) The Allow Console Port (ALW-CONSOLE-PORT) command is used to turn on the console port for the ML1000-2, ML100T-12 and ML-100T-8 cards.
Usage Guidelines
None.
Category
Security
Security
Superuser
Input Format
ALW-CONSOLE-PORT:[<TID>]:<AID>:<CTAG>;
Input Example
ALW-CONSOLE-PORT:CISCONODE:SLOT-2:123;
Input Parameters
<AID> |
Access identifier. Values are in the "EQPT" section. |
2.2 ALW-MSG-ALL
(Cisco ONS 15454) The Allow Message All (ALW-MSG-ALL) command instructs the NE to enter a mode where all the REPT ALM and REPT EVT autonomous messages are transmitted. Use the INH-MSG-ALL command to inhibit these autonomous messages. When a TL1 session starts, the REPT ALM and REPT EVT messages are allowed by default.
Usage Guidelines
If this command is issued twice in the same session, the SAAL (Status, Already Allowed) error message will be returned. The optional fields in the block are not supported.
Category
System
Security
Retrieve
Input Format
ALW-MSG-ALL:[<TID>]:[<AID>]:<CTAG>[::,,];
Input Example
ALW-MSG-ALL:PETALUMA:ALL:549;
Input Parameters
<AID> |
Access identifier. Support is limited to the AID ALL. AID is a string. |
2.3 ALW-MSG-DBCHG
(Cisco ONS 15454) The Allow Database Change Message (ALW-MSG-DBCHG) command enables REPT DBCHG. When a TL1 session starts, the REPT DBCHG messages are not allowed by default.
Note This command is not defined in the GR.
Usage Guidelines
None.
Category
Log
Security
Retrieve
Input Format
ALW-MSG-DBCHG:[<TID>]::<CTAG>[::,,];
Input Example
ALW-MSG-DBCHG:CISCO::123;
Input Parameters
None.
2.4 ALW-MSG-SECU
(Cisco ONS 15454) The Allow Message Security (ALW-MSG-SECU) command enables the REPT EVT SECU and REPT ALM SECU autonomous messages.
Usage Guidelines
None.
Category
Security
Security
Superuser
Input Format
ALW-MSG-SECU:[<TID>]::<CTAG>[::,,];
Input Example
ALW-MSG-SECU:PETALUMA::123;
Input Parameters
None.
2.5 ALW-PMREPT-ALL
(Cisco ONS 15454) The Allow Performance Report All (ALW-PMREPT-ALL) command resumes the processing of all the PM reports that are inhibited. The allowance of the PM reporting is session-based, which means the command is only effective to the TL1 session that issues this command.
Usage Guidelines
None.
Category
Performance
Security
Retrieve
Input Format
ALW-PMREPT-ALL:[<TID>]::<CTAG>;
Input Example
ALW-PMREPT-ALL:CISCONODE::123;
Input Parameters
None
2.6 ALW-SWDX-EQPT
(Cisco ONS 15454) The Allow Switch Duplex Equipment (ALW-SWDX-EQPT) command allows automatic or manual switching on a duplex system containing duplexed or redundant equipment. To inhibit an NE from switching to duplex, use the INH-SWDX-EQPT command.
Usage Guidelines
ALW-SWDX-EQPT is not used for SONET line or electrical card protection switching. For SONET line or path protection switching commands, see the OPR-PROTNSW and RLS-PROTNSW commands. For electrical card protection switching, see the SW-TOWKG-EQPT and SW-TOPROTN-EQPT commands.
Note This command applies to the XCVT, XC10G, and XC-VXC-10G equipment units only in this release.
Category
Equipment
Security
Maintenance
Input Format
ALW-SWDX-EQPT:[<TID>]:<AID>:<CTAG>[::];
Input Example
ALW-SWDX-EQPT:CISCO:SLOT-8:1234;
Input Parameters
AID |
Access identifier for the XCVT, XC10G, or XC-VXC-10G card from the "EQPT" section. |
2.7 ALW-SWTOPROTN-EQPT
(Cisco ONS 15454) The Allow Switch to Protection Equipment (ALW-SWTOPROTN-EQPT) command allows automatic or manual switching of an equipment unit back to a protection status. Use the INH-SWTOPROTN-EQPT command to inhibit an NE from switching to protection.
Usage Guidelines
ALW-SWTOPROTN-EQPT is used for electrical line cards, for example, DS-1, DS-3, DS3XM, and EC-1. DS-1, DS-3, and DS3XM cards have 1:1 and 1:N equipment protection. EC-1 cards have only 1:1 equipment protection. When this command is given to a working unit, the working unit will be allowed to switch to the protection unit. When this command is given to a protection unit, any working unit in the protection group is allowed to switch to the protection unit.
The standing condition of INHSWPR on the unit specified by the AID will be cleared.
Note•This command only supports only the BTH value of the <DIRN> parameter. A command with any other value is considered an incorrect use of the command. An IDNV (Input, Data Not Valid) error message is returned.
•This command is not used for the common control cards (TCC2/TCC2P/ TCC3, XCVT, XC10G, and XC-VXC-10G). A command on a common control card will receive an IIAC (Input, Invalid Access Identifier) error message. To use the common control card switching commands, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.
•This command is not used for OC-N cards. A command on a SONET card will receive an IIAC (Input, Invalid Access identifier) error message. To use a SONET card switching command, use the OPR-PROTNSW and RLS-PROTNSW commands.
•If this command is used on a card that is not in a protection group, the SNVS (Status, Not in Valid State) error message is returned.
•If this command is used on a card that is not in the inhibit state, the SAAL (Status, Already Allowed) error message is returned.
•As long as none of the previous error conditions apply, you are allowed to send this command to cards that have been uninstalled. This will not generate any error response.
Category
Equipment
Security
Maintenance
Input Format
ALW-SWTOPROTN-EQPT:[<TID>]:<AID>:<CTAG>[::<DIRN>];
Input Example
ALW-SWTOPROTN-EQPT:CISCO:SLOT-2:123::BTH;
Input Parameters
<AID> |
Access identifier. This parameter can either be the protection unit for which carrying traffic will be allowed (release of lockout) or the working unit for which switching to protect will be allowed (release of lock-on). Values are in the "EQPT" section. |
<DIRN> |
Optional. The switching direction relative to the entity defined in the AID field. This command only supports the BTH value of the DIRN parameter. Defaults to BTH. The parameter type is DIRECTION—transmit and receive directions. |
•BTH |
Both transmit and receive directions. |
2.8 ALW-SWTOWKG-EQPT
(Cisco ONS 15454) The Allow Switch to Working Equipment (ALW-SWTOWKG-EQPT) command allows automatic or manual switching of an equipment unit back to a working status. Use the INH-SWTOWKG-EQPT command to inhibit an NE from switching to working.
Usage Guidelines
ALW-SWTOWKG-EQPT is used for electrical line cards, for example, DS-1, DS-3, DS3XM, and EC-1. DS-1, DS-3 and DS3XM cards have 1:1 and 1:N equipment protection. EC-1 cards have only 1:1 equipment protection.
When this command is given to a working unit, the working unit will be allowed to carry traffic. In the case of revertive protection, the traffic will switch immediately from the protection unit to the working unit regardless of the reversion time setting.
When this command is given to a protection unit, the protection unit will be allowed to switch back to the working unit currently protected as long as the working unit has not raised INHSWWKG. In the case of revertive protection, the traffic will switch immediately from the protection unit to the working unit regardless of the reversion time setting. In the case of nonrevertive protection, the protection unit will continue to carry the traffic.
The standing condition of INHSWWKG on the unit specified by the AID will be cleared.
Note•This command only supports the BTH value of the <DIRN> parameter. A command with any other value is an incorrect use of the command. An IDNV (Input, Data Not Valid) error message is returned.
•This command is not used for the common control cards (TCC2/TCC2P/TCC3, XCVT, XC10G, and XC-VXC-10G). A command on a common control card will receive an IIAC (Input, Invalid Access Identifier) error message. To use the common control card switching commands, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.
•This command is not used for OC-N cards. A command on an optical card will receive an IIAC (Input, Invalid Access Identifier) error message. For OC-N cards, use the OPR-PROTNSW and RLS-PROTNSW commands.
•If this command is used on a card that is not in a protection group, the SNVS (Status, Not in Valid State) error message is returned.
•If this command is used on a card that is not in the inhibit state, the SAAL (Status, Already Allowed) error message is returned.
•As long as none of the previous error conditions apply, you are allowed to send this command to cards that have been uninstalled. This will not generate any error response.
Category
Equipment
Security
Maintenance
Input Format
ALW-SWTOWKG-EQPT:[<TID>]:<AID>:<CTAG>[::<DIRN>];
Input Example
ALW-SWTOWKG-EQPT:CISCO:SLOT-2:123::BTH;
Input Parameters
<AID> |
Access identifier. This parameter can either be the protection unit for which carrying traffic will be allowed (release of lockout) or the working unit for which switching to protect will be allowed (release of lock-on). Values are in the "EQPT" section. |
<DIRN> |
Optional. The switching direction relative to the entity defined in the AID field. This command only supports the BTH value of the DIRN parameter. Defaults to BTH. The parameter type is DIRECTION—transmit and receive directions. |
•BTH |
Both transmit and receive directions. |
2.9 ALW-USER-SECU
(Cisco ONS 15454) The Allow User Security (ALW-USER-SECU) command enables a user ID that has been disabled using the INH-USER-SECU command so the user can reestablish a session with the NE.
Usage Guidelines
None.
Category
Security
Security
Superuser
Input Format
ALW-USER-SECU:[<TID>]::<CTAG>::<UID>;
Input Example
ALW-USER-SECU:PETALUMA::123::UID;
Input Parameters
<UID> |
The user identifier (user ID) of the person logged in. UID can be a list of user IDs separated by "&". The keyword ALL cannot be used to specify all users on an NE. UID is a string. |