Cisco IOS Mobile Wireless Gateway GPRS Support Node Command Reference
show data-store through vrf

Table Of Contents

show aaa servers sg

show data-store

show data-store statistics

show diameter peer

show ggsn csg

show ggsn quota-server

show gprs

show gprs access-point

show gprs access-point statistics

show gprs access-point throughput statistics

show gprs bandwidth-pool status

show gprs charging parameters

show gprs charging statistics

show gprs charging status

show gprs gtp ms

show gprs gtp parameters

show gprs gtp path

show gprs gtp path statistics history

show gprs gtp path statistics remote-address

show gprs gtp path throughput

show gprs gtp pdp-context

show gprs gtp statistics

show gprs gtp status

show gprs memory threshold statistics

show gprs ms-address exclude-range

show gprs pcscf

show gprs plmn

show gprs plmn ip address

show gprs qos status

show gprs redundancy

show gprs service-aware statistics

show gprs slb detail

show gprs slb mode

show gprs slb statistics

show gprs slb vservers

show gprs service-mode

show gprs umts-qos map traffic-class

show gprs umts-qos police pdp-context tid

show gprs umts-qos profile pdp tid

show ip iscsi name

show ip iscsi session

show ip iscsi stats

show ip iscsi target

show policy-map apn

show record-storage-module stats

show record-storage-module target-info

show tech-support

source interface

subscription-required

t3-response

tariff-time

timer

traffic-class

transport

trigger

tx-timeout

virtual-address

vrf


show aaa servers sg

To display counters (information about the number of packets sent to and received from authentication, authorization, and accounting [AAA] servers) for all the servers that are members of a specific server group, use the show aaa servers sg command in privileged EXEC mode.

show aaa servers sg sg-name

Syntax Description

sg-name

Name of the server group for which you want to display counters for each server in the group.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.4(9)XG

This command was introduced.

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ.

12.4(24)T

This command was integrated into Cisco IOS Release 12.4(24)T.


Usage Guidelines

Use the show aaa servers sg command to display counters for all the servers in a specified server group.

The command displays information about packets sent and received for all AAA transaction types.

Examples

The following example displays information about each RADIUS servers that are a member of the "group1" server group:

router# show aaa servers sg group1

RADIUS: id 3, priority 0, host 1.1.1.1, auth-port 1645, acct-port 1646
     State: current UP, duration 159574s, previous duration 0s
     Dead: total time 0s, count 0
     Authen: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Author: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Account: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Elapsed time since counters last cleared: 1d20h19m

RADIUS: id 4, priority 0, host 2.2.2.2, auth-port 1645, acct-port 1646
     State: current UP, duration 159574s, previous duration 0s
     Dead: total time 0s, count 0
     Authen: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Author: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Account: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Elapsed time since counters last cleared: 1d20h19m

RADIUS: id 5, priority 0, host 3.3.3.3, auth-port 1645, acct-port 1646
     State: current UP, duration 159575s, previous duration 0s
     Dead: total time 0s, count 0
     Authen: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Author: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Account: request 0, timeouts 0
             Response: unexpected 0, server error 0, incorrect 0, time 0ms
             Transaction: success 0, failure 0
     Elapsed time since counters last cleared: 1d20h19m

Table 3 describes the fields shown in the display.

Table 3 show aaa servers sg Field Descriptions

Field
Description

id

An identifier that uniquely identifies the server on the router.

priority

The priority by which the server will be tried within the server group.

host

The IP address of the AAA server.

auth-port

The port on the AAA server that is used for authentication and authorization requests.

acct-port

The port on the AAA server that is used for accounting requests.

State

Indicates the assumed state of the AAA server. The following states are possible:

UP—Indicates that the server is currently considered alive and attempts will be made to communicate with it.

DEAD—Indicates that the server is currently presumed dead and, in the case of failovers, this server will be skipped unless it is the last server in the group.

duration—Is the amount of time the server is assumed to be in the current state, either UP or DEAD.

previous duration—Is the amount of time the server was considered to be in the previous state.

Dead

Indicates the number of times that this server has been marked dead, and the cumulative amount of time, in seconds, that it spent in that state.

Authen

Provides information about authentication packets that were sent to and received from a server, and authentication transactions that were successful or that failed. The following information may be reported in this field:

request—Number of authentication requests that were sent to the AAA server.

timeouts—Number of timeouts (no responses) that were observed, when a transmission was sent to this server.

Response—Provides statistics about responses that were observed from the server and includes the following reports:

unexpected—Number of unexpected responses. A response is considered unexpected when it is received after the timeout period for the packet has expired. This may happen if the link to the server is severely congested, for example. An unexpected response can also be produced when a server generates a response for no apparent reason.

server error—Number of server errors. This category is a catchall for error packets that do not any of the previous categories.

incorrect—Number of incorrect responses. A response is considered incorrect if it is of the wrong format expected by the protocol. This frequently happens when an incorrect server key is configured on the router.

Transaction—These fields provide information about AAA transactions related to the server. A transaction is defined as a request for authentication, authorization, or accounting information that is sent by the AAA module, or by an AAA client (such as PPP) to an AAA protocol (RADIUS or TACACS+), which may involve multiple packet transmissions and retransmissions. Transactions may require packet retransmissions to one or more servers in a single server group, to verify success or failure. Success or failure is reported to AAA by the RADIUS and TACACS+ protocols, as follows

success—Incremented when a transaction is successful.

