Technical Documentation

show services pgcp gate

Syntax

show services pgcp gate gateway-name gateway-name gate-id gate-id< brief | extensive | session-mirroring | statistics><master | backup>

Release Information

Command introduced in Junos OS Release 9.5.

statistics option introduced in Junos OS Release 9.1.

session-mirroring option introduced in Junos OS Release 9.2.

gateway option introduced in Junos OS Release 9.5.

master option introduced in Junos OS Release 9.6

backup option introduced in Junos OS Release 9.6

Description

Display in-depth information about a Packet Gateway Control Protocol (PGCP) gate.

Options

gateway gateway-name

(Optional) Display information about gates associated with this virtual border gateway function (BGF).

gate-id gate-id

(Optional) Display information about a particular gate.

brief

(Optional) Display brief output.

extensive

(Optional) Display extensive output.

session-mirroring

(Optional) Display the session mirroring information for gates that are being mirrored. You must have a login with sufficient permission to view session mirroring information. The set system login class class-name permissions pgcp-session-mirroring command grants this permission.

statistics

(Optional) Display statistics for gates.

master

(Optional) Display information for the backup services PIC. This option applies if you are running the virtual BGF on a services PIC or MS-DPC, and you have a primary and backup PIC configured on a virtual redundant MultiServices PIC (rms) interface.

backup

(Optional) Display information for the Routing Engine or primary services PIC. If the virtual BGF is running on the Routing Engine, gate information for the routing engine is displayed. If the virtual BGF is running on a services PIC, gate information the primary services PIC is displayed. If you do not specify the master or backup options, the master option is the default.

Required Privilege Level

view

pgcp-session-mirroring—To view session mirroring fields.

List of Sample Output

show services pgcp gate
show services pgcp gate extensive
show services pgcp gate statistics
show services pgcp gate session-mirroring

Output Fields

Table 1 lists the output fields for the show services pgcp gate command. Output fields are listed in the approximate order in which they appear.

Table 1: show services pgcp gate Output Fields

Field Name

Field Description

Output Level

Gate information

Information about the gate.

brief, extensive

Direction

Direction of the gate.

brief, extensive

State

State of the gate:

  • active
  • disabled
  • closed

brief, extensive

remote source address

IP address of the remote source of the gate.

brief, extensive

remote source port

Port of the remote source of the gate.

brief, extensive

remote dest address

IP address of the remote destination of the gate.

brief, extensive

remote dest port

Port of the remote destination of the gate.

brief, extensive

local source address

IP address of the local source of the gate.

brief, extensive

local source port

Port of the local source of the gate.

brief, extensive

local dest address

IP address of the local destination of the gate.

brief, extensive

local dest port

Port of the local destination of the gate.

brief, extensive

transport

Transport protocol.

brief, extensive

gate version

Numeric identifier for the version of the gate.

brief, extensive

latch

Latch status:

  • latch
  • none

brief, extensive

yellow action

Action to take in this state.

brief, extensive

red action

Action to take in this state.

brief, extensive

notifications

Number of notifications.

brief, extensive

User Data

Numeric identifier for the user data.

brief, extensive

Transport

H.248 media descriptor field:

  • udp
  • tcp
  • rtp
  • avp

extensive

RTCP

Additional (shadow) gate allocated for the Real-Time Control Protocol (RTCP): auto or off.

extensive

Latch

State of the latch action on the gate:

  • none
  • latch
  • relatch

extensive

DSCP

DiffServ code point (DSCP) marking value for the gate.

extensive

Policing

Status of policing on the gate:

  • On
  • Off

extensive

Fast update filter

Status of the fast update filter:

  • On
  • Off

extensive

Gate Statistics

Statistics for the specific gate.

statistics

Output Packets

Number of output packets from the PIC.

statistics

Input Packets

The number of PIC input packets plus the number of packets that the Packet Forwarding Engine dropped because they did not conform to rate limits.

statistics

Dropped Packets

Number of packets that the Packet Forwarding Engine and the PIC dropped because they did not conform to rate limits.

