|
|
This feature module describes the Pragmatic General Multicast (PGM) Host feature and includes the following sections:
Pragmatic General Multicast is a reliable multicast transport protocol for multicast applications that require reliable, ordered, duplicate-free multicast data delivery from multiple sources to multiple receivers. PGM guarantees that a receiver in a multicast group either receives all data packets from transmissions and retransmissions, or can detect unrecoverable data packet loss. PGM is intended as a solution for multicast applications with basic reliability requirements. PGM has two main parts: a host element (also referred to as the transport layer of the PGM protocol) and a network element (also referred to as the network layer of the PGM protocol).
The transport layer of the PGM protocol consists of two main parts: a source part and a receiver part. The transport layer defines how multicast applications send and receive reliable, ordered, duplicate-free multicast data from multiple sources to multiple receivers. The PGM Host feature is the Cisco implementation of the transport layer of the PGM protocol.
The network layer of the PGM protocol defines how intermediate network devices (such as routers and switches) handle PGM transport data as the data flows through a network. The PGM Router Assist feature is the Cisco implementation of the network layer of the PGM protocol. Refer to the "IP Multicast" part of the Cisco IOS IP and IP Routing Configuration Guide for information about the PGM Router Assist feature.
Figure 1 shows a simple network topology using the PGM Host and Router Assist features.
When the router is functioning as a network element (the PGM Router Assist feature is configured) and the PGM Host feature is configured (Router A in Figure 1), the router can process received PGM packets as a virtual PGM host, originate PGM packets and serve as its own first-hop PGM network element, and forward received PGM packets.
When the router is functioning as a network element and the PGM Host feature is not configured (Router B in Figure 1), the router forwards received PGM packets as specified by PGM Router Assist feature parameters.
When the router is not functioning as a network element and the PGM Host feature is configured (Router C in Figure 1), the router can receive and forward PGM packets on any router interface simultaneously as specified by PGM Host feature parameters. Although this configuration is supported, it is not recommended in a PGM network because the PGM works optimally on routers that have the PGM Router Assist feature configured.
PGM is network-layer independent; the PGM Host and PGM Router Assist features in the Cisco IOS software support PGM over IP. Both the PGM Host and PGM Router Assist features use a unique transport session identifier (TSI) that identifies each individual PGM session.
The PGM Host feature enables Cisco routers to support multicast applications that operate at the PGM transport layer of the PGM protocol.
The PGM Host feature is related to the existing Router Assist feature, which is documented in the "IP Multicast" part of the Cisco IOS IP and IP Routing Configuration Guide and the Cisco IOS IP and IP Routing Command Reference publication.
Standards
PGM Reliable Transport Protocol Specification, Internet Engineering Task Force (IETF) draft standard, December, 1999.
MIBs
No new or modified MIBs are supported by this feature.
For descriptions of supported MIBs and how to use MIBs, see the Cisco MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
No new or modified RFCs are supported by this feature.
Before configuring the PGM Host feature, ensure that the following tasks are completed:
To configure the PGM Host feature, first enable the feature globally on the router (enable the transport layer of the PGM protocol) then optionally enable the PGM Router Assist feature (enable the network layer of the PGM protocol) on each physical and virtual host interface (vif) installed on the router. When both the PGM Host and PGM Router Assist features are enabled, the router can process received PGM packets as a virtual PGM host, originate PGM packets and serve as its own first-hop PGM network element, and forward received PGM packets. These configuration tasks are explained in the following sections. Each task in the following list is identified as required or optional.
When enabling the PGM Host feature on your router, you must source PGM packets through a vif or out a physical interface installed in the router.
Sourcing PGM packets through a vif enables the router to send and receive PGM packets through any router interface. The vif also serves as the interface to the multicast applications that reside at the PGM network layer.
Sourcing IP multicast traffic out a specific physical or logical interface type (for example, an Ethernet, serial, or loopback interface) configures the router to send PGM packets out that interface only and to receive packets on any router interface.
To enable the PGM Host feature globally on the router and to configure the router to source PGM packets through a vif, use the following command in global configuration mode:
| Command | Purpose | ||
|---|---|---|---|
Router(config)# ip pgm host | Enables the PGM Host feature (both the source and receiver part of the PGM network layer) globally on the router and configures the router to source PGM packets through a vif.
|
To enable the PGM Host feature globally on the router and to configure the router to source PGM packets through a physical interface, complete the following steps beginning in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | Router(config)# ip pgm host | Enables the PGM Host feature (both the source and receiver part of the PGM network layer) globally on the router. |
Step 2 | Router(config)# ip pgm host source-interface type number | Configures the router to source PGM packets through a physical (or logical) interface. |
Configuring the PGM Router Assist feature on the same vif or physical interface that you configured in the previous section enables those interfaces to server as the first-hop PGM network element for the router---the router not only sends and receives PGM packets (as configured in the previous section), it processes PGM packets as a virtual host. Refer to the "Configuring PGM Router Assist" chapter of the Cisco IOS IP and IP Routing Configuration Guide for information about how to configure the PGM Router Assist feature.
To verify that the PGM Host feature is configured correctly on your router, use the following show commands in EXEC mode:
Router> show ip pgm host sessionsIdx GSI Source Port Type State Dest Port Mcast Address1 000000000000 0 receiver listen 48059 224.3.3.32 9CD72EF099FA 1025 source conn 48059 224.1.1.1
Router> show ip pgm host sessions 2Idx GSI Source Port Type State Dest Port Mcast Address2 9CD72EF099FA 1025 source conn 48059 224.1.1.1stream-type (apdu), ttl (255)spm-ambient-ivl (6000), txw-adv-secs (6000)txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)ihb-max (10000), join (0), tpdu-size (16384)txw-adv-method (time), tx-buffer-mgmt (return)ODATA packets sent 0bytes sent 0RDATA packets sent 0bytes sent 0Total bytes sent 0ADPUs sent 0APDU transmit memory errors 0SPM packets sent 6NCF packets sent 0NAK packets received 0packets received in error 0General bad packets 0TX window lead 0TX window trail 0
Router> show ip pgm host trafficGeneral Statistics :Sessions in 0out 0Bytes in 0out 0Source Statistics :ODATA packets sent 0bytes sent 0RDATA packets sent 0bytes sent 0Total bytes sent 0ADPUs sent 0APDU transmit memory errors 0SPM packets sent 0NCF packets sent 0NAK packets received 0packets received in error 0Receiver Statistics :ODATA packets received 0packets received in error 0valid bytes received 0RDATA packets received 0packets received in error 0valid bytes received 0Total valid bytes received 0Total bytes received in error 0ADPUs received 0SPM packets received 0packets received in error 0NCF packets received 0packets received in error 0NAK packets received 0packets received in error 0packets sent 0Undeliverable packets 0General bad packets 0Bad checksum packets 0
To reset PGM Host connections, use the following command in privileged EXEC mode, as needed:
| Command | Purpose |
|---|---|
Router# clear ip pgm host | Resets PGM Host connections to their default values and clears traffic statistics. |
To enable PGM Host debugging, use the following command in privileged EXEC mode, as needed:
| Command | Purpose |
|---|---|
Router# debug ip pgm host | Displays debug messages for the PGM Host feature. |
To display PGM Host information, use the following commands in EXEC mode, as needed:
| Command | Purpose |
|---|---|
Router> show ip pgm host defaults | Displays the default values for PGM Host traffic. |
Router> show ip pgm host sessions | Displays open PGM Host traffic sessions. |
Router> show ip pgm host traffic | Displays PGM Host traffic statistics. |
This section provides the following configuration examples:
 |
