The holdtime join-prune command sets the holdtime value in Join/Prune messages sent by all PIM interfaces. The devices that receive Join/Prune messages set the time during which the downstream interface keeps the Join or Prune state according to holdtime.
The undo holdtime join-prune command restores the default value.
By default, the holdtime value in Join/Prune messages sent by all PIM interfaces is 210 seconds.
| Parameter | Description | Value |
|---|---|---|
| interval | Specifies the value of holdtime carried in Join/Prune messages sent by the local switch. | The value is an integer that ranges from 1 to 65535, in seconds. |
Usage Scenario
After receiving a Join/Prune message from the downstream device, the switch starts the hold timer. If this message carries group-join information and the switch does not receive subsequent Join/Prune messages from the downstream device when the timer expires, it suppresses multicast data forwarding to downstream interfaces of the specified group. If Join/Prune message carries group-prune information, the switch resumes multicast data forwarding to downstream interfaces when the hold timer expires.
Prerequisites
IP multicast routing has been enabled using the multicast routing-enable command.
Precautions
This command is valid for PIM-SM and PIM-DM.
The holdtime of Join/Prune messages must be larger than the interval for sending Join/Prune messages and is generally 3.5 times the interval for sending Join/Prune messages.
The holdtime join-prune command has the same function as the pim holdtime join-prune command in the interface view. By default, if the holdtime value is not used on an interface, the holdtime value configured in the PIM view is used.