statistics

Lost RTP Packets

Number of RTP packets that have been lost on this gate.

statistics

Fractional lost RTP Packets

The fraction of RTP data packets that the remote side lost. The fraction is expressed as a percentage value.

statistics

RTCP Statistics

RTCP statistics for packets sent and received.

statistics

RTCP Sender Statistics

RTCP statistics for the sending endpoint.

statistics

SSRC

Synchronization source ID for the sending endpoint.

statistics

Sender Octets

Number of octets sent.

statistics

Sender Packets

Number of packets sent.

statistics

Invalid Packets

Number of invalid packets.

statistics

RTCP Receiver Statistics

Statistics for the endpoint receiving the RTCP packets.

statistics

SSRC

Synchronization source ID for the receiving endpoint.

statistics

Lost packets

The number of RTP data packets that the remote side lost in the current transmission.

statistics

Lost fraction

The fraction (percentage) of RTP data packets that the remote side lost in the current transmission.

statistics

Jitter

An estimate of the statistical variance of the RTP data packet interarrival time. The jitter is measured in the units of the RTP timestamp and represents the mean deviation of the difference in packet spacing at the receiver compared to the sender for a pair of packets.

statistics

Received RTCP-XR Statistics:

Statistics on RTCP packets sent and received.

statistics

Packet loss concealment

Method of packet loss concealment:

  • U—Unspecified
  • E—Enhanced
  • D—Disabled
  • S—Standard

statistics

Loss Rate

The fraction of RTP data packets from the source lost since the beginning of reception.

statistics

Discard Rate

The fraction of RTP data packets from the source that have been discarded since the beginning of reception.

statistics

Round Trip Delay

The most recent round-trip time between interfaces, in milliseconds.

statistics

End System Delay

The most recently estimated end system delay, expressed in milliseconds.

statistics

Signal Level

The voice signal relative level shown as the ratio of the signal level to dBm0.

statistics

Noise Level

The ratio of the silent period background noise level to dBm0.

statistics

RERL

The residual echo return loss value expressed as an integer in the range from 0 to 100 dB. A value of 94 corresponds to "toll quality", and values of 50 or less are regarded as unusable. This metric includes the effects of delay.

statistics

R Factor

A voice quality metric describing the segment of the call that is carried over this RTP session expressed as an integer in the range from 0 to 100 dB. A value of 94 corresponds to "toll quality", and values of 50 or less are regarded as unusable. This metric includes the effects of delay. A value of 127 indicates that this parameter is unavailable.

statistics

Ext. R Factor

The external R factor is a voice quality metric describing the segment of the call that is carried over a network segment external to the RTP segment, such as a cellular network. Its values are interpreted in the same manner as for the RTPR factor. This metric includes the effects of delay and relates to the outward voice path from the VoIP termination for which this metrics block applies.

statistics

MOS-LQ

The estimated mean opinion score for listening quality (MOS-LQ) is a voice quality metric on a scale from 1 to 5, in which 5 represents excellent and 1 represents unacceptable. It includes the effects of delay and other effects that would affect listening quality.

statistics

MOS-CQ

The estimated mean opinion score for conversational quality (MOS-CQ) is a voice quality metric on a scale from 1 to 5, in which 5 represents excellent and 1 represents unacceptable. It includes the effects of delay and other effects that would affect conversational quality.

statistics

Received RTCP Burst Metrics Statistics

This section provides statistics for burst metrics received from the far end of the RTCP session.

statistics

Minimum Gap Threshold

This field contains the value used for this report block to determine if a gap exists. The recommended value of 16 corresponds to a burst period having a minimum density of 6.25 percent of lost or discarded packets, which may cause noticeable degradation in call quality. During gap periods defined with a threshold of 16, each lost or discarded packet is preceded by and followed by a sequence of at least 16 received non-discarded packets.

statistics

Burst Density

The fraction of RTP data packets within burst periods since the beginning of reception that were either lost or discarded.

statistics

Burst Duration

