Guest

Cisco PGW 2200 Softswitch

Display Name and Connected Number Interworking

  • Viewing Options

  • PDF (254.3 KB)
  • Feedback
Cisco PGW 2200 Softswitch Display Name and Connected Number Interworking Feature Module

Table Of Contents

Cisco PGW 2200 Softswitch Display Name and Connected Number Interworking Feature Module

Feature Description

Benefits

Prerequisites

Restrictions or Limitations

Related Documents

Supported Standards, MIBs, and RFCs

Provisioning Tasks

Provision the SIP Trunk Group Property

Provision Dial Plans

Provision Prefix Convert Entries

Provision Original Called Number Translations

Provisioning Examples

MML Command Reference

New MML Commands

NUMAN-ADD:PREFIXCONVERT—Add a Prefix Convert (Release 9.8(1))

NUMAN-DLT:PREFIXCONVERT—Delete a Prefix Convert (Release 9.8(1))

NUMAN-RTRV:PREFIXCONVERT—Retrieve a Prefix Convert (Release 9.8(1))

Modified MML Commands

NUMAN-ADD:fullnumbertrans—Enabling Full Number Translation

Software Changes for This Feature

Properties

Modified Properties

Result Type Definitions

New Result Type Definitions

Modified Result Type Definitions

Troubleshooting the Feature

Obtaining Documentation and Submitting a Service Request

Glossary


Cisco PGW 2200 Softswitch Display Name and Connected Number Interworking Feature Module


Document Release History

Publication Date
Comments

November 30, 2009

Initial release of document.


Feature History

Release
Modification

9.8(1)

The Display Name and Connected Number Interworking feature is introduced on the Cisco PGW 2200 Softswitch software.


This document describes the Display Name and Connected Number Interworking feature. The feature is described in the following sections:

Feature Description

Supported Standards, MIBs, and RFCs

Provisioning Tasks

Provisioning Examples

MML Command Reference

Software Changes for This Feature

Troubleshooting the Feature

Obtaining Documentation and Submitting a Service Request

Glossary

Feature Description

The Display Name and Connected Number Interworking feature introduces a comprehensive structure for handling the parameters associated with the following features for calls between ISUP and SIP endpoints:

Calling Line Identification Presentation (CLIP)

Connected Line Identification Presentation (COLP)

Calling Line Identification Restriction (CLIR)

Connected Line Identification Restriction (COLR)

These parameters allow the Cisco PGW 2200 Softswitch to support interworking between ISUP and SIP networks for basic call features, for call forwarding features, and for call transfer features. Call forwarding features include Call Forwarding Unconditional (CFU), Call Forwarding No Answer (CFNA), and Call Forwarding Busy (CFB).

This feature enables the Cisco PGW 2200 Softswitch to handle display name and number identity interworking between PBX and SIP for basic calls, call forwarding, and call transfer.

CLIP/COLP provides call control and security for residential telephone users. It also provides an automatic means of identification and improved productivity to enterprise customers. In addition, display name is part of the calling line identity (CLI). Using CLI information within networks enhances the existing support for call processing, billing, emergency call handling, customer care, operator assistance services and advanced services.

With this feature, the Cisco PGW 2200 Softswitch can map display name and connected number between SIP and ISUP, and between SIP and QSIG. This feature also enables support of prefix modification for connected number, redirection number, and transferred number.

Figure 1 shows a typical deployment for this feature.

Figure 1 Typical Deployment for This Feature

Benefits

This feature provides the following benefits:

The Cisco PGW 2200 Softswitch can transit display name and connected number between SIP, SS7, and QSIG.


Note Only the ISUPv2_GERMAN variant is supported for SS7-related calls in this feature.


The Cisco PGW 2200 Softswitch enables prefix modification for connected number, redirection number, and transferred number.

The Cisco PGW 2200 Softswitch enables number modification for the Original Called Number.

The Cisco PGW 2200 Softswitch can transit redirection number and reason between SIP 181 and SS7 ACM (with CUCM 7.1.3 and later).

Prerequisites

