igmp
GrpInterface

IGMP Group Interface represents a group interface on this router that participates in the IGMP protocol.



public class GrpInterface

Properties
adminVersion The configured version of IGMP which is running on SAPs belonging to this group-interface. This object can be used to configure a router capable of running either value. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

type=igmp.IgmpVersion
default=version_three
Displayed(tab/group)=Administrative Version (/States)

availableMandatoryBw The available bandwidth on the interface for mandatory channels

type=long
access=read-only
default=0
units=kbps
Displayed(tab/group)=Available Bandwidth for Mandatory Channels (Multicast CAC.General)

availableOptionalBw The available bandwidth on the interface for optional channels

type=long
access=read-only
default=0
units=kbps
Displayed(tab/group)=Available Bandwidth for Optional Channels (Multicast CAC.General)

bwValuesInTransit Indicates that the operational (available and in-use mandatory/optional) value for the following objects are in transition due to configuration change: inUseMandatoryBw inUseOptionalBw availableMandatoryBw availableOptionalBw When Multicast CAC Policy is applied on the interface for the join of the next channel, the operational values will be recalculated and applied to the above objects and the value for bwValuesInTransit will be set to 'false'. If the value of bwValuesInTransit is 'true' then the values are in transition.

type=boolean
access=read-only
default=false
Displayed(tab/group)=Bandwidth Values in Transit (Multicast CAC.General)

creationOrigin

type=svt.L2RouteOriginType
access=read-create
default=manual

fwdServiceId

type=long
default=0
Displayed(tab/group)=Forwarding Service ID (/IGMP Group Interface)

groupIfPointer

type=Pointer
access=read-create
default=
Mandatory on create
Displayed(tab/group)=IGMP Group Interface (/IGMP Group Interface)

igmp.GroupInterfaceSap-Set type=Children-Set
importPlcyName The name of the IGMP policy (filter) that is to be applied on SAPs belonging to this group-interface..

type=string
default=
minimum=0
maximum=32
Displayed(tab/group)=Import Policy (Behavior)

inUseMandatoryBw The bandwidth already taken on the interface by mandatory channels

type=long
access=read-only
default=0
units=kbps
Displayed(tab/group)=In Use Bandwidth by Mandatory Channels (Multicast CAC.General)

inUseOptionalBw The bandwidth already taken on the interface by optional channels

type=long
access=read-only
default=0
units=kbps
Displayed(tab/group)=In Use Bandwidth by Optional Channels (Multicast CAC.General)

ipAddrType

type=rtr.InetAddressType
default=ipv4

lastLstnrQryIntvl Specifies the Max Response Time inserted into Group-Specific Queries sent in response to Leave Group messages, and is also the amount of time between Group-Specific Query messages. This value may be tuned to modify the leave latency of the network. A reduced value results in reduced time to detect the loss of the last member of a group.

type=int
default=0
minimum=0
maximum=1023
units=seconds
Displayed(tab/group)=Last Member Query Interval (Behavior)

mCacConstAdminState The administrative state of the multicast CAC policy's constraints.

type=netw.AdministrativeState
default=tmnxInService
Displayed(tab/group)=Constraint Administration State (Multicast CAC.General)

mCastCacIntfPolicyPointer Pointer to the instance of the multicast cac interface policy object.

type=Pointer
default=
Displayed(tab/group)=Multicast CAC Interface Policy (Multicast CAC.General)

mCastCacPolicyName The name of the multicast CAC policy.

type=string
access=read-only
default=
minimum=0
maximum=32

mCastCacPolicyPointer Pointer to the instance of the multicast cac policy object.

type=Pointer
default=
Displayed(tab/group)=Multicast CAC Policy (Multicast CAC.General)

maxGroups Specifies the maximum number of groups for which IGMP can have local receiver information based on received IGMP reports on a SAP belonging to this group-interface. When this configuration is changed dynamically to a value lower than currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups will not be allowed. When this object has a value of 0, there is no limit to the number of groups

type=long
default=0
minimum=0
maximum=16000
Displayed(tab/group)=Maximum Number of Groups (Behavior)

maxGrpSources Specifies the maximum number of group sources for which IGMP can have local receiver information based on received IGMP reports on this interface. When this configuration is changed dynamically to a value lower than currently accepted number of group sources, the group sources that are already accepted are not deleted. Only new group sources will not be allowed. When this object has a value of 0, there is no limit to the number of group sources.

type=long
default=0
minimum=0
maximum=32000
Displayed(tab/group)=Maximum Number of Group Sources (Behavior)

maxSources Specifies the maximum number of sources for which IGMP can have local receiver information based on received IGMP reports on a SAP belonging to this group-interface. When this configuration is changed dynamically to a value lower than currently accepted number of sources, the sources that are already accepted are not deleted. Only new sources will not be allowed. When this object has a value of 0, there is no limit to the number of sources.

type=long
default=0
minimum=0
maximum=1000
Displayed(tab/group)=Maximum Number of Sources (Behavior)

