Cisco ONS SDH TL1 Command Guide, Release 9.8.x
Chapter 3, ALW Commands
Downloads: This chapterpdf (PDF - 187.0KB) The complete bookPDF (PDF - 11.06MB) | Feedback

Table of Contents

ALW Commands

3.1 ALW-CONSOLE-PORT

3.2 ALW-MSG-ALL

3.3 ALW-MSG-DBCHG

3.4 ALW-MSG-SECU

3.5 ALW-PMREPT-ALL

3.6 ALW-SWDX-EQPT

3.7 ALW-SWTOPROTN-EQPT

3.8 ALW-SWTOWKG-EQPT

3.9 ALW-USER-SECU

ALW Commands

This chapter provides allow (ALW) commands for the Cisco ONS 15454 SDH, Cisco ONS 15454 M2, and Cisco ONS 15454 M6.


NoteAll commands supported on the Cisco ONS 15454 SDH platform are also supported on Cisco ONS 15454 M2 and Cisco ONS 15454 M6 platforms.


3.1 ALW-CONSOLE-PORT

(Cisco ONS 15454 SDH) 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.

3.2 ALW-MSG-ALL

(Cisco ONS 15454 SDH) 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. See 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 Status, Already Allowed (SAAL) 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.

3.3 ALW-MSG-DBCHG

(Cisco ONS 15454 SDH) 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.


NoteThis 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

3.4 ALW-MSG-SECU

( Cisco ONS 15454 SDH, Cisco ONS 15454 M2, Cisco ONS 15454 M6, and Cisco ONS 15600 SDH) 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

3.5 ALW-PMREPT-ALL

(Cisco ONS 15454 SDH) The Allow Performance Report All (ALW-PMREPT-ALL) command resumes processing for all of the performance monitoring (PM) reports that have been inhibited. The allowance of the PM reporting is session-based, which means that the command is only effective for 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

3.6 ALW-SWDX-EQPT

(Cisco ONS 15454 SDH) 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 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 the electrical card protection switching, see the SW-TOWKG-EQPT and SW-TOPROTN-EQPT commands.


NoteThis command applies to the XC-VXL-10G, XC-VXL-2.5G, and XC-VXC-10G cards only in R9.0.


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 XC-VXL-10G, XC-VXL-2.5G, or XC-VXC-10G from the “EQPT” section.

3.7 ALW-SWTOPROTN-EQPT

(Cisco ONS 15454 SDH) 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 cards that can participate in and electrical protection group (for cards, E1, E3, E4, DS3i-N-12, E1-21-E3-DS3-3, and E1-63-E3-DS3-3). When this command is given to a working card, the working unit will be allowed to switch to the protection card. When this command is given to a protection card, any working card in the protection group is allowed to switch to the protection card.

The standing condition of INHSWPR on the card specified by the AID will be cleared.


Note • This command supports only the BTH value of the <DIRN> parameter. A command with any other value is considered an incorrect use of the command. An Input, Data Not Valid (IDNV) error message is returned.

  • This command is not used for the common control (TCC2, TCC2P, TCC3, XC-VXL-10G, XC-VXL-2.5G, or XC-VXC-10G) cards. A command on a common control card will return an Input, Invalid Access Identifier (IIAC) error message. To allow switching for common control card, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.
  • This command is not used for SDH (STM) cards. A command on a SONET card will return an IIAC error message. To allow switching on an SDH card, use the OPR-PROTNSW and RLS-PROTNSW commands.
  • If this command is used on a card that is not in a protection group, the Status, Not in Valid State (SNVS) error message is returned.
  • If this command is used on a card that is not in the inhibit state, the Status, Already Allowed (SAAL) error message is returned.
  • As long as none of the previous error conditions apply, sending this command to missing cards is allowed and 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;

Table 3-1 ALW-SWTOPROTN-EQPT Command - Parameter Support

Input Parameters
Description
ONS 15454 SDH

<AID>

Access identifier. This parameter can either be the protection card for which carrying traffic is to be allowed (release of lockout) or the working card for which switching to protect is to be allowed (release of lock on). Values are in the EQPT.

Y

<DIRN>

(Optional) The direction relative to the entity defined in the AID field.Tthe direction of the switching. This command only supports one value of the DIRN parameter, BTH. Defaults to BTH. The parameter type is DIRECTION (transmit and receive directions).

Y

  • BTH

Both transmit and receive directions.

Y

  • RCV

Receive direction only

Y

  • TRMT

Transmit direction only

Y

3.8 ALW-SWTOWKG-EQPT

(Cisco ONS 15454 SDH) The Allow Switch to Working Equipment (ALW-SWTOWKG-EQPT) command allows automatic or manual switching of an equipment card back to a working status. Use the INH-SWTOWKG-EQPT command to inhibit an NE from switching to working. ALW-SWTOWKG-EQPT is used for electrical cards that can participate in an electrical protection group (for example, E1, E3, E4, and DS3i-N-12).

 
Usage Guidelines

When this command is given to a working card, the working card will be allowed to carry traffic. In the case of revertive protection, the traffic will switch immediately from the protection card to the working card regardless of the reversion time setting.

When this command is given to a protection card, the protection card will be allowed to switch back to the working card currently protected as long as the working card has not raised an INHSWWKG condition. In the case of revertive protection, the traffic will switch immediately from the protection card to the working card regardless of the reversion time setting. In the case of nonrevertive protection, the protection card will continue to carry the traffic.

The standing condition of INHSWWKG on the card 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 considered an incorrect use of the command. An Input, Data Not Valid (IDNV) error message is returned.

  • This command is not used for the common control (TCC2, TCC2P, TCC3, XC-VXL-10G, XC-VXL-2.5G, or XC-VXC-10G) cards. A command on a common control card will receive an IIAC error message. To switch the common control cards, use the SW-DX-EQPT and ALW-SWDX-EQPT commands.
  • This command is not used for SDH (STM) cards. A command on a SDH card will receive an IIAC error message. To switch an SDH card, 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 error message is returned.
  • If this command is used on a card that is not in the inhibit state, the SAAL error message is returned.
  • As long as none of the previous error conditions apply, sending this command to missing cards is allowed and 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;

Table 3-2 ALW-SWTOWKG-EQPT Command - Parameter Support

Input Parameters
Description

<AID>

Access identifier. This parameter can either be the protection card for which carrying traffic is to be allowed (release of lockout) or the working card for which switching to protect is to be allowed (release of lock-on). Values are in the EQPT.

<DIRN>

(Optional) The direction relative to the entity defined in the AID field.The direction of the switching. 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.

  • RCV

Receive direction only

  • TRMT

Transmit direction only

3.9 ALW-USER-SECU

(Cisco ONS 15454 SDH) 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 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.