The Cisco PGW 2200 Softswitch must be running software Release 9.8(1). Prerequisites for this release can be found in Release Notes for the Cisco PGW 2200 Softswitch Release 9.8(1) at:

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/release/note/rn981.html

Restrictions or Limitations

The Display Name and Connected Number Interworking feature has the following limitations:

This feature is not applicable to half-call scenario calls, such as Network Consultation Transfer (NCT) and Route Optimization (RO).

If the call is transferred under CUCM, when the Cisco PGW 2200 Softswitch receives UPDATE message from the CUCM, it does not know the state of transferred call (Alerting or Answered). ISUP just sends CPG with "call transfer active".

Related Documents

This document contains information that is strictly related to this feature. The documents that contain additional information related to the Cisco PGW 2200 Softswitch are at:

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

Supported Standards, MIBs, and RFCs

No new or modified standards, MIBs, or RFCs are supported by this feature.

Provisioning Tasks

This section describes provisioning tasks for this feature.


Note If you do not use the number modification function, you don't need to perform the tasks below.


To use this feature with number modification, you need to perform the following main tasks:

Provision the SIP Trunk Group Property

Provision Dial Plans

Provision Prefix Convert Entries

Provision Original Called Number Translations

For the complete provisioning examples, see the "Provisioning Examples" section.

Provision the SIP Trunk Group Property

For ISUP-PGW-SIP calls, if you are going to enable the Cisco PGW 2200 Softswitch to map the P-Asserted-Identity (PAID) and From headers of Invite message from ACgPN of IAM, use the following commands to provision the MapCLItoSipHeader property on the SIP trunk group:

prov-add:profile:name="profile1",type="SIPPROFILE",mapclitosipheader="5"

prov-add:trnkgrpprof:name="1000",grprofile="profile1"
prov-ed:profile:name="profile1",mapclitosipheader="5"

Provision Dial Plans

Use the following commands to provision the PREFIX_CONVERT result type to the dial plan:

numan-add:resulttable:custgrpid="1000",setname="set01",name="prefixconvert", 
resulttype="PREFIX_CONVERT"
numan-add:bdigtree:custgrpid="1000",callside="originating",setname="set01", 
digitstring="10"
numan-add:adigtree:custgrpid="1000",callside="originating",setname="set01", 
digitstring="80"

Provision Prefix Convert Entries

Use the following commands to add prefix convert entries to the TimesTen table:

numan-add:prefixconvert:cdpnprefix="8012",cgpnprefix="8001",acgpnprefix="8002", 
previousprefix="8012",previousnoa="4",newprefix="648012",newnoa="4",newaddconprefix="74", 
newaddconnoa="4"

numan-add:prefixconvert:previousprefix="8012",previousnoa="4",newprefix="658012", 
newnoa="5",newaddconprefix="75",newaddconnoa="5"

Provision Original Called Number Translations

Use the following commands to apply NUM_TRANS to the original called number in the dial plan:

numan-add:service:custgrpid="1000",name="ocntrans"

numan-add:fullnumbertrans:svcname="ocntrans",digstring="8011",translatednum="778011", 
numtype="5"

numan-add:resulttable:custgrpid="1000",name="trans",resulttype="NUM_TRANS",dw1="ocntrans",
dw2="5",dw3="4",setname="set10"

numan-add:bdigtree:custgrpid="1000",digitstring="10",callside="originating", 
setname="set10"

Provisioning Examples

This section provides a provisioning example for this feature. Additional provisioning examples for the Cisco PGW 2200 Softswitch can be found in Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide. Additional dial plan examples for the Cisco PGW 2200 Softswitch can be found in Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide.

________________________________________
; Start a Provision Session
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-sta::srcver="active",dstver="acgpn-map"

________________________________________
; Add a SIP Profile with apclitosipheader=5
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:profile:name="profile1",type="SIPPROFILE",mapclitosipheader="5"

________________________________________
; Add a Service to the Dial Plan
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:service:custgrpid="1000",name="ocntrans"

________________________________________
; Add a Full Number Translation Entry
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:fullnumbertrans:svcname="ocntrans",digstring="8011",translatednum="778011", 
numtype="5"