failure—Incremented when a transaction fails (for example, packet retransmissions to another server in the server group failed due to failover or did not succeed. (A negative response to an Access Request, such as Access Reject, is considered to be a successful transaction).

Author

The fields in this category are similar to those in the Authen fields. An important difference, however, is that because authorization information is carried in authentication packets for the RADIUS protocol, these fields are not incremented when using RADIUS.

Account

The fields in this category are similar to those in the Authen fields, but provide accounting transaction and packet statistics.

Elapsed time since counters last cleared

Displays the amount of time in days, hours, and minutes, that has passed since the counters were last cleared.


Related Commands

Command
Description

clear aaa counters server sg

Clears and resets the counters to zero for all servers in a specific server group.


show data-store

To display the status of the Persistent Storage Device (PSD) client and PSD server-related information, use the show data-store command in privileged EXEC mode.

show data-store

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(14)YU

This command was introduced.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

Use the show data-store command to display the status of the PSD client and PSD server information.

Examples

The following is sample output of the show data-store command:

router# show data-store

---------------------------------------------------------------------------
  Server       Retrieve  Link    Current      Operating    Disk       Data
IP address       Only    State    Status        Mode       State     Present
----------------------------------------------------------------------------
172.17.17.17      YES     DOWN      IDLE           -      AVAILABLE     YES
192.10.5.1        NO      UP        IDLE        STANDBY   AVAILABLE     NO
----------------------------------------------------------------------------
Auto retrieval                    :ENABLED
Client                            :GGSN Charging

Table 4 describes the fields shown in the display.

Table 4 show data-store Field Descriptions 

Field
Description

Server IP Address

IP address of the PSD.

Retrieve Only

Whether or not the PSD is a "retrieve-only" PSD. Possible values are YES or NO.

Link State

Status of link between the GGSN and PSD. Possible values are UP or DOWN.

Current Status

Whether or not activity is occurring on the link. Possible values are:

IDLE—PSD server is available. When a PSD moves from a Writing to Idle state, the pending write requests are copied and sent to the active charging gateway.

WRITING—G-CDRs are in the process of being backed up to the PSD. Once the PSD disk state is full, the PSD moves to an Idle state.

RETRIEVING—G-CDRs are being retrieved and forwarded to the active charging gateway. Once all records are retrieved, the PSD state moves to idle.

Operating Mode

Operational state of the PSD. Possible values are:

UNDEFINED—PSD is configured on the GGSN but no connection established.

STANDBY—PSD is configured and connection is established, but the PSD is in Standby mode (no writing or retrieving activity is occurring).

ACTIVE—G-CDRs are being backed up to the PSD. In this state, aggregation characteristics and throttles that normally apply to the charging gateways are applied to the PSD.

Disk State

Whether or not disk space is available on the PSD. Possible values are AVAILABLE or FULL.

Data Present

Whether or not data currently exists on a disk. Possible values are YES or NO.

Auto retrieval

Whether or not the auto-retrieval feature has been configured for a PSD server group.

Client

PSD client.


Related Commands

Command
Description

auto-retrieve

Configures the GGSN to automatically initiate a retrieval of G-CDRs from PSDs defined in a PSD server group.

clear data-store statistics

Clears PSD-related statistics.

data-store

Configures a PSD server group on the GGSN to use for GGSN-to-PSD communication.

show data-store statistics

Displays PSD client statistics.


show data-store statistics

To display statistics related to the Persistent Storage Device (PSD) client, including the number of requests sent and DRT responses received, use the show data-store statistics command in privileged EXEC mode.

show data-store statistics

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(14)YU

This command was introduced.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.

12.4(15)T

This command was integrated into Cisco IOS Release 12.4(15)T.


Usage Guidelines

Use the show data-store statistics command to display statistics related to the PSD client (for example, number of Read/Write requests sent and responses received).

Examples

The following is sample output of the show data-store command:

router# show data-store statistics

Requests sent:
         FIFO Write. . . . . . . . . . . . . . . . . . . . = 0
         FIFO Read . . . . . . . . . . . . . . . . . . . . = 12
         FIFO Read/Write retransmissions . . . . . . . . . = 12

DRT Responses rcvd:
         Retrieved msgs forwarded. . . . . . . . . . . . . = 8
         Disk full transitions. . . . . . . . . . . . . .  = 0

Table 5 describes the fields shown in the display.

Table 5 show data-store statistics Field Descriptions 

Field
Description

Requests sent: FIFO Write

First-in, first-our Write requests sent.

Requests sent: FIFO Read

First-in, first-our Read requests sent.

Requests sent: FIFO Read/Write retransmissions

First-in, first-our Read/Write requests sent.

DRT Responses rcvd: Retrieved msgs forwarded

 

DRT Responses rcvd:Disc full transitions

 

Related Commands

Command
Description

auto-retrieve

Configures the GGSN to automatically initiate a retrieval of G-CDRs from PSDs defined in a PSD server group.

clear data-store statistics

Clears PSD-related statistics.

data-store

Configures a PSD server group on the GGSN to use for GGSN-to-PSD communication.

show data-store

Displays the status of the PSD client and PSD server-related information.


show diameter peer

To display information about the state of a Diameter peer, including various counters, use the show diameter peer command in privilege EXEC mode.

show diameter peer [name | all]

Syntax Description

name

Name of the Diameter peer for which you want to display state information.

all

Displays information for all Diameter peers.


Defaults

No default behavior or values.

Command Modes

Privilege EXEC

Command History

Release
Modification

12.3(14)YQ

This command was introduced.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Examples

The following configuration example displays information about the state of Diameter peer "peerA":

show diameter peer peerA
 Peer information for peerA
---------------------------------------
Peer name :peerA
Peer type :Server
Peer transport protocol :TCP
Peer listening port :3688
Peer security protocol :IPSEC
Peer connection timer value :30 seconds
Peer watch dog timer value :35 seconds.
Peer vrf name :default
Peer connection status :UP.

Table 18 describes the fields shown in the display.

Table 6 show diameter peer Field Descriptions 

Field
Description

Peer Name

Name of the Diameter peer.

Peer Type

Type of Diameter peer. Possible values are Server and Client.

Peer transport protocol

Transport protocol used to connect to peer.

Peer listening port

Port being used listen for peer communication.

Peer security protocol

Security protocol being used for peer-to-peer communication. Possible value is IPSEC.

Peer connection timer

Timeout period for attempting to connect to the peer after a connection has been dropped.

Peer watch dog timer

Maximum period of time this node will wait for the Diameter peer to respond to a watchdog packet.

Peer vrf name

Name of VRF associated with the Diameter peer.

Peer connection status

Status of the connection to the peer. Possible values are UP or DOWN.


show ggsn csg

To display the parameters configured for a Content Services Group (CSG) group or the number of path and quota management messages sent and received by a quota server, use the show ggsn csg command in privilege EXEC mode.

show ggsn csg [parameters | statistics]

Syntax Description

parameters

Displays the parameters configured for a CSG group.

statistics

Displays the number of path and quota management messages sent and received by a quota server.


Defaults

No default behavior or values.

Command Modes

Privilege EXEC

Command History

Release
Modification

12.3(14)YQ

This command was introduced.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Examples

Example 1 displays the parameters used by the CSG group. Example 2 displays the number of path and management messages sent and received by the quota server.

Example 1

ggsn1#show ggsn csg parameters 
GGSN CSG parameters:
  Group name:           csg1
  virtual/alias address:5.5.5.14
  Port on CSG:          3386
  Path state:           UP
  Peal addresses:       5.1.1.1 5.1.1.2
  Active real's address:5.1.1.2 

Example 2

ggsn1#show ggsn csg statistics          
GGSN CSG path statistics:
  Outbound msg count:  224
  Outbound byte count: 1344
  Inbound msg count:   222
  Inbound byte count:  1554
GGSN CSG path msg statistics:
  Service Auth Req:     0
  Service Auth Resp:    0
  Service Reauth Req:   0
  Service Stop:         0
  Quota Return:         0
  Quota Return Req:     0
  Quota Push Resp:      0
  Service Stop Req:     0
  Quota Push:           0
  Quota Push resp:      0
  GTP' Acknowledgements:0
ggsn1#

Related Commands 

Command
Description

ggsn csg-group

Configures a CSG group on the GGSN for quota server-to-CSG communication.

port

Configures the port number on which the CSG listens for quota server traffic.

real-address

Configures the IP address of a real CSG for source checking on inbound messages from a CSG.

virtual-address

Configures a virtual IP address to which the quota server will send all requests.


show ggsn quota-server

To display quota server parameters or quota server-related statistics, use the show ggsn quota-server command in privilege EXEC mode.

show ggsn quota-server [parameters | statistics]

Syntax Description

parameters

Displays the quota server configuration.

statistics

Displays quota server-related message and error counts.


Defaults

No default behavior or values.

Command Modes

Privilege EXEC

Command History

Release
Modification

12.3(14)YQ

This command was introduced.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show ggsn quota-server command to display the quota server configuration or quota server-related statistics on messages and error counts.

Quota server-related statistics can be cleared using the clear ggsn quota-server statistics command.

Examples

Example 1 displays the quota server configuration on a GGSN. Example 2 displays quota server-related statistics.

Example 1

ggsn1#show ggsn quota-server parameters
GGSN Quota Server parameters:
  Server name:  qs
  Interface:    Loopback1
  IP address:   10.1.1.1
  Table ID:     0
  Port on QS:   3386
  Echo interval:60 secs
  N3 number:    5
  T3 time:      1 secs
  CSG group:    csg1

Example 2

ggsn1#show ggsn quota-server statistics 
GGSN Quota Server statistics
Quota management statistics:
  Requests rcvd:  35
  Responses rcvd: 16
  Requests sent:  16
  Responses sent: 27
Overall path management statistics:
  Requests rcvd:  5717
  Responses rcvd: 5818
  Requests sent:  5825
  Responses sent: 5717
Error statistics:
  Negative responses rcvd:0
  Requests unreplied:     0
  Seqnum failures:        0
  Dropped msgs:           10
  Unknown msgs:           0
  Unknown responses:      0
  Msgs with IE error:     0
  Bad source address msgs:0
  Version not supported:  0
  Mandatory TLV missing:  0
  Mandatory TLV incorrect:2
  Invalid Msg format:     0
  No response:            1

Related Commands 

Command
Description

clear ggsn quota-server statistics

Clears the quota server-related statistics displayed using the show ggsn quota-server statistics command.

csg-group

Associates the quota server to a CSG group that is to be used for quota server-to-CSG communication.

echo-interval

Specifies the number of seconds that the quota server waits before sending an echo-request message to the CSG.

ggsn quota-server

Configures the quota server process that interfaces with the CSG for enhanced service-aware billing.

interface

Specifies the logical interface, by name, that the quota server will use to communicate with the CSG.

n3-requests

Specifies the maximum number of times that the quota server attempts to send a signaling request to the CSG.

t3-response

Specifies the initial time that the quota server waits before resending a signaling request message when a response to a request has not been received.


.

show gprs

To display statistics for a gateway GPRS support node (GGSN), use the show gprs command in privileged EXEC mode.

show gprs

Syntax Description

access-point-index

Index number of an access point. Statistics for that access point are shown.

all

Statistics for all access points on the GGSN are shown.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.4(15)XQ

This command was introduced.

12.4(24)T

This command was integrated into Cisco IOS Release 12.4(24)T.


Usage Guidelines

Use the show gprs command to display statistics collected for the GGSN during the interval defined using the gprs interval global configuration command.

Examples

The following example displays statistics for the GGSN:

Router#show gprs 
 Collection interval - 3 min, Last collected at - 1 min back 
   upstream data volume in octets: 0 
   downstream data volume in octets: 0 
   upstream packet count: 0 
   downstream packet count: 0 
 Collection interval - 4 min, Last collected at - 2 min back 
   upstream data volume in octets: 0 
   downstream data volume in octets: 0 
   upstream packet count: 0 
   downstream packet count: 0 
Router#

Related Commands

Command
Description

gprs interval

Configures the interval at which the GGSN collects data for APNs.


show gprs access-point

To display information about access points on the gateway GPRS support node (GGSN), use the show gprs access-point command in privileged EXEC mode.

show gprs access-point {access-point-index [address-allocation] | all}

Syntax Description

access-point-index

Integer (from 1 to 65535) that identifies a GGSN access point. Information about that access point is shown.

address-allocation

Tunnel ID (TID) and dynamically allocated mobile station (MS) addresses (by either a DHCP or RADIUS server) are shown for packet data protocol (PDP) contexts on the specified access point.

all

Information about all access points on the GGSN is shown.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX.

The following output fields were added to the display:

accounting

aggregate

apn_accounting_server_group

apn_authentication_server_group

apn-type

apn_username

apn_password

Block Roamer Mode

GPRS vaccess interface

VPN

wait_accounting

The following output fields were removed from the display:

apn_charging_gw

apn_backup_charging_gw

apn_radius_server

Several output field results were changed from binary 0 and 1 to Yes and No.

The following output fields were added to the all version of this command:

Access-type

ppp-regeneration (max-session, setup time)

VRF Name

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD and the Block Roamer Mode output field was changed to Block Foreign-MS Mode output field.

12.2(8)YW

This command was integrated into Cisco IOS Release 12.2(8)YW.

The following output fields were added to the display:

input ACL

output ACL

backup

RADIUS attribute suppress MSISDN

RADIUS attribute suppress IMSI

RADIUS attribute suppress SGSN Address

RADIUS attribute suppress QoS

The format of the apn_username: , apn_password: display fields was changed to apn_username: apn_password:.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(2)XU.

The following fields were added to the display:

cac policy

idle timeout

input bandwidth pool

input service-policy

output bandwidth pool

Service Mode

session timeout

12.3(8)XU2

This command was integrated into Cisco IOS Release 12.3(2)XU2 and the single pdp-session field was the display.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU and the following field was added to the display:

apn_type: Virtual pre-authenticate

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB and the following field was added to the display:

P-CSCF group name

12.4(9)XG

This command was integrated into Cisco IOS Release 12.4(9)XG and the following fields were added to the show gprs access-point access-point-index display:

IPV6 enable

IPV6 base template

IPV6 uplink access list

IPV6 downline access list

IPV6 dynamic_address_pool

IPV6 local prefix pool

IPV6 primary dns

IPV6secondary dns

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ and the following field was added to the display:

Delete PDP upon update failure

Interim periodic accounting


Usage Guidelines

Use the access-point-index argument to specify a particular access point number for which you want to obtain information.

Use the address-allocation keyword to obtain information about dynamically allocated MS addresses and lease terms per access point.

Use the all keyword to obtain information about all access points in an abbreviated format.

Examples

Example 1

The following is sample output from the show gprs access-point command for access point 1, which is a real access point:


Routershow gprs access-point 1

    apn_index 1          apn_name = gprs.corporate.com
    apn_mode: transparent
    apn-type: Real
    accounting: Disable
    interim accounting: Disable
    interim periodic: Disable
    wait_accounting: Disable
    interim periodic accounting:
    input ACL: None, output ACL: None
    dynamic_address_pool: dhcp-proxy-client
    apn_dhcp_server: 10.99.100.5     backup: 10.99.100.4
    apn_dhcp_gateway_addr: 10.27.1.1
    apn_authentication_server_group: abc
    apn_accounting_server_group: abc1
    apn_username:  apn_password:
    subscribe_required: No
    deactivate_pdp_context_on violation: Yes
    Block Foreign-MS Mode: Disable
    VPN: Disable  (VRF Name : None) 
    GPRS vaccess interface: Virtual-Access2
    RADIUS attribute suppress MSISDN: Disabled
    RADIUS attribute suppress IMSI: Disabled
    RADIUS attribute suppress SGSN Address: Disabled
    RADIUS attribute suppress QoS: Disabled
    number of ip_address_allocated 0
    session timeout: 0
    idle timeout: 0
    Security features
     Verify mobile source addr: enable
     Verify mobile destination addr: enable

    Traffic redirection:
     Mobile-to-mobile: destination 1.1.1.1

    Total number of PDP in this APN :0

    aggregate:
    In APN:    Disable

    In Global: Disable

    primary dns: 0.0.0.0
    secondary dns: 0.0.0.0
    primary nbns: 0.0.0.0
    secondary nbns: 0.0.0.0
    Service Mode: Operational
    cac policy: p1
    input bandwidth pool: pool1
    output bandwidth pool: pool2
    input service-policy: pdp-class-pdp
    single pdp-session: Mandatory

    P-CSCF group name: GroupA
    IPV6 enable
    Delete PDP upon update failure
    IPV6 base vtemplate : 10
    IPv6 uplink access list: NONE
    IPV6 downlink access list : NONE
    IPV6 dynamic_address_pool : local
    IPV6 local prefix pool : localv6
    IPV6 primary dns : 2001:1:2:3::123
    IPV6 secondary dns: 3001:1:2:3::123

    DHCP address release sent by GGSN    0

Table 7 describes the fields show in the example.

Table 7 show gprs access-point Field Descriptions 

Field
Description

apn_index

Number assigned to the access point.

apn_name

Access point name.

apn_mode

Current setting for the access-mode command:

Transparent—Users are allowed access without authorization or authentication.

Non-transparent—Users must be authenticated by the GGSN acting as a proxy for the authentication.

apn-type

Current setting for the access-type command:

Real—APN type that corresponds to a physical interface to an external network on the GGSN.

Virtual—APN type that is not associated with any specific physical target network.

Virtual pre-authenticate—Pre-authentication-based APN type that uses AAA-based user profiles to return the target APN to which the Create PDP Context request is next routed.

charging service mode

Indicates whether the charging functions of a GGSN are in operational or maintenance mode.

Delete PDP upon update failure

Current setting for the gtp update qos-fail delete command:

Enabled—The GGSN deletes a PDP context if a GGSN-initiated QoS update fails.

Disabled—The GGSN does not delete a PDP context if a GGSN-initiated QoS update fails.

accounting

Current status of accounting services at the APN:

Enable—Accounting services are enabled at the APN. This is the default for non-transparent access APNs.

Disable—Accounting services are disabled at the APN. This is the default for transparent access APNs.

You can configure an APN for accounting services by using the aaa-accounting command in access point configuration mode.

interim accounting

Indicates whether the ability to send interim accounting records to an accounting server after a routing area update or QoS change has been made is configured by using the aaa-accounting interim update command. The possible values are enabled or disabled.

interim periodic

Indicates the time interval at which the periodic accounting records are sent by the GGSN. The possible values are Disabled' and Enabled (with periodic interval value in minutes) or Enabled with (use Attribute 85).

wait_accounting

Current status of RADIUS accounting response message waiting at the APN:

Enable—GGSN waits for an accounting response message from the RADIUS server before sending an Activate PDP Context request to the SGSN.

Disable—GGSN sends an Activate PDP Context request to the SGSN after sending an accounting request to the RADIUS server. The GGSN does not wait for a RADIUS accounting response.

You can configure RADIUS accounting response message waiting by using the gprs gtp response-message wait-accounting command in global configuration mode, or the response-message wait-accounting command in access point configuration mode.

input ACL

IP access list for inbound packets (Gi to Gn interfaces).

output ACL

IP access list for outbound packets (Gn to Gi interfaces).

dynamic_address_pool

Current setting for the ip-address-pool command.

apn_dhcp_server

IP address of the DHCP server, if configured.

backup

IP address of the backup DHCP server, if configured.

apn_dhcp_gateway_addr

IP address of the DHCP gateway, if an address has been configured.

apn_authentication_server_group

Name of the AAA server group that is providing authentication services.

apn_accounting_server_group

Name of the AAA server group that is providing accounting services.

apn_username

Username specified in the anonymous user command. If the anonymous user command is not configured, this field will be blank.

apn_password

Password specified in the anonymous user command. If the anonymous user command is not configured, this field will be blank.

subscribe_required

Current setting for the subscription-required command:

No—No subscription is required.

Yes—Subscription is required for access point users. The GGSN looks for the "subscription verified" selection mode in the Create PDP Context request to establish the session.

deactivate_pdp_context_on violation

Current setting for the access-violation command:

No—User packets are discarded.

Yes—Mobile sessions are terminated when there is an access violation.

Block Foreign-MS Mode

Current setting for the block-foreign-ms command:

Enable—Blocking for foreign MSs is configured.

Disable—Blocking for foreign MSs is not configured.

VPN

Indicates whether a Virtual Private Network (VPN) is enabled or disabled at the access point.

Note VRF is not supported for IPv6 PDPs. Therefore, if the ipv6 command is configured on an APN on which VRF is enabled, the IPv4 PDPs are routed in VRF, but the IPv6 PDPs are routed in the global routing table.

GPRS vaccess interface

Name of the virtual access interface associated with the VPN.

If no VPN is configured at the access point, the name of the virtual access interface for the GGSN virtual template is shown, which is always Virtual-Access1.

RADIUS attribute suppress MSISDN

Current setting for the msisdn suppression command:

Enabled—GGSN overrides or suppresses the Mobile Subscriber ISDN (MSISDN) number in its RADIUS authentication.

Disabled—GGSN does not override or suppress the MSISDN number in its RADIUS authentication.

RADIUS attribute suppress IMSI

Current setting for the radius attribute suppress imsi command:

Enabled—GGSN suppresses the 3GPP-IMSI number in its authentication and accounting requests to a RADIUS server.

Disabled—GGSN does not suppress the 3GPP-IMSI number in its authentication and accounting requests to a RADIUS server.

RADIUS attribute suppress SGSN Address

Current setting for the radius attribute suppress sgsn-address command:

Enabled—GGSN suppresses the 3rd Generation Partnership Program (3GPP) Vendor-Specific Attribute (VSA) 3GPP-SGSN-Address subattribute in its RADIUS authentication and accounting requests.

Disabled—GGSN does not suppress the 3GPP VSA 3GPP-SGSN-Address subattribute in its RADIUS authentication and accounting requests.

RADIUS attribute suppress QoS

Current setting for the radius attribute suppress qos command:

Enabled—GGSN suppresses the 3GPP VSA 3GPP-QoS-Profile subattribute in its RADIUS authentication and accounting requests.

Disabled—GGSN does not suppress the 3GPP VSA 3GPP-QoS-Profile subattribute in its RADIUS authentication and accounting requests.

number of ip_address_allocated

Number of IP addresses allocated to MS users.

session timeout

Amount of time that the GGSN waits before purging mobile sessions for the access point configured by using the gtp pdp-context timeout session command in access point configuration mode.

idle_timeout

Number of seconds the GGSN allows a PDP context to be idle before terminating the context as configured by using the gprs gtp pdp-context timeout idle global configuration command.

Verify mobile source addr

Current setting for the security verify source command:

Enabled—GGSN verifies the source IP address of upstream Transport Protocol Data Unit (TPDUs) against addresses previously assigned to MSs.

Disabled—GGSN does not verify the source IP address of upstream TPDUs against addresses previously assigned to MSs.

Verify mobile destination addr

Current setting for the security verify destination command:

Enabled—GGSN verifies the destination address of upstream TPDUs against the global list of Public Land Mobile Network (PLMN) addresses specified using the gprs plmn ip address command.

Disabled—GGSN does not verify the destination address of upstream TPDUs against the global list of PLMN addresses specified using the gprs plmn ip address command.

Mobile-to-Mobile

Current setting for the redirect intermobile ip command.

Total number of PDP in this APN

Number of active PDP contexts for this access point.

aggregate

Route aggregation configuration information on the GGSN.

The output display includes the "In APN" field for configuration information for the access point, and the "In global" field for global configuration on the GGSN.

The output field may contain the following information:

IP network address and mask for which PDP requests on the access point will be collectively routed over the virtual template interface on the GGSN. IP address and mask information appears if an aggregate range has been configured on the GGSN.

auto—Indicates that the GGSN uses the allocated IP mask from the DHCP (IPv4 PDPs) or RADIUS server to perform route aggregation on the APN. The keyword auto appears when the APN has been configured with the aggregate auto command in access point configuration mode. This value applies only to the APN.

Disable—Indicates that route aggregation is not configured at either the APN or global level.

primary dns

IP address of the primary DNS to be sent in Create PDP Context responses at the access point.

secondary dns

IP address of the secondary (backup) DNS to be sent in Create PDP Context responses at the access point

primary nbns

IP address of the primary NetBIOS Name Service (NBNS) to be sent in Create PDP Context responses at the access point.

secondary nbns

IP address of the secondary (backup) NBNS to be sent in Create PDP Context response at the access point.

Service Mode

Indicates whether a GGSN is in operational mode or maintenance mode.

cac policy

Name of the CAC maximum QoS policy applied to the APN, if any.

input bandwidth pool

Name of the bandwidth pool, if any, applied to the output (Gn) interface in the downlink direction.

output bandwidth pool

Name of the bandwidth pool, if any, applied to the output (Gi) interface in the uplink direction.

input service-policy

Service policy attached to the APN using the service-policy access point configuration command.

single pdp-session

Whether the GGSN has been configured to delete the primary PDP context, and any associated secondary PDP contexts, of a hanging PDP session upon receiving a new Create PDP Context request from the same MS that shares the same IP address of the hanging PDP context.

Possible values are:

Enabled—The feature is enabled on the APN and applies to all users for whom the "gtp-pdp-session=single-session" Cisco VSA has been defined in their RADIUS user profile.

Disabled—The feature is disabled on the access point and does not apply to any user regardless of the RADIUS user profile configuration.

Mandatory—The feature is enabled on the APN and applies to all users on that APN regardless of the RADIUS user profile configuration.

P-CSCF group name

Name of the P-CSCF server group(s) used by this APN for P-CSCF Discovery.

IPV6 enable

Current setting for the ipv6 command:

Enabled—Access point is configured to allow both IPv4 and IPv6 PDP contexts.

Exclusive—Access point is configured to allow only IPv6 PDP contexts.

IPV6 base template

Virtual template interface, which contains IPv6 routing advertisements (RAs) parameters, for an APN to copy to create virtual subinterfaces for IPv6 PDP contexts.

IPV6 uplink access list

IPv6 access list for inbound packets.

IPV6 downlink access list

IPv6 access list for outbound packets.

IPV6 dynamic_address_pool

Current setting for the ipv6 ipv6-address-pool command.

IPV6 local prefix pool

Local IPv6 prefix pool.

IPV6 primary dns

IPv6 address of the primary IPv6 DNS to be sent in Create PDP Context responses at the access point.

IPV6 secondary dns

IPv6 address of the secondary (backup) IPv6 DNS to be sent in Create PDP Context responses at the access point

VRF name

Name assigned to the VPN Routing and Forwarding instance. A value of None appears when VRF is not enabled at the access point.


Example 2

The following is sample output from the show gprs access-point address-allocation command:

router# show gprs access-point 8 address-allocation

TID                     PDP_ADDRESS

1111111100000099        10.88.105.227   
1111111100000191        10.88.105.7     
1111111100000192        10.88.105.70    
1111111100000297        10.88.106.162   
1111111100000298        10.88.106.169   
1111111100000299        10.88.106.161   
1111111100000391        10.88.106.150   
1111111100000392        10.88.106.25    
1111111100000442        10.88.106.196   
1111111100000443        10.88.106.197   
1111111100000886        10.88.108.153   
1111111100000887        10.88.108.158   
2222222200000000        10.88.111.255 

Table 8 describes the fields show in the display.

Table 8 show gprs access-point address-allocation Field Descriptions

Field
Description

TID

Tunnel ID for the Create PDP Context request on the APN.

PDP_ADDRESS

IP address assigned to the Create PDP Context request on the APN.


Example 3

The following is sample output of the show gprs access-point all command:

router# show gprs access-point all

There are 3 Access-Points configured

Index   Mode            Access-type    AccessPointName      VRF Name
-----------------------------------------------------------------------
1       transparent        Real        corporate_1.com       corporate_1.com
        ppp-regeneration (max-session: 10000, setup-time: 60)
-----------------------------------------------------------------------
2       non-transparent    Real        corporate_2.com       
-----------------------------------------------------------------------
3       transparent        Virtual     corporate_3.com       
-----------------------------------------------------------------------

Table 9 describes the fields show in the display.

Table 9 show gprs access-point all Field Descriptions 

Field
Description

Index

Integer assigned to the access point in the GGSN configuration. The index number is used to reference an APN in GGSN commands.

Mode

Authorization configured on the access point. The possible values are:

transparent—Users who access the PDN through the access point associated with the current virtual template are allowed access without authorization or authentication.

non-transparent—Users who access the PDN through the current virtual template must be authenticated by the GGSN acting as a proxy for the authentication.

Access-type

Type of access point. The possible values are:

Real—APN type that corresponds to an external physical network on the GGSN. This is the default value.

Virtual—APN type that is not associated with any specific physical target network on the GGSN. Virtual APNs are used to simply HLR provisioning in the PLMN.

AccessPointName

Access point network ID, which is commonly an Internet domain name.

VRF Name

Name of the VPN routing and forwarding instance associated with the APN.

ppp-regeneration (max-session, setup-time)

PPP regeneration session parameters configured at the access point:

max-session—Maximum number of PPP regenerated sessions allowed at the access point.

setup-time—Maximum amount of time (between 1 and 65535 seconds) within which a PPP regenerated session must be established.


Related Commands

Command
Description

access-point

Specifies an access point number and enters access point configuration mode.


show gprs access-point statistics

To display data volume and packet data protocol (PDP) activation and deactivation statistics for access points on the gateway GPRS support node (GGSN), use the show gprs access-point statistics command in privileged EXEC mode.

To display data volume and PDP activation and deactivation statistics for access points on the gateway GPRS support node (GGSN), use the show gprs access-point statistics command in privileged EXEC mode.

show gprs access-point statistics {access-point-index | all}

Syntax Description

access-point-index

Index number of an access point. Statistics for that access point are shown.

all

Statistics for all access points on the GGSN are shown.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(4)MX

This command was introduced.

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD.

12.2(8)YW

This command was integrated into Cisco IOS Release 12.2(8)YW.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU and the following new output fields were added:

DHCP address requests sent by GGSN

DHCP address requests successful

DHCP address release sent by GGSN

downstream packet count

upstream packet count

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.

12.4(9)XG

This command was integrated into Cisco IOS Release 12.4(9)XG and the following IPv6-related fields were added to the show gprs access-point statistics access-point-index command display:

ms init ipv6 pdp activation

successful ms init ipv6 pdp activation

dynamic ipv6 PDP activation

successful dynamic ipv6 activation

ms init ipv6 pdp deactivation

successful ms init ipv6 pdp deactivation

ggsn init ipv6 pdp deactivation

successful ggsn init ipv6 pdp deactivation

network init ipv6 pdp deactivation

successful network init ipv6 pdp deactivation

upstream ipv6 data bytes

upstream ipv6 data pak

downstream ipv6 data bytes

downstream ipv6 pak

12.4(15)XQ

This command was integrated into Cisco IOS Relesae 12.4(15)XQ and the following fields were added to the display:

PDP update initiated by GGSN

Successful PDP update initiated by GGSN

Total number of successful COA requests

Number of times direct tunnel enabled


Usage Guidelines

Use the show gprs access-point statistics command to display data volume and PDP activation and deactivation statistics for access points on the GGSN.

Use the access-point-index argument to specify a particular access point number for which you want to obtain information.

Use the all keyword to obtain information about all access points in an abbreviated format.

Examples

The following example displays PDP context activation and deactivation statistics for all access points on the GGSN:

router# show gprs access-point statistics 3
   PDP activation initiated by MS:                         11
   PDP update initiated by GGSN                             0
   Successful PDP update initiated by GGSN                  0
   Successful PDP activation initiated by MS:               8
   *Dynamic PDP activation initiated by MS:                11
   Successful dynamic activation initiated by MS:           8
   PDP deactivation initiated by MS:                        0
   Successful PDP deactivation initiated by MS:             0
   Network initiated PDP activation:                        0
   Successful network initiated PDP activation:             0
   PDP deactivation initiated by GGSN:                      4
   Successful PDP deactivation initiated by GGSN:           3
   upstream data volume in octets:                          0
   *downstream data volume in octets:                       0
   upstream packet count:                                   0
   downstream packet count:                                 0
   *DHCP address requests sent by GGSN:                     0
   *DHCP address requests successful:                       0
   *DHCP address release sent by GGSN:                      0

   ms init ipv6 pdp activation                             11
   successful ms init ipv6 pdp activation                   8
   dynamic ipv6 pdp activation                             11
   successful dynamic v6 pdp activation                     8
   ms init ipv6 pdp deactivation                            0
   successful ms init v6 pdp deactivation                   0
   ggsn init ipv6 pdp deactivation                          4
   successful ggsn init v6 pdp deactivation                 3
   network init ipv6 pdp deactivation                       0
   successful network init ipv6 pdp deactivation            0

   upstream ipv6 data bytes                               192
   upstream ipv6 data pak                                   3
   downstream ipv6 data bytes                            3552
   downstream ipv6 data pak                                48

   Total number of successful COA requests                  0
   Number of times direct tunnel enabled                    0

Table 10 show gprs access-point statistics Field Descriptions 

Field
Description

active PDP

Number of IPv4 PDP contexts that are currently established on the GGSN.

downstream data volume in octets

Number of bytes of data received by the GGSN from the PDN, or network.

downstream packet count

Downstream traffic byte counts.

DHCP address release sent by GGSN

Number of DHCP release packets sent by a DHCP server to the GGSN.

DHCP address requests sent by GGSN

Number of DHCP request packets sent to a DHCP server by the GGSN.

DHCP address requests successful

Number of DHCP requests that were successful.

Dest addr violation

Number of IPv4 packets (and bytes) dropped by the GGSN because of a source address violation. This field displays only when the security verify destination command is configured.

This field does not apply to APNs using VRF. In addition, verification of destination addresses does not apply to GTP-PPP regeneration or GTP-PPP with L2TP.

Dynamic PDP activation initiated by MS

Number of Create PDP Context Request messages received by the GGSN from an MS without a PDP address. (Duplicate requests are not counted.)

downstream ipv6 data bytes

Number of bytes of IPv6 data received by the GGSN from the PDN, or network.

downstream ipv6 pak

Downstream IPv6 traffic byte counts.

dynamic ipv6 PDP activation

Number of IPv6 Create PDP Context requests received by the GGSN from an MS requesting dynamic IPv6 address allocation.

ggsn init ipv6 pdp deactivation

Number of IPv6 PDP context deactivation requests initiated by the GGSN.

upstream ipv6 data bytes

Number of bytes of IPv6 data received by the GGSN from the SGSN.

upstream ipv6 data pak

Upstream IPv6 traffic byte counts.

ms init ipv6 pdp activation

Number of IPv6 Create PDP Context requests received by the GGSN that were initiated by the MS.

ms init ipv6 pdp deactivation

Number of IPv6 Delete PDP Context requests received by the GGSN that were initiated by the MS.

Number of times direct tunnel enabled

Number of direct tunnel PDPs established.

network init ipv6 pdp deactivation

Number of IPv6 Create PDP Context Request messages received by the GGSN that were network-initiated.

successful dynamic ipv6 activation

Number of successful IPv6 PDP context creations initiated by mobile user that used dynamic ipv6 address allocation.

successful ggsn init ipv6 pdp deactivation

Number of IPv6 PDP contexts that were successfully deactivated by a GGSN-initiated request.

successful ms init ipv6 pdp activation

Number of successful IPv6 PDP context creations initiated by a SGSN-initiated request.

successful ms init ipv6 pdp deactivation

Number of IPv6 PDP contexts that were successfully deactivated by a SGSN-initiated request.

successful network init ipv6 pdp activation

Number of IPv6 PDP contexts that were successfully activated by a network-initiated request.

successful network init ipv6 pdp deactivation

Number of IPv6 PDP contexts that were successfully deactivated by a network-initiated request.

Network initiated PDP activation

Number of Create PDP Context Request messages received by the GGSN from network initiation.

PDP activation initiated by MS

Number of Create PDP Context Request messages received by the GGSN from an SGSN. (Duplicate requests are not counted.)

PDP deactivation initiated by GGSN

Number of Delete PDP Context Request messages sent by the GGSN to an SGSN.

PDP deactivation initiated by MS

Number of Delete PDP Context Request messages received by the GGSN from an SGSN. (Duplicate messages are not counted.)

PDP update initiated by GGSN

Number of Update PDP Context Requests that were initiated by the GGSN.

ppp-regeneration (max-session, setup-time)

PPP regeneration session parameters configured at the access point:

max-session—Maximum number of PPP regenerated sessions allowed at the access point.

setup-time—Maximum amount of time (between 1 and 65535 seconds) within which a PPP regenerated session must be established.

Redirected mobile-to-mobile traffic

Number of IPv4 packets (and bytes) dropped at the APN from which they exit because mobile-to-mobile traffic has been redirected. This field displays only when the redirect intermobile ip command is configured.

Src addr violation

Number of IPv4 packets (and bytes) dropped because of source address violation. This field displays only when the security verify source command is configured.

Successful dynamic activation initiated by MS

Number of Create PDP Context Response messages sent by the GGSN with a cause value of "GTP_RES_REQACCEPTED", indicating that the PDP address has been dynamically assigned.

Successful network initiated PDP activation

Number of PDP contexts activated on the GGSN that were initiated by the network.

Successful PDP activation initiated by MS

Number of Create PDP Context Response messages sent by the GGSN with a cause value of "GTP_RES_REQACCEPTED."

Successful PDP deactivation initiated by GGSN

Number of Delete PDP Context Response messages received by the GGSN from an SGSN.

Successful PDP deactivation initiated by MS

Number of Delete PDP Context Response messages sent by the GGSN to an SGSN with a cause value of "GTP_RES_REQACCEPTED".

Successful PDP update initiated by GGSN

Number of Update PDP Context Requests initiated by the GGSN that were successful.

Total number of successful CoA requests

Number of CoA requests, containing new QoS, that were successful.

upstream data volume in octets

Number of bytes of data received by the GGSN from the SGSN.

upstream packet count

Upstream traffic byte counts.


Related Commands

Command
Description

clear gprs access-point statistics

Clears statistics counters for a specific access point or for all access points on the GGSN.

show gprs access-point

Displays information about access points on the GGSN.


show gprs access-point throughput statistics

To display throughput statistics for access points on a gateway GPRS support node (GGSN), use the show gprs access-point throughput statistics command in privileged EXEC mode.

show gprs access-point throughput statistics {access-point-index | all}

Syntax Description

access-point-index

Index number of an access point. Statistics for that access point are shown.

all

Statistics for all access points on the GGSN are shown.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(8)XU

This command was introduced.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs access-point throughput statistics command to display throughput statistics for access points on the GGSN.

Use the access-point-index argument to specify a particular access point number for which you want to obtain information.

Use the all keyword to obtain information about all access points in an abbreviated format.

Examples

The following example displays throughput statistics for access point 1:

GGSN# show gprs access-point throughput statistics 1

Collection interval - 1 min, Last collected at - 1 min back
    upstream data volume in octets:     0
    downstream data volume in octets:   0
    upstream packet count:              0
    downstream packet count:            0
  Collection interval - 2 min, Last collected at - 2 min back
    upstream data volume in octets:     0
    downstream data volume in octets:   0
    upstream packet count:              0
    downstream packet count:            0

Related Commands

Command
Description

clear gprs access-point statistics

Clears statistics counters for a specific access point or for all access points on the GGSN.

gprs throughput interval

Configures the interval at which the GGSN collects throughput data for APNs.

show gprs access-point

Displays information about access points on the GGSN.


show gprs bandwidth-pool status

To display a list of configured CAC bandwidth pools, along with their status, use the show gprs bandwidth-pool status command in privileged EXEC mode.

show gprs bandwidth-pool status pool-name

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(8)XU

This command was introduced.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs bandwidth-pool status command to display a list of configured bandwidth pools and their status.

Examples

The following is sample output of the show gprs bandwidth-pool status command:

GGSN#show gprs bandwith-pool status bwpool1

BW Name:bwpool1
Total BW:1000000
Available BW:0
=====================================================================
conversational                 Total BW:400000      Available BW:400000
streaming                      Total BW:300000      Available BW:300000
interactive                    Total BW:200000      Available BW:200000
background                     Total BW:100000      Available BW:100000

Table 8 describes the fields shown in the display.

Table 11 show gprs bandwidth-pool status Field Descriptions 

Field
Description

BW Name

Name of the bandwidth pool as defined using the gprs bandwidth-pool global configuration command and each sub traffic class -based pools defined using the traffic-class bandwidth pool configuration command.

Total BW

Total amount of bandwidth, in kilobits per second, allocated to a bandwidth pool using the bandwidth bandwidth pool configuration command. Also, the total bandwidth allocated to a sub traffic class-based pool, defined as a percentage or absolute value using the traffic-class bandwidth pool configuration command.

Available BW

Remaining amount of bandwidth, in kilobits per second, for a bandwidth pool and the remaining available bandwidth (in percentage or absolute value) for each sub traffic class-based pool.

conversational

Amount of the bandwidth pool bandwidth, in kilobits per second or as a percentage, allocated to the Conversational traffic class and the bandwidth currently available.

streaming

Amount of the bandwidth pool bandwidth, in kilobits per second or as a percentage, allocated to the Streaming traffic class and the bandwidth currently available.

interactive

Amount of the bandwidth pool bandwidth, in kilobits per second or as a percentage, allocated to the Interactive traffic class and the bandwidth currently available.

background

Amount of the bandwidth pool bandwidth, in kilobits per second or as a percentage, allocated to the Background traffic class and the bandwidth currently available.


Related Commands

Command
Description

bandwidth

Defines the total bandwidth, in kilobits per second, for a bandwidth pool.

bandwidth-pool

Applies a bandwidth pool to an APN.

gprs qos bandwidth-pool

Creates or modifies a bandwidth pool.

traffic-class

Allocates bandwidth pool bandwidth to a specific traffic class.


show gprs charging parameters

To display information about the current gateway GPRS support note (GGSN) charging configuration, use the show gprs charging parameters command in privileged EXEC mode.

show gprs charging parameters

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX.

The following output fields were added to the display:

Charging CDR Option Local Record Sequence Number

Charging CDR Option No Partial CDR Generation

Charging CDR Option Node ID

Charging CDR Option Packet Count

Charging Change Condition Limit

Charging Send Buffer Size

Charging GTP' Port Number

Charging MCC Code

Charging MNC Code

Charging Roamers CDR Only

Charging HPLMN Matching Criteria

Charging SGSN Limit

The following output fields were removed from the display:

Charging MCC Code

Charging MNC Code

Charging HPLMN Matching Criteria

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD.

12.2(8)YW

This command was integrated into the Cisco IOS Release 12.2(8)YW.

The Charging Path Protocol field was changed from binary 0 and 1 to udp and tcp.

The Charging qos-info output field was changed to Charging release.

The following output fields were added to the display:

Charging Time Limit

Charging qos-info

Charging Transfer Format.

GTP' use short header

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU and the following fields were added to the display:

Access Point Name

ChCh Selection Mode

Default Tertiary Charging Gateway Address

Dynamic Address

External Charging ID

PDP Type

Served PDP Address

Service Mode

SGSN PLMN ID

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into the Cisco IOS Release 12.3(14)YU and the following fields were added to the display:

Access Point Name Virtual

Camel Charging Info

IMEISV

MS Time Zone

Radio Access Technology

User Location Information

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.

12.4(9)XG

This command was integrated into Cisco IOS Release 12.4(9)XG.

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ and the following fields were added to the display:

GGSN's iSCSI profile

Charging Source Interface


Usage Guidelines

Use the show gprs charging parameters command to display the currently active charging parameters for the GGSN.

Examples

The following is sample output of the show gprs charging parameters command:

Router# show gprs charging parameters

GPRS Charging Protocol Parameters
        =================================

* Default Charging Gateway Address:             <172.17.1.2>
* Default Backup Charging Gateway Address:      UNDEFINED.
* Default Tertiary Charging Gateway Address:UNDEFINED.
* Backup data store (PSD) Address:          UNDEFINED
* Retrieve only data store (PSD) Address    UNDEFINED
* GGSN's iSCSI profile:                     TARGET_LINUX
* Current Active Charging Gateway Address:  <172.17.1.2>
* Current Backup Charging Gateway Address:  UNDEFINED.
* Charging Server Switch-Over Timer:        <60> seconds.
* Charging Path Protocol:                   udp
* GTP' use short header:                    DISABLED
* Charging Message Options:
   Transfer Request:
 - Packet Transfer Command IE:              DISABLED.
   Transfer Response:
 - Number Responded:                        DISABLED.
* Charging MAP DATA TOS:                    <3>
* Charging Transfer Interval:               <105> seconds.
* Charging Transfer Threshold:              <1048576> bytes.
* Charging CDR Aggregation Limit:           <255> CDRs per msg.
* Charging Packet Queue Size:               <128> messages.
* Charging Gateway Path Request Timer:      <0> Minutes.
* Charging Change Condition Limit:          <5>
* Charging SGSN Limit:                      DISABLED.
* Charging Time Limit:                      <0>
* Charging Send Buffer Size:                <1460>
* Charging Port Number:                     <3386>
* Charging Roamers CDR Only:                DISABLED.
* Charging CDR Option:
- Local Record Sequence Number:             DISABLED.
 - APN Selection Mode:                      DISABLED.
 - ChCh Selection Mode:                     DISABLED.
 - Radio Access Type - RAT:                 DISABLED.
 - User Location Information:               ENABLED.
 - MS Time Zone:                            ENABLED.
 - IMEISV:                                  DISABLED.
 - CAMEL Charging Info:                     ENABLED.
 - SGSN PLMN ID:                            DISABLED.
 - Dynamic Address:                         ENABLED.
 - Served PDP Address:                      ENABLED.
 - PDP Type:                                ENABLED.
 - Access Point Name:                       ENABLED.
 - Network Initiated PDP:                   ENABLED.
 - No Partial CDR Generation:               DISABLED.
 - Node ID:                                 DISABLED.
 - Packet Count:                            DISABLED.
 - Served MSISDN:                           DISABLED.
 - Private Echo:                            DISABLED.
* Charging release:                         5
* Charging Tariff Time Changes:
- NO Tariff Time Changes
* Charging Service Mode:                    OPERATIONAL
* Charging Source Interface                 loopbackX
* Backup data store (PSD) Address:          172.28.28.28
* Retrieve only data store (PSD) Address    192.13.13.13

Table 12 describes the fields shown in the display.

Table 12 show gprs charging parameters Field Descriptions 

Field
Description

Backup data store (PSD) Address

IP address of the local Persistent Storage Device (PSD) to which G-CDRs are backed up if a charging gateway is unavailable.

Charging CDR Aggregation Limit

Maximum number of CDRs that the GGSN aggregates in a charging data transfer message to the charging gateway.

You can configure this limit using the gprs charging cdr-aggregation-limit command.

Charging CDR Option: Access Point Name


Charging CDR Option: Access Point Name Virtual

Status indicating if the GGSN provides the APN or virtual APN parameter in G-CDRs. Possible values are enabled or disabled.

You can enable the GGSN to provide the APN or virtual PAN parameter in G-CDRs using the gprs charging cdr-option apn and gprs charging cdr-option apn virtual commands.

Charging CDR Option: APN Selection Mode

Status indicating if the GGSN provides the reason code for APN selection in G-CDRs. The possible values are enabled or disabled.

You can enable the GGSN to provide the APN selection mode in G-CDRs using the gprs charging cdr-option apn-selection-mode command.

Charging CDR Option: CAMEL Charging Info

Status indicating if the GGSN includes a copy of the tag and length of the Customized Application for Mobile Enhanced Logic (CAMEL) from the S-CDR in G-CDRs.

You can enable the GGSN to include a copy of the tag and length of the CAMEL in G-CDRs using the gprs charging cdr-option camel-charge-info command.

Charging CDR Option: ChCh Selection Mode

Status indicating if the GGSN includes the charging characteristics selection mode parameter in G-CDRs. Possible values are enabled or disabled.

Charging CDR Option: Dynamic Address

Status indicating if the GGSN includes the dynamic address flag parameter in G-CDRs. Possible values are enabled or disabled.

You can enable the GGSN to provide the APN parameter in G-CDRs using the gprs charging cdr-option dynamic-address command.

Charging CDR Option: IMEISV

Status indicating if the GGSN includes the International Mobile Equipment Identity IMEI software version (IMEISIV) in G-CDRs.

You can enable the GGSN to include the IMEISIV IE in G-CDRs using the gprs charging cdr-option imeisv command.

Charging CDR Option: Local Record Sequence Number

Status indicating if the GGSN uses the local record sequence field in G-CDRs. The possible values are enabled or disabled.

You can enable the GGSN to use the local record sequence field in G-CDRs using the gprs charging cdr-option local-record-sequence-number command.

Charging CDR Option: MS Time Zone

Status indicating if the GGSN includes the MS time zone (MSTZ) in G-CDRs.

You can enable the GGSN to provide MSTZ in G-CDRs using the gprs charging cdr-option ms-time-zone command.

Charging CDR Option: Network Initiated PDP

Status indicating if the GGSN includes the NIP parameter in G-CDRs. The possible values are enabled or disabled.

You can enable the GGSN to use the local record sequence field in G-CDRs using the gprs charging cdr-option nip command.

Charging CDR Option: No Partial CDR Generation

Status indicating if the GGSN can create partial CDRs. The possible values are enabled or disabled.

You can disable partial CDR generation by the GGSN using the gprs charging cdr-option no-partial-cdr-generation command.

Charging CDR Option: Node ID

Status indicating if the GGSN specifies the name of the node that generated the CDR in the node ID field of the G-CDR. The possible values are enabled or disabled.

You can enable the GGSN to use the node ID field in G-CDRs using the gprs charging cdr-option node-id command.

Charging CDR Option: Packet Count

Status indicating if the GGSN provides uplink and downlink packet counts in the optional record extension field of a G-CDR. The possible values are ON or OFF.

You can enable the GGSN to provide packet counts using the gprs charging cdr-option packet-count command.

Charging CDR Option: PDP Type

Status indicating if the GGSN includes the PDP type parameter in G-CDRs. The possible values are enabled or disabled.

You can enable the GGSN to provide packet counts using the gprs charging cdr-option pdp-type command.

Charging CDR Option: Private Echo

Status indicating if the GGSN uses private echo signaling for flow control. The possible values are enabled or disabled.

You can enable private echo signaling using the gprs charging flow-control private-echo command.

Charging CDR Option: Radio Access Type-RAT

Status indicating if the GGSN includes the radio access technology (RAT) IE in G-CDRs.

You can enable the GGSN to provide the RAT IE in G-CDRs using the gprs charging cdr-option rat-type command.

Charging CDR Option: Served MSISDN

Status indicating if the GGSN provides the mobile station integrated services digital network number from the Create PDP Context request in a G-CDR. The possible values are enabled or disabled.

You can enable the GGSN to provide the MSISDN number using the gprs charging cdr-option served-msisdn command.

Charging CDR Option: Served PDP Address

Status indicating if the GGSN provides the PDP address from the Create PDP Context request in a G-CDR. Possible values are enabled or disabled.

You can enable this feature using the gprs charging cdr-option pdp-address command.

Charging CDR Option: SGSN PLMN ID

Status indicating if the GGSN includes the SGSN PLMN identifier in G-CDRs. The possible values are enabled or disabled.

You can enable the GGSN to include the SGSN PLMN identifier using the gprs charging cdr-option sgsn-plmn command.

Charging CDR Option: User Location Information

Status indicating if the GGSN includes the user location information (ULI) IE in G-CDRs.

You can configure the GGSN to include the ULI IE in G-CDRs using the gprs charging cdr-option user-loc-info command.

Charging Change Condition Limit

Maximum number of charging containers in each G-CDR.

You can configure the change condition limit using the gprs charging container change-limit command.

Charging Gateway Path Request Timer

Number of minutes that the GGSN waits before trying to establish the TCP path to the charging gateway when TCP is the specified path protocol.

You can configure the path request timer using the gprs charging cg-path-requests command.

Charging Gateway Priority Switchover

Whether or not the GGSN switches over to a charging gateway of higher priority when that gateway becomes active.

The possible values are ENABLED (the GGSN switches over to a charging gateway of higher priority when that gateway becomes active) or DISABLED (the GGSN does not switch over to gateways of higher priority when such a gateway becomes active).

You can enable the GGSN to switch over to a higher priority charging gateway using the gprs charging switchover priority command.

Charging MAP DATA TOS

Type of service (ToS) priority currently configured for GGSN charging packets. Value (between 0 and 5) is set in the precedence bits of the IP header of charging packets.

You can configure the ToS mapping using the gprs charging map data tos command.

Charging Message Options: Number Responded

Status indicating if the GGSN uses the Number of Requests Responded field instead of the Length field in the Requests Responded IE of Data Record Transfer Response messages. The possible values are enabled or disabled.

You can enable the GGSN to use the Number of Requests Responded field using the gprs charging message transfer-response number-responded command.

Charging Message Options: Packet Transfer Command IE

Status indicating if the GGSN includes the Packet Transfer Command IE in the Data Record Transfer Request messages. The possible values are enabled or disabled.

You can enable the GGSN to include the Packet Transfer Command IE in the Data Record Transfer Request messages using the gprs charging message transfer-request command-ie command.

Charging Message Options: Send Possibly Duplicated CDR

Status indicating if the GGSN retransmits Data Record Transfer Request messages (sent to a previously active charging gateway) with the value of the Packet Transfer Request IE set to Send Possibly Duplicate Data Record Packet (2). The possible values are enabled or disabled.

To configure the GGSN to retransmit Data Record Transfer Request messages with the value of the Packet Transfer Request IE set to 2, use the gprs charging message transfer-request possibly-duplicate command.

Charging Message Options: Transfer Request

Whether the GGSN includes the Packet Transfer Command IE in the Data Record Transfer Response messages.

The possible values are ENABLED (the GGSN includes the Packet Transfer Command IE) or DISABLED (the GGSN does not include the IE).

Charging Messages Options: Transfer Response

Whether the GGSN is using the Number of Requests Responded field instead or the Length field in the Requests Responded IE of Data Record Transfer Response messages.

The possible values are ENABLED (the GGSN uses the Number of Requests Responded field) or DISABLED (the GGSN uses the Length field).

Charging Packet Queue Size

Maximum number of unacknowledged charging data transfer requests that the GGSN maintains in its queue.

You can configure the maximum queue size using the gprs charging packet-queue-size command.

Charging Path Protocol

Protocol in use between the GGSN and the charging gateway. The possible values are udp or tcp.

You can configure the charging path protocol using the gprs charging path-protocol command.

Charging Port Number

Destination port of the charging gateway.

You can configure the destination port using the gprs charging port command.

Charging release

Charging release with which the GGSN is to comply when presenting G-CDRs. Possible values are 98, 99, 4, or 5.

You can configure the charging release using the gprs charging release command.

Charging Roamers CDR Only

Status of the charging for roamers feature on the GGSN. The possible values are enabled or disabled.

You can configure the GGSN to support creation of CDRs for roaming subscribers using the gprs charging roamers command.

Charging Send Buffer Size

Size (in bytes) of the buffer that contains the GTP' PDU and signaling messages on the GGSN.

You can configure the buffer size using the gprs charging send-buffer command.

Charging Server Switch-Over Timer

Amount of time (in seconds) that the GGSN waits before sending charging data to the backup charging gateway, after the active charging gateway fails.

You can configure this period of time using the gprs charging server-switch-timer command.

Charging SGSN Limit

Maximum number of SGSN changes that can occur before the GGSN closes a G-CDR for a particular PDP context.

Charging Source Interface

Loopback interface being used for charging traffic.

Charging Tariff Time Changes

Time of day when GGSN charging tariffs change.

You can configure this time using the gprs charging tariff-time command.

Charging Transfer Interval

Amount of time (in seconds) that the GGSN waits before checking and sending any closed CDRs to the charging gateway.

You can configure this period of time using the gprs charging transfer interval command.

Charging Transfer Threshold

Maximum size (in bytes) that the GGSN maintains in a charging container before closing it and updating the CDR.

You can configure the container volume using the gprs charging container volume-threshold command.

Current Active Charging Gateway Address

IP address of the charging gateway to which the GGSN is currently sending charging data.

You can configure the primary charging gateway using the gprs default charging-gateway command.

Current Backup Charging Gateway Address

IP address of the backup charging gateway to which the GGSN will send charging data if the current active charging gateway becomes unavailable.

You can configure the backup charging gateway using the gprs default charging-gateway command.

Default Backup Charging Gateway Address

IP address of the default secondary (backup) charging gateway.

You can configure the default backup charging gateway using the gprs default charging-gateway command.

Default Tertiary Charging Gateway Address

IP address of the default tertiary (backup) charging gateway.

You can configure the default backup charging gateway using the gprs default charging-gateway command.

Default Charging Gateway Address

IP address of the default primary charging gateway.

You can configure the default primary charging gateway using the gprs default charging-gateway command.

GGSN's iSCSI profile

Name of the iSCSI target interface profile configured on the GGSN.

GTP' use short header

Whether the GGSN is using the GTP short header (6-byte header). The possible values are ENABLED (the GGSN is using the GTP short header) or DISABLED (the GGSN is using the GTP long header).

You can configure the GGSN to use the GTP short header using the gprs charging header short command.

Retrieve only data store (PSD) Address

IP address of the remote Persistent Storage Device (PSD) from which G-CDRs are only retrieved.


Related Commands

Command
Description

show gprs charging statistics

Displays cumulative charging statistics for the GGSN.


show gprs charging statistics

To display cumulative charging statistics for the gateway GPRS support node (GGSN), use the show gprs charging statistics command in privileged EXEC mode.

show gprs charging statistics

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX, and the statistics were changed to be cumulative since the last restart of the GGSN and the keyword options were removed.

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD.

12.2(8)YW

This command was integrated into Cisco IOS Release 12.2(8)YW.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs charging statistics command to display cumulative charging statistics since the last restart of the GGSN.

Examples

The following is sample output of the show gprs charging statistics command:

router# show gprs charging statistics all
            GPRS Charging Protocol Statistics
            =================================
   
   * Total Number of CDRs for Charging:              <200>
   * Total Number of Containers for Charging:        <104>
   * Total Number of CDR_Output_Msgs sent:           <22>
   
   -- Charging Gateway Statistics --
   * Charging Gateway Down Count:                    <1>
   * Last Charging Gateway Down Time = 2001/11/29 15:23:0


Table 10 describes the fields shown in the display.

Table 13 show gprs charging statistics Field Descriptions 

Field
Description

Total Number of CDRs for Charging

Cumulative number of open and closed G-CDRs on the GGSN since the last startup of the GGSN.

Total Number of Containers for Charging

Cumulative number of all open and closed charging containers for all G-CDRs on the GGSN since the last startup of the GGSN.

Total Number of CDR_Output_Msgs sent

Cumulative number of G-CDR output messages that the GGSN sent to the charging gateway and received acknowledgment for since the last startup of the GGSN.

Charging Gateway Down Count

Number of times that the charging gateway has transitioned its state (from up or unknown, to down) since the last startup of the GGSN.

Last Charging Gateway Down Time

Recorded system time when the charging gateway was last in a down state. This statistics only appears if a charging gateway has been down.


.

Related Commands

Command
Description

show gprs charging parameters

Displays information about the current GGSN charging configuration.

show gprs charging status

Displays current charging statistics for the GGSN.


show gprs charging status

To display current charging statistics for the gateway GPRS support node (GGSN), use the show gprs charging status command in privileged EXEC mode.

show gprs charging status {tid tunnel_id | access-point access-point-index | all}

Syntax Description

tid tunnel_id

Specifies a tunnel ID for which you want to display charging statistics.

access-point access-point-index

Specifies the index of the access point for which you want to display charging statistics.

all

Requests display of all charging statistics.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(4)MX

This command was introduced.

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD and the Number of partial CDRs output field was changed to the Number of closed CDRs buffered.

12.2(8)YW

This command was integrated into Cisco IOS Release 12.2(8)YW.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB and the sgsn_plmn_id field was added to the display.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs charging status command to display current charging statistics for the GGSN since the last G-CDR was sent.

Examples

Example 1

The following is sample output of the show gprs charging status tid command:

router# show gprs charging status tid 1102334415151515
                    GPRS Charging Protocol Status for TID
                    =========================================
          
           * Number of CDRs :                                <1>
           * Number of closed CDRs buffered:                 <0>
           * Number of Containers:                           <0>

                    ** Detail fields of CDR entry ** 
                       ========================== 
           - served_imsi = 0x112 3344151515F5 
           - sgsn_plmn_id = 0x21F354 
           - ggsn_address = 10.10.10.1 
           - charging_id = 68960026 
           - SGSN change list (total=[1]): [4.4.4.4] 
           - apn = www.gprs_companya.fr 
           - pdp_type: - pdp_type_org = 1 
           - pdp_type_num = 33 
           - dynamic_addr_flag = 1 
           - pdp_type.chrg_data_vol_list: 
           - rec_opening_time = 2003/5/9 10:2:12 <tz_offset:0> 
           - duration = 0 - cause_rec_closing = 0 
           - rec_seq_number = 0 

Table 11 describes the fields shown in the display.

Table 14 show gprs charging status tid Field Descriptions 

Field
Description

Number of CDRs

Number of currently open and closed G-CDRs on the GGSN for the specified TID, since the last G-CDR was successfully sent to the charging gateway.

Number of closed CDRs buffered

Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway for the specified TID.

Number of Containers

Number of all currently open and closed charging containers for the specified TID, since the last G-CDR was successfully sent to the charging gateway.


Example 2

The following is sample output of the show gprs charging status access-point command:

router# show gprs charging status access-point 1
                  
                    GPRS Charging Protocol Status for APN
                    =========================================
          
           * Number of CDRs:                                 <96>
           * Number of closed CDRs buffered:                 <0>
           * Number of Containers:                           <0>

Table 12 describes the fields shown in the display.

Table 15 show gprs charging status access-point Field Descriptions 

Field
Description

Number of CDRs

Number of currently open and closed G-CDRs on the GGSN for the specified access point, since the last G-CDR was successfully sent to the charging gateway.

Number of closed CDRs buffered

Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway for the specified access point.

Number of Containers

Number of all currently open and closed charging containers for the specified access point, since the last G-CDR was successfully sent to the charging gateway.


Example 3

The following is sample output of the show gprs charging status all command:

router# show gprs charging status all
            GPRS Charging Protocol Status
            =================================

   * Number of APNs :                                <1>
   * Number of CDRs :                                <96>
   * Number of closed CDRs buffered:                 <0>
   * Number of Containers buffered:                  <0>
   * Number of pending unack. CDR_Output_Msgs:       <1>

Table 13 describes the fields shown in the display.

Table 16 show gprs charging status Field Descriptions 

Field
Description

Number of APNs

Number of access points for which charging data has currently been collected. This statistic appears in the all version of this command only.

Number of CDRs

Number of currently open and closed G-CDRs on the GGSN since the last G-CDR was successfully sent to the charging gateway. For the tid and access-point versions of this command, this is the number of currently open and closed G-CDRs for the specified TID or access point.

Number of closed CDRs buffered

Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway. For the tid and access-point versions of this command, this is the number of currently closed G-CDRs for the specified TID or access-point that have not yet been sent to the charging gateway.

Number of Containers buffered

Number of all currently open and closed charging containers since the last G-CDR was successfully sent to the charging gateway.

Number of pending unack. CDR_Output_Msgs

Number of G-CDR output messages sent by the GGSN that are not acknowledged by the charging gateway.


Related Commands

Command
Description

show gprs charging parameters

Displays information about the current GGSN charging configuration.

show gprs charging statistics

Displays cumulative charging statistics for the GGSN.


show gprs gtp ms

To display the currently active MSs on the gateway GPRS support node (GGSN), use the show gprs gtp ms command in privileged EXEC mode.

show gprs gtp ms {imsi imsi| access-point access-point-index | all}

Syntax Description

imsi imsi

Displays MSs by International Mobile Subscriber Identity (IMSI). The IMSI can be up to 15 numeric digits. You can obtain the IMSI from the output for the show gprs gtp ms all command or the show gprs gtp pdp-context tid command.

access-point access-point-index

Displays MSs by access point.

all

Displays all MSs.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(8)YW

This command was introduced.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

The MS Addr field was updated to reflect the virtual interface identifier for PPP PDP contexts and the status of PPP PDP with L2TP contexts.

The SGSN MCC/MNC field was added

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs gtp ms command to display information about the mobile stations that are currently active on the GGSN. You can display the MS information according to access-point or IMSI. You can also display information for all MSs.

Examples

The following example displays information for all MSs:

router# show gprs gtp ms all
IMSI               SGSN MCCMNC     MS ADDRESS      APN
112233445565437    12345           10.3.0.1        gprsa.apn.com

223456788765437    67891           10.2.0.1 (Vi5)  gprsb.apn.com

The following example displays information for all MSs on access-point 1:

router# show gprs gtp ms access-point 1
IMSI                    SGSN MCCMNC    MS ADDRESS      APN
112233445565437         12345          10.3.0.1        gprsa.apn.com

The following example displays information for all MSs on IMSI 110406080002045:

router# show gprs gtp ms imsi 110406080002045
IMSI              SGSN MCCMNC     MS ADDRESS      APN
110406080002045   12345           10.10.10.2      gprsc.apn.com

 number of pdp:2
 reference count:1

Table 14 describes the fields shown in the display.

Table 17 show gprs gtp ms Field Descriptions 

Field
Description

IMSI

International mobile subscriber identity for the MSs.

MS ADDRESS

The IP address for the MSs.

Note For PPP PDP contexts, this field will also display the virtual interface identifier. For PPP PDP with L2TP contexts, this field will also display the state of the PDP context. Possible states are Pending, Forwarded, or Terminating.

APN

Access point name.

number of pdp

Number of PDP contexts on the MSs.

reference count

Internal data structure field. It is used only for internal troubleshooting purposes.

SGSN MCCMNC

MCC/MNC of the SGSN.


Related Commands

Command
Description

show gprs gtp pdp-context

Displays a list of the currently active PDP contexts (mobile sessions).

show gprs gtp status

Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics).


