TG Advance Feature Module
Document Release History
Publication Date
Comments
March 31, 2011
Initial release of document.
Feature History
Release
Modification
9.8(1)
TG Advance feature introduced on the Cisco PGW 2200 Softswitch
software.
This document describes the TG Advance feature. This feature is described in the following sections:
•
Feature Description, page 1
•
Supported Standards, MIBs, and RFCs, page 2
•
XECfgParm.dat Configuration Tasks, page 2
•
Provisioning Tasks, page 3
•
Provisioning Examples, page 4
•
Obtaining Documentation and Submitting a Service Request, page 6
•
Glossary, page 6
Feature Description
In the current instance of normal Trunk group (TG) advance, if the number of advances meets or exceeds
the *.MaxNumTGAdvances value defined in XECfgParm.dat, the failure cause is set to Temporary
Failure, and the treated cause code that started the reattempt cycle will not be passed to the originating
side. The cause code will always be Temporary Failure, no matter what the terminating call release cause
code is.
With the introduction of the TG Advance feature, the release cause code is passed transparently to the
originating side in case of a failure from a terminating call leg.
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
TG Advance Feature Module
XECfgParm.dat Configuration Tasks
Benefits
This feature provides the following benefit:
Transparently passing the release cause code to the originating side in case of a failure from a
terminating call leg.
Prerequisites
The Cisco PGW 2200 Softswitch must be running software Release 9.8(1). Prerequisites for this release
can be found in the 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
Related Documents
This document contains information pertaining to only the TG Advance 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
This section identifies the new or modified standards, MIBs, and RFCs that are supported by this feature.
Standards
No new or modified standards are supported by this feature.
MIBs
No new or modified MIBs are supported by this feature.
For more information on the MIBs used in the Cisco PGW 2200 Softswitch, see Cisco PGW 2200
Softswitch MIBs at:
http://www.cisco.com/iam/PGW_MIBS/index.html
RFCs
No new or modified RFCs are supported by this feature.
XECfgParm.dat Configuration Tasks
This section contains the steps for configuring the Cisco PGW 2200 Softswitch to support the TG
Advance feature.
Configuring the XECfgParm.dat File for This Feature
To use the TG Advance feature, you must first configure the *.MaxNumTGAdvances parameter of the
XECfgParm.dat file. This parameter indicates the limit on the TG advance action.
Cisco PGW 2200 Softswitch TgAdvance Feature Module
2
TG Advance Feature Module
Provisioning Tasks
Note
For details about the parameters pertaining to the XECfgParm.dat file, see Appendix A,
“XECfgParm.dat File Parameters”, in the Cisco PGW 2200 Softswitch Release 9.8 Software Installation
and Configuration Guide.
Configuration Examples
Following is an example of the command you should enter to configure the *.MaxNumTGAdvances
parameter in the XECfgParm.dat file:
*.MaxNumTGAdvances=1 # Limit on num Trunk Group Advance actions
Note
Any changes to the XECfgParm.dat file require a restart of the Cisco PGW 2200 Softswitch software.
Provisioning Tasks
Information about provisioning is available in the Cisco PGW 2200 Softswitch Release 9.8 Provisioning
Guide in the following sections:
•
Planning for Provisioning
http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9.8/Provisioning/Guide/R9_OvrVw.html
•
MML Basics
http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9.8/Provisioning/Guide/R9MMLCfg.html
This section describes the provisioning tasks for the TG Advance feature. For a list of all the
provisioning examples, see the “Provisioning Examples” section on page 4.
Note
Make sure you have completed the configuration of the XECfgParm.dat file before you perform the
provisioning tasks pertaining to this feature. For information about the configuration of the
XECfgParm.dat file, see the “XECfgParm.dat Configuration Tasks” section on page 2.
To use the TG Advance feature, perform the following tasks:
1.
Provision the Cisco PGW 2200 Softswitch for SS7.
2.
Set *.MaxNumTGAdvances=1 in the XECfgParm.dat file.
3.
Configure two SS7 trunk groups (for example, trunk groups 233 and 234) on the
Cisco PGW 2200 Softswitch, with result type "RETRY_ACTION" and dw1 value ="tgadvance".
When the cause code value=52(IC_USER_BUSY), the call gets routed to the second trunk group,
234. Following is a list of sample MML commands used for the implementation of this
configuration:
mml> prov-ed:trnkgrpprop:name="234",custgrpid="1111"
mml> numan-add:resultset:custgrpid="1111",name="Rtry-234"
mml> numan-add:resulttable:custgrpid="1111",name="rtadv-2",resulttype="RETRY_ACTION",
dw1="tgadvance",dw2="0",dw3="0",dw4="0",setname="Rtry-234"
mml> numan-add:cause:custgrpid="1111",causevalue=52,setname="Rtry-234"
Cisco PGW 2200 Softswitch TgAdvance Feature Module
3
TG Advance Feature Module
Provisioning Examples
4.
Initiate an IAM on trunk group 233, and release the call using cause code="User busy" (auto release
and auto response of IAM is disabled).
5.
The call gets routed to TrunkGroup 234. As soon as IAM is received on this trunk group, release the
call using cause code="User busy".
6.
Because the number of advances exceeds the *.MaxNumTGAdvances value defined in
XECfgParm.dat (*.MaxNumTGAdvances=1), failure cause code="User busy" is passed
transparently to the originating side that started the reattempt cycle.
Provisioning Examples
This section provides provisioning examples pertaining to the TG Advance feature. Additional
provisioning examples pertaining to the Cisco PGW 2200 Softswitch can be found in the
Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide at:
http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9.8/Provisioning/Guide/prvgde98.html
Additional dial plan examples pertaining to the Cisco PGW 2200 Softswitch can be found in the
Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide at:
http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9.8/Dial_Plan/Guide/Dplan98.html
________________________________________
; Start a New Provisioning Session
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-sta::srcver="active",dstver="ss7_provision",confirm
________________________________________
; Add a New Dialplan Named "1111"
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:dialplan:custgrpid="1111",OVERDEC="NO"
________________________________________
; Add OPC and DPC
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:OPC:NAME="stim-opc",DESC="stim opc",NETADDR="1.1.1",NETIND=2,TYPE="TRUEOPC"
prov-add:DPC:NAME="stim-dpc",DESC="stim dpc",NETADDR="1.2.1",NETIND=2
________________________________________
; Provision SS7 Link
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:SS7PATH:NAME="ss7path1",DESC="ss7 path to stim",MDO="Q761_BASE",CUSTGRPID="1111",
SIDE="network",DPC="stim-dpc",OPC="stim-opc",M3UAKEY="",ORIGLABEL="",TERMLABEL=""
prov-add:EXTNODE:NAME="stim1",DESC="ss7 stim",TYPE="SLT",ISDNSIGTYPE="N/A",GROUP=0
prov-add:SESSIONSET:NAME="stim-set1",EXTNODE="stim1",IPADDR1="IP_Addr1",
PEERADDR1="10.0.2.11",PORT=7000,PEERPORT=7000,TYPE="BSMV0"
prov-add:LNKSET:NAME="lkset1",DESC="ss7 linkset to stim",APC="stim-dpc",PROTO="SS7-ITU",
TYPE="IP"
prov-add:SS7ROUTE:NAME="ss7rt1",DESC="ss7 route to stim",OPC="stim-opc",DPC="stim-dpc",
LNKSET="lkset1",PRI=1
prov-add:C7IPLNK:NAME="c7lnk1",DESC="ss7 link to stim",LNKSET="lkset1",SLC=0,PRI=1,
TIMESLOT=0,SESSIONSET="stim-set1"
________________________________________
; Provision MGCP Path
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:EXTNODE:NAME="mgcp1",DESC="mgcp stim",TYPE="AS5300",ISDNSIGTYPE="N/A",GROUP=0
prov-add:MGCPPATH:NAME="stimpath1",DESC="mgcp path to pype",EXTNODE="mgcp1"
Cisco PGW 2200 Softswitch TgAdvance Feature Module
4
TG Advance Feature Module
Provisioning Examples
prov-add:IPLNK:NAME="stim-iplnk1",DESC="mgcp to
pype",SVC="stimpath1",IPADDR="IP_Addr1",PORT=2427,PEERADDR="10.0.2.12",PEERPORT=2427,PRI=1
,IPROUTE=""
________________________________________
; Provision Trunk Group
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:trnkgrp:name="233", svc="ss7path1",type="TDM_ISUP",SELSEQ="LIDL"
prov-ed:trnkgrpprop:name="233",custgrpid="1111"
prov-add:switchtrnk:name="1",trnkgrpnum="233",span="ffff",cic=1,cu="mgcp1",spansize=31,
endpoint="s0/ds1-1/1@aristim2"
prov-add:rttrnkgrp:name="233",type=1,reattempts=1,queuing=0,cutthrough=0,resincperc=0
prov-add:rttrnk:weightedTG="OFF",name="rt233",trnkgrpnum=233
prov-add:rtlist:name="rtlst233",rtname="rt233",distrib="OFF"
________________________________________
; Add Digitstring to Routeset
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:resultset:custgrpid="1111",name="rset233"
numan-add:resulttable:custgrpid="1111",name="rtab1",resulttype="ROUTE",dw1="rtlst233",
setname="rset233"
numan-add:bdigtree:custgrpid="1111",callside="originating",digitstring="233",
setname="rset233"
________________________________________
; Active Configuration
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-cpy
________________________________________
; Change Status to In Service
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
set-c7lnk:c7lnk1:is
set-iplnk:stim-iplnk1:is
________________________________________
; Provision TGAdvance
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
numan-add:resultset:custgrpid="1111",name="rset2"
numan-add:resulttable:custgrpid="1111",name="rtab2",resulttype="RETRY_ACTION",
dw1="tgadvance",setname="rset2"
numan-ed:cause:custgrpid="1111",causevalue=44,setname="rset2"
________________________________________
; Provision Another Trunk for TGAdvance
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-add:trnkgrp:name="333", svc="ss7path1",type="TDM_ISUP",SELSEQ="LIDL"
prov-ed:trnkgrpprop:name="333",custgrpid="1111"
prov-add:switchtrnk:name="32",trnkgrpnum="333",span="ffff",cic=32,cu="mgcp1",spansize=31,
endpoint="s0/ds1-1/32@aristim2"
prov-add:rttrnkgrp:name="333",type=1,reattempts=1,queuing=0,cutthrough=0,resincperc=0
prov-add:rttrnk:weightedTG="OFF",name="rt333",trnkgrpnum=333
prov-ed:rtlist:name="rtlst233",rtname="rt333",distrib="OFF"
numan-add:bdigtree:custgrpid="1111",callside="originating",digitstring="333",
setname="rset233"
________________________________________
; Save the Provisioning Session
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-cpy
Cisco PGW 2200 Softswitch TgAdvance Feature Module
5
TG Advance Feature Module
Obtaining Documentation and Submitting a Service Request
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 1 provides the acronyms and expansions that appear in this document.
Table 1
Expansions
Acronym
Expansion
MML
man-machine language
PGW
PSTN Gateway
SS7
Signaling System 7
TG
Trunk Group
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks
can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R)
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.
© 2011 Cisco Systems, Inc. All rights reserved.
Cisco PGW 2200 Softswitch TgAdvance Feature Module
6