________________________________________
; Add the NUM_TRANS Result to a Result Set
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:resulttable:custgrpid="1000",name="trans",resulttype="NUM_TRANS",dw1="ocntrans",
dw2="5",dw3="4",setname="set10"

________________________________________
; Add the Results to the B Digit Tree
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:bdigtree:custgrpid="1000",digitstring="10",callside="originating", 
setname="set10"

________________________________________
; Add a Prefix Convert Entry
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:prefixconvert:cdpnprefix="8012",cgpnprefix="8001",acgpnprefix="8002", 
previousprefix="8012",previousnoa="4",newprefix="648012",newnoa="4",newaddconprefix="74", 
newaddconnoa="4"

________________________________________
; Add the PREFIX_CONVERT Result to a Result Set
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:resulttable:custgrpid="1000",setname="set01",name="prefixconvert", 
resulttype="PREFIX_CONVERT"

________________________________________
; Add the Result to the B Digit Tree
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:bdigtree:custgrpid="1000",callside="originating",setname="set01", 
digitstring="10"

________________________________________
; Add the Result to the A Digit Tree
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:adigtree:custgrpid="1000",callside="originating",setname="set01", 
digitstring="80"

________________________________________
; Save the Provisioning Session
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-dply

MML Command Reference

This section documents new, modified, or deleted Man-Machine Language (MML) commands. All other MML commands are documented in Cisco PGW 2200 Softswitch Release 9 MML Command Reference.

New MML Commands

This section contains the MML commands that are new for this feature.

NUMAN-ADD:PREFIXCONVERT—Add a Prefix Convert (Release 9.8(1))

Purpose:

Adds a prefix convert entry.

Syntax:

numan-add:prefixconvert:cdpnprefix="cdpnprefix",cgpnprefix="cgpnprefix", 
acgpnprefix="acgpnprefix",previousnoa="previousnoa", 
previousprefix="previousprefix",newprefix="newprefix"[,newnoa="newnoa"] 
[,newaddconprefix="newaddconprefix"][,newaddconnoa="newaddconnoa"]

Input Description:

cdpnprefix—Called party number prefix. Default value is "DEFAULT".

cgpnprefix—Calling party number prefix. Default value is "DEFAULT".

acgpnprefix—Additional calling party number prefix. Default value is "DEFAULT".

previousnoa—Connected number NOA. Default value is 0.

previousprefix—Connected number or redirection number prefix that will be changed, not null.

newprefix—The changed prefix for connected number or redirection number.

(Optional) newnoa—New connected number NOA.

(Optional) newaddconnoa—New additional connected number NOA. If not empty, additional connected number is inserted on top of connected number as generic number.

(Optional) newaddconprefix—New additional connected number prefix. If empty, the received connected number digits are used as digits for the additional connected number. If not empty, this prefix followed by received connected number digits are used as digits for the additional connected number.


Note If cdpnprefix, cgpnprefix, or acgpnprefix are not specified, they will be assigned with DEFAULT values.


Example:

The following sample MML command adds a prefix convert entry:

mml> numan-add:prefixconvert:cdpnprefix="8012",cgpnprefix="8001", 
acgpnprefix="8002",previousprefix="8012",previousnoa="4", 
newprefix="648012",newnoa="4",newaddconprefix="74",newaddconnoa="4"

Comments:


Note The prefix modifications are based on the original calling/called/generic number received on the originating side.


Performance Impact Category: A


NUMAN-DLT:PREFIXCONVERT—Delete a Prefix Convert (Release 9.8(1))

Purpose:

Deletes a prefix convert entry.

Syntax:

numan-dlt:prefixconvert:cdpnprefix="cdpnprefix",cgpnprefix="cgpnprefix", 
acgpnprefix="acgpnprefix",previousnoa="previousnoa", 
previousprefix="previousprefix"

Input Description:

cdpnprefix—Called party number prefix, default value is "DEFAULT".

cgpnprefix—Calling party number prefix, default value is "DEFAULT".

acgpnprefix—Additional calling party number prefix, default value is "DEFAULT".

