Guest

Cisco PGW 2200 Softswitch

Calling Name Delivery (CNAM)

  • Viewing Options

  • PDF (541.9 KB)
  • Feedback
Calling Name Delivery (CNAM)

Table Of Contents

Calling Name Delivery (CNAM)

Understanding the CNAM Feature

Benefits

Call Flow Examples

CNAM Invocation Procedure

Generic Number Parameter Included in Initial Address Message (IAM)

GN Parameter NOT included in IAM

CNAM Database Query Procedure

CNAM Presentation

Prerequisites for Using this Feature

Limitations

Supported Standards, MIBs, and RFCs

Related Documents

Prerequisites for Using This Feature

Dial Plan Examples

Billing Interface

CNAM DIP (Tag: 4240)

Calling Name (Tag: 4241)

Result Type Definitions

Troubleshooting the CNAM Feature

Obtaining Documentation, Obtaining Support, and Security Guidelines

Glossary


Calling Name Delivery (CNAM)


Document Release History

Publication Date
Comments

June 25, 2007

Initial version of the document.


Feature History

Release
Modification

9.7(3)

The Calling Name Delivery (CNAM) feature was introduced on the Cisco MGC software.


This document describes the Calling Name Delivery (CNAM) feature in the following sections:

Understanding the CNAM Feature

Dial Plan Examples

Billing Interface

Result Type Definitions

Troubleshooting the CNAM Feature

Obtaining Documentation, Obtaining Support, and Security Guidelines

Understanding the CNAM Feature

This feature allows the name of the calling party to be delivered to the called party if the called party has subscribed to the CNAM feature. CNAM is a terminating user feature allowing a customer premises equipment (CPE) connected to a switching system to receive a calling party's name during the first silent interval.

The PGW 2200 supports transaction capabilities application part (TCAP) query to a CNAM database, and only if, it is allowed based on calling name delivery blocking (CNAB) and calling identity delivery and suppression (CIDS) information. The calling party name resides in the line information database (LIDB) which is accessed using TCAP query.

Benefits

The following are the benefits of this feature:

Supports CNAM for PSTN (ANSI SS7) to IP (H.323 and SIP) calls.

Obtains calling name by performing a TCAP name query to the CNAM database. The query is be initiated according to Telcordia Technologies Generic Requirements GR-1188-CORE.

The decision to query the database depends on the called number.

The CNAM presentation to the called entity depends on the ISUP and TCAP generic name presentation parameters.

Call Flow Examples

The following figures depict the CNAM call flows. In the figures, Query represents an SS7 TCAP query message, and Response represents an SS7 TCP Response message. The symbol P represents a "private" indication, and the symbol O represents an "out-of-area/unavailable" indication, in messages sent to the called user's CPE when the calling party name cannot be sent. Messages are numbered according to the time order of occurrence.

Figure 1 CNAM Architecture Call Flow

Figure 2 Calling Name Presentation Restriction

Figure 3 Calling Name Presentation Allowed

Figure 4 Calling Name Presentation Private

CNAM Invocation Procedure

Generic Number Parameter Included in Initial Address Message (IAM)

If the generic number (GN) type of name indicates 1 (name not available), PGW initiates a CNAM database query as defined in the "CNAM Database Query Procedure" section.

If it is calling name type and the name is available, PGW continues to analyze the presentation field next.

If the GN presentation indicates 11 (no indication) or 10 (blocking toggle), PGW initiates a CNAM database query as defined in the "CNAM Database Query Procedure" section.

If the received GN presentation is set to 01 (presentation restricted), PGW sends the name "Private" text to the egress trunk.

If the received GN Presentation is set to "presentation allowed", PGW populates the name text based on the received GN characters and sends it to egress trunk.

If the nature of address of the calling party number (CPN) does not indicate "unique/non-unique national number", the call appearance (CA) sends an "out-of-area/unavailable" text to the egress trunk.

GN Parameter NOT included in IAM