show gprs gtp parameters

To display information about the current GPRS Tunneling Protocol (GTP) configuration on the gateway GPRS support node (GGSN), use the show gprs gtp parameters command in privileged EXEC mode.

show gprs gtp parameters

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX.

The following output fields were added to the display:

Charging MCC Code

Charging MNC Code

Charging HPLMN Matching Criteria

GTP dynamic echo-timer minimum

GTP dynamic echo-timer smooth factor

The following output field was removed:

GTP max hold time for old sgsn PDUs T3_tunnel

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD and the following output field was removed from the display:

GPRS HPLMN Matching Criteria

12.2(8)YW

This command was integrated into Cisco IOS Release 12.2(8)YW.

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU and the following output fields were removed from the display:

GPRS MCC Code

GPRS MNC Code

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.


Usage Guidelines

Use the show gprs gtp parameters command to display the current GTP parameters configured on the GGSN.

Examples

The following is sample output of the show gprs gtp parameters command:

router# show gprs gtp parameters
    GTP path echo interval                        = 60                
    GTP signal max wait time T3_response          = 1                
    GTP max retry N3_request                      = 5                
    GTP dynamic echo-timer minimum                = 5                
    GTP dynamic echo-timer smooth factor          = 2                
    GTP buffer size for receiving N3_buffer       = 8192                
    GTP max pdp context                           = 45000 