previousnoa—Connected number NOA, default value is 0.

previousprefix—Connected number or redirection number prefix that will be changed, not null.


Note If cdpnprefix, cgpnprefix, or acgpnprefix are not specified, only the entries with variables have DEFAULT values are deleted.


Example:

The following sample MML command deletes a prefix convert entry:

mml> numan-dlt:prefixconvert:cdpnprefix="8012",cgpnprefix="8001", 
acgpnprefix="8002",previousprefix="8012",previousnoa="4"

Comments:

Performance Impact Category: A


NUMAN-RTRV:PREFIXCONVERT—Retrieve a Prefix Convert (Release 9.8(1))

Purpose:

Retrieves a prefix convert entry.

Syntax:

numan-rtrv:prefixconvert:cdpnprefix="cdpnprefix",cgpnprefix="cgpnprefix", 
acgpnprefix="acgpnprefix",previousnoa="previousnoa", 
previousprefix="previousprefix"
numan-rtrv:prefixconvert:"all"

Input Description:

cdpnprefix—Called party number prefix, default value is "DEFAULT".

cgpnprefix—Calling party number prefix, default value is "DEFAULT".

acgpnprefix—Additional calling party number prefix, default value is "DEFAULT".

previousnoa—Connected number NOA, default is 0.

previousprefix—Connected number or redirection number prefix that will be changed, not null.

all—All prefix convert entries.


Note If cdpnprefix, cgpnprefix, or acgpnprefix are not specified, only the entries with variables have DEFAULT values are displayed.


Example:

The following sample MML command retrieves a prefix convert entry:

mml> numan-rtrv:prefixconvert:cdpnprefix="8012",cgpnprefix="8001", 
acgpnprefix="8002",previousprefix="8012",previousnoa="4"

Comments:

Performance Impact Category: A


Modified MML Commands

This section contains the MML commands that are modified for this feature.

NUMAN-ADD:fullnumbertrans—Enabling Full Number Translation

Purpose:

Adds a digit string to the Full Number Translation table.

Syntax:

numan-add:fullnumbertrans:svcname="Service Name",numbtype="Number Type", 
digstring="Original Digits",translatednum="Translated Digits"

Input Description:

svcname—A unique service name string for full number translation entries. Maximum length of string: 10 characters.

numtype—Identifier for the number type (1-5), it is one of the following values:

1—called party number

2—calling party number

3—redirecting number

4—calling party number and redirecting number

5—original called number


Note The numtype value of 5 is added in the Cisco PGW 2200 Softswitch Release 9.8(1) S7P7.


Maximum length of integers: 1 digit

digstring—The digit string that is to be translated. Maximum length of integers: 20 digits.

translatednum—The translated digit string. Maximum length of integers: 20 digits.


Note Digit strings stored in the full number translation table are case insensitive. That is to say, if digit strings that you provisioned contain alphabetic characters, the TimesTen database saves them as uppercase characters in the full number translation table.


Example:

The MML command shown in the following example enables full number translation for result types:

mml>numan-add:fullnumbertrans:svcname="freephone",numbtype="1", 
digstring="1234",translatednum="54321" 

Comments:

Performance Impact Category: A


Software Changes for This Feature

The following sections contain software changes related to this feature:

Properties

Result Type Definitions

Properties

This section describes new and modified properties for this feature. For more information on the other properties of the Cisco PGW 2200 Softswitch, see Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide.

Modified Properties

Table 1 describes the modified properties for this feature.

Table 1 Modified Properties

Property
Description

MapCLItoSipHeader

The new value 5 was added in the Cisco PGW 2200 Softswitch Release 9.8(1) S7P7. This property determines the mappings from the ISUP calling party number to the outgoing SIP message.

Valid Values:

0-4 (existing before this feature)

Note For detailed description of the existing values, see Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide.

5—MAP_ACLI_INTO_FROM_AND_PAID. For ISUP-PGW-SIP calls, the PAID and From headers of Invite message are mapped from ACgPN of IAM.


Result Type Definitions

This section describes the new and modified result types for this feature. For information on other result types, see Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide.

