The LED sends Announce events that match the GQI version on the SRM. The GQI v1 Extension protocol uses Announce event messages for GQIv1 Extension and GQI v2 uses Announce event messages for v2.

Some SRMs may not handle the announce events or may only generate a log when it receives the announce event messages from the eQAM, without taking any action. To avoid flooding and minimize the number of Remote Procedure Call (RPC) messages sent to the server, the operator can disable the announce events on the LED through the Cisco cBR-8 CLI.

Cisco cBR does not provide announce event messages for GQIv1. However, with GQI v1 Extension, Cisco cBR provides three announce event messages. The GQIv2 protocol support provides all the supported GQI announce event messages.

GQIv1 Extension supports the following announce events:

• Stream Active (2104)—The stream is successfully established and the session is active.

• Multicast Source Change (5406)—This event is triggered when the LED detects a loss of input of the source stream from the current multicast source and it fails over to a redundant multicast source.

• Stream Lost (5200)—The stream is lost and the video becomes idle or off.

GQIv2 supports the following announce event messages:

To prevent flooding of too many announce events, you can specify how the announce event messages should be delivered to the SRM. If configured, the announce event is sent one at a time synchronously.

To use blocking mode for announce event messages, specify a timeout value range from 0 to 240 seconds. If the timeout value is greater than zero, after sending the announce event message to the server, LED sets up a timer with the timeout value, and waits for the announce event acknowledgement. If the timer expires before receiving the acknowledgement, the next announce event in the queue is sent and the timer is restarted. The failed announce event is discarded.

To disable blocking the announce event messages, you should set the timeout value to 0 which is the default value. If the value is zero, the LED does not wait for the announce acknowledgement before sending the next message. All announce events are sent to the SRM instantly.

The announce event profile allows the user to define how announce events are managed in the GQI protocol. The profile can include a timeout value for blocking the event messages and the list of events that the operator wants to filter.

The GQI Announce Event Profile provides the following functions and you can assign it to any GQI LED.

• Filtering out all announce events.

  This command disables and does not forward announce events to SRM.

• Timeout value for sending the announce event.

• In blocking mode, this timeout is triggered when the announce event acknowledgement is not received within a specified time.

• Filtering subset of unwanted events.

You can assign the announce event profile to an LED at any time, even when the LED is already active. If the server is already connected and in service, and an event profile is updated, which is already assigned to an LED, all existing announce events in the queue are discarded and restarted according to the new changes.

This section provides example for the GQI Announce Event Profile configuration.

By default, all announce events are enabled. If all the events are filtered, the ack-timeout configured in the profile is no longer applicable, until you remove the filtering of all-events from the profile.

When you set the filtering to filter all-events, the individual event codes are removed from the CLI. The user is prompted before the changes take effect.

enable
configure terminal
cable video
  announce-event-profile disable-all id 1
      filter all-events

logical-edge-device led-1 id 1
   protocol gqi
    event-profile disable-all
    vcg vcg-1
    active 

You can filter the events, and add or remove a filter, when the LED is in active mode. When the filtering is enabled, the events that are generated and still queued, are discarded, and are not sent to the SRM.

cable video
  announce-event-profile gqi-led-1 id 2
      ack-timeout 240
      filter 5502
      filter 5602

logical-edge-device led-1 id 1
   protocol gqi
    event-profile gqi-led-1
    vcg vcg-1
    active

Use the no command to revert it to the default value. If the ack-timeout is set to 0 or no ack-timeout, the LED resumes the non-blocking event and sends messages to the SRM. All pending events in the Cisco cBR router queue are forwarded to the SRM without waiting for the announce event acknowledgement. If you remove the filter command, the GQI resumes generating that specific event code and reports it to the SRM.

To display the configuration of announce event profile and a list of LEDs that use the profile, use the show cable video announce-event-profile [name <profile-name> | id <#>] command as given in the following example.

Router# show cable video announce-event-profile id 3
ID:3     Name: profile-2
  ACK timeout: 240 seconds
  Number of Event Filters: 10
    2104 4400 4401 5200 5401 5404 5405 5406 5502 5602 

  Number of Logical-edge-device: 2
    ID    Name
    ---------------------------------------------------------------
    2     led2
    3     led3