If the (CPN) is received in the IAM, PGW uses it to invoke a name query to an external name database (CNAM/LIDB).

If it is received but the nature of address of the CPN does not indicate "unique/non-unique national number", then the CA sends an "out-of-area/unavailable" text to the egress trunk.

Otherwise, PGW proceeds to query the CNAM/LIDB database as defined in the "CNAM Database Query Procedure" section.

CNAM Database Query Procedure

When the CA invokes the name query procedure (CNAM DB), it performs the following:

1. CA starts the timer Tname for the name query and initiates the TCAP query.

2. The TCAP Name Query is initiated according to GR-1188:

3. The setting of the name text as a result of the TCAP query is:

If the Tname expires before a TCAP response is received, or a TCAP error/reject is received, PGW proceeds with the call termination with the name text set to "out-of-area/unavailable".

If the received TCAP GN does not have the "Type of Name" set to 001 (calling name) or the "Availability" is set to 1 (name unavailable), or no name characters are present, then PGW proceeds with the call termination with the name text set to "out-of-area/unavailable". Otherwise PGW continues the following steps.

4. If NO GN was received in the IAM before, the CA uses the received TCAP GN as shown in Table 1.

Table 1 No GN Received in IAM Message

Input
CNAM Output
TCAP GN Presentation
Name Text sent to called party

00: Permanently presentation allowed

Name: TCAP GN characters

01: Permanently presentation restricted

Name: "Private"

10: Blocking toggle

Name: "out-of-area/unavailable"

11: no indication

Name: "out-of-area/unavailable"


5. If GN was received in the IAM, the CA uses the received TCAP GN as shown in Table 2.

Table 2 GN Received in IAM Message

Input
Output
ISDN GN Presentation
TCAP GN Presentation
Name Text Sent to Called Party

CIDS: Allowed

Allowed

Name: TCAP GN Characters

CIDS: Allowed

Restricted

Name: TCAP GN Characters

CIDS: Allowed

Blocking Toggle

Name: TCAP GN Characters

CIDS: Allowed

No Indication

Name: TCAP GN Characters

CIDS: Restricted

Not Applicable (No Query Generated)

Name: "Private"

CNAB: Blocking Toggle

Allowed

Name: "Private"

CNAB: Blocking Toggle

Restricted

Name: TCAP GN Characters

CNAB: Blocking Toggle

Blocking Toggle

Name: "Out-of-area/Unavailable"

CNAB: Blocking Toggle

No Indication

Name: "Out-of-area/Unavailable"

No Indication (or no ISDNUP GN in IAM)

Allowed

Name: "Out-of-area/Unavailable"

No Indication (or no ISDNUP GN in IAM)

Restricted

Name: "Private"

No Indication (or no ISDNUP GN in IAM)

Blocking Toggle

Name: "Out-of-area/Unavailable"

No Indication (or no ISDNUP GN in IAM)

No Indication

Name: "Out-of-area/Unavailable"


CNAM Presentation

CNAM is inserted as described above in the following interfaces:

SS7 to SIP call flow: The calling name is inserted in the From and P-Asserted-Identity headers

SS7 to H.323 call flow: The calling name is inserted into the display information element (IE) of the SETUP message (H.225)

If the calling user dials a CNAB code, the GN parameter is coded as follows:

The "Type of Name" subfield is coded "001" to indicate "calling name."

The "Availability" subfield is coded "0" to indicate "name available, or name availability unknown."

The "Presentation" subfield is coded "10" to indicate "blocking toggle."

No name characters are expected to be present.

If the calling user Dials a CIDS Suppression code, the GN parameter is coded as follows:

The "Type of Name" subfield is coded "001" to indicate "calling name."

The "Availability" subfield is coded "0" to indicate "name available, or name availability unknown."

The "Presentation" subfield is coded "01" to indicate "presentation restricted."

No name characters are expected to be present.

Prerequisites for Using this Feature