The mean duration of the burst periods that have occurred since the beginning of reception, in milliseconds.

statistics

Gap Loss Density

The fraction of RTP data packets within inter-burst gaps since the beginning of reception that were either lost or discarded.

statistics

Gap Duration

The mean duration of the gap periods that have occurred since the beginning of reception, in milliseconds.

statistics

Gate Measured Rate

Current gate throughput measured in bytes per second.

statistics

Rate-Limiting Statistics

Counter showing data traffic statistics based on the TRTC (two-rate-three-colors) policer.

statistics

FUF statistics

The number of dropped packets when the Fast Update Filter was enabled on the gate.

statistics

Drop count

The number of packets dropped by the data PIC.

statistics

Session mirroring status

Status of session mirroring:

  • On
  • Off

session mirroring

Session mirroring correlation number

Indicates whether the data mirrors are encrypted.

session mirroring

Session mirroring target ID list

One or more targets of the mirrored packets.

session mirroring

Session mirroring direction

Direction of session mirroring:

  • Egress
  • Ingress

session mirroring

Sample Output

show services pgcp gate

user@host> show services pgcp gate gateway pg1 gate-id 4295033088
Gate information:
Direction: A->B 

State: active 

remote source address: 3.0.0.101 

remote source port: * 

remote dest address: 4.0.0.102 

remote dest port: 5060 

local source address: - 

local source port: - 

local dest address: 3.99.99.100 

local dest port: 5060 

transport: udp 

gate version: 00 

latch: none 

yellow action: forward 

red action: drop 

notifications: 64 

User Data: 0001102000000000

show services pgcp gate extensive

user@host> show services pgcp gate gateway pg1 gate-id 2817498611968 extensive
Gate information:
================

Gate id: 2817498611968
Gate state: active
Direction: A->B
Action: drop
Remote source address: *
Remote source port: *
Remote destination address: 3.0.0.102
Remote destination port: 20000
Local source address: [20.50.150.1]
Local source port: [2334]
Local destination address: 10.50.150.1
Local destination port: 2334
Transport: rtp/avp
RTCP: On
Latch: none
DSCP: 0x40 (Effective 16)
Policing: Off
Fast update filter: Off

show services pgcp gate statistics

user@host> show services pgcp gate gateway pg1 gate-id 98784313601 statistics
Gate Statistics:
================
Output packets: 0
Input packets: 0
Dropped packets: 0
Lost RTP packets: 0
Fractional lost RTP packets: 0

RTCP statistics:
================
    RTCP Sender statistics:                              
    SSRC : 122598409 Sender octets: 268632      Sender packets: 1599 
    Invalid packets: 0

    RTCP Receiver statistics:                             
    SSRC: 14479      Lost packets: 0            Lost fraction: 0.00 
    Jitter: 0

    Received RTCP-XR Statistics:               
    Packet Loss Concealment: 0         Loss Rate: 0           Discard Rate: 0
    Round Trip Delay: 0                End System Delay: 0    Signal Level: 0
    Noise Level: 0                     RERL: 0                R Factor: 0 
    Ext. R Factor: 0                   MOS-LQ: 0              MOS-CQ: 0

    Received RTCP Burst Metrics Statistics:    
    Minimum Gap Threshold: 0           Burst Density: 0       Burst Duration: 0  
    Gap loss Density: 0                Gap Duration: 0        

Gate measured rate: 0

Rate limiting statistics:

Mark Color   Number of Packets    Number of Bytes

Green                      205              41000
Yellow                       0                  0
Red                          0                  0

FUF statistics:
Drop count: 0

show services pgcp gate session-mirroring

user@host> show services pgcp gate gateway pg1 gate-id 4295033088 session-mirroring
Gate information:
Gate id: 4295033088
Session mirroring status: On
Session mirroring correlation number: 0x8040c020a060e010
Session mirroring target ID list: [008040c0, ffffff80]
Session mirroring direction: Egress

Published: 2010-08-03

Help
|
My Account
|
Log Out