TCL IVR 1.0 Frequently Asked Questions

This document contains FAQs that address the most common problem areas dealing with the Cisco Tool Command Language (TCL) Interactive Voice Response (IVR) scripting environment, which helps customers to meet their needs in script customization and/or new IVR script creation.

TCL IVR 1.0

When the user aborts a playPrompt entry by hitting the abortKey, does playPrompt return "collect fail" or does it reset to continue collecting input?
How do you code PIN numbers and card numbers? Which RADIUS fields are used (name for card number and password for PIN number)?
I am not running under Solaris. Will lockScript work for me?
I want to understand how and why I need to run lockScript on my script.
Can you show me an example of regexp used within an IVR script?
What type of program is lockScript?
How do I use lockScript?

Tcl IVR 1.0

Q. When the user aborts a playPrompt entry by hitting the abortKey, does playPrompt return "collect fail" or does it reset to continue collecting input?

A. Neither. It should return "collect aborted", and stop collecting input. "collect fail" is returned if the digits entered do not match the patterns.

Q. How do you code PIN numbers and card numbers? Which RADIUS fields are used (name for card number and password for PIN number)?

A. Card number is a combination of the entered account number and pin number. When a user is prompted to enter a card number, the collected digits are passed through $info(digits). That field is then split into two variables (account number and pin number) and then passed to the RADIUS server for authorization.

Q. I am not running under Solaris. Will lockScript work for me?

A. No, lockScript is a Solaris binary. If you want to bypass having to use lockScript and you are using IOS 12.0(7) T image there is a test command: "test voip scripts", which turns off the signature mechanism. You have to run it again if you reboot the box, so currently you can't use it in a production environment.
This command is run in the Exec privilege mode. When executed you get the following message:
router-name#test voip scripts %
This command is an unreleased and unsupported feature allowing unsupported scripts to be loaded. To turn if off you run it again. If you are running with an earlier version you will not have this command.

Q. I want to understand how and why I need to run lockScript on my script.

A. Cisco created lockScript as a security to prevent modified script from running on the router. The lockScript binary provides the signature necessary to run the modified Tcl scripts. For the Clapton project Cisco is providing lockScript to allow the customers the ability to modify existing scripts or generate their own. So it is required both for security and testing.

Q. Can you show me an example of regexp used within an IVR script ? I get 'syntax error in regexp' even with the simplest patterns. For example, I am testing for a single digit collected in the variable digits_collected, with the command:

if {regexp {^[0-9]$} $digits_collected First_digit} { ....

}

and the debug finds a syntax error

A. You need to enclose your regexp in []

if {[regexp {^[0-9$]} $digits_collected First_ digit]} {

.....

}

Q. What type of program is lockScript?

A. lockScript is a Solaris binary executable.

Q. How do I use lockScript?

A. After you have made your changes to your script you run the command line 'lockScript <user ID> your_script.tcl' which will create a new file your_script.1.1.1.tcl. Then you load your script on the router. Use following command to accomplish this:

lockScript <UID>./scripts (your script)