The Cisco PGW 2200 must be running Cisco MGC software Release 9.7(3). Prerequisites for this release can be found in the Release Notes for the Cisco Media Gateway Controller Software Release 9.7(3).

Limitations

The following are limitations of the CNAM feature on the PGW 2200:

The PGW supports CNAM only in call control mode.

The PGW triggers CNAM service only when the originating call control (OCC) side protocol is ANSI SS7.

CNAM service limitation for call forwarding

The PGW triggers CNAM service once for a call, at most, and can only trigger CNAM service in B number analysis. The CNAM query result is saved in call context.

For example, if the terminating call control (TCC) side tries to forward the call two times by a 302 message, PGW triggers the CNAM service if the following conditions are met:

The CNAM has not been triggered before. If this is the first forwarding message, the original call does not trigger the CNAM service.

The new contact in 302 triggers B number analysis. If 302 triggers a new B number analysis, then the PGW triggers CNAM service.

The PGW does not send early address complete message (ACM) back to the OCC side as soon as it triggers the CNAM service.

Supported Standards, MIBs, and RFCs

This section identifies the new or modified standards, MIBs, or RFCs that are supported by this feature.

Standards

Telcordia Technologies Generic Requirements GR-1188-CORE

Related Documents

This document contains information that is related strictly to this feature. The documents that contain additional information related to the Cisco Media Gateway Controller (MGC) are at the following url:

http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/tsd_products_support_series_home.html

Prerequisites for Using This Feature

The Cisco PGW 2200 must be running Cisco MGC software Release 9.7(3). Prerequisites for this release can be found in the Release Notes for the Cisco Media Gateway Controller Software Release 9.7(3).

http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/prod_release_note09186a00807ffa15.html

Dial Plan Examples

Add the CNAM service to inService.dat, route by SSN:

prov-sta::srcver="active",dstver="CNAM",confirm
prov-add:inservice:name="ansi-pre-ain-cnam",skortcv=0, 
gtorssn="ROUTEBYSSN",gtformat="NOGT", msname="ansi-pre-ain-cnam"
prov-cpy

Add the CNAM service to inService.dat, route by GT:

prov-sta::srcver="active",dstver="CNAM",confirm
prov-ed:inservice:name="ansi-pre-ain-cnam",skortcv=0,gtorssn="ROUTEBYGT",gtformat="GTTT", 
msname="ansi-pre-ain-cnam"
prov-cpy

Provision CNAM service in B number dial plan:

prov-sta::srcver="active",dstver="CNAM",confirm
numan-add:resultset:custgrpid="1111",name="CNAM"
numan-add:resulttable:custgrpid="1111",name="CNAMtrigger", 
resulttype="IN_TRIGGER",dw1="30",dw2="0",dw3="0",dw4="6",setname="CNAM"

numan-add:resulttable:custgrpid="1111",name="route",resulttype="ROUTE",
dw1="rtlist1",setname="CNAM"
	
numan-add:bdigtree:custgrpid="1111",callside="originating",digitstring="2146",setname="CNA
M"

prov-cpy

Enable calling name display in EISUP path and trunkgroup:

prov-add:sigsvcprop:name="EISUP", InhibitOutgoingCallingNameDisplay ="0"
prov-add:trnkgrpprop:name="7777", InhibitOutgoingCallingNameDisplay ="0"

Provision cgpninclude on SIP trunkgroup profile

prov-add:PROFILE:NAME="sippro",TYPE="grprofile",cgpninclude="1"
prov-add:TRNKGRPPROF:name="5600",grprofile="sippro"

Provision MapCLItoSipHeader on SIP sigpath to map the ISUP CLI to P-Asserted-ID header in addition to From header:

prov-add:sigsvcprop:name="sip-path", mapclitosipheader="3"

Billing Interface

This section identifies the call detail record (CDR) data added for this feature. For billing interface information for the rest of the Cisco MGC software, see the Cisco Media Gateway Controller Software Release 9 Billing Interface Guide.

CNAM DIP (Tag: 4240)

Table 3 CNAM DIP