Table 15 describes the fields shown in the display.

.

Table 18 show gprs gtp parameters Field Descriptions 

Field
Description

GTP buffer size for receiving N3_buffer

Current size of the receive buffer (in bytes) that the GGSN uses to receive GTP signaling messages and packets sent through the tunneling protocol.

You can configure the N3 buffer using the gprs gtp n3-buffer-size command.

GTP dynamic echo-timer minimum

Current minimum time period (in seconds) used by the dynamic echo timer.

You can configure the minimum value using the gprs gtp echo-timer dynamic minimum command.

GTP dynamic echo-timer smooth factor

Current multiplier used by the GGSN to calculate the T-dynamic for the dynamic echo timer.

You can configure the smooth factor using the gprs gtp echo-timer dynamic smooth-factor command.

GTP max pdp context

Current maximum number of PDP contexts (mobile sessions) that can be activated on the GGSN.

You can configure the maximum number of PDP context requests using the gprs maximum-pdp-context-allowed command.

GTP max retry N3_request

Maximum number of times that the GGSN attempts to send a signaling request to an SGSN.

You can configure the maximum number of signaling requests made by the GGSN using the gprs gtp n3-requests command.

GTP path echo interval

Interval, in seconds, that the GGSN waits before sending an echo-request message to the SGSN.

