Feedback
|
Table Of Contents
Cisco PGW 2200 Softswitch Display Name and Connected Number Interworking Feature Module
Supported Standards, MIBs, and RFCs
Provision the SIP Trunk Group Property
Provision Prefix Convert Entries
Provision Original Called Number Translations
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))
NUMAN-ADD:fullnumbertrans—Enabling Full Number Translation
Software Changes for This Feature
Modified Result Type Definitions
Obtaining Documentation and Submitting a Service Request
Cisco PGW 2200 Softswitch Display Name and Connected Number Interworking Feature Module
Document Release History
Feature History
Release Modification9.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:•
Supported Standards, MIBs, and RFCs
•
Software Changes for This Feature
•
Obtaining Documentation and Submitting a Service Request
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 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-dplyMML 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))
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
This section contains the MML commands that are modified for this feature.
NUMAN-ADD:fullnumbertrans—Enabling Full Number Translation
Software Changes for This Feature
The following sections contain software changes related to this feature:
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.
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.
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.
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 DescriptionStep 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 DescriptionStep 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 DescriptionStep 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
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2009 Cisco Systems, Inc. All rights reserved.
Feedback