Name: CNAM DIP

Tag: 4240

Source: MDL

Description/Purpose:

1. Indicates whether CNAM is invoked.

2. The query result.

Format: Structured variable

Length in Octets: 2

Data Value:

Octet 1 query indicator

0= no query

1=query

Octet 2 query result indicator

0=success

1=return error

2=return reject

3=query timeout

4=query abandon

Extended Data Value: No extended value.

General Information:

MGC Release: Release 9.7 or later.

Answered (1010)

Deselected (1020)

Aborted (1030)

Release (1040)

Interrupted (1050)

Ongoing (1060)

Maintenance (1070)

External DB (1080)

End of Call (1110)

Y

N

Y

Y

N

N

N

N

Y


Calling Name (Tag: 4241)

Table 4 Calling Name

Name: Calling Name

Tag: 4241

Source: MDL

Description/Purpose: The calling party name is gotten from the service control point (SCP) or the original call setup message. The retrieved calling party name is passed to the egress destination if and only if it is allowed, based on CNAB and CIDS information. It is a terminating feature.

Format: Structured variable

Length in Octets: 1-15

Data Value: Characters of calling name displayed on the terminating side.

Example: Bob Johnson

Extended Data Value: No extended value.

General Information:

MGC Release: Release 9.7 or later.

Answered (1010)

Deselected (1020)

Aborted (1030)

Release (1040)

Interrupted (1050)

Ongoing (1060)

Maintenance (1070)

External DB (1080)

End of Call (1110)

Y

N

Y

Y

N

N

N

N

Y


Result Type Definitions

The IN_TRIGGER result type is modified for this feature.

Table 5 New Result Type Definition 

Result Number.
Result Type
Dataword1
Dataword2
Dataword3
Dataword4
Analysis Points
Result Type Valid For
Intermediate
End Point
A-digit analysis
B-digit analysis
Cause
Pre-analysis

22

IN_TRIGGER

Service type

Scp/stp index

Min digits req

Timer

X

 

 

X

 

 


Dataword1 is the TCAP trigger service value (30). The value of this is listed in inService.dat. This value is an indication of the type of IN service that needs to be invoked.

Dataword2 is the scp/stp index used in the trigger module for selection of the SCP for TCAP query.

Dataword3 is the minimum number of digits (0 through 32) required to be received to support further analysis.

Dataword4 is the timer value (1 through 30), in seconds, used to identify short duration calls.

The global title translation type is configurable, the default value is 5. You can change this in trigger.dat under the "etc" directory. This parameter takes effect only after you restart the PGW.

Troubleshooting the CNAM Feature

The following documents contain information to help you troubleshoot the TCAP query:

PGW 2200 Softswitch TCAP Release 9.3 and Later

http://www.cisco.com/warp/customer/788/products/pgw2200-tcap-ts.html

Cisco Media Gateway Controller Software Release 9 Operations, Maintenance, and Troubleshooting Guide

http://www.cisco.com/en/US/partner/products/hw/vcallcon/ps2027/products_maintenance_guide_book09186a008007e563.html

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Glossary

Table 6 contains expansions of acronyms and technical terms used in this feature module.

Table 6 Acronyms and Expansions

Acronym
Expansion

ACM

Address Complete Message

ANSI

American National Standards Institute

CA

Call Appearance

CDR

Call Detail Record

CIDS

Calling Identity Delivery and Suppression

CNAB

Calling Name Delivery Blocking

CNAM

Calling Name Delivery

CPN

Calling Party Number

DPNSS

Digital private network signaling system

EISUP

Enhanced ISUP

GN

Generic Number

IAM

Initial Address Message

IE

Information Element

ISUP

ISDN User Part

LIDB

Line Information Database

MGC

Media Gateway Controller

MML

Man-Machine Language

OCC

Originating Call Control

PGW

PSTN gateway

SIP

Session Initiation Protocol

TCAP

Transaction Capabilities Application Part

TCC

Terminating Call Control