You can configure the path echo interval using the gprs gtp path-echo-interval command.

GTP signal max wait time T3_response

Interval, in seconds, that the GGSN waits before responding to a signaling request message.

You can configure the maximum interval using the gprs gtp t3-response command.


Related Commands

Command
Description

show gprs gtp statistics

Displays the current GTP statistics for the GGSN (such as IE, GTP signaling, and GTP PDU statistics).

show gprs gtp status

Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics).


show gprs gtp path

To display information about one or more GTP paths between the gateway GPRS support node (GGSN) and other GPRS/UMTS devices, use the show gprs gtp path command in privileged EXEC mode.

show gprs gtp path {all | remote-address ip-address [remote-port remote-port] | version gtp-version}

Syntax Description

all

Displays information for all GTP paths.

remote-address ip-address

Displays GTP path information for a specified remote IP address. Optionally, displays GTP path information for a specified remote IP address and port number.

remote-port remote_port_num

(Optional) Displays GTP path information for a specified remote IP address and port number.

version gtp-version

Displays the of GTP paths by the GTP version (0 or 1).


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(8)XU

This command was introduced.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.


12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.

12.4(9)XG

This command was integrated into Cisco IOS Release 12.4(9)XG.

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ.


Usage Guidelines

Use the show gprs gtp path command to display information for one or more GTP paths from the GGSN.

Examples

Example 1

The following example shows the output for all GTP paths on the GGSN:

GGSN# show gprs gtp path  all
Total number of path:1

Local address           Remote address          GTP version    Dynamic echo
timer
33.33.33.1(3386)        11.0.0.1(3386)          0              Disabled

  Collection interval - 5 min, Last collected at - 3 min back
    upstream data volume in octets:     480
    downstream data volume in octets:   0
    upstream packet count:              4
    downstream packet count:            0

  Collection interval - 10 min, Last collected at - 8 min back
    upstream data volume in octets:     120
    downstream data volume in octets:   0
    upstream packet count:              1
    downstream packet count:            0

Table 22 describes the fields shown in the display.

Table 19 show gprs gtp path Field Descriptions 

Field
Description

Total number of path

Total number of GTP paths currently established.

Local address

IP address and port number for the local end of the GTP path.

Remote address

IP address and port number for the remote end of the GTP path, such as the address of the SGSN.

GTP version

Version of the GTP protocol (version 0 or 1) supported by the path.

Dynamic echo timer

Current setting (in seconds) for the dynamic echo timer. "Disabled" appears when the dynamic echo timer is not in use.


show gprs gtp path statistics history

To display statistics (such as the local address and remote port of the path, the GTP version, and the time that the path was deleted) for GTP path entries stored in history, use the show gprs gtp path statistics history command in privileged EXEC mode.

show gprs gtp path statistics history number

Syntax Description

number

Number of path entries for which to display statistics.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.4(9)XG

This command was introduced.

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQand the following fields were added to the display:

Total Update requests sent

Total Update responses rcvd

Number of times DT enabled

12.4(24)T

This command was integrated into Cisco IOS Release 12.4(24)T.


Usage Guidelines

Use the show gprs gtp path statistics history command to display statistics for the path entries stored in the path history table. The statistics includes information such as the local address, remote address, GTP version of the path, and the time at which the path was deleted.

The first group of statistics in the list are those of the most recently-deleted path.

The maximum number of path entries stored in the history table is configured by using the gprs gtp path history global configuration command.

Examples

The following is sample output from the show gprs gtp path statistics history command:

Router#show gprs gtp path statistics history 
Path: IP address: 172.21.21.21, Remote port: 2152 
GPRS GTP Path Statistics: 
  Unexpected Data Message            0          Received PDU message                0 
  Total Data dropped                 0          Sent PDU message                    0 
  Received PDU bytes                 0          Number of short messages            0 
  Sent PDU bytes                     0          Number of unknown message           0 
  Unexpected signaling message       0          Roaming trusted PDPs                0 
  Roaming non-trusted PDPs           0          Non-roaming PDPs                    0 
  Source Violations                  0          Unsupported extension hdr recd      0 
  Path failures                      0          Path fail due to local delete       0 
  Total packets dropped              0          Signaling messages dropped          0 
  Signaling msg received             2          Signaling msg sent                  3 
  Number of PDPs created             0          Number of PDPs deleted              0 
  Number of PPP PDPs created         0          Number of PPP PDPs deleted          0 
  Single PDP cleared                 0          Creates received as update          0 
  Local delete: version upgrade      0          Local delete due to no sgsn         0 
  Local delete: version fallback     0          Create collide with delete          0 
  Version changes                    0          Retransmit for create               0 
  IPv6 PDP activation rejected       0          IPv6 PDPs created                   0 
  IPv6 PDPs deleted                  0          IPv6 signaling msg rcvd             0 
  IPv6 signaling msg sent            0          IPv6 pdus received                  0 
  IPv6 pdus sent                     0          IPv6 bytes received                 0 
  IPv6 bytes sent                    0          Total update requests sent          0 
  Total update responses rcvd        0          Number of times DT enabled          0 
 
Path: IP address: 172.21.21.21, Remote port: 2123 
GPRS GTP Path Statistics: 
  Unexpected Data Message            0          Received PDU message                0 
  Total Data dropped                 0          Sent PDU message                    0 
  Received PDU bytes                 0          Number of short messages            0 
  Sent PDU bytes                     0          Number of unknown message           0 
  Unexpected signaling message       0          Roaming trusted PDPs                0 
  Roaming non-trusted PDPs           0          Non-roaming PDPs                    0 
  Source Violations                  0          Unsupported extension hdr recd      0 
  Path failures                      0          Path fail due to local delete       0 
  Total packets dropped              0          Signaling messages dropped          0 
  Signaling msg received             6          Signaling msg sent                  12 
  Number of PDPs created             0          Number of PDPs deleted              0 
  Number of PPP PDPs created         0          Number of PPP PDPs deleted          0 
  Single PDP cleared                 0          Creates received as update          0 
  Local delete: version upgrade      0          Local delete due to no sgsn         0 
  Local delete: version fallback     0          Create collide with delete          0 
  Version changes                    0          Retransmit for create               3 
  IPv6 PDP activation rejected       0          IPv6 PDPs created                   0 
  IPv6 PDPs deleted                  0          IPv6 signaling msg rcvd             0 
  IPv6 signaling msg sent            0          IPv6 pdus received                  0 
  IPv6 pdus sent                     0          IPv6 bytes received                 0 
  IPv6 bytes sent                    0          Total update requests sent          0 
  Total update responses rcvd          0           Number of times DT enabled            0
 
Path: IP address: 172.10.1.1, Remote port: 2152 
GPRS GTP Path Statistics: 
  Unexpected Data Message            0          Received PDU message                0 
  Total Data dropped                 0          Sent PDU message                    0 
  Received PDU bytes                 0          Number of short messages            0 
  Sent PDU bytes                     0          Number of unknown message           0 
  Unexpected signaling message       0          Roaming trusted PDPs                0 
  Roaming non-trusted PDPs           0          Non-roaming PDPs                    0 
  Source Violations                  0          Unsupported extension hdr recd      0 
  Path failures                      0          Path fail due to local delete       0 
  Total packets dropped              0          Signaling messages dropped          0 
  Signaling msg received             1          Signaling msg sent                  2 
  Number of PDPs created             1          Number of PDPs deleted              1 
  Number of PPP PDPs created         0          Number of PPP PDPs deleted          0 
  Single PDP cleared                 0          Creates received as update          0 
  Local delete: version upgrade      0          Local delete due to no sgsn         0 
  Local delete: version fallback     0          Create collide with delete          0 
  Version changes                    0          Retransmit for create               0 
  IPv6 PDP activation rejected       0          IPv6 PDPs created                   0 
  IPv6 PDPs deleted                  0          IPv6 signaling msg rcvd             0 
  IPv6 signaling msg sent            0          IPv6 pdus received                  0 
  IPv6 pdus sent                     0          IPv6 bytes received                 0 
  IPv6 bytes sent                    0          Total update requests sent          0 
  Total update responses rcvd        0          Number of times DT enabled          0 

