snmp-agent trap enable feature-name igmp
Function
The snmp-agent trap enable feature-name igmp command enables the trap function for the IGMP module.
The undo snmp-agent trap enable feature-name igmp command disables the trap function for the IGMP module.
By default, the trap function for IGMP events is disabled.
Format
snmp-agent trap enable feature-name igmp [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear | hwmgmdtotallimitthresholdexceed | hwmgmdtotallimitthresholdexceedclear | hwmgmdhoststargthresholdexceed | hwmgmdhoststargthresholdexceedclear | hwmgmdhoststargexceed | hwmgmdhoststargexceedclear | hwmgmdhostsgthresholdexceed | hwmgmdhostsgthresholdexceedclear | hwmgmdhostsgexceed | hwmgmdhostsgexceedclear } ]
undo snmp-agent trap enable feature-name igmp [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear | hwmgmdtotallimitthresholdexceed | hwmgmdtotallimitthresholdexceedclear | hwmgmdhoststargthresholdexceed | hwmgmdhoststargthresholdexceedclear | hwmgmdhoststargexceed | hwmgmdhoststargexceedclear | hwmgmdhostsgthresholdexceed | hwmgmdhostsgthresholdexceedclear | hwmgmdhostsgexceed | hwmgmdhostsgexceedclear } ]
Only the S5720-EI, S5720-HI, S5720I-SI, S5720-LI, S5735-L, S5735S-L, S5735S-L-M, S5720S-LI, S5720S-SI, S5720-SI, S5735-S, S5735S-S, S5735-S-I, S5730-HI, S5730S-EI, S5730-SI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720-LI, S6720S-EI, S6720S-LI, S6720S-SI, S6720-SI, S6730-H, S6730S-H, S6730-S, and S6730S-S support this command.
Parameters
| Parameter | Description | Value |
|---|---|---|
| trap-name | Enables the trap for a specified type of IGMP event. | - |
| glblimit | Enables the trap for the event indicating that the total number of the IGMP entries of all instances reaches the limit. | - |
| iflimit | Enables the trap for the event indicating that the number of IGMP entries on an interface reaches the limit. | - |
| iflimitclr | Enables the trap for the event indicating that the number of IGMP entries on an interface falls below the limit. | - |
| inslimit | Enables the trap for the event indicating that the number of IGMP entries in an instance reaches the limit. | - |
| joingrp | Enables the trap for the event indicating that an IGMP Join message is received. | - |
| leavegrp | Enables the trap for the event indicating that an IGMP Leave message is received or the group timer expires. | - |
| hwmgmdgmptotallimitclear | Enables the trap for the event indicating that the number of IGMP entries in all instances falls below the upper threshold. | - |
| hwmgmdgmpgloballimitclear | Enables the trap for the event indicating that the number of IGMP entries a single instance falls below the upper threshold. | - |
| hwmgmdtotallimitthresholdexceed | Enables the trap for the event indicating that the proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed reaches the upper alarm threshold. | - |
| hwmgmdtotallimitthresholdexceedclear | Enables the trap for the event indicating that the proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed falls below the lower alarm threshold. | - |
| hwmgmdhoststargthresholdexceed | Generates an alarm when the (*, G) entry usage of all instances reaches the specified upper alarm threshold on the user-side IGMP/MLD device. | - |
| hwmgmdhoststargthresholdexceedclear | Generates a clear alarm when the (*, G) entry usage of all instances falls below the specified lower alarm threshold on the user-side IGMP/MLD device. | - |
| hwmgmdhoststargexceed | Generates an alarm when the number of (*, G) entries of all instances exceeds the maximum number allowed on the user-side IGMP/MLD device. | - |
| hwmgmdhoststargexceedclear | Generates a clear alarm when the number of (*, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device. | - |
| hwmgmdhostsgthresholdexceed | Generates an alarm when the (S, G) entry usage of all instances reaches the specified upper alarm threshold on the user-side IGMP/MLD device. | - |
| hwmgmdhostsgthresholdexceedclear | Generates a clear alarm when the (S, G) entry usage of all instances falls below the specified lower alarm threshold on the user-side IGMP/MLD device. | - |
| hwmgmdhostsgexceed | Generates an alarm when the number of (S, G) entries of all instances exceeds the maximum number allowed on the user-side IGMP/MLD device. | - |
| hwmgmdhostsgexceedclear | Generates a clear alarm when the number of (S, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device. | - |
Usage Guidelines
To enable the trap function for a specific type of event, specify trap-name. To enable the trap function for multiple types of events, run this command multiple times.
Example
# Enable the trap for the event indicating that an IGMP Join message is received.
<HUAWEI> system-view [HUAWEI] snmp-agent trap enable feature-name igmp trap-name joingrp
# Disable the trap for the event indicating that an IGMP Join message is received.
<HUAWEI> system-view [HUAWEI] undo snmp-agent trap enable feature-name igmp trap-name joingrp