- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
05-POS interface commands | 206.56 KB |
POS interface commands
IMPORTANT: Only devices with the RT-MIC-X-SP4 or RT-MIC-X-SP8 interface modules installed support POS interfaces. |
alarm-detect
se alarm-detect to configure the action to take when an RDI, SD, or SF alarm occurs on an interface.
Use undo alarm-detect to restore the default.
Syntax
alarm-detect { rdi | sd | sf } action link-down
undo alarm-detect { rdi | sd | sf }
Default
The device does not take any actions on the interface when an RDI, SD, or SF alarm occurs.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
rdi: Specifies remote defect indication (RDI) alarms.
sd: Specifies signal degrade (SD) alarms.
sf: Specifies signal fail (SF) alarms.
action: Specifies the action to take when the specified alarm is detected on the interface.
link-down: Places the interface in down state.
Usage guidelines
An RDI alarm occurs if the device receives multiplexer section remote defect indication (MS-RDI) signals from the remote end.
An SD or SF alarm occurs if the bit error rate of incoming packets crosses the SD or SF alarm threshold. To set the SD or SF alarm threshold, use the threshold command.
Examples
# Configure Pos 1/1/1 to go down when an SD alarm occurs.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] alarm-detect sd action link-down
Related commands
threshold
bandwidth
Use bandwidth to configure the expected bandwidth of an interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.
Examples
# Set the expected bandwidth to 50 kbps for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] bandwidth 50
clock
Use clock to set the clock mode of a standard POS interface.
Use undo clock to restore the default.
Syntax
clock { master | slave }
undo clock
Default
The clock mode of a POS interface is slave.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
master: Sets the clock mode to master.
slave: Sets the clock mode to slave.
Usage guidelines
Standard POS interfaces support the following clock modes:
· Master—Uses internal clock signal.
· Slave—Uses line clock signal.
If the standard POS interface is connected to another router, set its clock mode to be different from the mode used by the remote end. If the standard POS interface is connected to a SONET/SDH device, which provides higher clock precision, always set its clock mode to slave.
Examples
# Set the clock mode to master for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] clock master
crc
Use crc to set the CRC length on an interface.
Use undo crc to restore the default.
Syntax
crc { 16 | 32 }
undo crc
Default
The CRC length on an interface is 32 bits.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
16: Sets the CRC length to 16 bits.
32: Sets the CRC length to 32 bits.
Usage guidelines
The CRC length must be the same at both ends.
Examples
# Set the CRC length to 16 bits on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] crc 16
dampening
Use dampening to enable the device to dampen an interface when it is flapping.
Use undo dampening to disable interface dampening.
Syntax
dampening [ half-life reuse suppress max-suppress-time ]
undo dampening
Default
Interface dampening is disabled on POS interfaces.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
half-life: Specifies the amount of time (in seconds) for a penalty to decrease by half of its value. The value range is 1 to 120 seconds, and the default is 54 seconds.
reuse: Specifies the reuse threshold. The value range is 200 to 20000, and the default is 750. The reuse threshold must be lower than the suppression threshold.
suppress: Specifies the suppression threshold. The value range is 200 to 20000, and the default is 2000.
max-suppress-time: Specifies the maximum amount of time an interface can be dampened. The value range is 1 to 255 seconds, and the default is 162 seconds (three times the default half-life timer).
Usage guidelines
This command and the link-delay command are mutually exclusive on an interface.
This command does not take effect on the administratively down events. When you execute the shutdown command, the penalty restores to 0, and the interface reports the down event to the higher layer protocols.
For more information about the interface dampening feature, see Interface Configuration Guide.
Examples
# Configure interface dampening on POS 2/2/1.
<Sysname> system-view
[Sysname] interface pos 2/2/1
[Sysname-Pos2/2/1] dampening 2 800 3000 5
Related commands
display interface pos
link-delay
default
Use default to restore the default settings for an interface.
Syntax
default
Views
Standard POS interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impact of this command when you use it on a live network. |
This command might fail to restore the default settings for some commands for reasons such as command dependencies or system restrictions. You can use the display this command in interface view to check for these commands, and use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message to resolve the problem.
Examples
# Restore the default settings of Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] default
description
Use description to configure the description of an interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The interface description uses the interface-name Interface format, for example, Pos1/1/1 Interface.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
text: Specifies the description, a case-sensitive string of 1 to 255 characters.
Examples
# Configure the description of Pos 1/1/1 as pos-interface.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] description pos-interface
display interface pos
Use display interface pos to display information about POS interfaces.
Syntax
display interface [ pos [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of interface descriptions.
down: Displays physically down interfaces and their down causes. If you do not specify this keyword, the command displays information about interfaces in any state.
Examples
# Display detailed information about Pos 1/1/1.
<Sysname> display interface pos 1/1/1
Pos1/1/1
Current state: DOWN
Line protocol state: DOWN
Description: Pos1/1/1 Interface
Bandwidth: 50kbps
Maximum transmission unit: 1500
Hold timer: 10 seconds, retry times: 5
Internet Address: 5.5.5.2/24 Primary
Link layer protocol: PPP
LCP: opened, IPCP: opened
Physical layer: Packet Over SONET, Baudrate: 155520000 bps
Scramble: enabled, crc: 32, clock: slave, loopback: not set
SONET alarm:
section layer: OOF LOF LOS
line layer: AIS
path layer: AIS RDI
C2(Rx): 0xff, C2(Tx): 0x16
J0(Rx): unknown
J0(Tx): ""
J1(Rx): unknown
J1(Tx): ""
SONET error:
section layer: B1 65535
line layer: B2 0 M1 0
path layer: B3 0 G1 0
Last link flapping: 6 hours 39 minutes 25 seconds
Last clearing of counters: Never
Last 300 seconds input rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec
Last 300 seconds output rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec
Input:
0 packets, 0 bytes
0 errors, 0 runts, 0 giants, 0 CRC
0 overruns, 0 aborts, 0 no buffers
Output:
0 packets, 0 bytes
0 errors, 0 underruns, 0 aborts
# Display brief information about Pos 1/1/1.
<Sysname> display interface pos 1/1/1 brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Primary IP Description
Pos1/1/1 DOWN DOWN --
# Display brief information about all POS interfaces in down state and the causes.
<Sysname> display interface pos brief down
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
Pos1/1/1 ADM Administratively
Table 1 Command output
Field |
Description |
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up. |
Line protocol state |
Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer. · UP—The data link layer protocol is up. · DOWN—The data link layer protocol is down. |
Description |
Description of the interface. |
Bandwidth |
Expected bandwidth of the interface. |
Maximum transmission unit |
MTU of the interface. |
Hold timer |
Interval at which the data link layer protocol sends keepalives. |
retry times |
Keepalive retry limit. The interface determines that the remote end is down if it does not receive a keepalive response after the keepalive retry limit has been made. |
Internet address: ip-address/mask-length (Type) |
IP address of the interface and type of the address in parentheses. Possible IP address types include: · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. · DHCP-allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in BRAS Services Configuration Guide. · Unnumbered—IP address borrowed from another interface. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide. |
Link layer protocol |
Data link layer protocol of the interface. |
LCP: opened, IPCP: opened |
Both LCP negotiation and IPCP negotiation succeeded. |
Physical layer |
Physical interface. |
Baudrate |
Baudrate of the interface. |
Scramble |
Payload scrambling state. |
crc |
CRC length. |
clock |
Clock mode. |
loopback |
Loopback state. |
SONET alarm |
SONET alarms. |
SONET error |
SONET errors. |
Vendor PN |
Electronic label of the module vendor. |
Vendor Name |
Name of the module vendor. |
Wavelength |
Central wavelength of the transmitted laser for the transceiver module, in nm |
Transfer Distance |
For a single-mode module, xx indicates the transmission distance in km. For other modules, xx indicates the distance in m. |
RX power: ndBm/100,Alarm thresholds:[x,y]dBm/100 |
The current Rx optical power of the transceiver module is n dBm/100. The normal range for Rx optical power is x dBm/100 to y dBm/100. The unit of Rx optical power for the transceiver module is dBm, with an accuracy of 0.01. |
TX power: ndBm/100,Alarm thresholds:[x,y]dBm/100 |
The current Tx optical power of the transceiver module is n dBm/100. The normal range for Tx optical power is x dBm/100 to y dBm/100. The unit of Tx optical power for the transceiver module is dBm, with an accuracy of 0.01. |
Last link flapping |
The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup. |
Last clearing of counters |
The most recent time that the reset counters interface pos command was executed. This field displays Never if the command has not been executed on the interface since device startup. |
Current system time |
Current system time in the YYYY-MM-DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY-MM-DD HH:MM:SS UTC±HH:MM:SS format. |
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec |
Average input rates (in Bps, bps, and pps) for the last 300 seconds. |
Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec |
Average output rates (in Bps, bps, and pps) for the last 300 seconds. |
Input: 0 packets, 0 bytes 0 errors, 0 runts, 0 giants, 0 CRC 0 overruns, 0 aborts, 0 no buffers |
Inbound traffic statistics for the POS interface: · errors—Number of inbound packets with errors detected at the physical layer. · runts—Number of inbound packets shorter than the minimum frame length. · giants—Number of inbound packets larger than the maximum frame length. · CRC—Total number of inbound normal-size packets with CRC errors. · overruns—Number of packet drops because the input rate of the interface exceeded the forwarding capability. · aborts—Number of invalid inbound frames. · no buffers—Number of packet drops because the receive buffer is full. |
Output: 0 packets, 0 bytes 0 errors, 0 underruns, 0 aborts |
Outbound traffic statistics for the POS interface: · errors—Number of outbound packets with errors detected at the physical layer. · underruns—Number of packets dropped because the output rate of the interface exceeded the memory reading rate. · aborts—Total number of invalid outbound packets. |
Brief information on interface(s) under route mode: |
Brief information about Layer 3 interfaces. |
Link: ADM - administratively down; Stby - standby |
Physical link state of the interface: · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command. |
Protocol: (s) - spoofing |
If the protocol attribute value contains (s). The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s)attribute represents the spoofing flag. |
Interface |
Abbreviated interface name. |
Link |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. |
Protocol |
Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s)attribute represents the spoofing flag. |
Primary IP |
Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address. |
Description |
Description of the interface. |
Cause |
Cause for the physical link state of an interface to be DOWN: · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty). |
Related commands
reset counters interface pos
flag c2
Use flag c2 to set the C2 path signal label byte.
Use undo flag c2 to restore the default.
Syntax
flag c2 flag-value
undo flag c2
Default
The C2 value is 16 in hexadecimal notation.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
flag-value: Specifies a C2 byte value, a hexadecimal number in the range of 0 to ff.
Usage guidelines
The C2 byte is a higher-order path overhead byte. It indicates the multiplex structure of virtual container (VC) frames and the property of payload.
When the C2 byte of one end is set to 1, the C2 byte of the other end can be set to any character in hexadecimal notation. If the C2 byte of either ends of a link is not set to 1, the C2 byte must be the same at both ends.
Examples
# Set the C2 byte to 01 in hexadecimal notation on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] flag c2 01
Related commands
display interface pos
flag j0
Use flag j0 to set the J0 regenerator section trace byte for SONET or SDH frames.
Use undo flag j0 to restore the default.
Syntax
flag j0 { sdh | sonet } flag-value
undo flag j0 { sdh | sonet }
Default
The device uses the SDH framing format. In SDH frames, the J0 byte value is null.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
flag-value: Specifies the J0 byte. It must be a string of 1 to 15 characters for SDH, and a hexadecimal number in the range of 0 to ff for SONET.
sdh: Specifies the SDH framing format.
sonet: Specifies the SONET framing format.
Usage guidelines
J0 byte is a section overhead byte. SDH and SONET use this byte to test continuity of the connection between two interfaces at the section level.
The J0 byte can be different on devices of the same service provider. On the interfaces between two service providers, the J0 byte must be the same.
When a POS interface uses the SDH framing format, you cannot set the J0 regenerator section trace byte for SONET frames on the interface.
When a POS interface uses the SONET framing format, you cannot set the J0 regenerator section trace byte for SDH frames on the interface.
Examples
# Set the J0 byte to ff in hexadecimal notation for SDH on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] flag j0 sdh ff
Related commands
display interface pos
frame-format
flag j1
Use flag j1 to set the J1 path trace byte for SONET or SDH frames.
Use undo flag j1 to restore the default.
Syntax
flag j1 { sdh | sonet } flag-value
undo flag j1 { sdh | sonet }
Default
The device uses the SDH framing format. In SDH frames, the J1 byte value is null.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
flag-value: Specifies a J1 byte value. It must be a string of 1 to 15 characters for SDH and a string of 1 to 62 characters for SONET.
sdh: Specifies the SDH framing format.
sonet: Specifies the SONET framing format.
Usage guidelines
J1 byte is a higher-order path overhead byte. SDH and SONET use this byte to test continuity of the connection between two interfaces at the path level.
The J1 byte must be the same at both ends of a link.
When a POS interface uses the SDH framing format, you cannot set the J1 path trace byte for SONET frames on the interface.
When a POS interface uses the SONET framing format, you cannot set the J1 path trace byte for SDH frames on the interface.
Examples
# Set the J1 byte to aabbcc for SDH on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] flag j1 sdh aabbcc
Related commands
display interface pos
frame-format
frame-format
Use frame-format to set the framing format on a standard POS interface.
Use undo frame-format to restore the default.
Syntax
frame-format { sdh | sonet }
undo frame-format
Default
The framing format is SDH on a standard POS interface.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
sdh: Specifies the SDH framing format.
sonet: Specifies the SONET framing format.
Usage guidelines
When a POS interface uses the SDH framing format, you cannot set the J0 regenerator section trace byte or J1 path trace byte for SONET frames on the interface.
When a POS interface uses the SONET framing format, you cannot set the J0 regenerator section trace byte or J1 path trace byte for SDH frames on the interface.
Examples
# Set the framing format to SONET on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] frame-format sonet
Related commands
flag j0
flag j1
interface pos
Use interface pos to enter POS interface view.
Syntax
interface pos interface-number
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a standard POS interface by its number.
Examples
# Enter the view of interface Pos1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1]
Related commands
link-protocol
link-delay
Use link-delay to set the physical state change suppression interval on an interface.
Use undo link-delay to restore the default.
Syntax
link-delay msec milliseconds
undo link-delay
Default
The physical state change suppression interval is not configured on an interface.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
msec milliseconds: Sets the physical state change suppression interval on an interface, in milliseconds. The value range for this argument is 0 to 10000 milliseconds.
Usage guidelines
When the physical state changes, a POS interface reports the event to the upper-layer modules, and generates log and SNMP notification messages. To reduce system overhead caused by frequent physical state changes, use this command to suppress physical state changes within an interval. The interface will ignore any changes that occur during each suppression interval. When the suppression interval expires, the interface will not report the change event or generate messages if the change is removed.
For example, the suppression interval starts when the interface changes from up to down. The interface reports the change event and generates messages if it is still down when the interval expires. The interface does not report the change event or generate messages if it is up when the interval expires.
Examples
# Set the physical state change suppression interval to 100 milliseconds for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] link-delay msec 100
link-protocol
Use link-protocol to set the data link layer protocol of an interface.
Syntax
Default
PPP is used.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
hdlc: Specifies HDLC as the data link layer protocol of the interface.
ppp: Specifies PPP as the data link layer protocol of the interface.
Examples
# Specify HDLC as the data link protocol of Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] link-protocol hdlc
loopback
Use loopback to enable loopback for standard POS interface.
Use undo loopback to disable loopback for a standard POS interface.
Syntax
loopback { local | remote }
undo loopback
Default
Loopback is disabled on a standard POS interface.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
local: Enables internal loopback.
remote: Enables external loopback.
Usage guidelines
Loopback is intended for testing only. Disable the feature when the interface is operating correctly.
Before you use this command on a standard POS interface, make sure its clock mode is master.
When you enable internal loopback on a standard POS interface before you connect it to the peer end, the state of the data link layer protocol is reported as up.
# Enable internal loopback on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] loopback local
Related commands
clock
mtu
Use mtu to set the MTU size for an interface.
Use undo mtu to restore the default.
Syntax
mtu size
undo mtu
Default
The MTU of an interface is 1500 bytes.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
size: Sets the maximum transmission unit (MTU) in bytes. The value range for this argument is 128 to 4500.
Usage guidelines
The MTU setting affects the assembly and fragmentation of IP packets.
After configuring the MTU for an interface, you must use the shutdown command and then the undo shutdown command on the interface for the modification to take effect.
Examples
# Set the MTU to 1430 bytes for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] mtu 1430
reset counters interface pos
Use reset counters interface pos to clear interface statistics.
Syntax
reset counters interface [ pos [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
pos [ interface-number ]: Clears statistics for a standard POS interface specified by its number. If you do not specify the pos keyword, this command clears statistics for all interfaces except VA interfaces. If you specify the pos keyword without specifying an interface, this command clears statistics for all standard POS interfaces.
Usage guidelines
Use this command to clear history statistics before you collect statistics for a time period.
Examples
# Clear statistics for Pos 1/1/1.
<Sysname> reset counters interface pos 1/1/1
display interface pos
scramble
Use scramble to enable payload scrambling on an interface.
Use undo scramble to disable payload scrambling on an interface.
Syntax
scramble
undo scramble
Default
Payload scrambling is enabled on standard POS interfaces and POS channel interfaces.
Views
Standard POS interface view
Predefined user roles
network-admin
Usage guidelines
Payload scrambling enables an interface to scramble outgoing data and descramble incoming data. By preventing the presence of long strings of all 1s or all 0s, payload scrambling enables the receiving end to extract the line clock signal correctly.
If payload scrambling is disabled, the interface does not scramble outgoing data or descramble incoming data.
The payload scrambling setting must be the same at both ends of a link to ensure correct communication.
For H3C devices, changing the payload scrambling setting does not affect cell headers. After you change the payload scrambling settings on both ends of a link, verify that the C2 byte value on them match each other. If the two values do not match, use the flag c2 command to modify the C2 byte value on the H3C device.
Examples
# Enable payload scrambling on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] scramble
shutdown
Use shutdown to shut down an interface.
Use undo shutdown to bring up an interface.
Syntax
shutdown
undo shutdown
Default
An interface is up.
Views
Standard POS interface view
Predefined user roles
network-admin
Examples
# Shut down Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] shutdown
snmp-agent trap enable { b1-tca | b2-tca | b3-tca }
Use snmp-agent trap enable{ b1-tca | b2-tca | b3-tca } to enable SNMP notifications about signal transmission performance for a standard POS interface.
Use undo snmp-agent trap enable{ b1-tca | b2-tca | b3-tca } to disable SNMP notifications about signal transmission performance for a standard POS interface.
Syntax
snmp-agent trap enable{ b1-tca | b2-tca | b3-tca }
undo snmp-agent trap enable{ b1-tca | b2-tca | b3-tca }
Default
Signal transmission performance notifications are enabled for the standard POS interface.
Views
Standard POS interface view
Predefined user roles
network-admin
Usage guidelines
To generate SNMP notifications when a B1, B2, or B3 alarm occurs on a standard POS interface, use this command.
B1, B2, and B3 bytes indicate the signal transmission performance of a line at different levels.
· B1 alarm occurs if the bit error rate of a complete STM-N frame exceeds the B1 alarm threshold.
· B2 alarm occurs if the bit error rate of an STM-1 frame exceeds the B2 alarm threshold.
· B3 alarm occurs if the bit error rate of a multiplexed signal (VC3 or VC4 frame) in the STM-1 frame exceeds the B3 alarm threshold.
For B1, B2, or B3 alarm SNMP notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.
Examples
# Disable B1 alarm notifications on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] undo snmp-agent trap enable b1-tca
Related commands
threshold { b1-tca | b2-tca | b3-tca }
threshold
Use threshold to configure the power for setting the SD or SF alarm threshold on a standard POS interface.
Use undo threshold to restore the default power for setting the SD or SF alarm threshold on a standard POS interface.
Syntax
threshold { sd sdvalue | sf sfvalue } *
undo threshold [ sd | sf ]
Default
The sdvalue argument is 6, and the sfvalue argument is 3.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
sd: Specifies the SD alarm threshold.
sdvalue: Specifies the power for setting the SD alarm threshold. The threshold is 10e to the power of negative sdvalue (10e–sdvalue). The value range for this argument is 3 to 9. The greater the value, the lower the SD alarm threshold.
sf: Specifies the SF alarm threshold. The SF alarm threshold must be higher than the SD alarm threshold.
sfvalue: Specifies the power for setting the SF alarm threshold. The threshold is 10e to the power of negative sdvalue (10e–sfvalue). The value range for this argument is 3 to 9. The greater the value, the lower the SF alarm threshold.
Usage guidelines
SD and SF alarms indicate line performance. SF alarms are more severe than SD alarms.
· An SD alarm occurs if the number of B2 errors reaches the SD alarm threshold.
· An SF alarm occurs if the number of B2 errors reaches the SF alarm threshold.
Examples
#Set the SD threshold to 10e to the power of negative 4 (10e–4) on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] threshold sd 4
threshold { b1-tca | b2-tca | b3-tca }
Use threshold { b1-tca | b2-tca | b3-tca } to configure the power for setting the B1, B2, or B3 alarm threshold on a standard POS interface.
Use undo threshold { b1-tca | b2-tca | b3-tca } to restore the default power for setting the B1, B2, or B3 alarm threshold on a standard POS interface.
Syntax
threshold { b1-tca b1value | b2-tca b2value | b3-tca b3value }
undo threshold { b1-tca | b2-tca | b3-tca }
Default
The power for setting the B1, B2, and B3 alarm thresholds on a standard POS interface is 6.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
b1value: Specifies the power for setting the B1 alarm threshold. The threshold is 10e to the power of negative b1value (10e–b1value). The value range for this argument is 6.
b2value: Specifies the power for setting the B2 alarm threshold. The threshold is 10e to the power of negative b2value (10e–b2value). The value range for this argument is 6.
b3value: Specifies the power for setting the B3 alarm threshold. The threshold is 10e to the power of negative b3value (10e–b3value). The value range for this argument is 6.
Usage guidelines
B1, B2, and B3 bytes indicate the signal transmission performance of a line at different levels.
· B1 alarm occurs if the bit error rate of a complete STM-N frame exceeds the B1 alarm threshold.
· B2 alarm occurs if the bit error rate of an STM-1 frame exceeds the B2 alarm threshold.
· B3 alarm occurs if the bit error rate of a multiplexed signal (VC3 or VC4 frame) in the STM-1 frame exceeds the B3 alarm threshold.
The B1, B2, and B3 alarm threshold settings take effect after SNMP notifications are enabled for these alarms.
Examples
# Set the B1 alarm threshold to 10e to the power of negative 6 (10e–6) on Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] threshold b1-tca 6
Related commands
snmp-agent trap enable{ b1-tca | b2-tca | b3-tca }
timer-hold
Use timer-hold to set the keepalive interval.
Use undo timer-hold to restore the default.
Syntax
timer-hold seconds
undo timer-hold
Default
The keepalive interval is 10 seconds.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
seconds: Specifies the interval at which the interface sends keepalive packets. The value range for this argument is 0 to 32767 seconds.
Usage guidelines
On an interface encapsulated with PPP or HDLC, the data link layer sends keepalive packets at keepalive intervals to detect the availability of the remote end. The data link layer determines that the peer end is down if it does not receive a response after the keepalive retry limit has been made. The data link layer then reports the link down event to the upper-layer protocols.
To set the keepalive retry limit, use the timer-hold retry command.
On a slow link, increase the keepalive interval to prevent false shutdown of the interface. This situation might occur when keepalive packets are delayed because a large packet is being transmitted on the link.
Examples
# Set the keepalive interval to 15 seconds for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] timer-hold 15
Related commands
timer-hold retry
timer-hold retry
Use timer-hold retry to set the keepalive retry limit.
Use undo timer-hold retry to restore the default.
Syntax
timer-hold retry retries
undo timer-hold retry
Default
The keepalive retry limit is 5.
Views
Standard POS interface view
Predefined user roles
network-admin
Parameters
retries: Specifies the keepalive retry limit, in the range of 1 to 255.
Usage guidelines
The interface determines that the remote end is down if it does not receive a keepalive response after the keepalive retry limit has been made.
This command applies to interfaces encapsulated with PPP or HDLC. To set the keepalive interval, use the timer-hold command.
On a slow link, increase the keepalive retry limit to prevent false shutdown of the interface. This situation might occur when keepalive packets are delayed because a large packet is being transmitted on the link.
Examples
# Set the keepalive retry limit to 10 for Pos 1/1/1.
<Sysname> system-view
[Sysname] interface pos 1/1/1
[Sysname-Pos1/1/1] timer-hold retry 10
Related commands
timer-hold