Path: IP address: 172.10.1.1, Remote port: 2123 
GPRS GTP Path Statistics: 
  Unexpected Data Message            0          Received PDU message                0 
  Total Data dropped                 0          Sent PDU message                    0 
  Received PDU bytes                 0          Number of short messages            0 
  Sent PDU bytes                     0          Number of unknown message           0 
  Unexpected signaling message       0          Roaming trusted PDPs                0 
  Roaming non-trusted PDPs           0          Non-roaming PDPs                    0 
  Source Violations                  0          Unsupported extension hdr recd      0 
  Path failures                      0          Path fail due to local delete       0 
  Total packets dropped              0          Signaling messages dropped          0 
  Signaling msg received             0          Signaling msg sent                  0 
  Number of PDPs created             0          Number of PDPs deleted              0 
  Number of PPP PDPs created         0          Number of PPP PDPs deleted          0 
  Single PDP cleared                 0          Creates received as update          0 
  Local delete: version upgrade      0          Local delete due to no sgsn         0 
  Local delete: version fallback     0          Create collide with delete          0 
  Version changes                    0          Retransmit for create               0 
  IPv6 PDP activation rejected       0          IPv6 PDPs created                   0 
  IPv6 PDPs deleted                  0          IPv6 signaling msg rcvd             0 
  IPv6 signaling msg sent            0          IPv6 pdus received                  0 
  IPv6 pdus sent                     0          IPv6 bytes received                 0 
  IPv6 bytes sent                    0          Total update requests sent          0 
  Total update responses rcvd        0          Number of times DT enabled          0 

Router#

Table 20 describes the fields shown in the display.

Table 20 show gprs gtp path statistics history Command Field Descriptions 

Field
Description

Creates collide with delete

Number of create PDP context requests that collided with a delete PDP context request.

Creates received as update

Number of create PDP context requests received as an update PDP context request.

IPv6 bytes received

Number of IPv6 bytes received.

IPv6 bytes sent

Number of IPv6 bytes sent.

IPv6 PDP activation rejected

Number of activate IPv6 PDP context request rejected.

IPv6 PDPs created

Number of IPv6 PDP contexts created.

IPv6 PDPs deleted

Number of IPv6 PDP contexts deleted.

IPv6 pdus received

Number of IPv6 PDUs received.

IPv6 pdus sent

Number of IPv6 PDUs sent.

IPv6 signaling msg rcvd

Number of IPv6 signaling messages received.

IPv6 signaling msg sent

Number of IPv6 signaling messages sent.

Local delete due to no sgsn

Number of PDPs deleted locally because of no SGSN.

Local delete: version fallback

Number of PDPs deleted because of a version fallback.

Local delete: version upgrade

Number of PDPs deleted because of a version upgrade.

Non-roaming PDPs

Number of non-roaming PDPs.

Number of PDPs created

Number of IPv4 PDP contexts created.

Number of PDPs deleted

Number of IPv4 PDP contexts deleted.

Number of PPP PDPs created

Number of PPP PDP contexts created.

Number of PPP PDPs deleted

Number of PPP PDP contexts deleted.

Number of short messages

Number of GTP messages received which are too short.

Number of times DT enabled

Number of times direct tunnel was enabled for a PDP context.

Number of unknown messages

Number of unknown GTP messages received.

Path failures

Number of path failures.

Path fail due to local delete

Number of path failure due to a local delete PDP context request.

Received PDU bytes

Number of IPv4 PDU bytes transmitted.

Received PDU message

Number of IPv4 PDU messages received.

Retransmit for create

Number of retransmitted create PDP context requests received.

Roaming non-trusted PDPs

Number of roaming PDPs not in a trusted PLMN.

Roaming trusted PDPs

Number of roaming PDPs in a trusted PLMN.

Sent PDU bytes

Number of IPv4 PDU bytes transmitted.

Sent PDU message

Number of IPv4 PDU messages transmitted.

Signaling messages dropped

Number of GTP signaling messages dropped.

Signaling msg received

Number of signaling messages received.

Signaling msg sent

Number of signaling messages sent.

Single PDP cleared

Number of hanging single PDP contexts cleared on the GGSN.

Source Violations

Number of PDPs terminated due to an access violation.

Total Data dropped

Total data dropped.

Total Update requests sent

Total number of GGSN-initiated Update PDP Context Requests sent.

Total Update responses rcvd

Total number responses to GGSN-initiated Update PDP Context Requests.

Total packets dropped

Total number of packets dropped.

Unexpected Data Message

Number of GTP PDUs received for nonexistent PDP contexts.

Unexpected signaling message

Number of unexpected GTP signaling messages received.

Unsupported extension hdr recd

Number of create PDP context requests received with unsupported extension headers when GGSN comprehension is required.

Version changes

Number of GTP version changes that have occurred on the SGSN path


Related Commands

Command
Description

gprs gtp path history

Configures the maximum number of path entries for which the GGSN stores statistics after the path is deleted.

show gprs gtp path statistics remote-address

Displays the statistics for a specific GTP path.


show gprs gtp path statistics remote-address

To display statistics for a specific path, use the show gprs gtp path statistics remote-address command in privileged EXEC mode.

show gprs gtp path statistics remote-address ip-address [remote-port port-num]

Syntax Description

remote-address ip-address

IP address of the SGSN for which you want to view path details.

remote-port port-num

Port number on the SGSN of the entry for which you want to view details.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.4(9)XG

This command was introduced.

12.4(9)XG2

This command was integrated into Cisco IOS Release 12.4(9)XG2 and the following fields were added to the display:

Local delete: no req to sgsn

Local delete: no wait sgsn

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ and the following fields were added to the display:

Number of time DT enabled

Total Update requests sent

Total Update responses rcvd

12.4(24)T

This command was integrated into Cisco IOS Release 12.4(24)T.


Usage Guidelines

Use the show gprs gtp path statistics remote-address command to display statistics for a specific GTP path. These details include the local address and remote address of the path, the GTP version used, and the time at which the path was deleted.

If a remote port is not specified, statistics for all entries of the path are displayed.

If the path specified does not currently exist, the statistics stored in the path history table will be searched and displayed if the entry exists in history.

Examples

The following is sample output from the show gprs gtp path statistics remote-address command:

router#show gprs gtp path statistics remote-address 172.10.10.10  
Path: IP address: 172.10.10.10, Remote port: 2123 

GPRS GTP Path Statistics:
  Unexpected Data Message        0       Received PDU message             0
  Total Data dropped             0       Sent PDU message                 0
  Received PDU bytes             0       Number of short messages         0
  Sent PDU bytes                 0       Number of unknown message        0
  Unexpected signaling message   0       Roaming trusted PDPs             0
  Roaming non-trusted PDPs       0       Non-roaming PDPs                 0
  Source Violations              0       Unsupported extension hdr recd   0
  Path failures                  0       Path fail due to local delete    0
  Total packets dropped          0       Signaling messages dropped       0
  Signaling msg received         26504   Signaling msg sent               26504
  Number of PDPs created         26504   Number of PDPs deleted           35
  Number of PPP PDPs created     0       Number of PPP PDPs deleted       0
  Number of times DT enabled   0       Single PDP cleared             0 
  Creates received as update     0       Local delete: version upgrade     0
  Local delete due to no sgsn    0       Local delete: version fallback    0
  Create collide with delete     0       Local delete: no wait sgsn        0 
  Local delete: no req to sgsn   0       Version changes                   0
  Retransmit for create          0       IPv6 PDP activation rejected      0
  IPv6 PDPs created              0       IPv6 PDPs deleted                 0
  IPv6 signaling msg rcvd        0       IPv6 signaling msg sent           0
  IPv6 pdus received             0       IPv6 pdus sent                    0
  IPv6 bytes received            0       IPv6 bytes sent                   0
  Total Update requests sent     2       Total Update responses rcvd       1

Path: IP address: 10.102.5.92, Remote port: 2152
GPRS GTP Path Statistics:
  Unexpected Data Message        0       Received PDU message               0
  Total Data dropped             0       Sent PDU message                   0
  Received PDU bytes             0       Number of short messages           0
  Sent PDU bytes                 0       Number of unknown message          0
  Unexpected signaling message   0       Roaming trusted PDPs               0
  Roaming non-trusted PDPs       0       Non-roaming PDPs                 0
  Source Violations              0       Unsupported extension hdr recd   0
  Path failures                  0       Path fail due to local delete    0
  Total packets dropped          0       Signaling messages dropped       0
  Signaling msg received         26504   Signaling msg sent               26504
  Number of PDPs created         26504   Number of PDPs deleted           35
  Number of PPP PDPs created     0       Number of PPP PDPs deleted       0
  Number of times DT enabled   0       Single PDP cleared             0 
  Creates received as update     0       Local delete: version upgrade     0
  Local delete due to no sgsn    0       Local delete: version fallback    0
  Create collide with delete     0       Local delete: no wait sgsn        0 
  Local delete: no req to sgsn   0       Version changes                   0
  Retransmit for create          0       IPv6 PDP activation rejected      0
  IPv6 PDPs created              0       IPv6 PDPs deleted                 0
  IPv6 signaling msg rcvd        0       IPv6 signaling msg sent           0
  IPv6 pdus received             0       IPv6 pdus sent                    0
  IPv6 bytes received            0       IPv6 bytes sent                   0
  Total Update requests sent     2       Total Update responses rcvd       1
router#

Table 21 describes the fields shown in the display.

Table 21 show gprs gtp path statistics remote-address Command Field Descriptions 

Field
Description

Creates collide with delete

Number of create PDP context requests that collided with a delete PDP context request.

Creates received as update

Number of create PDP context requests received as an update PDP context request.

IPv6 bytes received

Number of IPv6 bytes received.

IPv6 bytes sent

Number of IPv6 bytes sent.

IPv6 PDP activation rejected

Number of activate IPv6 PDP context request rejected.

IPv6 PDPs created

Number of IPv6 PDP contexts created.

IPv6 PDPs deleted

Number of IPv6 PDP contexts deleted.

IPv6 pdus received

Number of IPv6 PDUs received.

IPv6 pdus sent

Number of IPv6 PDUs sent.

IPv6 signaling msg rcvd

Number of IPv6 signaling messages received.

IPv6 signaling msg sent

Number of IPv6 signaling messages sent.

Local delete due to no sgsn

Number of PDPs deleted locally because of no SGSN.

Local delete: version fallback

Number of PDPs deleted because of a version fallback.

Local delete: version upgrade

Number of PDPs deleted because of a version upgrade.

Local delete: no req to sgsn

Number of PDPs deleted when the GGSN is configured to delete PDP contexts locally without sending a delete PDP context request to the SGSN.

Local delete: no wait sgsn

Number of PDPs deleted when the GGSN is configured to not wait for the SGSN to respond to its delete PDP context request before deleting the PDP context.

Non-roaming PDPs

Number of non-roaming PDPs.

Number of times DT enabled

Number of direct tunnel PDP contexts created.

Number of PDPs created

Number of IPv4 PDP contexts created.

Number of PDPs deleted

Number of IPv4 PDP contexts deleted.

Number of PPP PDPs created

Number of PPP PDP contexts created.

Number of PPP PDPs deleted

Number of PPP PDP contexts deleted.

Number of short messages

Number of GTP messages received which are too short.

Number of unknown messages

Number of unknown GTP messages received.

Path failures

Number of path failures.

Path fail due to local delete

Number of path failure due to a local delete PDP context request.

Received PDU bytes

Number of IPv4 PDU bytes transmitted.

Received PDU message

Number of IPv4 PDU messages received.

Retransmit for create

Number of retransmitted create PDP context requests received.

Roaming non-trusted PDPs

Number of roaming PDPs not in a trusted PLMN.

Roaming trusted PDPs

Number of roaming PDPs in a trusted PLMN.

Sent PDU bytes

Number of IPv4 PDU bytes transmitted.

Sent PDU message

Number of IPv4 PDU messages transmitted.

Signaling messages dropped

Number of GTP signaling message dropped.

Signaling msg received

Number of signaling messages received.

Signaling msg sent

Number of signaling messages sent.

Single PDP cleared

Number of hanging single PDP contexts cleared on the GGSN.

Source Violations

Number of PDPs terminated due to a access violation.

Total Data dropped

Total data dropped.

Total packets dropped

Total number of packets dropped.

Total Update requests sent

Total number of GGSN-initiated Update PDP Context Requests sent.

Total Update responses rcvd

Total number responses to GGSN-initiated Update PDP Context Requests.

Unexpected Data Message

Number of GTP PDUs received for nonexistent PDP contexts.

Unexpected signaling message

Number of unexpected GTP signaling messages received.

Unsupported extension hdr recd

Number of create PDP context requests received with unsupported extension headers when GGSN comprehension is required.

Version changes

Number of GTP version changes that have occurred on the SGSN path.


Related Commands

Command
Description

gprs gtp path history

Configures the maximum number of path entries for which the GGSN stores statistics after the path is deleted.

show gprs gtp path statistics history

Displays summary of the counters for past GTP path entries stored in history.


show gprs gtp path throughput

To display throughput information for one or more GTP paths between a gateway GPRS support node (GGSN) and other GPRS/UMTS devices, use the show gprs gtp path throughput command in privileged EXEC mode.

show gprs gtp path throughput {all | remote-address ip-address [remote-port remote-port] | version gtp-version}

Syntax Description

all

Displays information for all GTP paths.

remote-address ip-address

Displays GTP path throughput information for a specified remote IP address. Optionally, displays GTP path throughput information for a specified remote IP address and port number.

remote-port remote_port_num

(Optional) Displays GTP path throughput information for a specified remote IP address and port number.

version gtp-version

Displays the throughput of GTP paths by the GTP version (0 or 1).


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(8)XU

This command was introduced.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.


12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs gtp path throughput command to display throughput information for one or more GTP paths from the GGSN.

Examples

Example 1

The following example shows the output for all GTP paths on the GGSN:

GGSN# show gprs gtp path throughput all
Total number of path:1

Local address           Remote address          GTP version    Dynamic echo
timer
33.33.33.1(3386)        11.0.0.1(3386)          0              Disabled

  Collection interval - 5 min, Last collected at - 3 min back
    upstream data volume in octets:     480
    downstream data volume in octets:   0
    upstream packet count:              4
    downstream packet count:            0

  Collection interval - 10 min, Last collected at - 8 min back
    upstream data volume in octets:     120
    downstream data volume in octets:   0
    upstream packet count:              1
    downstream packet count:            0

Table 17 describes the fields shown in the display.

Table 22 show gprs gtp path throughput Field Descriptions 

Field
Description

Total number of path

Total number of GTP paths currently established.

Local address

IP address and port number for the local end of the GTP path.

Remote address

IP address and port number for the remote end of the GTP path, such as the address of the SGSN.

GTP version

Version of the GTP protocol (version 0 or 1) supported by the path.

Dynamic echo timer

Current setting (in seconds) for the dynamic echo timer. "Disabled" appears when the dynamic echo timer is not in use.


show gprs gtp pdp-context

To display a list of the currently active PDP contexts (mobile sessions), use the show gprs gtp pdp-context command in privileged EXEC mode.

show gprs gtp pdp-context {tid tunnel_id [service [all | id id_string]] | ms-address ip_address [access-point access-point-index] | imsi imsi [nsapi nsapi [tft]] | path ip-address [remote-port-num] | access-point access-point-index | pdp-type {ip | ppp} | qos-umts-class {background | conversational | interactive | streaming} | qos-precedence {low | normal | high} | qos-delay {class1 | class2 | class3 | classbesteffort} | version gtp-version} | msisdn [msisdn] | all}

Syntax Description

tid tunnel_id [service [all | id id_string]]

Displays PDP contexts by tunnel ID. This value corresponds to the IMSI plus NSAPI and can be up to 16 numeric digits. Optionally, displays the service category in a PDP context.

ms-address ip_address

Displays PDP contexts for the specified mobile station IP address (in dotted-decimal format).

apn-index access-point-index