New Result Type Definitions

Table 2 describes the new result types for this feature.

Table 2 New Result Type Definitions 

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

90

PREFIX_CONVERT

0 (not used)

0 (not used)

0 (not used)

0 (not used)

 X

 X

 X


PREFIX_CONVERT

A new result type PREFIX_CONVERT is added for this feature. It allows the Cisco PGW 2200 Softswitch to support prefix modification for connected number, redirection number, and transferred number. PREFIX_CONVERT can work for SIP-to-ISUP, ISUP-to-SIP, and ISUP-to-ISUP connected numbers. It cannot work for SIP-to-SIP connected number.


Note The prefix modifications are based on the original calling/called/generic number received on the originating side.


Modified Result Type Definitions

Table 3 describes the modified result types for this feature.

Table 3 Modified Result Type Definitions 

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

69

NUM_TRANS

Service Key

Number Type

NOA

Dial Plan

 X

 X

 X


The following paragraphs contain definitions of the result type listed in Table 3.

NUM_TRANS

The NUM_TRANS result type is returned from A-number (the calling number) or B-number analysis (the called number) indicating that one or more numbers encountered require full replacement. The NUM_TRANS result type has the following Datawords:

Dataword1—ServiceKey.

Dataword2—Number Type. An integer indicating the number type being translated. Dataword2 values are:

1. CdPn—Called party number.

2. CgPn—Calling party number.

3. Rdn—Redirecting number.

4. Rdn and CgPn—Redirecting number and calling party number.

5. OCN—Original Called Number. This value is added in software Release 9.8(1) S7P7.

Dataword3 (Optional)—Nature of Address (NOA).

Dataword4 (Optional)—Dial plan.


Note For more information on the NUM_TRANS result type, see Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide.


Troubleshooting the Feature

This section provides the troubleshooting solutions for this feature.

Number modification is failed.

Step
Action
Description

Step 1 

Check the PREFIX_CONVERT result type.

Make sure that you have provisioned the result type PREFIX_CONVERT for the dial plan. This result type enables the Cisco PGW 2200 Softswitch to support prefix modification.

For result type details, see the "Result Type Definitions" section.

Step 2 

Check the prefix convert entries.

Make sure that you have provisioned prefix convert entries to the TimesTen table. Defined values for matching calling/called/generic number should base on the original values received on the originating side.

For details, see the "Provision Prefix Convert Entries" section.


PAID does not contain an empty display name or the ACgPN received from ISUP in the address field.

Step
Action
Description

Step 1 

Check the MapCLItoSipHeader property.

Make sure that the MapCLItoSipHeader property is provisioned with value 5 on the SIP trunk group.

For property details, see the "Properties" section.


Full number translation for original called number (OCN) is failed.

Step
Action
Description

Step 1 

Check the full number translation entries.

Make sure that you have provisioned OCN translation entries to the Timesten table.

For details, see the "Provision Original Called Number Translations" section.

Step 2 

Check the NUM_TRANS result type.

Make sure that the NUM_TRANS operation is enabled in the dial plan result set.

For result type details, see the"Result Type Definitions" section.


Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, 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

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.

Glossary

Table 4 Acronym Expansions 

Acronym
Expansion

ACgPN

Additional Calling Party Number

CFB

Call Forwarding Busy

CFNA

Call Forwarding No Answer

CFU

Call Forwarding Unconditional

CLI

Calling Line Identity

CLIP

Calling Line Identification Presentation

CLIR

Calling Line Identification Restriction

COLP

Connected Line Identification Presentation

COLR

Connected Line Identification Restriction

CUCM

Cisco Unified Communications Manager

ISUP

ISDN User Part

M3UA

Message Transfer Part Level 3 User Adaptation

MGCP

Media Gateway Control Protocol

OCN

Original Called Number

PAID

P-Asserted-Identity

PBX

Private Branch Exchange

PGW

PSTN Gateway

PSTN

Public Switched Telephone Network

QSIG

Q Signaling

SCTP

Stream Controlled Transmission Protocol

SIP

Session Initiation Protocol

SS7

Signaling System 7