ISDN Voice Configuration Guide, Cisco IOS Release 15M&T
QSIG Support for Tcl IVR 2.0
Downloads: This chapterpdf (PDF - 1.32MB) The complete bookPDF (PDF - 4.43MB) | The complete bookePub (ePub - 1.38MB) | Feedback

QSIG Support for Tcl IVR 2.0

QSIG Support for Tcl IVR 2.0

This chapter describes how to implement the QSIG for Tool Command Language Interactive Voice Response (Tcl IVR) 2.0 feature. Q.SIG support is required for European countries to interconnect enterprise customers to a wholesale voice solution. The feature provides transparent Q.SIG interworking with a Tcl IVR 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.

Feature benefits include the following:

  • Increased interconnection options for VoIP wholesale providers
  • Elimination of unnecessary decoding

Feature History for QSIG for Tcl IVR 2.0

Release

Modification

12.2(11)T

This feature was introduced.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Prerequisites for Configuring QSIG for Tcl IVR 2.0


Note


VCWare applies only to the Cisco AS5300.


Before configuring IVR Version 2.0 features, do the following:

  • Download the Tcl scripts and audio files to be used with this feature. Store them on a TFTP server configured to interact with your gateway access server.
  • Create the IVR/Tcl application script to use when configuring IVR. Store it on a server or at a location where it can be retrieved by the gateway access server. Then configure the server to use IVR with the application that you created.
  • Configure the dial peer on incoming POTS or VoIP dial peers.

Restrictions for Configuring QSIG for Tcl IVR 2.0

Restrictions are described in the "Restrictions for Configuring ISDN Voice Interfaces". In addition, the following apply:

  • This feature is applicable to only the following:
    • VoIP and POTS dial peers
    • Tcl IVR version 2.0 only; not version 1.0

Information About QSIG for Tcl IVR 2.0

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.


Note


General information about ISDN voice interfaces is presented in the "Information About ISDN Voice Interfaces" section.


How to Configure QSIG for Tcl IVR 2.0

Configuring QSIG

To configure QSIG, perform the following steps.


Note


You must create the application that is to be called to interact with the dial peer (that collects the digits from the caller) before you configure the dial peer that will call this application.


SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    call application voice application-name location

    4.    exit


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example:
    Router> enable
     

    Enters privileged EXEC mode. Enter your password when prompted.

     
    Step 2 configure terminal


    Example:
    Router# configure terminal
     

    Enters configuration mode.

     
    Step 3 call application voice application-name location


    Example:
    Router(config)# call application voice ap1 172.16.4.4
     

    Creates the application to be used with your IVR script and indicates the location of the corresponding Tcl files that implement this application. The location can be a URL, directory, or TFTP server.

     
    Step 4 exit


    Example:
    Router(config)#
     exit
    
     

    Exits the current mode.

     

    Configuring Supplementary Service for a POTS Dial Peer

    To configure supplementary service for a POTS dial peer, perform the following steps.


    Note


    The supplementary-service pass-through 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 passthrough 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.


    • This CLI has effect only 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.
    SUMMARY STEPS

      1.    enable

      2.    configure terminal

      3.    dial-peer voice tag pots

      4.    application application-name

      5.    supplementary-service pass-through

      6.    exit


    DETAILED STEPS
       Command or ActionPurpose
      Step 1 enable


      Example:
      Router> enable
       

      Enters privileged EXEC mode. Enter your password when prompted.

       
      Step 2 configure terminal


      Example:
      Router# configure terminal
       

      Enters configuration mode.

       
      Step 3 dial-peer voice tag pots


      Example:
      Router(config)# dial-peer voice 99 pots
       

      Enters voice dial-peer configuration mode for the specified POTS dial peer.

       
      Step 4 application application-name


      Example:
      Router(config-dial-peer)# application ap1
       

      Specifies the application that handles incoming voice calls associated with this dial-peer.

       
      Step 5 supplementary-service pass-through


      Example:
      Router(config-dial-peer)# supplementary-service pass-through
       

      Configures supplementary service feature to transparently pass supplementary service to the next gateway.

       
      Step 6 exit


      Example:
      Router(config-dial-peer)#
       exit
      
       

      Exits the current mode.

       

      Configuring Supplementary Service for a VoIP Dial Peer

      To configure supplementary service for a VoIP dial peer, perform the following steps.

      SUMMARY STEPS

        1.    enable

        2.    configure terminal

        3.    dial-peer voice tag voip

        4.    application application-name

        5.    supplementary-service pass-through

        6.    exit


      DETAILED STEPS
         Command or ActionPurpose
        Step 1 enable


        Example:
        Router> enable
         

        Enters privileged EXEC mode. Enter your password when prompted.

         
        Step 2 configure terminal


        Example:
        Router# configure terminal
         

        Enters configuration mode.

         
        Step 3 dial-peer voice tag voip


        Example:
        Router(config)# dial-peer voice 96 voip
         

        Enters voice dial-peer configuration mode for the specified VoIP dial peer.

         
        Step 4 application application-name


        Example:
        Router(config-dial-peer)# application ap5
         

        Specifies the application that handles incoming voice calls associated with this dial-peer.'

         
        Step 5 supplementary-service pass-through


        Example:
        Router(config-dial-peer)# supplementary-service pass-through
         

        Configures supplementary service feature to transparently pass supplementary service to the next gateway.

         
        Step 6 exit


        Example:
        Router(config-dial-peer)#
         exit
        
         

        Exits the current mode.

         

        Verifying QSIG and Supplementary Service

        To verify QSIG and supplementary service, perform the following steps (listed alphabetically).

        SUMMARY STEPS

          1.    show isdn status

          2.    show running-config


        DETAILED STEPS
          Step 1   show isdn status

          Use this command to display the status of all ISDN interfaces, including active layers, timer information, and switch-type settings.

          Step 2   show running-config

          Use this command to display the basic router configuration.


          Configuration Example for QSIG for Tcl IVR 2.0

          The following sample output is typical of that for implementation of supplementary service. ISDN supplementary service messages from PBX 1 are sent transparently to PBX 2 by routers 1 and 2 as if PBX 1 and PBX 2 were connected directly to each other.

          Figure 1. QSIG for Tcl IVR 2.0: Sample Network Topology

          Router# show running-config
          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
          !
          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 100 pots
           application debit-card
           incoming called-number 650233....
           direct-inward-dial
           supplementary-service pass-through
           port 0:1
          !
          dial-peer voice 1001 voip
           incoming called-number 650233....
          !
          dial-peer voice 12345602 voip
           supplementary-service pass-through
          !
          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

          Additional References

          General ISDN References

          • "Overview of ISDN Voice Interfaces" --Describes relevant underlying technology; lists related documents, standards, MIBs, and RFCs; and describes how to obtain technical assistance
          • "Additional References" section --Lists additional ISDN references