(Optional) Displays PDP contexts for the specified mobile station IP address at a particular access point. This option is required to display mobile stations that are accessing a private VPN.

imsi imsi

Displays PDP contexts by International Mobile Subscriber Identity (IMSI). The IMSI value can be up to 15 numeric digits.

nsapi nsapi [tft]

(Optional) Displays a particular PDP context by Network Service Access Point Identifier (NSAPI) for the specified IMSI. Optionally, displays the traffic flow template (TFT) filters associated with the NSAPI.

path ip-address [remote_port_num]

Displays PDP contexts by path. Optionally, displays PDP contexts by remote IP address and port number.

access-point access-point-index

Displays PDP contexts by access point. Possible values are 1 to 65535.

pdp-type {ip | ppp}

Displays PDP contexts that are transmitted using either IP or PPP.

qos-umts-class

Displays PDPs by UMTS QoS traffic class. You can specify the following traffic classes: background, conversational, interactive, and streaming. This option is available when UMTS QoS is enabled.

qos-precedence

Displays PDP contexts for a specified GPRS QoS precedence type. You can specify the following precedence types: low, normal, and high. This option is available when GPRS QoS canonical QoS is enabled.

qos-delay

Displays PDP contexts for a specified GPRS quality of service delay class type. You can specify the following delay class types: class1, class2, class3, and classbesteffort. This option is available when GPRS QoS delayed-based QoS is enabled.

version gtp-version

Displays PDP contexts by GTP version. The possible values are 0 or 1.

msisdn [msisdn]

Displays all PDP contexts with MSISDN information. Optionally, displays particular PDPs filtered by the longest prefix match of the specified MSISDN.

all

Displays all PDP contexts.


Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(1)

The MS International PSTN/ISDN Number (MSISDN) field was added to the output display.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX.

The pdp-type ppp and qos-delay options were added to the command.

The following fields were added to the output display of the tid version of this command:

cef_down_byte

cef_down_pkt

cef_drop

cef_up_byte

cef_up_pkt

gtp pdp idle time

The Network Init Information section was added to the output display of the tid version of this command with the following new fields:

Buf.Bytes

MNRG Flag

NIP State

PDU Discard Flag

SGSN Addr

The following fields were removed from the output display of the tid version of this command:

fast_up_pkt

fast_up_byte

fast_down_pkt

fast_down_byte

fast_drop

The "dynamic?" and "Dynamic" fields were removed from the output display of the all and tid versions of this command, and were replaced by the Source field.

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD and the following fields were added to the output display of the tid version of this command:

primary dns

secondary dns

primary nbns

secondary nbns

12.2(8)YW

This command was integrated into the 12.2(8)YW.

The the option of displaying PDP contexts by remote IP address and port number was added.

The delay Qos class(req.) output field was added to the display of the tid version of this command when the mapping of GPRS QoS categories to delay QoS classes is enabled.

The ms-address, imsi, qos-umts-class and version options were added to the command.

The ggsn_addr_signal field was changed to the sgsn_addr_data in the output display of the tid version of this command.

The following fields were added to the output display of the tid version of this command:

control teid local

control teid remote

data teid local

data teid remote

primary pdp

nsapi

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB and the MS Addr field updated to reflect the virtual interface identifier for PPP PDP and PPP Regen contexts and the status of PPP PDP with L2TP contexts.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU.

The following fields were added to the output display of the tid version of this command:

charging characteristics

charging characteristics received

Framed_route

idle timeout

mask

roamer

session timeout

visitor

The gtp pdp idle time field were removed from the output display of the tid version of this command.

An overflow indicator (+) was added to the following fields of the output display of the tid version of this command:

cef_down_pkt

cef_up_pkt

rcv_pkt_count

send_pkt_count

12.3(8)XU2

This command was integrated into Cisco IOS Release 12.3(8)XU2 and the single pdp-session field was added to the output display of the tid version of this command.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into the Cisco IOS Release 12.3(14)YQ.

The option of display the service category in a PDP context was added was added.

The following fields were added to the tid version of this command when the service keyword option is specified:

Diameter Credit Control

Current Billing Status

Reason to convert to postpaid

DCCA profile name and Source

Rule base id and Source

ServiceID

State

Quota(octets)

Time

flags

Last pushed quota

- Tariff Time Change

- Time Quota

- Volume Quota

- Validity Time

- Quota ConsumptionTime

- Quota Holding time

- Time Quota Threshold

- Volume Quota Threshold

- Trigger Flags

Last received quota

- Tariff_time_change

- Time_quota

- Volume_quota

- Validity_time

- Quota ConsumptionTime

- Quota Holding_Time

- Time Quota Threshold

- Volume Quota Threshold

- Trigger Flags

12.3(14)YU

This command was integrated into the Cisco IOS Release 12.3(14)YU and the msisdn [msisdn] keyword option was added.

Additionally, the QoS for charging field was removed from the show gprs gtp pdp-context tid command display and when a PDP is created via a virtual APN, the following field has been added to the show gprs gtp pdp-context tid command display:

virtual-apn: virtual-apn-name

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB.


Usage Guidelines

Use the show gprs gtp pdp-context command to display the currently active PDP contexts on the GGSN. You can display PDP contexts by tunnel ID, by IMSI, by access point, by PDP type, and by GPRS QoS precedence, UMTS QoS traffic class, or you can display all PDP contexts.

Several versions of the show gprs gtp pdp-context command display similar output. The examples provided show these two different types of output.

Interpreting the Effective Bandwidth

Example 2 provides sample output from the show gprs gtp pdp-context tid command, which includes the field called effective bandwidth (in bps). The effective bandwidth is determined according to the GPRS QoS canonical QoS class (premium, normal, or best effort) for the PDP context; it does not represent the actual bandwidth in use by the PDP context. The potential number of supported PDP contexts for that class of QoS can then be calculated according to the total amount of bandwidth (GSN resource) available to the GGSN.

For more information about GPRS QoS canonical QoS and resources on the GGSN, see the "Configuring QoS on the GGSN" chapter in the Cisco IOS Mobile Wireless Configuration Guide.

Examples

Example 1

The following is sample output of the show gprs gtp pdp-context all command:

routershow gprs gtp pdp-context all
TID              MS Addr         Source  SGSN Addr       APN
1234567890123456 10.11.1.1       Radius  10.4.4.11       www.pdn1.com
2345678901234567 Forwarded (Vi5) IPCP    10.4.4.11       www.pdn2.com
3456789012345678 10.21.1.1 (Vi7) IPCP    10.1.4.11       www.pdn3.com
4567890123456789 10.31.1.1 (Vi9) IPCP    10.1.4.11       www.pdn4.com
5678901234567890 10.41.1.1       Static  10.4.4.11       www.pdn5.com

Note The same output fields shown in Example 1 also appear when you use the access-point, path, pdp-type, qos-delay, or qos-precedence keyword options of the show gprs gtp pdp-context command.


Table 18 describes the fields shown in the display.

Table 23 show gprs gtp pdp-context all Field Descriptions

Field
Description

APN

Access point name where the PDP context is active.

MS Addr

IP address of the mobile station.

Note For PPP PDP and PPP Regen contexts, this field will also display the virtual interface identifier. For PPP PDP with L2TP contexts, this field will also display the state of the PDP context. Possible states are Pending, Forwarded, or Terminating.

SGSN Addr

IP address of the SGSN that is processing the packets.

Source

Source of IP addressing for the MS. The possible values are:

DHCP—Dynamic address allocation using DHCP.

IPCP—Dynamic address allocation for PPP PDP types, or for IP PDP types with PPP regeneration, using PPP IP Control Protocol.

Local—Dynamic address allocation using a local pool.

Pending—Waiting for dynamic address allocation. Dynamic address source is unknown.

Radius—Dynamic address allocation using RADIUS.

Static—IP address is not dynamically assigned.

TID

Tunnel ID for the PDP context.


Example 2

The following is sample output from the show gprs gtp pdp-context tid command for a PDP context 
created by GTP version 1 and GPRS QoS canonical QoS is configured:

router#show gprs gtp pdp-context tid 1111111111111111
TID              MS Addr         Source  SGSN Addr       APN
1111111111111111 10.1.1.1        Radius  10.8.8.1        dns.com

    current time :Mar 18 2002 11:24:36
    user_name (IMSI):1111111111111111   MS address:10.1.1.1
    MS International PSTN/ISDN Number (MSISDN):ABC
    sgsn_addr_signal:10.8.8.1           sgsn_addr_data:10.8.0.1
    control teid local: 0x63493E0C
    control teid remove: 0x00000121
    data teid local:  0x63483E10
    data teid remote:  0x00000121
    primary pdp: Y      nsapi: 0
    signal_sequence: 0                  seq_tpdu_up:     0
    seq_tpdu_down:   0
    upstream_signal_flow:  1            upstream_data_flow:  2
    downstream_signal_flow:14           downstream_data_flow:12
    RAupdate_flow:         0
    pdp_create_time:  Mar 18 2002 09:58:39
    last_access_time: Mar 18 2002 09:58:39
    mnrgflag:         0                tos mask map:00
    session timeout: 0
    idle timeout: 0
    gprs qos_req:091101               canonical Qos class(req.):01
    gprs qos_neg:25131F               canonical Qos class(neg.):01
    effective bandwidth:0.0
    rcv_pkt_count:     0              rcv_byte_count:  0
    send_pkt_count:    0              send_byte_count: 0
    cef_up_pkt:        0              cef_up_byte:    0
    cef_down_pkt:      0              cef_down_byte:  0
    cef_drop:           0             out-sequence pkt: 0
    Src addr violation:            2 paks,     1024 bytes
    Dest addr violation:           2 paks,     1024 bytes
    Redirected mobile-to-mobile traffic:  2 paks,     1024 bytes
    charging_id:        29160231
    visitor: No        roamer: No
    charging characteristics: 0
    charging characteristics received: 0
    pdp reference count:2
    primary dns:        2.2.2.2
    secondary dns:      4.4.4.4
    primary nbns:       3.3.3.3
    secondary nbns:     5.5.5.5
    ntwk_init_pdp:      0
    Framed_route 5.5.5.0 mask 255.255.255.0
    single pdp-session: Enabled
    absolute session start time: NOT SET
    virtual apn: pre-auth-virtual

    ** Network Init Information **
    MNRG Flag: 0                PDU Discard Flag: 0
    SGSN Addr: 172.16.44.1      NIP State:        NIP_STATE_WAIT_PDP_ACTIVATION
    Buf.Bytes: 500

Table 19 describes the fields shown in the display.


Note The Network Init Information section of the output appears only while network-initiated PDP contexts are being processed by the GGSN.



Note The same output fields shown in Example 2 also appear when you use the imsi keyword option of the show gprs gtp pdp-context command.



Note If the PDP context is created via a virtual APN, the "virtual-apn: virtual-apn name" field displays.


Table 19 describes the fields shown in the display.

Table 24 show gprs gtp pdp-context tid Field Descriptions 

Field
Description

APN

Access point name where the PDP context is active.

canonical Qos class (neg.)

Negotiated canonical quality of service class for the PDP context, with the following values:

01—Best effort

02—Normal

03—Premium

This field displays when GPRS QoS canonical QoS is enabled on the GGSN.

canonical Qos class (req.)

Requested GPRS canonical QoS class by the PDP context, with the following values:

01—Best effort

02—Normal

03—Premium

This field displays when GPRS QoS canonical QoS is enabled on the GGSN.

cef_down_byte

Total number of G-PDU bytes CEF switched on the downlink, from the GGSN to the SGSN.

cef_down_pkt

Total number of G-PDU packets CEF switched on the downlink, from the GGSN to the SGSN. The plus (+) sign is an overflow indicator.

cef_drop

Total number of G-PDU packets dropped during CEF switching.

cef_up_byte

Total number of G-PDU bytes CEF switched on the uplink, from the SGSN to the GGSN.

cef_up_pkt

Total number of G-PDU packets CEF switched on the uplink, from the SGSN to the GGSN. The plus (+) sign is an overflow indicator.

charging characteristics

Number of the charging profile selected for the PDP context.

charging characteristics received

Charging characteristics IE received from the SGSN.

The value of the charging characteristics received field is the decimal value of the two octets, with the first octet being the more significant byte than the second.

The profile index, which is used to select the charging profile, is the integer obtained by dividing the charging characteristics received value by 256.

charging_id

Unique 4-octet value generated by the GGSN for the PDP context. The value 0 is reserved.

control teid local

Uplink tunnel endpoint identifier (TEID) chosen by the GGSN for control plane messages.

This field displays for PDP contexts created with GTP version 1.

control teid remote

Downlink TEID chosen by the SGSN for control plane messages.

This field displays for PDP contexts created with GTP version 1.

current time

Date and time of the show command output.

data teid local

Uplink TEID chosen by the GGSN for G-PDUs.

This field displays for PDP contexts created with GTP version 1.

data teid remote

Downlink TEID chosen by the SGSN for PDUs.

This field displays for PDP contexts created with GTP version 1.

Dest addr violation

Number of packets (and bytes) dropped by the GGSN because of a source address violation.

This field displays only when the security verify destination command is configured.

Note This field does not apply to APNs using VRF. In addition, verification of destination addresses does not apply to GTP-PPP regeneration or GTP-PPP with L2TP.

downstream_data_flow

Flow label of downlink G-PDUs.

downstream_signal_flow

Flow label of downlink signaling messages.

effective bandwidth

Estimated number of bits per second allocated by the GGSN for this PDP context. The effective bandwidth is determined according to the QoS class (premium, normal, or best effort) for the PDP context. The potential number of supported PDP contexts for that class of QoS can be calculated according to the total amount of bandwidth (GSN resource) available to the GGSN.

This field displays when canonical QoS is enabled on the GGSN.

Note The effective bandwidth does not represent actual bandwidth usage.

Framed_route

Framed-Route, attribute 22, for the PDP context, downloaded from the RADIUS server during authentication and authorization.

gprs qos_neg

Negotiated quality of service for the PDP context. The field is in the format vwxyzz, which represents the following QoS classes (as defined in the GSM specifications for quality of service profiles):

v—Delay class

w—Reliability class

x—Peak throughput class

y—Precedence class

zz—Mean throughput class

Note To determine the GPRS QoS attributes shown in this output, you must convert the value to binary and interpret the values to find the corresponding class attributes. Some of the bits represent "don't care" bits and are not interpreted as part of the final value. For more information about how to interpret this value, see the "Interpreting the Requested and Negotiated GPRS QoS" section of the "Configuring QoS" chapter in the Cisco IOS Mobile Wireless Configuration Guide.

gprs qos_req

Requested quality of service by the PDP context. The field is in the format vwxyzz, which represents the following QoS classes (as defined in the GSM specifications for GPRS QoS profiles):

v—Delay class

w—Reliability class

x—Peak throughput class

y—Precedence class

zz—Mean throughput class

Note See the Note in the description of the gprs qos_neg output field above.

idle timeout

Number of seconds the GGSN waits before purging idle PDP contexts.

last_access_time

Time when the PDP context for this TID was last accessed. The date format is MMM DD YYYY. The time format is hours:minutes:seconds.

When a signaling packet or data packet for a PDP context arrives on the GGSN, the last_access_time is reset to the current date and time. If the last_access_time exceeds the purge timer for idle PDP contexts, then the PDP context is purged by the GGSN.

mask

Framed-Route subnet.

mnrgflag

Mobile not reachable flag, with the following values:

0—flag is off.

1—flag is on, indicating that the MS is not reachable

MS_ADDR and MS Address

IP address of the mobile station.

Note For PPP PDP and PPP Regen contexts, this field will also display the virtual interface identifier. For PPP PDP with L2TP contexts, this field will also display the state of the PDP context. Possible states are Pending, Forwarded, or Terminating.

MS International PSTN/ISDN Number (MSISDN)

Integrated Services Digital Network (ISDN) number of the mobile station.

nsapi

Network Service Access Point Identifier (NSAPI).

This field displays for PDP contexts created with GTP version 1.

ntwk_init_pdp

Network initiated PDP context indicator, with the following values:

0—Not a network initiated PDP context. This indicates a mobile initiated PDP context.

1—Network initiated PDP context

out-sequence pkt

 

pdp_create_time

Time when the PDP context for this TID was created. The date format is MMM DD YYYY. The time format is hours:minutes:seconds.

pdp reference count

Number of subsystems on the GGSN that are aware of the PDP context. For example, if both the charging and GTP subsystems are aware of the PDP context, then the pdp reference counter shows a value of 2.

primary dns

