Feature History Release 12.2(11)T Modification This feature was introduced. This document describes the QSIG for TCL IVR (Tool Language Interactive Voice Response) 2.0 feature in and includes the following sections: Feature Overview, page 1 Supported Platforms, page 2 Supported Standards, MIBs, and RFCs, page 3 Prerequisites, page 3 Configuration Tasks, page 4 Configuration Examples, page 6 Reference, page 8 Glossary, page 11 Feature Overview Q.SIG support is required for European countries to interconnect enterprise customers to a wholesale voice solution. The Q.SIG for TCL IVR 2.0 feature provides transparent Q.SIG interworking when using a TCL IVR version 2.0 voice application on a Cisco IOS Voice gateway. This functionality can be enabled using a new CLI on the POTS or VoIP dial-peer. Prior to this feature, Q.SIG messages were interpreted by the TCL IVR 2.0 application, rather than passed transparently to the remote endpoint. Benefits Increases VoIP wholesale providers interconnection options. Increases program efficiency by eliminating unnecessary decoding. 1
Supported Platforms QSIG for TCL IVR 2.0 Restrictions Applicable to VoIP and POTS dial peers only. This feature applies to TCL IVR version 2.0 only; not version 1.0. Related Features and Technologies ISDN PRI Q.SIG Voice Signaling Voice over IP AAA Functionality on the VoIP Gateway RADIUS and H.323 Gateway-Specific Accounting Related Documents Service Provider Features for Voice over IP Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2: Configuring Gateways Configuring Interactive Voice Response for Cisco Access Platforms Configuring Debit Card for Packet Telephony TCL IVR API Version 2.0 Programmer's Guide Supported Platforms Cisco 2600 series Cisco 3600 series Cisco AS5300 Cisco AS5350 Cisco AS5400 Cisco AS5800 Cisco AS5850 Determining Platform Support Through Cisco Feature Navigator Cisco IOS software is packaged in feature sets that are supported on specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature. Cisco Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common. 2
Supported Standards, MIBs, and RFCs To access Cisco Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL: http://www.cisco.com/register Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. For the most current information, go to the Cisco Feature Navigator home page at the following URL: http://www.cisco.com/go/fn Availability of Cisco IOS Software Images Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or, if supported, Cisco Feature Navigator. Supported Standards, MIBs, and RFCs Standards None MIBs None To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: http://tools.cisco.com/itdit/mibs/servlet/index If Cisco MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco MIBs page at the following URL: http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL: http://www.cisco.com/register RFCs None Prerequisites or later release. 3
Configuration Tasks QSIG for TCL IVR 2.0 Before you configure your router or access server platform with this feature, complete the following activities: Establish a working IP network. For more information, refer to the Cisco IOS documentation set. See specifically the Cisco IOS IP and IP Routing Configuration Guide, Release 12.1, and the Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2. Configure VoIP. For more information, refer to the Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2. Download the TCL scripts required for this feature, located at the following URL: http://www.cisco.com/cgi-bin/tablebuild.pl/tclware Ensure that the VCWare version used for the AS5300 is compatible with the IOS image being used. Note VCWare applies only to the Cisco AS5300. Configuration Tasks This command controls the interpretation of supplementary service (QSIG, H.450, and so on) on a gateway. When the CLI is enabled (that is, set to pass through mode), the supplementary service message (usually in Q.931 facility message) is transparently sent to the destination gateway without any interpretation (raw). When the CLI is not enabled (the default), the supplementary service message is decoded and interpreted by the gateway. This CLI is available under VoIP or POTS dial peers. Note This CLI only has effect if a TCL IVR 2.0 application is configured on the same dial peer. The default session application always performs transparent Q.SIG interworking. TCL IVR 1.0 applications always interpret and consume the Q.SIG supplementary services messages. Before starting the software configuration tasks for theivr Version 2.0 features, complete the following pre-installation tasks: Download the TCL Scripts and audio files to be used with this feature from the CCO Software Support Center. Store the TCL scripts and audio files on a TFTP server configured to interact with your gateway access server. Create the IVR/TCL application script to use with the call application voice command when configuring IVR using TCL scripts. You create this application first, store it on a server, or location where it can be retrieved by the access server, then you configure the access server to use IVR with the application that you created. Configure the dial peer on incoming POTS or VoIP dial peers. See the following sections for configuration tasks for the QSIG TCL IVR 2.0 feature. Configuring the Application (required) Configuring Supplementary Service for POTS Dial-Peer (optional) Configuring Supplementary Service for VoIP Dial-Peer (optional) Verifying Supplementary Service (optional) 4
Configuration Tasks Configuring the Application The application that is to be called to interact with the dial peer (that collects the digits from the caller), needs to be created before configuring the dial peer that will call this applicaiton. Use the call application voice command as shown. Each command line is optional depending on the type of action desired, or which digits to collect. Step 1 Router(config)# call application voice application-name location Purpose Defines the name of the applicaiton to be used with your IVR script, and indicates the location of the appropriate IVR script to be used with this application. The location can be a URL, directory, or a TFTP server. Step 2 Router(config-dial-peer)# exit Exits dial-peer configuration mode. Configuring Supplementary Service for POTS Dial-Peer Purpose Step 1 Router(config)# dial-peer voice tag pots Enters voice dial-peer configuration mode. Step 2 Step 3 Router(config-dial-peer)# application application-name Router(config-dial-peer)# tag Digits that define a particular dial peer. Valid entries are from 1 to 2,147,483,647. pots Indicates that this is a plain old telephone service (POTS) peer using VoIP encapsulation on the IP backbone. Specifies the application that will handle incoming voice calls associated with this dial-peer.' Configures supplementary service feature to transparently pass supplementary service to the next gateway. Step 4 Router(config-dial-peer)# exit Exits dial-peer configuration mode. Configuring Supplementary Service for VoIP Dial-Peer Purpose Step 1 Router(config)# dial-peer voice tag voip Enters VoIP dial-peer configuration mode. Step 2 Router(config-dial-peer)# application application-name tag Digits that define a particular dial peer. Valid entries are from 1 to 2,147,483,647. voip Indicates that this is a VoIP peer using voice encapsulation on the POTS network. Specifies the application that will handle incoming voice calls associated with this dial-peer.' 5
Configuration Examples QSIG for TCL IVR 2.0 Step 3 Router(config-dial-peer)# Purpose Configures supplementary service feature to transparently pass supplementary service to the next gateway. Step 4 Router(config-dial-peer)# exit Exits dial-peer configuration mode. Verifying Supplementary Service Use the show running configuration privileged EXEC command to verify your configuration, as shown in the Configuration Example section. Configuration Examples This section provides the following configuration examples: Supplementary Service Example Supplementary Service Example The output shown below is the result of using the show running-config command. Building configuration... Current configuration :3531 bytes version 12.2 service timestamps debug datetime msec localtime service timestamps log datetime msec localtime no service password-encryption service internal hostname router no logging buffered resource-pool disable ip subnet-zero ip host jurai 223.255.254.254 ip host dirt 223.255.254.254 ip host CALLGEN-SECURITY-V2 15.90.60.59 1.82.0.0 trunk group 323 isdn switch-type primary-ni voice service pots 6
Configuration Examples fax interface-type modem mta receive maximum-recipients 0 partition flash 2 8 8 controller T1 0 framing esf clock source line primary linecode b8zs ds0-group 1 timeslots 1-4 type e&m-fgb dtmf dnis cas-custom 1 translation-rule 1 Rule 1 ^.% 1 interface Ethernet0 ip address 172.19.140.96 255.255.255.0 no ip route-cache no ip mroute-cache squelch reduced interface Serial1:23 no ip address no keepalive shutdown ip classless ip route 0.0.0.0 0.0.0.0 172.19.140.1 ip route 223.255.254.254 255.255.255.255 1.8.0.1 no ip http server snmp-server community public RW snmp-server packetsize 4096 call rsvp-sync voice-port 0:1 mgcp profile default dial-peer cor custom dial-peer voice 650 voip destination-pattern 650... session target ipv4:1.8.50.14 dial-peer voice 1 pots dial-peer voice 1234 pots 7
Reference QSIG for TCL IVR 2.0 destination-pattern 1234 dial-peer voice 100 pots application debit-card incoming called-number 650233... direct-inward-dial dial-peer voice 1001 voip incoming called-number 650233... dial-peer voice 12345602 voip dial-peer hunt 6 line con 0 exec-timeout 0 0 logging synchronous level all line aux 0 line vty 0 4 exec-timeout 60 0 password lab login end Reference This section documents the following new command. All other commands used with this feature are documented in the Cisco IOS Release 12.2 command reference publications. supplementary-service 8
supplementary-service supplementary-service To disable the interpretation of supplementary service messages, use the supplementary-service command in dial-peer configuration mode. To enable interpretation, use the no form of this command. no Syntax Description pass-through Configures the supplementary service feature to transparently pass supplementary service to the next gateway. Defaults The interpretation of supplementary service messages is enabled. Modes Dial-peer configuration History Release 12.2(2)XU Modification This command was introduced. Usage Guidelines When in pass-through mode all ssinfo from the Facility message is discardedby the TCL IVR 2.0 application and the raw message is sent to another leg.when it is turned to non-pass-through mode (default) TCL IVR 2.0 checks the content of ssinfo and sends it to the supplementary service module. Applies only when a TCL IVR 2.0 application is configured on the dial-peer. Examples The following example shows interpretation of supplementary service messages has been disabled.for POTS dial peer 999: dial-peer voice 999 pots application session destination-pattern 4... direct-inward-dial port 1:D Related s application call application voice Description To enable a specific application on a dial peer. For H.323 networks, the application is defined by a TCL IVR filename and location. Creates an application and indicates the location of the corresponding TCL files that implement this application. 9
supplementary-service QSIG for TCL IVR 2.0 call application voice authen-list call application voice authen-method Description Specifies the name of an authentication method list for a TCL application. Specifies the authentication method for a TCL application. 10
Glossary Glossary CLI command-line interface. An interface that allows the user to interact with the operating system by entering commands and optional arguments. ISDN Integrated Services Digital Network. Communication protocol offered by telephone companies that permits telephone networks to carry data, voice, and other source traffic. IVR interactive voice response. Term used to describe systems that provide information in the form of recorded messages over telephone lines in response to user input in the form of spoken words or, more commonly, DTMF signaling. Examples include banks that allow you to check your balance from any telephone and automated stock quote systems. PINX private integrated services network exchange. A PBX or key system which, in a BRI voice application, uses QSIG signaling. PISN Private Integrated Services Network. An ISDN providing services to a specific set of users (contrary to public ISDN which provides services to the general public). PRI Primary Rate Interface. ISDN interface to primary rate access. Primary rate access consists of a single 64-kbps D channel plus 23 (T1) or 30 (E1) B channels for voice or data. Q.931 ITU-T specification for signaling to establish, maintain, and clear ISDN network connections. QSIG Q (point of the ISDN model) Signaling. Signaling standard. Common channel signaling protocol based on ISDN Q.931 standards and used by many digital PBXs. ssinfo A structure in raw message, which contains all decoded Supplementary Service information. TCL Tool Language. 11