Note For clarity, superfluous information has been omitted from the examples in the following sections. |
In the following example, the PGM Host feature (both the source and receiver part of the PGM network layer) is enabled globally on the router and PGM packets are sourced through virtual host interface 1 (vif1). PGM packets can be sent and received on the vif and on the two physical interfaces (Ethernet1 and Ethernet2) simultaneously.
ip multicast-routing ip routing ip pgm host interface vif1 ip address 10.0.0.1 255.255.255.0 ip pim dense-mode no ip pgm router no ip directed-broadcast no ip mroute-cache interface ethernet1 ip address 10.1.0.1 255.255.255.0 ip pim dense-mode no ip pgm router no ip directed-broadcast no ip mroute-cache media-type 10BaseT interface ethernet2 ip address 10.2.0.1 255.255.255.0 ip pim dense-mode no ip pgm router no ip directed-broadcast no ip mroute-cache media-type 10BaseT
In the following example, the PGM Host feature (both the source and receiver part of the PGM network layer) is enabled globally on the router and PGM packets are sourced out of physical interface Ethernet1. PGM packets can be received on physical interfaces Ethernet1 and Ethernet2.
ip multicast-routing ip routing ip pgm host ip pgm host source-interface ethernet1 interface ethernet1 ip address 10.1.0.1 255.255.255.0 ip pim dense-mode no ip pgm router no ip directed-broadcast no ip mroute-cache media-type 10BaseT interface ethernet2 ip address 10.2.0.1 255.255.255.0 ip pim dense-mode no ip pgm router no ip directed-broadcast no ip mroute-cache media-type 10BaseT
In the following example, both the PGM Host feature (the source and receiver part of the PGM network layer) and the PGM Router Assist feature (the PGM network layer) are enabled on the router and PGM packets are sourced and originated on interface vif1. PGM packets can be sent and received on interfaces vif1, Ethernet1, and Ethernet2 simultaneously, and the router can serve as its own first-hop PGM network element.
ip multicast-routing ip routing ip pgm host interface vif1 ip address 10.0.0.1 255.255.255.0 ip pim dense-mode ip pgm router no ip directed-broadcast no ip mroute-cache interface ethernet1 ip address 10.1.0.1 255.255.255.0 ip pim dense-mode ip pgm router no ip directed-broadcast no ip mroute-cache media-type 10BaseT interface ethernet2 ip address 10.2.0.1 255.255.255.0 ip pim dense-mode ip pgm router no ip directed-broadcast no ip mroute-cache
media-type 10BaseT
This section documents new commands. All other commands used with this feature are documented in the Cisco IOS Release 12.1 command reference publications.
To reset PGM Host connections to their default values and to clear traffic statistics, use the clear ip pgm host privileged EXEC command.
clear ip pgm host {defaults | traffic}
Syntax Description
defaults Resets all PGM Host connections to their default values. traffic Clears all PGM Host traffic statistics.
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
12.1(1)T This command was introduced.
Release
Modification
Usage Guidelines
This command should be used only in rare cases or during debugging. A reason to reset all PGM Host connections to their default values is to eliminate configuration errors in one step. A reason to clear traffic statistics is to make diagnostic testing easier.
Examples
The following example resets all PGM host connections to their default values:
clear ip pgm host defaults
The following example clears all PGM host traffic statistics:
clear ip pgm host statistics
Related Commands
show ip pgm host defaults Displays default values for PGM Host traffic. show ip pgm host traffic Displays PGM Host traffic statistics.
Command
Description
To enable the PGM Host feature, use the ip pgm host global configuration command. To disable the PGM Host feature and close all open PGM Host traffic sessions, use the no form of this command.
ip pgm host [source-interface {type number} | connection-parameter]
Syntax Description
source-interface type number (Optional) Interface type and number on which to run the Pragmatic General Multicast (PGM) Host feature. connection-parameter (Optional) Configures advanced PGM Host connection parameters. The optional configuration parameters should only be configured by experts in PGM technology. See Table 1 for a comprehensive list of the optional connection parameters and their definitions.
Defaults
The PGM Host feature is not enabled.
Command Modes
Global configuration
Command History
12.1(1)T This command was introduced.
Release
Modification
Using the ip pgm host command without a keyword or an argument enables the PGM Host feature on the router and configures the router to source PGM packets through a virtual host interface (vif).
Specifying a physical or logical interface type (for example, an Ethernet, serial, or loopback interface) with the ip pgm host source-interface command configures the router to source PGM packets out of the physical or logical interface.
|
Note You must first enable the PGM Host feature globally on the router using the ip pgm host command before sourcing PGM packets out of a physical or logical interface using the ip pgm host source-interface command. |
Sourcing PGM packets through a vif enables the router to send and receive PGM packets through any router interface. The vif also serves as the interface to the multicast applications that reside at the PGM network layer.
Sourcing IP multicast traffic out a specific physical or logical interface configures the router to send PGM packets out that interface only and to receive packets on any router interface.
When both the PGM Host feature and the PGM Router Assist feature are enabled on the router, the router can process received PGM packets as a virtual PGM host, originate PGM packets and serve as its own first-hop PGM network element, and forward received PGM packets. Refer to the "IP Multicast" part of the Cisco IOS IP and IP Routing Configuration Guide for more information about the PGM Router Assist feature.
Table 1 lists the available parameters for the connection-parameter argument. The parameters should only be configured by experts in PGM technology. Use the no ip pgm host connection-parameter command to return a parameter to its deafult value.
| Parameter | Definition |
|---|---|
ihb-max milliseconds | (Optional) Sets the SPM interheartbeat timer maximum. The default is 10000 milliseconds. |
ihb-min milliseconds | (Optional) Sets the source path message (SPM) interheartbeat timer minimum. The default is 1000 milliseconds. |
join milliseconds | (Optional) Sets the amount of time the PGM Host waits, when running in router mode, for client requests. The default is 0 milliseconds. |
nak-gen-ivl milliseconds | (Optional) Sets the amount of time the PGM Host waits for a PGM negative acknowledge (NAK) data packet. The default is 60000 milliseconds. |
nak-rb-ivl milliseconds | (Optional) Sets the amount of time the PGM Host waits before sending a PGM NAK data packet. The default is 500 milliseconds. |
nak-rdata-ivl milliseconds | (Optional) Sets the amount of time the PGM Host waits for a retransmitted PGM NAK (NAK RDATA) data packet. The default is 2000 milliseconds. |
nak-rpt-ivl milliseconds | (Optional) Sets the amount of time the PGM Host waits for a PGM NAK confirmation (NAK NCF) data packet. The default is 2000 milliseconds. |
ncf-max packets-per-second | (Optional) Sets the maximum number of PGM NAK confirmation data packets (NAK NCFs) the PGM Host sends per second. The default is infinite. |
rx-buffer-mgmt {full | minimum} | (Optional) Sets the type of receive data buffers (full or minimum) for the PGM Host. The default is minimum. |
spm-ambient-ivl milliseconds | (Optional) Sets the amount of time the PGM Host waits for a PGM SPM ambient data packet. The default is 6000 milliseconds. |
spm-rpt-ivl milliseconds | (Optional) Sets the amount of time the PGM host waits for a PGM SPM repeat data packet. The default is 3000 milliseconds. |
stream-type {apdu | byte} | (Optional) Sets the data stream type (apdu or byte) for the PGM Host. The default is apdu. |
tpdu-size number | (Optional) Sets the size of the source transport data unit (TPDU) for the PGM Host. The available range is 41 through 16384 bytes. The default is 1400 bytes. |
ttl number | (Optional) Sets the time-to-live (TTL) value on the PGM Host for sent multicast data packets. The default is 255 hops. The TTL value for a packet is decremented by 1 as the packet passes through a router. |
tx-buffer-mgmt {keep | return} | (Optional) Sets the type of transmit data buffers (keep or return) for the PGM Host. The default is return. |
tx-adv-method {data | time} | (Optional) Sets the type of advanced transmit window method (data or time) for the PGM Host. The default is time. |
txw-adv-secs milliseconds | (Optional) Sets the size of advanced transmit window for the PGM Host. The default is 6000 milliseconds. |
txw-rte bytes-per-second | (Optional) Sets the data transmit rate for the PGM Host. The default is 16384 bytes per second. |
txw-secs milliseconds | (Optional) Sets the data transmit window size for the PGM Host. The default is 30000 milliseconds. |
txw-timeout-max milliseconds | (Optional) Sets the amount of time the PGM Host waits before giving up on sent data packets, even if the PGM Host receives PGM negative acknowledge packets. The default is 3600000 milliseconds. |
Examples
The following example enables the PGM Host feature (both the source and receiver part of the PGM network layer) globally on the router and configures the router to source PGM packets through a virtual host interface (vif):
ip pgm host
The following example enables the PGM Host feature globally on the router and configures the router to source PGM packets out of physical interface ethernet 0/1:
ip pgm host
ip pgm host source-interface ethernet 0/1
Related Commands
ip pgm router Enables PGM Router Assist and thereby allows PGM to operate more efficiently on the router. show ip pgm host defaults Displays the default values for PGM Host traffic. show ip pgm host sessions Displays open PGM Host traffic sessions. show ip pgm host traffic Displays PGM Host traffic statistics.
Command
Description
To display the default values for PGM Host traffic, use the show ip pgm host defaults EXEC command.
show ip pgm host defaultsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.1(1)T This command was introduced.
Release
Modification
Usage Guidelines
The default values displayed in the show ip pgm host defaults command output are applied to every new host connection that is opened.
Examples
The following is sample output from the show ip pgm host defaults command:
Router> show ip pgm host defaultsSource Session Default Values :spm-ambient-ivl (6000), txw-adv-secs (6000)txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)ihb-max (10000), join (0), tpdu-size (16384)txw-adv-method (time), tx-buffer-mgmt (return)Receiver Session Default Values :nak-gen-ivl (60000), nak-rb-ivl (500), nak-rdata-ivl (2000)nak-rpt-ivl (2000), rx-buffer-mgmt (minimum), rx-local-retrans (none)Common Default Values:stream-type (apdu), ttl (255)Address used to source packets:(10.1.1.1)
Table 2 describes the fields Source Session Default Values, Receiver Session Default Values, Common Default Values, and Address used to source packets shown in the sample output. See Table 1 for a definition of each individual default value in the sample output.
| Field | Description |
|---|---|
Source Session Default Values | Shows the values for source-specific Pragmatic General Multicast (PGM) Host traffic defaults. |
Receiver Session Default Values | Shows the values for receiver-specific PGM Host traffic defaults. |
Address used to source packets | The unicast IP address that the virtual host is using to originate PGM packets. |
Common Default Values | Shows the values for PGM Host traffic defaults that are common between a source and a receiver. |
Related Commands
clear ip pgm host Resets PGM Host connections to their default values and clears traffic statistics. ip pgm host Enables the PGM Host feature. show ip pgm host sessions Displays open PGM Host traffic sessions. show ip pgm host traffic Displays PGM Host traffic statistics.
Command
Description
To display open PGM Host traffic sessions, use the show ip pgm host sessions EXEC command.
show ip pgm host sessions [session-number | multicast-group-address]
Syntax Description
session-number (Optional) PGM Host traffic session number. multicast-group-address (Optional) Multicast group address for the PGM Host.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.1(1)T This command was introduced.
Release
Modification
Usage Guidelines
If a session number or multicast group address is not specified, all open traffic sessions are shown.
Examples
The following example shows all open traffic sessions:
Router> show ip pgm host sessionsIdx GSI Source Port Type State Dest Port Mcast Address1 000000000000 0 receiver listen 48059 224.3.3.32 9CD72EF099FA 1025 source conn 48059 224.1.1.1
The following example shows traffic information for traffic session number 2:
Router> show ip pgm host sessions 2Idx GSI Source Port Type State Dest Port Mcast Address2 9CD72EF099FA 1025 source conn 48059 224.1.1.1stream-type (apdu), ttl (255)spm-ambient-ivl (6000), txw-adv-secs (6000)txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)ihb-max (10000), join (0), tpdu-size (16384)txw-adv-method (time), tx-buffer-mgmt (return)ODATA packets sent 0bytes sent 0RDATA packets sent 0bytes sent 0Total bytes sent 0ADPUs sent 0APDU transmit memory errors 0SPM packets sent 6NCF packets sent 0NAK packets received 0packets received in error 0General bad packets 0TX window lead 0TX window trail 0
The following example shows traffic information for multicast group address 244.1.1.1:
Router> show ip pgm host sessions 244.1.1.1Idx GSI Source Port Type State Dest Port Mcast Address2 9CD72EF099FA 1025 source conn 48059 224.1.1.1stream-type (apdu), ttl (255)spm-ambient-ivl (6000), txw-adv-secs (6000)txw-adv-timeout-max (3600000), txw-rte (16384), txw-secs (30000)ncf-max (infinite), spm-rpt-ivl (3000), ihb-min (1000)ihb-max (10000), join (0), tpdu-size (16384)txw-adv-method (time), tx-buffer-mgmt (return)ODATA packets sent 0bytes sent 0RDATA packets sent 0bytes sent 0Total bytes sent 0ADPUs sent 0APDU transmit memory errors 0SPM packets sent 6NCF packets sent 0NAK packets received 0packets received in error 0General bad packets 0TX window lead 0TX window trail 0
Table 3 describes the fields shown in the sample output.
| Field | Description |
|---|---|
Idx | The local index for the traffic session. |
GSI | The global source identifier for the traffic session. |
Source Port | The source port for the traffic session. |
Type | Source or receiver session. |
State | The state of the session. For example, connected or listening. |
Dest Port | The destination port for the traffic session. |
Mcast Address | The IP multicast address for the traffic session. |
ODATA | Normal data packet. |
RDATA | Retransmitted data packet. |
ADPUs | Application data units. |
SPM | Source path message. |
NCF | Negative acknowledgment confirmation packet. |
NAK | Negative acknowledgment packet. |
Related Commands
clear ip pgm host Resets PGM Host connections to their default values and clears traffic statistics. ip pgm host Enables the PGM Host feature. show ip pgm host defaults Displays the default values for PGM Host traffic. show ip pgm host traffic Displays PGM Host traffic statistics.
Command
Description
To display PGM Host traffic statistics, use the show ip pgm host traffic EXEC command.
show ip pgm host trafficSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.1(1)T This command was introduced.
Release
Modification
Usage Guidelines
Use this command to view traffic statistics at the Pragmatic General Multicast (PGM) transport layer.
Examples
The following is sample output from the show ip pgm host traffic command:
Router> show ip pgm host trafficGeneral Statistics :Sessions in 0out 0Bytes in 0out 0Source Statistics :ODATA packets sent 0bytes sent 0RDATA packets sent 0bytes sent 0Total bytes sent 0ADPUs sent 0APDU transmit memory errors 0SPM packets sent 0NCF packets sent 0NAK packets received 0packets received in error 0Receiver Statistics :ODATA packets received 0packets received in error 0valid bytes received 0RDATA packets received 0packets received in error 0valid bytes received 0Total valid bytes received 0Total bytes received in error 0ADPUs received 0SPM packets received 0packets received in error 0NCF packets received 0packets received in error 0NAK packets received 0packets received in error 0packets sent 0Undeliverable packets 0General bad packets 0Bad checksum packets 0
Table 4 describes the fields shown in the sample output.
| Field | Description |
|---|---|
General Statistics | Displays statistics that relate to both the traffic source and the receiver. |
Source Statistics | Displays statistics that relate to the traffic source. |
Receiver Statistics | Displays statistics that relate to the traffic receiver. |
Related Commands
clear ip pgm host Resets PGM Host connections to their default values and clears traffic statistics. ip pgm host Enables the PGM Host feature. show ip pgm host defaults Displays the default values for PGM Host traffic. show ip pgm host sessions Displays open PGM Host traffic sessions.
Command
Description
This section documents the new debug command related to the PGM Host feature. All other commands used with this feature are documented in the Cisco IOS Release 12.1 command reference publications.
To display debug messages for the PGM Host feature, use the debug ip pgm host privileged EXEC command. To disable PGM Host debugging output, use the no form of this command.
debug ip pgm host [data | nak | spm]
Syntax Description
data (Optional) Enables debugging for Pragmatic General Multicast (PGM) transmitted (ODATA) and retransmitted (RDATA) data packets. nak (Optional) Enables debugging for PGM negative acknowledgment (NAK) data packets, NAK confirmation (NCF) data packets, and Null NAK data packets. spm (Optional) Enables debugging for PGM source path messages (SPMs).
Defaults
Debugging for PGM Host is not enabled. If the debug ip pgm host command is used with no additional keywords, debugging is enabled for all PGM Host message types.
Command Modes
Privileged EXEC
Command History
12.1(1)T This command was introduced.
Release
Modification
Examples
The following example shows output for the debug ip pgm host command:
Router# debug ip pgm host Host SPM debugging is on Host NAK/NCF debugging is on Host ODATA/RDATA debugging is on
The following example shows output of the debug ip pgm host command when the data keyword is used.
Router# debug ip pgm host data 02:50:23:PGM Host:Received ODATA from 10.0.30.2 to 224.3.3.3 (74 bytes) 02:50:23: ODATA TSI 00000A001E02-0401 data-dport BBBB csum 9317 tlen 74 02:50:23: tsqn 31 dsqn 39
The following example shows output of the debug ip pgm host command when the nak keyword is used. In the following example, the host sends a NAK to the source for a missing packet and the source returns an NCF to the host followed by an RDATA data packet.
Router# debug ip pgm host nak 02:50:24:PGM Host:Sending NAK from 10.0.32.2 to 10.0.32.1 (36 bytes) 02:50:24: NAK TSI 00000A001E02-0401 data-dport BBBB csum 04EC tlen 36 02:50:24: dsqn 38 data source 10.0.30.2 group 224.3.3.3 02:50:24:PGM Host:Received NCF from 10.0.30.2 to 224.3.3.3 (36 bytes) 02:50:24: NCF TSI 00000A001E02-0401 data-dport BBBB csum 02EC tlen 36 02:50:24: dsqn 38 data source 10.0.30.2 group 224.3.3.3 02:50:24:PGM Host:Received RDATA from 10.0.30.2 to 224.3.3.3 (74 bytes) 02:50:24: RDATA TSI 00000A001E02-0401 data-dport BBBB csum 9218 tlen 74 02:50:24: tsqn 31 dsqn 38
The following example shows output of the debug ip pgm host command with the spm keyword:
Router# debug ip pgm host spm 02:49:39:PGM Host:Received SPM from 10.0.30.2 to 224.3.3.3 (36 bytes) 02:49:39: SPM TSI 00000A001E02-0401 data-dport BBBB csum EA08 tlen 36 02:49:39: dsqn 980 tsqn 31 lsqn 31 NLA 10.0.32.1
Related Commands
clear ip pgm host Resets PGM Host connections to their default values and clears traffic statistics. ip pgm host Enables the PGM Host feature. show ip pgm host defaults Displays the default values for PGM Host traffic. show ip pgm host sessions Displays open PGM Host traffic sessions. show ip pgm host traffic Displays PGM Host traffic statistics.
Command
Description
Posted: Mon Apr 3 10:07:39 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.