preRsvdMandatoryBandwidth The value of preRsvdMandatoryBandwidth specifies the bandwidth pre-reserved for all the mandatory channels on a given interface in kilo-bits per second(kbps). If the value of unconstrainedBandwidth is '0', no mandatory channels are allowed. If the value of unconstrainedBandwidth is '-1', then all mandatory and optional channels are allowed. If the value of preRsvdMandatoryBandwidth is equal to the value of unconstrainedBandwidth, then all the unconstrained bandwidth on a given interface is allocated to mandatory channels configured through multicast cac policy on that interface and no optional groups (channels) are allowed. The default value of '-1' can be set only by setting unconstrainedBandwidth object to '-1'. An attempt to set the value of preRsvdMandatoryBandwidth to '-1' will result in inconsistent value error. The value of preRsvdMandatoryBandwidth will be set to the same as unconstrainedBandwidth if the latter is set to either '-1' or '0'. The value of preRsvdMandatoryBandwidth should always be less than or equal to that of unconstrainedBandwidth. An attempt to set the value of preRsvdMandatoryBandwidth greater than that of unconstrainedBandwidth will result in inconsistent value error.

type=int
default=-1
minimum=-1
maximum=2147483647
units=kbps
Displayed(tab/group)=Mandatory Bandwidth (Multicast CAC.General)

queryInterval Specifies the frequency at which the IGMP Host-Query packets are transmitted for this group interface. Valid range for query interval is 0 or 2..1024.

type=int
default=0
minimum=0
maximum=1024
units=seconds
Displayed(tab/group)=Query Interval (Behavior)

queryResponseIntvl Specifies maximum query response time advertised in IGMP queries for this group interface.

type=int
default=0
minimum=0
maximum=1023
units=seconds
Displayed(tab/group)=Response Query Interval (Behavior)

querySourceIP

type=InetAddress
default=0.0.0.0
Displayed(tab/group)=Query Source IP

rtrAlertCheckDisabled Used to enable/disable router alert checking for IGMP messages received on SAPs belonging to this group-interface. If this flag is set to 'true', checking is disabled

type=generic.TruthValue
default=false
Displayed(tab/group)=Disable Router Alert Check (Behavior)

subHostsOnly used to enable/disable handling of IGMP joins received from hosts that are not known in subscriber management or on which no IGMP policy is applied. If this flag is set to 'true', only traffic from IGMP enabled hosts is allowed.

type=boolean
default=true
Displayed(tab/group)=Sub Hosts Only (Behavior)

subnetCheck Used to enable/disable subnet checking for IGMP messages received on SAPs belonging to this group-interface. If this flag is set to 'true', subnet checking is enabled. All IGMP packets with a source address that is not in the local subnet are dropped.

type=generic.TruthValue
default=true
Displayed(tab/group)=Subnet Check (Behavior)

unconstrainedBandwidth The bandwidth assigned for interface's multicast cac policy traffic in kilo-bits per second(kbps). If the default value of '0' is set, then the value will be set to the physical bandwidth available for the interface.

type=int
default=-1
minimum=-1
maximum=2147483647
units=kbps
Displayed(tab/group)=Unconstrained Bandwidth (Multicast CAC.General)

 
Overridden Properties
administrativeState

default=tmnxInService

displayedName

default=IGMP Group Interface

operationalState

default=tmnxOutOfService

 
Properties inherited from netw.RouterTerminatingNonIpInterface
additionalForNamingInterfaceName, interfaceId
 
Properties inherited from netw.RouterTerminatingInterface
interfaceClass, serviceId, serviceType, subscriberId
 
Properties inherited from netw.StatefullConnectableInterface
administrativeState, compositeState, encapType, operationalState, resourceState, underlyingResourceState
 
Properties inherited from netw.ConnectableInterface
actualMtu, ctpPointer, encapType, isExclusiveTermination, mtuMismatch, portId, portName, provisionedMtu, routerId, routerName, terminatedObjectId, terminatedObjectName, terminatedObjectPointer, terminatedPortClassName, terminatedPortCombinedEncapValue, terminatedPortInnerEncapValue, terminatedPortOuterEncapValue, terminatedPortPointer, terminationParticipationType
 
Properties inherited from netw.LogicalInterface
application, description, displayedName, domain, nodeId, nodeName
 
Properties inherited from ManagedObject
actionMask, children-Set, deploymentState, isFaultSquelched, name, objectFullName, selfAlarmed
 
Supported Network Elements
7750 SR Supported for all versions
  • Excluded chassis types: 7750-SR1
7450 ESS Supported for all versions
  • Excluded chassis types: 7450-ESS1
  • Required Capabilities: MixedMode
Product Specifics
7450 ESS 20.0
7450 ESS 21.0
7450 ESS 22.0
7450 ESS 23.0
7450 ESS 24.0
7450 ESS 25.0
7750 SR 20.0
7750 SR 21.0
7750 SR 22.0
7750 SR 23.0
7750 SR 24.0
7750 SR 25.0