Table Of Contents
show gprs access-point
show gprs charging parameters
show gprs charging statistics
show gprs gtp parameters
show gprs gtp path
show gprs gtp pdp-context
show gprs gtp statistics
show gprs gtp status
subscription-required
use-interface
show gprs access-point
To obtain information about access points on the GGSN, use the show gprs access-point privileged EXEC command.
show gprs access-point [access-point-index] [address-allocation] [all]
Syntax Description
access-point-index
|
Index number of an access point. Information about that access point is shown.
|
address-allocation
|
Information about dynamically allocated mobile station (MS) addresses and lease terms for the access point is shown.
|
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(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the show gprs access-point command to obtain information about an individual access point or about all access points.
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 by access point.
Use the all keyword to obtain information about all access points in an abbreviated format.
Examples
The following is sample output of the show gprs access-point command:
router# show gprs access-point 1
apn_index 1 apn_name = gprs.somewhere.com
apn_type: ip apn_mode: transparent
dynamic_address_pool: not configured
apn_dhcp_server: 10.100.0.3
apn_dhcp_gateway_addr: 10.0.0.0
apn_radius_server: 10.0.0.0
apn_charging_gw: 10.0.0.0
apn_backup_charging_gw: 10.0.0.0
deactivate_pdp_context_on violation = 0
network_activation_allowed = 0
number of ip_address_allocated = 0
Total number of PDP in this APN :4
Table 1 describes the fields shown in the display.
Table 1 show gprs access-point Field Descriptions
Field
|
Description
|
apn_backup_charging_gw
|
IP address of the secondary (backup) charging gateway.
Note This gateway can not be configured on the GGSN.
|
apn_charging_gw
|
IP address of the primary charging gateway.
Note This gateway can not be configured on the GGSN.
|
apn_dhcp_gateway_addr
|
IP address of the DHCP gateway, if configured.
|
apn_dhcp_server
|
IP address of the DHCP server, if configured.
|
apn_index
|
Number assigned to this access point.
|
apn_mode
|
Indicates whether security is transparent or non-transparent.
|
apn_name
|
Access-point number name.
|
apn_radius_server
|
IP address of RADIUS server, if configured.
|
apn_type
|
Protocol used for this access-point number.
|
deactivate_pdp_context_on violation
|
Current setting for the access-violation command: 0 indicates that the default setting is active (user packets are discarded); 1 indicates that the optional setting is active (mobile sessions are terminated when there is an access violation).
|
dynamic_address_pool
|
Current setting for the ip-address-pool command.
|
network_activation_allowed
|
Not supported in the current release.
|
number of ip_address_allocated
|
Number of IP addresses allocated to MS users.
|
subscribe_required
|
Current setting for the subscription-required command: 0 indicates no subscription is required; 1 indicates a subscription is required for access-point number users.
|
Total number of PDP in this APN
|
Number of PDP contexts active for this access-point number.
|
Related Commands
Command
|
Description
|
access-point-name
|
Specifies the network (or domain) name for a PDN that users can access from the GGSN at a defined access point.
|
show gprs charging parameters
To display information about the current GPRS charging configuration, use the show gprs charging parameters privileged EXEC command.
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(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
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.23.55.1
* Default Backup Charging Gateway Address: 172.23.56.23
* Current Active Charging Gateway Address: 172.23.55.1
* Current Backup Charging Gateway Address: 172.23.56.23
* Charging Server Switch-Over Timer: <60> seconds.
* Charging Path Protocol (0:UDP, 1:TCP): <0>.
* 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 Tariff Time Changes:
- NO Tariff Time Changes.
Table 2 describes the fields shown in the display.
Table 2 show gprs charging parameters Field Descriptions
Field
|
Description
|
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 MAP DATA TOS
|
Type of service (ToS) priority currently configured for GPRS 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 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 (0:UDP, 1:TCP)
|
Binary value representing the protocol in use between the GGSN and the charging gateway. When 0, UDP is in use; when 1, TCP is in use.
You can configure the charging path protocol using the gprs charging path-protocol 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 Tariff Time Changes
|
Time of day when GPRS 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, or 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.
|
Related Commands
Command
|
Description
|
show gprs charging statistics
|
Displays current statistics for the transfer of charging packets between the GGSN and charging gateways.
|
show gprs charging statistics
To display current statistics about the transfer of charging packets between the GGSN and charging gateways, use the show gprs charging statistics privileged EXEC command.
show gprs charging statistics {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 statistics.
|
all
|
Requests display of all charging statistics.
|
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1(1)GA
|
This command was introduced.
|
12.1(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the show gprs charging statistics command to display statistics for the transfer of charging packets between the GGSN and charging gateways.
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 APNs for Charging: <1>
* Total Number of CDRs for Charging: <1>
* Total Number of CLOSED CDRs for Charging: <0>
* Total Number of Containers for Charging: <0>
* Total Number of pending unack. CDR_Output_Msgs: <0>
* Total Number of CDR_Output_Msgs sent: <7>
-- Charging Gateway Statistics --
* Charging Gateway Down Count: <5>
* Last Charging Gateway Down Time = 2000/10/3 18:47:22
Table 3 describes the fields shown in the display.
Table 3 show gprs charging statistics Field Descriptions
Field
|
Description
|
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.
|
Total Number of APNs for Charging
|
Number of access points for which charging data has been collected since the last startup of the GGSN.
|
Total Number of CDRs for Charging
|
Number of currently open and closed G-CDRs on the GGSN.
|
Total Number of CDR_Output_Msgs sent
|
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.
|
Total Number of CLOSED CDRs for Charging
|
Number of currently closed G-CDRs that the GGSN has not yet sent to the charging gateway.
|
Total Number of Containers for Charging
|
Number of all currently open and closed charging containers for all G-CDRs on the GGSN.
|
Total 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
show gprs gtp parameters
To display information about the current GPRS Tunneling Protocol (GTP) configuration on the GGSN, use the show gprs gtp parameters privileged EXEC command.
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(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
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 max hold time for old sgsn PDUs T3_tunnel= 20
GTP buffer size for receiving N3_buffer = 8192
GTP max pdp context = 45000
Table 4 describes the fields shown in the display.
.
Table 4 show gprs gtp parameters Field Descriptions
Field
|
Description
|
GTP buffer size for receiving N3_buffer
|
Current size of the N3 buffer, in bytes.
|
GTP max hold time for old sgsn PDUs T3_tunnel
|
Current setting specified by the gprs gtp t3-tunnel command. This command specifies the interval, in seconds, that a GGSN waits to forward a PDU to a requesting SGSN.
|
GTP max pdp context
|
Current setting, specified by gprs maximum-pdp-context-allowed command. This command specifies the maximum number of PDP contexts (mobile sessions) that can be activated on the GGSN.
|
GTP max retry N3_request
|
The maximum retry setting for N3 requests.
|
GTP path echo interval
|
Interval, in seconds, that the GGSN waits before resending echo responses.
|
GTP signal max wait time T3_response
|
Interval, in seconds, that the GGSN waits before responding to a T3 request.
|
Related Commands
Command
|
Description
|
gprs gtp n3-buffer-size
|
Specifies the size of the receive buffer that the GGSN uses to receive GTP signaling messages and packets sent through the tunneling protocol.
|
gprs gtp n3-requests
|
Specifies the maximum number of times that the GGSN attempts to send a signaling request.
|
gprs gtp path-echo-interval
|
Specifies the interval that the GGSN waits before sending an echo-request message to check for GTP path failure.
|
gprs gtp t3-response
|
Specifies the maximum time that the GGSN waits to respond to a signaling request message.
|
gprs gtp t3-tunnel
|
Specifies the length of time that the GGSN waits, after receiving a GTP context request message from the SGSN, before forwarding a PDU to the requesting SGSN.
|
gprs maximum-pdp-context-allowed
|
Specifies the maximum number of PDP contexts (mobile sessions) that can be activated on the GGSN.
|
show gprs gtp path
To display information about one or more GTP paths between the GGSN and other GPRS devices, use the show gprs gtp path privileged EXEC command.
show gprs gtp path {ip-address | all}
Syntax Description
ip-address
|
Displays GTP path information for a specified IP address.
|
all
|
Displays information for all GTP paths.
|
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1(1)GA
|
This command was introduced.
|
12.1(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the show gprs gtp path command to display information about one or more GTP paths from the GGSN.
Examples
The following is sample output of the show gprs gtp path command:
router# show gprs gtp path all
path pointer local address Remote address
0x616378D0 10.10.10.1 1.1.1.1
Table 5 describes the fields shown in the display.
Table 5 show gprs gtp path Field Descriptions
Field
|
Description
|
local address
|
The local address for the path.
|
path pointer
|
The value of the GGSN internal pointer to the GTP path, in hexadecimal.
|
remote address
|
Address of the remote end of the path.
|
total number of paths
|
Total number of GTP paths.
|
show gprs gtp pdp-context
To display a list of the currently active PDP contexts (mobile sessions), use the show gprs gtp pdp-context privileged EXEC command.
show gprs gtp pdp-context {tid tunnel_id | imsi imsi | path ip-address | access-point
access-point-index | pdp-type ip | qos-precedence {low | normal | high} | all}
Syntax Description
tid tunnel_id
|
Displays PDP contexts by tunnel ID.
|
imsi imsi
|
Displays PDP contexts by International Mobile Subscriber Identity (IMSI).
|
path ip-address
|
Displays PDP contexts by IP address.
|
access-point access-point-index
|
Displays PDP contexts by access point.
|
pdp-type ip
|
Displays PDP contexts that are transmitted via IP.
|
qos-precedence
|
Displays PDP contexts for a specified GPRS quality of service precedence type. You can specify the following precedence types: low, normal, or high.
|
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(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
12.2(1)
|
The MS International PSTN/ISDN Number (MSISDN) field was added to the output display.
|
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, or you can display all PDP contexts.
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 QoS class (high, 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 example, the default bandwidth for a PDP context in the best effort QoS class is 10 bps. (You can configure this value using the gprs canonical-qos best-effort bandwidth-factor command.) The value 10 appears in the effective bandwidth field of the show gprs gtp pdp-context tid command for a PDP context in the best effort class.
To determine an estimate of the potential number of best effort PDP contexts that can be supported on the GGSN, you can divide the total bandwidth available on the GGSN by the effective bandwidth value. For example, the default bandwidth available on the GGSN is 1048576 bps. (The total GSN resource available is reported in the total gsn_resource field in the output of the show gprs gtp status command.) Therefore, you can divide 1048576 bps by 10 bps to yield support for approximately 104857 best effort PDP contexts.
Examples
Example 1
The following is sample output of the show gprs gtp pdp-context all command:
GGSN_1# show gprs gtp pdp-context all
TID MS_ADDR dynamic? SGSN_addr APN
1111111111111111 10.2.0.1 0 10.10.10.10 gprs.somewhere.com
3333333333333331 10.10.10.30 1 10.10.10.10 gprs.somewhere.com
4444444444444441 10.60.0.4 1 10.10.10.10 xyz.com
5555555555555551 10.2.0.51 0 10.10.10.10 gprs.somewhere.com
8888888888888881 10.10.10.31 1 10.10.10.10 gprs.somewhere.com
Table 6 describes the fields shown in the display.
Table 6 show gprs gtp pdp-context Field Descriptions
Field
|
Description
|
APN
|
Access-point name for the access point on which the PDP context is active.
|
dynamic
|
The method used for address allocation for mobile station sessions; 0 indicates that static IP address mapping is used; 1 indicates dynamic address allocation through DHCP.
|
MS_ADDR
|
IP address of the mobile station.
|
SGSN_addr
|
IP address of the SGSN that is processing the packets.
|
TID
|
Tunnel ID for the PDP context.
|
.
Example 2
The following is sample output from the show gprs gtp pdp-context tid command:
router# show gprs gtp pdp-context tid 12F1111103000000
TID MS_ADDR dynamic? SGSN_addr APN
12F1111103000000 10.1.1.1 0 10.1.1.68 gprs.cisco.com
current time :Jan 29 2001 10:30:36
user_name (IMSI): 211F111130000000 MS address: 10.1.1.1
MS International PSTN/ISDN Number (MSISDN): 21436587214365
sgsn_addr_signal: 10.1.1.68 ggsn_addr_signal: 10.100.100.1
signal_sequence: 32 seq_tpdu_up: 0
upstream_signal_flow: 1 upstream_data_flow: 2
downstream_signal_flow: 187 downstream_data_flow: 170
pdp_create_time: Jan 29 2001 10:27:20
last_access_time: Jan 29 2001 10:27:20
mnrgflag: 0 tos mask map: 00
gprs qos_req: 1B021F canonical Qos class(reg.): 01
gprs qos_neg: 1B031F canonical Qos class(neg.): 01
rcv_byte_count: 0 rcv_pkt_count: 0
send_byte_count: 0 send_pkt_count: 0
fast_up_pkt: 0 fast_up_byte : 0
fast_down_pkt: 0 fast_down_byte : 0
charging_id: 1 pdp reference count : 2
Table 7 describes the fields shown in the display:
Table 7 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.
|
canonical Qos class (req.)
|
Requested canonical quality of service class by the PDP context.
|
charging_id
|
Unique 4-octet value generated by the GGSN for the PDP context. The value 0 is reserved.
|
current time
|
Date and time of the show command output.
|
downstream_data_flow
|
Flow label of downlink G-PDUs.
|
downstream_signal_flow
|
Flow label of downlink signaling messages.
|
dynamic
|
Method used for MS address allocation, with the following values:
• 0—static IP address mapping
• 1—dynamic address allocation using DHCP
|
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 (high, normal, or best effort) for 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.
Note The effective bandwidth does not represent actual bandwidth usage.
|
fast_down_byte
|
Total number of G-PDU bytes fast switched on the downlink, from the GGSN to the SGSN.
|
fast_down_pkt
|
Total number of G-PDU packets fast switched on the downlink, from the GGSN to the SGSN.
|
fast_drop
|
Total number of G-PDU packets dropped during fast switching.
|
fast_up_byte
|
Total number of G-PDU bytes fast switched on the uplink, from the SGSN to the GGSN.
|
fast_up_pkt
|
Total number of G-PDU packets fast switched on the uplink, from the SGSN to the GGSN.
|
ggsn_addr_signal
|
IP address of the GGSN.
|
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
|
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 quality of service profiles):
• v—Delay class
• w—Reliability class
• x—Peak throughput class
• y—Precedence class
• zz—Mean throughput class
|
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.
|
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.
|
MS International PSTN/ISDN Number (MSISDN)
|
Integrated Services Digital Network (ISDN) number of the mobile station.
|
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.
|
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.
|
send_byte_count
|
Total number of G-PDU bytes sent by the GGSN.
|
send_pkt_count
|
Total number of G-PDU packets sent by the GGSN.
|
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.
|
SGSN_addr
sgsn_addr_signal
|
IP address of the SGSN that is processing the packets.
|
signal_sequence
|
Last sequence number used in the GTP signaling message.
|
TID
|
Tunnel ID for the PDP context. This value corresponds to the IMSI plus NSAPI.
|
tos mask map
|
ToS value in IP header of this PDP context.
|
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.
|
Related Commands
show gprs gtp statistics
To display the current GPRS Tunneling Protocol (GTP) statistics for the GGSN (such as IE, GTP signaling, and GTP PDU statistics), use the show gprs gtp statistics privileged EXEC command.
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
|
The following fields were added to the output display:
• total created_pdp
• total deleted_pdp
|
12.1(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
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
version_not_support 0 msg_too_short 0
unknown_msg 0 unexpected_sig_msg 0
unexpected_data_msg 12762 mandatory_ie_missing 0
mandatory_ie_incorrect 0 optional_ie_invalid 0
ie_unknown 0 ie_out_of_order 0
ie_unexpected 0 ie_duplicated 0
optional_ie_incorrect 0 pdp_activation_rejected 0
path_failure 0 total_dropped 0
no_resource 0 get_pak_buffer_failure 0
rcv_signalling_msg 27854 snd_signalling_msg 27854
rcv_pdu_msg 12762 snd_pdu_msg 0
rcv_pdu_bytes 1174104 snd_pdu_bytes 0
total created_pdp 4 total deleted_pdp 3
Table 8 describes the fields shown in the display.
Table 8 show gprs gtp statistics Field Descriptions
Field
|
Description
|
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).
|
ie_out_of_order
|
Number of GTP messages received with an IE out of order.
|
ie_unexpected
|
Number of GTP messages received with an IE that is 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.
|
ie_unknown
|
Number of GTP messages received with an IE of an unknown type.
|
length_mismatch
|
Number of GTP messages rejected because the length field of the UDP and GTP headers did not match.
|
mandatory_ie_incorrect
|
Number of GTP messages received with an incorrect mandatory IE—for example, with an IE of incorrect length.
|
mandatory_ie_missing
|
Number of GTP messages received that are missing a mandatory IE.
|
msg_too_short
|
Number of GTP messages received that are too short to hold the GTP header for the supported GTP version.
|
no_resource
|
Number of times a resource was not available for transmitting GTP messages. For example, the router may be out of memory.
|
optional_ie_incorrect
|
Number of GTP messages received with an incorrect optional IE. This prevents the GGSN from processing the GTP message correctly.
|
optional_ie_invalid
|
Number of GTP messages received with an IE containing a value outside the defined range for that IE. GTP messages with invalid optional IEs are processed as if the IE were not present.
|
path_failure
|
Number of path failures on the GPRS Support Node (GSN).
|
pdp_activation_rejected
|
Number of times a request to activate a PDP context was rejected.
|
rcv_pdu_bytes
|
Number of bytes received in protocol data units (PDUs).
|
rcv_pdu_msg
|
Number of PDU messages received.
|
rcv_signaling_msg
|
Number of GTP signaling messages received.
|
snd_pdu_bytes
|
Number of PDU bytes sent.
|
snd_pdu_msg
|
Number of PDU messages sent.
|
snd_signalling_msg
|
Number of GTP signaling messages sent.
|
total_dropped
|
Number of GTP messages dropped.
|
unexpected_data_msg
|
Number of GTP PDUs received for nonexistent PDP contexts.
|
unexpected_sig_msg
|
Number of unexpected GTP signaling messages received—for example, a message received on the wrong end of the tunnel, or a response message received for a request that was not sent by the GGSN.
|
unknown_msg
|
Number of unknown GTP messages received.
|
version_not_support
|
Number of GTP messages received from devices running an unsupported version of the GTP.
|
total created_pdp
|
Total number of PDP contexts created since system startup (supports Special Mobile Group (SMG)-28 standards level and later).
|
total deleted_pdp
|
Total number of PDP contexts deleted since system startup (supports SMG-28 standards level and later).
|
Related Commands
show gprs gtp status
To display information about the current status of the GPRS Tunneling Protocol (GTP) on the GGSN (such as activated PDP contexts, throughput, and QoS statistics), use the show gprs gtp status privileged EXEC command.
show gprs gtp status
Syntax DescriptionDescription
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(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the show gprs gtp status command to display information about the status of the GTP running on the GGSN.
The values displayed by the show gprs gtp status command show totals since the GGSN was started. Unlike the values displayed by the show gprs gtp statistics command, these values cannot be cleared.
Examples
The following example shows output from the show gprs gtp status command:
router# show gprs gtp status
gsn_used_bandwidth 0.0 total gsn_resource 1048576.0
activated_pdp 0 mean_throughput_premium 0.0
mean_throughput_normal 0.0 mean_throughput_besteffort 0.0
qos_high_pdp 0 qos_normal_pdp 0
qos_low_pdp 0 qos premium mean-throughput-deviation 0.100
Table 9 describes the fields shown in the display.
Table 9 show gprs gtp status Field Descriptions
Field
|
Description
|
activated_pdp
|
Number of PDP contexts currently activated.
|
gsn_resource
|
Currently available GSN resources.
|
gsn_used_bandwidth
|
Currently used bandwidth, in bits per second.
|
mean_throughput_besteffort
|
Total mean throughput for best effort QoS users, in bytes.
|
mean_throughput_normal
|
Total mean throughput for normal QoS users, in bytes.
|
mean_throughput_premium
|
Total mean throughput for premium QoS users, in bytes.
|
qos_high_pdp
|
Current number of PDP contexts that have a high QoS.
|
qos_low_pdp
|
Current number of PDP contexts that have a low QoS.
|
qos_normal_pdp
|
Current number of PDP contexts that have a normal QoS.
|
qos premium mean-throughput-deviation
|
Current mean throughput deviation for QoS.
|
Related Commands
Command
|
Description
|
encapsulation gtp
|
Specifies GTP as the encapsulation type for packets transmitted over the virtual template interface.
|
show gprs gtp statistics
|
Displays the current GTP statistics for the GGSN.
|
subscription-required
To specify that a subscription is required to access a PDN through a particular access point, use the subscription-required access-point configuration command. To restore the default setting (no subscription is required), use the no form of the command.
subscription-required
no subscription-required
Defaults
No subscription is required
Command Modes
Access-point configuration.
Command History
Release
|
Modification
|
12.1(1)GA
|
This command was introduced.
|
12.1(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the subscription-required command to specify that a subscription is required for user access to PDNs through the current access point. The subscription must be set up by the service provider, and subscription information must be passed with the mobile user's PDP context requests.
Examples
The following example shows that access-point subscription is required:
access-point-name gprs.somewhere.com
use-interface
To configure the GGSN to use a specific interface for user access at a particular access point, use the use-interface access-point configuration command. To deactivate the use of a specific interface, use the no form of the command.
use-interface interface_name next-hop-address ip_address
no use-interface interface_name next-hop-address ip_address
Syntax Description
interface_name
|
Name of an interface on the router to be used by the specified access point.
|
ip_address
|
IP address of the gateway device for the virtual private network.
|
Defaults
No specific interface is used.
Command Modes
Access-point configuration
Command History
Release
|
Modification
|
12.1(1)GA
|
This command was introduced.
|
12.1(3)T
|
This command was integrated in Cisco IOS Release 12.1(3)T.
|
Usage Guidelines
Use the use-interface command to specify a specific router interface to be used with a specified access point. The interface_name argument specifies the name of the interface and the ip-address argument specifies the IP address of the Internet gateway device used for the virtual private network.
Examples
The following example specifies that access-point 1 will use the FastEthernet 4/0 interface on the router:
access-point-name gprs.anywhere.com
use-interface FastEthernet4/0 next-hop-address 4.0.0.2