igmp
GroupInterfaceSapGroup

The IP multicast groups for which there are members on a particular SAP. Each instance represents a group address for which receivers are interested/not interested in receiving multicast traffic.



public class GroupInterfaceSapGroup

Properties
compatibilityMode This is used in order for routers to be compatible with older version routers. IGMPv3 hosts MUST operate in version 1 and version 2 compatibility modes. IGMPv3 SAPs MUST keep state per local SAP regarding the compatibility mode of each attached network. A SAPs compatibility mode is determined from the Host Compatibility Mode variable which can be in one of three states: IGMPv1, IGMPv2 or IGMPv3. This variable is kept per interface and is dependent on the version of General Queries heard on that SAP as well as the Older Version Queries Present timers for the SAP.

type=long
access=read-only
Displayed(tab/group)=Compatibility Mode

creationOrigin

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

encapVal The value of the label used to identify this SAP on the access port specified by sapPortId.

type=long
access=read-only
default=0
minimum=0
maximum=4294967295

expiryTime The minimum amount of time remaining before this entry will be aged out. A value of 0 indicates that the entry is only present because igmpCacheSelf is true and that if the router left the group, this entry would be aged out immediately.

type=Time
access=read-only
Displayed(tab/group)=Expire Time (/Timers)

fwdServiceId The forwarding service ID for a subscriber interface in a retailer context.

type=long
access=read-only
default=0

groupAddress The IP multicast group address.

type=InetAddress
access=read-create
default=0.0.0.0
Displayed(tab/group)=Group Address

groupAddressType The IP multicast group address type.

type=rtr.InetAddressType
access=read-create
default=ipv4

grpIfindex The unique value which identifies this interface of this virtual router.

type=long
access=read-only

igmp.GroupInterfaceSapGroupSource-Set type=Children-Set
mode The type of membership report(s) received on the SAP for the group. In the 'include' mode, reception of packets sent to the specified multicast address is requested only from those IP source addresses listed in the source-list parameter of the IGMP membership report. In 'exclude' mode, reception of packets sent to the given multicast address is requested from all IP source addresses except those listed in the source-list parameter.

type=igmp.GroupModeType
access=read-only
Displayed(tab/group)=Mode

portId The ID of the access port where this SAP is defined.

type=long
access=read-only
default=0

routerId

type=int
access=read-create
default=1

siteId

type=string
access=read-only
default=

type Indicates how this group entry was learned. If this group entry was learned by IGMP, it will be set to 'dynamic'. For statically configured groups, the value will be set to 'static'.

type=igmp.GroupType
access=read-only
Displayed(tab/group)=Group Type

upTime The time elapsed since this object was created.

type=Time
access=read-only
Displayed(tab/group)=Up Time (/Timers)

ver1HostTmr The time remaining until the local router will assume that there are no longer any IGMP version 1 members on the IP subnet attached to this SAP. Upon hearing any IGMPv1 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv2 Leave messages for this group that it receives on this SAP.

type=Time
access=read-only
Displayed(tab/group)=IGMP version 1 Timeout (/Timers)

ver2HostTimer The time remaining until the local router will assume that there are no longer any IGMP version 2 members on the IP subnet attached to this SAP. Upon hearing any IGMPv2 Membership Report, this value is reset to the group membership timer. While this time remaining is non-zero, the local router ignores any IGMPv3 Leave messages for this group that it receives on this SAP.

type=Time
access=read-only
Displayed(tab/group)=IGMP version 2 Timeout (/Timers)

  
Properties inherited from ManagedObject
actionMask, children-Set, deploymentState, isFaultSquelched, name, objectFullName, selfAlarmed
 
Methods

retrieveIgmpGroupIfSapGrp

Method used to query the NE for group address entries under a GroupInterfaceSap.
Input Parameters:
aInSiteId : string -
aInRouterId : int -
aInFwdServiceId : long -
aInGrpIfindex : long -
aInPortId : long -
aInEncapVal : long -
resultFilter : ResultFilter - (Optional) Filter for narrowing down the information returned per object
continueOnFailure : continueOnFailure - (Optional) Continue processing requests in this stream if an exception occurs, unless the request is invalid. Default: false
Output Parameters:
result : List (generic.CommonManagedEntityInformation) -
Exceptions:
igmp.GroupInterfaceSapGroup.retrieveIgmpGroupIfSapGrpException -
Supported Network Elements
7750 SR Supported from 9.0.R3
  • Excluded chassis types: 7750-SR1
7450 ESS Supported from 9.0.R3 until 10.0.R1
  • Excluded chassis types: 7450-ESS1, 7450-ESS6, 7450-ESS6V
  • Required Capabilities: MixedMode
Supported from 10.0.R1
  • Excluded chassis types: 7450-ESS1
  • Required Capabilities: MixedMode