pim timer join-prune

Function

The pim timer join-prune command sets the interval for periodically sending Join/Prune messages to the upstream device.

The undo pim timer join-prune command restores the default interval.

By default, the interval for periodically sending Join/Prune messages to the upstream device is 60 seconds.

Format

pim timer join-prune interval

undo pim timer join-prune

Parameters

Parameter	Description	Value
interval	Specifies the interval at which Join/Prune messages are sent.	The value is an integer that ranges from 1 to 18000, in seconds.

Views

GE interface view, XGE interface view, MultiGE interface view, 25GE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, GE sub-interface view, XGE sub-interface view, MultiGE sub-interface view, 25GE sub-interface view, 40GE sub-interface view, 100GE sub-interface view, Eth-Trunk sub-interface view, VLANIF interface view, loopback interface view, tunnel interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The device sends join information to the upstream device, requesting the upstream device to forward multicast data. The device sends prune information to the upstream device, requesting the upstream device to stop forwarding multicast data. Join information and prune information are encapsulated in Join/Prune messages. The device periodically sends Join/Prune messages to the upstream device to update the forwarding status.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

This command is valid only for PIM-SM.

The interval configured through this command must be shorter than the interval configured through the pim holdtime join-prune command. The interval at which Join or Prune messages are sent must be shorter than the holdtime carried in Join/Prune messages.

The configuration is the same as that of the timer join-prune (IPv4) command in the PIM view. The system prefers the configuration in the interface view. The value configured in the PIM view is used if no value is configured on the interface.

Example

# Set the interval for sending Join or Prune messages to 80 seconds on VLANIF100.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] pim timer join-prune 80

# Set the interval for sending Join or Prune messages to 80 seconds on GE0/0/1.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] pim timer join-prune 80