IP address of the primary DNS server.

primary nbns

IP address of the primary NetBIOS Name Service (NBNS).

primary pdp

Whether the PDP is primary or secondary. Possible values are Y (PDP is primary) or N (PDP is secondary).

This field displays for PDP contexts created with GTP version 1.

RAupdate_flow

Flow Label Data II information element in GTP header. This IE contains the flow label for data transmission between old and new SGSNs for a particular PDP context. This IE is requested by the new SGSN.

rcv_byte_count

Total number of G-PDU bytes received. For the GGSN, this is the total byte count on the uplink.

rcv_pkt_count

Total packet count of received G-PDUs. For the GGSN, this is the total byte count on the uplink. The plus (+) sign is an overflow indicator.

Redirected mobile-to-mobile traffic

Number of packets (and bytes) dropped at the APN from which they exit because mobile-to-mobile traffic has been redirected. This field displays only when the redirect intermobile ip command is configured.

roamer

Whether the PDP context is that of a roaming mobile subscriber (subscriber whose SGSN PLMN ID differs from the GGSN's). The possible values are yes or no.

secondary dns

IP address of the secondary DNS server.

secondary nbns

IP address of the secondary NBNS.

send_byte_count

Total number of G-PDU bytes sent by the GSN (GGSN or SGSN D-node).

send_pkt_count

Total number of G-PDU packets sent by the GSN (GGSN or SGSN D-node). The plus (+) sign is an overflow indicator.

seq_tpdu_down

Last sequence number used in the downlink T-PDU. This number wraps to 0 after 65535.

seq_tpdu_up

Last sequence number used in the uplink T-PDU. This number wraps to 0 after 65535.

session timeout

Number of seconds that the GGSN allows a session to remain active before purging all PDP contexts with the same IMSI or MS address.

sgsn_addr_signal

IP address of the SGSN that is processing the packets.

sgsn_addr_data

IP address of the SGSN that is processing tunnel packet data units (TPDUs).

signal_sequence

Last sequence number used in the GTP signaling message.

single PDP-session

Whether the GGSN has been configured to delete the primary PDP context, and any associated secondary PDP contexts, of a hanging PDP session upon receiving a new create request from the same MS that shares the same IP address of the hanging PDP context.

Source

Source of IP addressing for the MS. The possible values are:

DHCP—Dynamic address allocation using DHCP.

IPCP—Dynamic address allocation for PPP PDP types, or for IP PDP types with PPP regeneration, using PPP IP Control Protocol.

Local—Dynamic address allocation using a local pool.

Pending—Waiting for dynamic address allocation. Dynamic address source is unknown.

Radius—Dynamic address allocation using RADIUS.

Static—IP address is not dynamically assigned.

Src addr violation

Number of packets (and bytes) dropped because of source address violation. This field displays only when the security verify source command is configured.

TID

Tunnel ID for the PDP context.

tos mask map

ToS value in IP header of this PDP context.

umts qos_req

Requested UMTS quality of service by the PDP context. This field displays when UMTS QoS is enabled on the GGSN.

umts qos_neg

Negotiated UMTS quality of service for the PDP context. This field displays when UMTS QoS is enabled on the GGSN.

upstream_data_flow

Flow label of uplink G-PDUs.

upstream_signal_flow

Flow label of uplink signaling messages.

user_name (IMSI)

International mobile subscriber identity for the PDP context.

virtual APN

Virtual access point name where the PDP context is active.

visitor

Whether the PDP context is that of a visiting mobile subscriber (subscriber whose IMSI contains a foreign PLMN ID).). The possible values are yes or no.


Table 20 describes the fields shown in the Network Init Information section of the output.

Table 25 show gprs gtp pdp-context tid Network Init Information Field Descriptions 

Field
Description

Buf.Bytes

Number of bytes currently buffered for this network-initiated PDP context.

last_access_time

Time when the PDP context for this TID was last accessed. The date format is MMM DD YYYY. The time format is hours:minutes:seconds.

When a signaling packet or data packet for a PDP context arrives on the GGSN, the last_access_time is reset to the current date and time. If the last_access_time exceeds the purge timer for idle PDP contexts, then the PDP context is purged by the GGSN.

MNRG Flag

Mobile not reachable flag, with the following values:

0—flag is off.

1—flag is on, indicating that the MS is not reachable

NIP State

State information for the network initiated PDP process on the GGSN.

PDU Discard Flag

Discarded PDU indicator for a network initiated PDP context, with the following values:

0—PDUs are not discarded. This indicates that PDUs for a network initiated PDP context are being sent to the SGSN.

1—PDUs are being discarded by the GGSN. PDUs are discarded by the GGSN when a network initiated PDP context procedure is unsuccessful. This occurs when the SGSN sends a rejection of the PDP context request to the GGSN with a Cause value of either "MS Refuses" or "MS is not GPRS Responding."

When the flag is set to 1, the GGSN ignores PDUs destined for that MS for the specified PDU discard period. The default period is 300 seconds (5 minutes). You can configure the PDU discard time using the gprs ntwk-init-pdp pdu-discard-period command.

SGSN Addr

IP address of the SGSN that is associated with the network-initiated procedure for this PDP context (used for paging).


Example 3

The following is sample output from the show gprs gtp pdp-context tid service id command:

ggsn1#show gprs gtp pdp tid 1111000000000050 service id 1 
Diameter Credit Control:Enabled
Current Billing status:Prepaid
Reason to convert to postpaid:N/A
DCCA profile name:1, Source:charging profile
Rule base id:ABC,  Source:AAA server
ServiceID  State         Quota(octets)         Time     flags

 1        AUTHORIZED        80000              6000     SGSN:

Last pushed quota
-----------------
Tariff Time Change:    1110585600  Time Quota:            6000    
Volume Quota:          80000       Validity Time:         500     
Quota ConsumptionTime: 45          Quota Holding time:    35      
Time Quota Threshold:  4000        Volume Quota Threshold:50000   
Trigger Flags:         1       
Last received quota
-------------------
Tariff_time_change:    1110585600  Time_quota:           6000    
Volume quota:          80000       Validity_time:        500     
Quota ConsumptionTime: 45          Quota Holding_Time:   35      
Time Quota Threshold:  4000        Volume Quota Threshold:50000   
Trigger Flags:         1       

Example 4

The following is sample output from the show gprs gtp pdp-context msisdn command:

ggsn1#show gprs gtp pdp-context msisdn

TID              MS Addr         Source  SGSN Addr       MSISDN                APN
2123456708000010 55.10.0.2       LOCAL   10.1.1.70       408525823010          ippdpl
2123456809000010 55.10.0.3       LOCAL   10.1.1.70       408525823011          ippdpl
2123456707000010 55.10.0.4       LOCAL   10.1.1.70       408525823110          ippdpl
2123456789990010 55.10.0.5       LOCAL   10.1.1.70       408525823210          ippdpl

Note All PDP contexts are displayed


The following is sample output from the show gprs gtp pdp-context msisdn command with an msisdn specified:

ggsn1#show gprs gtp pdp-context msisdn 4085258230

TID              MS Addr         Source  SGSN Addr       MSISDN                APN
2123456708000010 55.10.0.2       LOCAL   10.1.1.70       408525823010          ippdpl
2123456809000010 55.10.0.3       LOCAL   10.1.1.70       408525823011          ippdpl

Note All PDP contexts whose MSISDN matches the prefix 4085258230 are displayed


Table 21 describes the fields shown in the display.

Table 26 show gprs gtp pdp-context msisdn Field Descriptions 

Field
Description

TID

Tunnel ID for the PDP context request on the APN.

MS Addr

The IP address for the MS.

Source

Source of IP addressing for the MS. The possible values are:

DHCP—Dynamic address allocation using DHCP.

IPCP—Dynamic address allocation for PPP PDP types, or for IP PDP types with PPP regeneration, using PPP IP Control Protocol.

Local—Dynamic address allocation using a local pool.

Pending—Waiting for dynamic address allocation. Dynamic address source is unknown.

Radius—Dynamic address allocation using RADIUS.

Static—IP address is not dynamically assigned.

SGSN Addr

IP address of the SGSN that is processing the packets.

MSISDN

Integrated Services Digital Network (ISDN) number of the mobile station.

APN

Access point name.


Related Commands

Command
Description

show gprs access-point

Displays information about access points on the GGSN.

show gprs gtp status

Displays information about the current status of the GTP on the GGSN (such as activated PDP contexts, throughput, and QoS statistics).


show gprs gtp statistics

To display the current GPRS tunneling protocol (GTP) statistics for the gateway GPRS support node (GGSN) (such as IE, GTP signaling, and GTP PDU statistics), use the show gprs gtp statistics command in privileged EXEC mode.

show gprs gtp statistics

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(1)GA

This command was introduced.

12.1(2)GB

This command was integrated into Cisco IOS Release 12.1(2)GB and the following fields were added to the output display:

total created_pdp

total deleted_pdp

12.1(5)T

This command was integrated into Cisco IOS Release 12.1(5)T.

12.2(4)MX

This command was integrated into Cisco IOS Release 12.2(4)MX, and the following fields were added to the output display:

ntwk_init_pdp_act_rej

ppp_regen_pending

ppp_regen_pending_peak

ppp_regen_total_drop

ppp_regen_no_resource

total created_ppp_pdp

total ntwkInit created pdp

12.2(8)YD

This command was integrated into Cisco IOS Release 12.2(8)YD.

12.2(8)YW

This command was integrated into the Cisco IOS Release 12.2(8)YW and the following fields were added to the output display:

tft_semantic_error

tft_syntactic_error

packet_filter_semantic_error

packet_filter_syntactic_error

total deleted_ppp_pdp

12.3(2)XB

This command was integrated into Cisco IOS Release 12.3(2)XB.

12.3(8)XU

This command was integrated into Cisco IOS Release 12.3(8)XU and the following fields were added to the output display:

insert_download_route_fail

network_behind_ms APNs

pdp_wo_tft_exist

save_download_route_fail

total_download_route

total_insert_download_route

unsupported_comp_exthdr

12.3(8)XU2

This command was integrated into Cisco IOS Release 12.3(8)XU2 and the single pdp-session cleared output field was added.

12.3(11)YJ

This command was integrated into Cisco IOS Release 12.3(11)YJ.

12.3(14)YQ

This command was integrated into Cisco IOS Release 12.3(14)YQ.

12.3(14)YU

This command was integrated into Cisco IOS Release 12.3(14)YU.

12.4(2)XB

This command was integrated into Cisco IOS Release 12.4(2)XB and the following fields were added to the output display:

create_as_update

create_collide_with_delete

no_sgsn_local_del_pdp

path_fail_local_del_pdp

rcv_retransmit_create_req

version_changes

ver_upgrade_local_del

ver_faillback_local_del

12.4(9)XG

This command was integrated into Cisco IOS Release 12.4(9)XG and the following IPv6-related fields were added to the display:

created ipv6 pdp

created ipv6 pdpmcb

deleted ipv6 pdp

deleted ipv6 pdpmcb

rejected ipv6 pdp

rcvd ipv6 data bytes

rcvd ipv6 pdu

rcvd ipv6 signal msg

sent ipv6 data bytes

sent ipv6 pdu

sent ipv6 signal msg

12.4(9)XG2

This command was integrated into Cisco IOS Release 12.4(9)XG2 and the following fields were added to the display:

no_req_sgsn_local_del_pdp

no_wait_sgsn_local_del_pdp

12.4(15)XQ

This command was integrated into Cisco IOS Release 12.4(15)XQ and the following fields were added to the display:

Number of times DT enabled

total COA msg received

total COA msgs discarded

total COA triggered update

total EI rcvd on DT PDPs

total error indication sent

total error indication rcvd

total error indication rcvd DT PDPs

total update responses rcv

total update fail DT pdps


Usage Guidelines

Use the show gprs gtp statistics command to display the GTP statistics for the GGSN. The counter values displayed by this command represent totals accumulated since the last time the statistical counters were cleared using the clear gprs gtp statistics command.

Examples

The following is sample output of the show gprs gtp statistics command:

router# show gprs gtp statistics
 GPRS GTP Statistics:  
  version_not_support             0       msg_too_short               0  
  unknown_msg                     0       unexpected_sig_msg          0  
  unexpected_data_msg             0       unsupported_comp_exthdr     0  
  mandatory_ie_missing            0       mandatory_ie_incorrect      0  
  optional_ie_invalid             0       ie_unknown                  0  
  ie_out_of_order                 0       ie_unexpected               2  
  ie_duplicated                   0       optional_ie_incorrect       0  
  pdp_activation_rejected         1       tft_semantic_error          0  
  tft_syntactic_error                     pkt_ftr_semantic_error      0  
  pkt_ftr_syntactic_error         0       pdp_wo_tft_exist            0  
  non_existent 1 path_failure     0  
  total_dropped                   0       signalling_msg_dropped      0  
  data_msg_dropped 0 no_resource  0  
  get_pak_buffer_failure          0       rcv_signalling_msg         11  
  snd_signalling_msg             11       rcv_pdu_msg                53  
  snd_pdu_msg                    79       rcv_pdu_bytes             865  
  snd_pdu_bytes                3319       total created_pdp           4  
  total deleted_pdp               3       total created_ppp_pdp       3  
  total deleted_ppp_pdp           3       ppp_regen_pending           0  
  ppp_regen_pending_peak          0       ppp_regen_total_drop        0  
  ppp_regen_no_resource           0       ntwk_init_pdp_act_rej       0  
  total ntwkInit created pdp      0       single pdp-session cleared  0  
  total ntwkInit update pdp       2       total update responses rcv  2  
  total COA msg received          2       total COA msgs discarded    0  
  total COA triggered update      2       total err indications rcvd    0  
  total err indications sent      0       Number of times DT enabled    0  
  total EI rcvd on DT PDPs        0       total update fail DT pdps     0  
  created ipv6 pdp                0       rejected ipv6 pdp             0  
  deleted ipv6 pdp                0       created ipv6 pdpmcb           0  
  deleted ipv6 pdpmcb             0  
  rcvd ipv6 pdu                   0       sent ipv6 pdu                10  
  rcvd ipv6 data bytes            0       sent ipv6 data bytes       1000  
 
 GPRS Network behind mobile Statistics:  
  network_behind_ms APNs          1       total_download_route          0  
  save_download_route_fail        0       insert_download_route_fail    0  
  total_insert_download_route     0 
 
 Debug info:  
  path_fail_local_del_pdp         0       ver_upgrade_local_del         0  
  no_sgsn_local_del_pdp           0       ver_fallback_local_del        0  
  no_wait_sgsn_local_del_pdp      0       no_req_sgsn_local_del_pdp     0  
  create_collide_with_delete      0       version_changes               0  
  rcv_retransmit_create_req         0       create_as_update                 0 
router#
 
router#show gprs gtp statistics | in DT  
  total err indications sent      0       Number of times DT enabled    0 
  total EI rcvd on DT PDPs 0 total update fail DT pdps 0

Table 27 describes the fields shown in the display:

<

Table 27 show gprs gtp statistics Field Descriptions 

Field
Description

created ipv6 pdp

Number of IPv6 PDP contexts created since system startup.

created ipv6 pdpmcb

 

data_msg_dropped

Number of GTP PDUs dropped.

Debug info:
create_as_update

Number of create PDP context requests treated as update.

Debug info: create_collide_with_delete

Number of create PDP context requests that collided with delete PDP context requests.

Debug info:
no_sgsn_local_del_pdp

Number of PDPs deletes because an SGSN could not be found.

Debug info:
path_fail_local_del_pdp

Number of PDPs deletes because a path failure occurred.

Debug info:
rcv_retransmit_create_req

Number of create PDP context requests for which retransmit requests were received.

Debug info:
ver_faillback_local_del

Number of PDP deletes due to version fallback.

Debug info:
ver_upgrade_local_del

Number of PDP deletes due to version upgrade

Debug info:
verson_changes

Number of PDPs locally deleted due to change in version.

deleted ipv6 pdp

Number of IPv6 PDP contexts deleted since system startup.

deleted ipv6 pdpmcb

 

get_pak_buffer_failure

Number of times the GGSN has failed to obtain a GTP packet.

ie_duplicated

Number of GTP messages received with a duplicated information element.

ie_out_of_order

Number of GTP messages received with an information element (IE) out of order.

ie_unexpected

Number of GTP messages received with an information element that not expected in the GTP message, but is defined in GTP. GTP messages with unexpected IEs are processed as if the IE was not present.