═══ 1. InfoOnCall for OS/2 - applcation help ═══ This file contains the help for the OS/2 version of InfoOnCall. ═══ 1.1. InfoOnCall - main window help ═══ From the main menu, you can access all of the major functions of InfoOnCall. These include:  The script dialog, where you can create, edit, and execute scripts.  The voice file dialogs, where you can manage InfoOnCall's voice files.  The log window, which records the execution of scripts.  The configuration notebook, which allow you to customize and control InfoOnCall. ═══ 1.1.1. File menu ═══ From the File menu, you can open and close scripts or quit InfoOnCall.  Open  Save  Save as  Close  Exit ═══ 1.1.1.1. File - Open ═══ This option opens a dialog which allows you to choose the script that you wish to open. If you specify a filename which does not exist, you will be given the option to create a new script file with that name. You can only open one script at a time. ═══ 1.1.1.2. File - Save ═══ Choose this option to save the script and continue editing. ═══ 1.1.1.3. File - Save as ═══ Choose this option to save the script under a new name, then continue editing. ═══ 1.1.1.4. File - Close ═══ Choose this option to close the script dialog. You will be given the option to save the script before closing it. If you do not save, all changes that you have made will be lost. ═══ 1.1.1.5. File - Exit ═══ Choose this option to terminate the InfoOnCall application. If a script is open, you will be asked whether or not you wish to save it. ═══ 1.1.2. Voice menu ═══ This menu is for accessing voice mail messages and system prompts used by the system. There are options for recording, playing, deleting, and creating voice files.  Mail  System  Hangup modem ═══ 1.1.2.1. Voice - Mail ═══ This is the voice mail management area. Use this option to listen to voice mail messages left by callers. Old messages should be deleted so that the mailbox does not become too cluttered and so disk space is not wasted. You may also record a voice mail message for someone else that uses the system console. To do so, select the recipient's mailbox number, choose the New button, and record the message. ═══ 1.1.2.2. Voice - System ═══ The system prompts window is used for maintaining the voice files (*.VOC) which are used by InfoOnCall scripts. You can create, delete, record, or play any system prompt. ═══ 1.1.2.3. Voice - Hangup modem ═══ Select this option to hang up the modem and prepare it for normal calling and answering. ═══ 1.1.3. Broadcast menu ═══ From the Broadcast menu, you can set up a multiline broadcast.  Voice  Fax ═══ 1.1.3.1. Broadcast - Voice ═══ Select this option to set up a multiline voice broadcast. ═══ 1.1.3.2. Broadcast - Fax ═══ Select this option to set up a multiline fax broadcast. ═══ 1.1.4. Window menu ═══ From the Window menu, you can open windows to view the configuration and the system logs.  Configure  Log ═══ 1.1.4.1. Window - Configure ═══ Select this option to display the configuration notebook window. ═══ 1.1.4.2. Window - Log ═══ Select this option to display the script execution log. ═══ 1.1.5. Help menu ═══ This menu allows you to get help using InfoOnCall.  General help  Fax info  About ═══ 1.1.5.1. Help - General help ═══ Select this option to get general help for using InfoOnCall. ═══ 1.1.5.2. Help - Fax info ═══ Select this option to set a technical support fax to TTC Computer Products. ═══ 1.1.5.3. Help - About ═══ Select this option to see version and copyright information. ═══ 1.1.6. Script edit dialog ═══ This dialog shows the cards which comprise the currently open script. From here you can create new cards, edit existing cards, or delete cards. With the menu commands, you can also play or record voice files associated with cards in the script, access script utilities, and execute scripts. Button commands:  New  Edit  Mark  Keypad  Abort Menu functions:  Execute  Utilities  Card  Voice ═══ 1.1.6.1. Script window ═══ Using the edit window:  Select cards by clicking on them with the mouse or by moving the cursor with the arrow keys.  You can open cards for editing by double-clicking on them or highlighting them and pressing ENTER.  You can mark cards by highlighting them and pressing the spacebar. ═══ 1.1.6.2. Script - New ═══ Select this option to create a new card. You will be prompted to select an id number and a type for the card. ═══ 1.1.6.3. Script - Edit ═══ Select this option to bring up a Card Edit dialog for the selected card. From there, you can enter or edit the parameters for the card. ═══ 1.1.6.4. Script - Mark ═══ Select this option to toggle a card between the marked and unmarked states. Marked cards are ignored when the script is executed. To delete all of the marked cards from the script, select Pack from the Utilities menu. ═══ 1.1.6.5. Script - Keypad ═══ Select this option to display or edit the keypad assignments for a K1 card. ═══ 1.1.6.6. Script - Abort ═══ Select this option to abort a script execution in progress. ═══ 1.1.6.7. Script - Execute ═══ This menu contains the options for executing the script  Outside line  Local test  Abort ═══ 1.1.6.8. Script - Execute - Outside line ═══ Select this option to begin executing your script normally, taking calls from an outside line. ═══ 1.1.6.9. Script - Execute - Local test ═══ Select this option to begin executing your script in a local test mode. InfoOnCall will process a simulated phone call using the local handset plugged into your modem. ═══ 1.1.6.10. Script - Execute - Abort ═══ Select this option to abort a script execution in progress. ═══ 1.1.6.11. Script - Utilities ═══ This menu contains utilities for editing the script.  Pack  Renumber  Write  Print  Merge ═══ 1.1.6.11.1. Script - Utilities - Pack ═══ Choose this option to permanently delete all the marked cards from the script. ═══ 1.1.6.11.2. Script - Utilities - Renumber ═══ Choose this option to bring up the renumber dialog. This utility allows you to renumber the cards in your script. ═══ 1.1.6.11.3. Script - Utilities - Write ═══ Choose this option to create a readable text file copy of your script on disk. The file will receive the same name as your script, and an extension of .LST ═══ 1.1.6.11.4. Script - Utilities - Print ═══ Choose this option to print a readable text copy of your script on the default printer. ═══ 1.1.6.11.5. Script - Utilities - Merge ═══ Choose this option to merge the currently open script with another on disk. The the new script will replace the current one. When a merge is performed, the cards of the second script are simply loaded into the current script. If there is a duplicate card number, the card from the second script replaces the one in the current script. ═══ 1.1.6.12. Script - Card ═══ This menu allows you to create and edit script cards.  Script - Card - New  Script - Card - Edit  Script - Card - Keypad  Script - Card - Mark ═══ 1.1.6.12.1. Script - Card - New ═══ Select this option to create a new card. You will be prompted to select a type for the card. The new card will be created with a default ID that will place it at the end of the script. ═══ 1.1.6.12.2. Script - Card - Edit ═══ Select this option to bring up a Card Edit dialog for the selected card. From there, you can enter or edit the parameters for the card. ═══ 1.1.6.12.3. Script - Card - Keypad ═══ Select this option to display or edit the keypad assignments for a K1 card. ═══ 1.1.6.12.4. Script - Card - Mark ═══ Select this option to toggle a card between the marked and unmarked states. Marked cards are ignored when the script is executed. To delete all of the marked cards from the script, select Pack from the Utilities menu. ═══ 1.1.6.13. Script - Voice ═══ This menu allows you to play or record the voice files associated with script cards.  Play  Record ═══ 1.1.6.13.1. Script - Voice - Play ═══ Select this option to play the voice file associated with the currently selected card in the script. ═══ 1.1.6.13.2. Script - Voice - Record ═══ Select this option to record the voice file associated with the currently selected card in the script. ═══ 1.1.7. Log window ═══ This windows shows the system log, a record of actions performed by InfoOnCall while executing scripts. You can change the logging detail and other log options by choosing options in the Log page. The text in the log window is not preserved between one run of InfoOnCall and the the next, and it is automatically cleared when the window becomes too full. If you need a more permanent record, use the echo to disk or printer options. Log options:  Reset  Print  Close  Auto-scroll ═══ 1.1.7.1. Log - Reset ═══ Select this option to erase the contents of the log window and delete the log file on disk, if one exists. ═══ 1.1.7.2. Log - Print ═══ Select this option to send the current log contents to the default printer. ═══ 1.1.7.3. Log - Close ═══ Select this option to hide the log window. ═══ 1.1.7.4. Log - Auto-scroll ═══ If this option is selected, the log window will automatically scroll as new entries are recorded. ═══ 1.1.8. Renumber ═══ This utility allows you to renumber the cards of a script in an orderly fashion. The cards will be assigned new ids, starting at the new starting card number id, and incrementing the increment value between each card. The cards remain in the same order, and all jumps between cards are automatically adjusted will so that the script will execute the same as before it was renumbered. Example: If you select a start value of 10 and an increment of 10, the new script will be numbered: 10, 20, 30, 40... Select Ok to renumber the script with the values you have specified, or Cancel to close the dialog without renumbering. ═══ 1.1.8.1. Renumber - starting card ═══ Enter the new ID number for the first card in the renumbered script. ═══ 1.1.8.2. Renumber - increment card ═══ Enter the increment between card IDs. ═══ 1.1.9. Technical support fax ═══ This dialog allows you to fax a problem report to TTC. You can automatically send your personal and system information, along with up to four text files and a question or comment. Select Send to send the technical support fax to TTC using the parameters you have specified. Select Cancel to quit without sending a fax. ═══ 1.1.9.1. Tech support - Files ═══ Here, you may enter the names of up to four text files that you wish to send to TTC along with the technical support fax. ═══ 1.1.9.2. Tech support - Question ═══ Enter your question to TTC here. ═══ 1.1.9.3. Tech support - Phone number ═══ Make sure the correct number for TTC's fax line is entered here. ═══ 1.1.10. Keypad dialog ═══ This dialog is associated with a K1 card. A K1 card plays a voice prompt, waits for the caller to press a touchtone key, then branches to a card. This dialog is where you choose which cards are associated with which touchtone keys. For each touchtone key, enter the number of the card that you want to script to branch to. Enter zero for a key if you want that choice to terminate the script. If you leave a key blank, then that key will be ignored by the script. ═══ 1.1.11. Voice edit dialog ═══ This dialog allows you to manage voice files. Options:  New  Play  Record  Delete  Close ═══ 1.1.11.1. Voice edit window ═══ This windows lists all of the voice files in the group you are editing, as well as their statistics. You can move the cursor with the arrow keys, and play voice files by pressing ENTER or double-clicking. ═══ 1.1.11.2. Voice - New ═══ Select this option to create a new, empty voice file. After you creating the file, you can then select Record to record it. ═══ 1.1.11.3. Voice - Play ═══ Select this option to play the currently selected voice file. You will hear the output through your handset speaker, and also through the external speaker of your modem, if this is enabled. ═══ 1.1.11.4. Voice - Record ═══ Select this option to record over the currently selected voice file. Speak into your telephone handset when recording. ═══ 1.1.11.5. Voice - Delete ═══ Select this option to erase a voice file. ═══ 1.1.11.6. Voice - Close ═══ Select this option to close the voice editing dialog. ═══ 1.1.12. New card dialog ═══ This dialog allows you to choose the ID number and type of a new card. Select OK to create a new card with the options you have selected, or select Cancel to abort with creating a card. Options:  ID  Type ═══ 1.1.12.1. New card - Id ═══ Enter the ID number for the new card. You may accept the default value, or replace it with your own. ═══ 1.1.12.2. New card - type ═══ Select the type of card that you want to create from the drop down list. Note: Once a card has been created, its type cannot be changed. ═══ 1.1.13. Card dialog ═══ This dialog allows you to edit the fields of a card. Select Ok to close this dialog and save the card, or Cancel to quit without saving. Choose Help to get specific help for this card type. Card types ═══ 1.1.14. Broadcast dialog ═══ With the multiline broadcast function, you can broadcast a list of faxes or voice files to a list of phone numbers. InfoOnCall will automatically use all of the ports which are enabled and divide the work between them. You can monitor the progress of the calls by viewing the system logs. In each list, you should enter the items one per line. You can select Import to import a list from a file on disk, or Clear to clear the list. When you are finished, select Start to begin the broadcast or Cancel to quit without doing a broadcast. ═══ 1.1.15. Command line execution mode ═══ This window appears when you execute a script from an OS/2 command prompt. The syntax for this command is: IOC scriptname [-h] Scriptname is the script that you wish to execute. Add the -h parameter if you want to run the script in handset mode. The following options are available in this mode: Stop Stop script execution. Log View the script log(s). About Display InfoOnCall's copyright information. ═══ 1.1.16. Card types ═══ InfoOnCall supports the following card types:  A1 Answer  B1 Broadcast Fax  B2 Broadcast Voice  C1 Change Directory  D1 Dial Out  D2 Dial Pager  D3 Play Tones  E1 Execute DOS  F1 Mark Fax  G1 Get Voice File  G2 Get Variable  G3 Get Time  G4 Get Date  H1 Hangup and Recycle  H2 Hangup and Quit  H3 Flash Hook  I1 Increment Variable  I2 Build String  J1 Jump Voice  J2 Jump Fax  J3 Jump Variable  J4 Jump Calling Tones  J5 Jump Unconditional  K1 Keypad  L1 Look Database  L2 Write Database  N1 Name Local Variable  N2 Name Shared Variable  P1 Play Voice File  Q1 Password  R1 Receive Fax  S1 Say Variable  S2 Say Money  S3 Say Date  S4 Say Time  T1 Timer  V1 Voice Mail  W1 Write Variables  W2 Read Variables  W3 Write Text  X1 Transmit Fax  Z1 Reset Variables  Z2 Assign Variables ═══ 1.1.17. A1 - Answer ═══ The A1 Answer card type is used to answer the phone when an incoming phone call is received. If no incoming calls are detected, the A1 card does nothing but wait. Optionally, you can specify a timeout value so that if no calls are detected in a certain time period, you can jump to another card in your script. When a call comes in, the card waits for the specified number of rings, then connects the caller to the system. In local test mode, InfoOnCall delays for two seconds, then continues automatically. Ring count This is the number of times the card allows the phone to ring before answering the calls. Legal values are 1-99, and the default value is 2. Timeout/Timeout card If Timeout is specified, this card waits this many seconds for incoming calls, then jumps to the Timeout Card if none are received. ═══ 1.1.18. B1 - Broadcast Fax ═══ The Broadcast Fax card reads a list of fax phone numbers from an ASCII text file and faxes a specified file or list of files to each number. Normally, you should only use this card type in a script intended for single line use. If you want to do a broadcast with multiple lines, use the Broadcast/Fax command on the main menu instead. File to fax This is the name of the file to be broadcast. If this parameter is left blank, InfoOnCall will broadcast the files which have been previously marked by F1 cards. Phone number list The name of the ASCII text file containing the list of fax numbers. This file should contain only one fax number per line. Failure list output The name of an optional text file to contain the fax numbers which were not successfully reached. Retries allowed The maximum number of consecutive retries for each fax tranmission attempt before giving up. ═══ 1.1.19. B2 - Broadcast Voice ═══ The Broadcast Voice card type reads a list of phone numbers from an ASCII text file and plays a voice file after dailing each one. Normally, you should only use this card type in a script intended for single line use. If you want to do a broadcast with multiple lines, use the Broadcast/Voice command on the main menu instead. Voice file The name of the voice file to play Phone number The name of the text file containing the list of phone numbers. This file should contain only one phone number per line. Seconds to wait The number of seconds to wait for an answer to each call Retries allowed The maximum number of consecutive retries for each call before giving up. This parameter is optional, and defaults to zero. ═══ 1.1.20. C1 - Change Directory ═══ This card allows the voice and fax directories to be temporarily changed during a script. This card should be used with caution if multiple lines are enabled. Any changes made by this card apply to all lines, not just the one that executes this card. Voice mail The new voice mail directory Voice file The new voice file directory Fax mail The new directory for receiving faxes Fax-on-demand The new directory for sending faxes ═══ 1.1.21. D1 - Dial Out ═══ The dial card type will dial a specified phone number and play a voice file after the phone is answered. When someone answers the call, he can be connected to the system and treated as a normal caller. This card should be used with caution if multiple lines are enabled. Make sure that you do not try to dial the same phone number with more than one line at the same time. Voice file The name of the voice file to played after dialing out. Phone number The phone number to be called. Seconds to wait The maximum number of seconds to wait for an answer. One ring lasts for about six seconds. The default value is forty seconds. Redials allowed The number of consecutive rdials to attempt before accepting failure. Failure card If the call is not completed, the system will jump to this card number. If the call succeeds, control is passed to the card specified in the Next field. ═══ 1.1.22. D2 - Dial Pager ═══ The Pager card type is used to call a pager and leave a callback phone number as a message. The pager card will redial on failure three times and wait for a maximum of five rings before abandoning the call. This card should be used with caution if multiple lines are enabled. Make sure that you do not try to dial the same phone number with more than one line at the same time. Delay time The number of seconds to pause between dialing the page's number and sending the callback message number. Typically, this should be around eight or nine seconds. Phone number The phone number of the pager. Callback number The callback message phone number which is to appear on the page's display as a message. Termination char The termination character used to inform the pager that you are done entering digits. ═══ 1.1.23. D3 - Play Tones ═══ This card simply plays DTMF tones, which may be used in conjunction with the H3 Flash Hook card to transfer calls. Digits to play The string to digits to play. Seconds to wait The number of seconds to pause after playing the tones. ═══ 1.1.24. E1 - Execute DOS ═══ This card type opens a DOS session in the background and executes a command or program. The script resumes when this is finished. Program The filename of the program to be executed. If the program is not located in the current directory, the full path name must be included. Parameters The command line parameters to be passed to the program. Error card The card to be execute if the DOS command returns a non-zero result, indicating an error. If this is left blank, the system will proceed to the next card regardless of the result. ═══ 1.1.25. F1 - Mark Fax ═══ The Mark Fax card type marks a file for faxing. When all the desired items are marked, they can later be faxed all at once using an X1 or B1 card. Document The filename of the document to be faxed. This file should be either a plain ASCII text file, or an InfoOnCall fax file (*.FAX). If no path is specified, InfoOnCall looks for the document in the Fax send directory. If the file cannot be found, FAXNOT.VOC, a system voice file is played. If it had already been marked, FAXDUP.VOC is played. Fax limit card If a fax is requested when the maximum allowed number of faxes has already been reached, FAXMAX.VOC is played, and the script jumps to the card number entered here, or to the Next card if this is blank. Not found card If a card is specified here, this script will branch to that card if the fax file cannot be found. ═══ 1.1.26. G1 - Get Voice File ═══ This card type plays a prompt to the caller, then records an incoming voice mail message into the specified voice mailbox. You can also use this card to record system prompts from a remote phone. Prompt voice file The filename of the system propmt to be played to the caller. Mailbox The number of the voice mailbox in which the caller's incoming message will be recorded. Receiving file Voice mail message file in which to store the message. If no mailbox number is given, this parameter is the name of a system voice file. Silence card The next card executed if silence is detected. ═══ 1.1.27. G2 - Get Variable ═══ The Get Variable card type will store touchtone keypad input received from the caller in a variable to be used later. Prompt voice file The filename of a system prompt file to be played which tells the caller what information to enter. Variable The name of the variable in which the caller's keypad input is to be stored. Max characters The maximum number of characters allowed for the caller's input. If the input is shorter than the maximum length, the caller must press the pound sign to signal the end of his input. ═══ 1.1.28. G3 - Get Time ═══ The Get Time card type will store the current system time in a variable. Formatted time Variable to contain the current time in the form HH:MM:SS. Seconds elapsed Variable to contain the current time as the number of seconds since midnight. ═══ 1.1.29. G4 - Get Date ═══ The Get Date card type will store the current system date in a variable to be used later. Formatted date The variable to contain the current date in the form MM/DD/YY. Days elapsed The variable to contain the Julian date, the number of days since January 1, 4713 BC. ═══ 1.1.30. H1 - Hangup and Recycle ═══ The Hangup and Recycle card type will hang up the phone, then jump to the Next card. Use this card when you want to hang up the current caller and prepare for the next one. ═══ 1.1.31. H2 - Hangup and Quit ═══ The Hangup and Quit card type will hang up the phone and terminate script execution. The Next field is ignored since, by definition, there is no next card. ═══ 1.1.32. H3 - Flash Hook ═══ The Flash Hook card is used to on-hook (hang up) and then off-hook (pick up) the phone, thereby executing a flash hook. The delay between on-hook and off-hook is determined by your modem, and cannot be adjusted. For the VP-003, this delay is 750 miliseconds. ═══ 1.1.33. I1 - Increment Variable ═══ The Increment Variable card type adds a specified number to the value of avariable. Variable The name of the variable to be changed. Number to add If this parameter is missing, the default value of 1 is used. If you want to subtract a value from the variable, enter a negative number here. ═══ 1.1.34. I2 - Build String ═══ The Build String card type allows you to build a string of characters and then store the result in a variable to be used later. Result Variable in which to store the resulting string of characters. Part 1 - 4 You may enter up to four strings or variables to be assembled into the result string. The components are strung together without any spaces. To add a space, enter as one of the parameters. ═══ 1.1.35. J1 - Jump Voice ═══ This card type plays a message and jumps to the V1 Voice Mail card whose number is entered by the caller. The number entered must be the number of a V1 card. Prompt voice file The filename of the system prompt played to the caller. Max characters The maximum number of characters that can be entered by the caller. Tip: Enter a 4 here and set up your script so that the number of the V1 Voice Mail card matches the mailbox number. Retries The number of allowed retries in getting the touchtone input from the caller. If the caller inputs an invalid card number or does not input anything, the card will allow this number of additional attempts. Next The script jumps to the Next card if the caller's input is invalid. ═══ 1.1.36. J2 - Jump Fax ═══ The Jump Fax card type is used for faxing documents. The card plays a message and accepts input from the caller's telephone keypad. The script will branch to the F1 Mark Fax card whose number is entered by the caller. This card must be an F1 card. Prompt voice file The filename of the message played to the caller. Max characters The maximum number of characters allowed for the caller's touchtone input. The default value is 5 characters. Retries The number of retries allowed in getting the touchtone input from the caller. Next The script jumps to the Next card if the caller's input is invalid. ═══ 1.1.37. J3 - Jump Variable ═══ This card type compares two numbers and branches according to their relative values. Variable 1 The first number to be compared. Variable 2 The second number to be compared. Less-than card The next card if the first number is less than the second number. Greater-than card The next card if the first number is greater than the second number. Next The next card executed if the first and second numbers are equal. ═══ 1.1.38. J4 - Jump Calling Tones ═══ This card type is used for call discrimination. When a J4 card is executed, InfoOnCall spends a specified amount of time looking for calling tones which can indicate an incoming fax, a dial tone, or a data call. Normally, you should use this card immediately after an A1 Answer card, when you want to answer a call and do call discrimination. Timeout The time (in seconds) that InfoOnCall should spend checking for calling tones. Note: This value should be at least 4 seconds for reliable fax detection. Fax, dialtone, and data cards These are the cards to which the script will jump if a calling tone is detected. Any blank parameters default to the value of the Next field. ═══ 1.1.39. J5 - Jump Unconditional ═══ This card type does nothing but jump to the card specified in the Next field. ═══ 1.1.40. K1 - Keypad ═══ The Keypad card type is used to branch to another card according to which single button the caller presses on his telephone keypad. A voice file informing the caller of the available choice is played first. Then, a branch to another card is made according to which key was pressed. Prompt voice file The filename of the system prompt which informs the caller of his choices. This message is generally of the form "Press 1 to ..., press 2 to ..., etc." Retries The maximum number of retries in getting the caller input before giving up and passing control to the Next card. Delay time The number of seconds to wait for caller input after playing the menu prompt. Invalid voice file The filename of the system prompt to be played if the caller's input is invalid. Next The number of the next card to be executed if no valid keypad input is received. ═══ 1.1.41. L1 - Look Database ═══ This card type allows you to look up data contained in an indexed dBASE III or III plus file. Database file The filename of dBASE III data file (*.DBF) to be used. Index file The filename of the dBASE II index file (*.NDX) to be used. The database file must be indexed on the field being searched by this card. Search value The value to search for in the indexed field of the data file. Field number The field number of the database file containing the information to be retrieved. Note: This field must be of character type. Result variable The variable in which the retrieved data should be stored. If the search fails, this variable is set to null. ═══ 1.1.42. L2 - Write Database ═══ This card allows you to write character data to a dBASE III file. Database file The filename of dBASE III data file (*.DBF) to be used. Index file The filename of the dBASE II index file (*.NDX) to be used. The database file must be indexed on the field being searched by this card. Search value The value to search for in the indexed field of the data file. Field number The field number of the database file containing the information to be retrieved. Note: This field must be of character type. New data The data to be written to the dBASE file. ═══ 1.1.43. N1 - Name Local Variable ═══ This card type declares a local variable and gives it an initial value. In a multi-line script, local variables are maintained separately for each line. Variable The name of the variable to be declared. Initial value The initial value of the variable ═══ 1.1.44. N2 - Name Shared Variable ═══ This card type declares a shared variable and specifies its initial value. In a multi-line script, shared variables are common to every line, and can be used for things like keeping cumulative totals. Shared variables are also saved between script executions. Variable The name of the variable to be declared. Initial value The initial value of the variable. This value is only used when a script is run for the first time. ═══ 1.1.45. P1 - Play Voice File ═══ This card type simply plays one or more voice files over the phone to the caller. Voice file The filename of a system prompt to be played. Leave any unused fields blank. ═══ 1.1.46. Q1 - Password ═══ The Password card type is used to prompt the caller for a password, then take appropriate action based on the caller's response. Password The actual password in digits. Chars allowed The maximum number of characters (1-30) allowed for a password attempt. Failure card The next card if the password is NOT correct. Max retries The maximum number of retries that the user is allowed for correctly entering the password. If the retries are exhausted, the Failure card is executed next. Next The next card to be executed if the user correctly enters the password. ═══ 1.1.47. R1 - Receive Fax ═══ The Receive Fax card type is used to receive and store an incoming fax document. When an R1 card is executed, InfoOnCall immediately places the modem if fax mode and attempts to answer a fax call. If you need to wait for an incoming call, then you should place an A1 Answer card before the R1 card. Fax filename The name of the file in which the incoming faxes will be stored. ═══ 1.1.48. S1 - Say Variable ═══ The Say Variable card type will speak a number digit by digit, as a whole number, or both. You may fill in one or both of the parameters. Say as digits A number to be spoken back to the caller digit by digit. Say as number A number or variable to be spoken back to the caller as a whole number. ═══ 1.1.49. S2 - Say Money ═══ The Say Money card type will speak a number back to the caller as a dollar amount. Dollar amount The number to be spoken. ═══ 1.1.50. S3 - Say Date ═══ The Say Date card type will a date to the caller. Date The string of characters to be spoken as a date. When specifying a date to be spoken, the character string should consist of eight characters in the form MM/DD/YY, where / can be any separator. If this parameter is left blank, today's date will be spoken. ═══ 1.1.51. S4 - Say Time ═══ The Say Time card type will speak a time to the caller. Time The string of characters to be spoken as a time. When specifying a time to be spoken, the character string should consist of eight characters in the form HH:MM:SS, when : can be any separator. If this paramter is blank, the current time will be spoken. ═══ 1.1.52. T1 - Timer ═══ The Timer car allows the system to wait until a specified time, wait for a specified number of seconds, and/or branch according to the current system time. Wait for time The time (in 24-hour format) to wait for. The system pauses until the current time is equal to or later than this time. The hour and minute both must be specified, but the seconds are optional. Wait seconds The number of seconds to wait before the next card is executed. Comparison time The time used in comparison to the current system time. All times must be entered in 24-hour format with a character separating the two-digit hour, minute, and seconds. Wait for date A date, if different from the current date, to wait for before continuing. Dates should be entered in the mm/dd/yy format. Before time card Next card to be executed if the current time is before the time entered for Comparison time If the current time is equal to or later than the specified time, the Next card is executed. ═══ 1.1.53. V1 - Voice Mail ═══ The Voice Mail card type allows remote access of voice mailboxes. To retrieve messages remotely, press the pound sign after the voice prompt starts playing and then enter the password (if required) when asked to do so by PASSWORD.VOC. If the correct password is entered, any messages stored in the specified mailbox will be plaed back. After each message, menu prompt SCHT7.VOC is played to inform the caller of his options. If you have many mailboxes, and you want to specify a unique password for each, you can leave the Password field blank and store all of the passwords in the plain text file VOCPASS.TXT. Greeting voice file The filename of the system prompt to be played. Mailbox Mailbox number to retrieve messages from. Retries The maximum allowed number of retries for entering the password. The default is 3. Password The password for the voice mailbox. Success card The next card to be executed if the caller successfully retrieves messages. Next The next card to be executed if the mailbox is not successfully accessed. ═══ 1.1.54. W1 - Write Variables ═══ This card type will write all shared variable values to a disk file. This file will be given the same root name as the script file, but with the extension DAT. ═══ 1.1.55. W2 - Read Variables ═══ This card type is used to read back the shared variable values which were written to a disk file with the Write Variables card. Note: You should seldom need to use this card, since this function is automatically done for you when script execution begins. ═══ 1.1.56. W3 - Write Text ═══ This card type will append values to a text file. Filename The file to be appended to. If no file is entered, the file IOC_W3.$$$ will be used. Value A value to write to the text file. ═══ 1.1.57. X1 - Transmit Fax ═══ This card type will fax the previously requested files (marked by a Mark Fax card) or those files listed in a specified text file to the caller. This card should be used with caution if multiple lines are enabled. Make sure that you do not try to fax to the same phone number with more than one line at the same time. Phone number The fax phone number to which the files are sent. If it fails, the transmission will be retried up to the number of times specified in the Fax Information Dialog. If this parameter is blank, the system assumes a 1-call fax and the requested files are sent over the current connection while the caller is on-line. File list The name of the text file containing a list of files to fax. Within the text file, each filename including full paths should be listed one per line. Failure card The next card to be executed if the fax fails. This parameter is optional. If it is not specified, the script always continues with the Next card. Next The next card to be executed if the fax succeeds. ═══ 1.1.58. Z1 - Reset Variables ═══ This card type is used to reset some or all variables to zero or null. It will reset any variables specified. If no variables are given, it will reset all existing variables. ═══ 1.1.59. Z2 - Assign Variables ═══ This card is used to assign values to variables. Use the form Variable=NewValue ═══ 1.1.60. Configuration Notebook ═══ This notebook contains all of the configuration information for InfoOnCall. ═══ 1.1.61. Port page ═══ The port section of the notebook contains one page for each logical port allowed by this version of InfoOnCall. Each port can be enabled or disabled individually, and has its own customizable settings.  Active  Enable speaker  Enable microphone  Tone dialing  Pulse dialing  COM port  Outside line  Log filename Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.61.1. Active ═══ If this check box is selected, then this port is enabled, otherwise it is disabled. When a script is executed, all active ports operate simultaneously. ═══ 1.1.61.2. Enable speaker ═══ Select this option to turn on the external speaker for this port. ═══ 1.1.61.3. Enable microphone ═══ Select this option to turn on the microphone for this port. ═══ 1.1.61.4. Tone dialing ═══ Dial using DTMF tones. ═══ 1.1.61.5. Pulse dialing ═══ Dial using pulse modulation. ═══ 1.1.61.6. COM port ═══ Enter the COM port number for this logical port. ═══ 1.1.61.7. Outside line ═══ Enter the prefix code, if any, that is required by your telephone line to access an outside line. For example, many office phone systems require the user to dial 9, before making outside calls. ═══ 1.1.61.8. Log filename ═══ Enter the log filename for this port here. Each port has a separate log file. ═══ 1.1.62. Primary port page ═══ This page allows you to select the primary port. The primary port is the one used for operations that use only one port, such as playing a voice file from a voice edit dialog, or sending a technical support fax. Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.63. Voice settings ═══ This page allows you to set options for playing and recording voice files.  Format phone numbers  Allow long distance  Silence detection  Date stamp  Time stamp  Maximum message length  Maximum response length  Silence timeout Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.63.1. Format phone numbers ═══ If this option is selected, phone numbers will be formatted using the prefix code information (area code, metro numbers, etc.). If not, only the outside line code will be added, and phone numbers will otherwise be dialed exactly as given. Note: If formatting is off, long distance calls cannot be disabled. ═══ 1.1.63.2. Allow long distance ═══ If this option is selected, InfoOnCall will be allowed to originate long distance calls. ═══ 1.1.63.3. Silence detection ═══ Select this option if you want InfoOnCall to stop recording voice files when silence is detected. ═══ 1.1.63.4. Date stamp ═══ When voice mail messages are retrieved, InfoOnCall will speak the date on which the message was received, if this option is selected. ═══ 1.1.63.5. Time stamp ═══ When voice mail messages are retrieved, InfoOnCall will speak the time at which the message was received, if this option is selected. ═══ 1.1.63.6. Maximum message length ═══ Enter the maximum length, in seconds, for voice files recorded locally. ═══ 1.1.63.7. Maximum response length ═══ Enter the maximum length, in seconds, for voice mail messages left on the system. ═══ 1.1.63.8. Silence timeout ═══ When silence detection is enabled, InfoOnCall halts voice file recording when the line has been silent for this length of time. ═══ 1.1.64. Fax page ═══ This page contains settings for sending and receiving faxes.  Fax leader file  Fax trailer file  Faxes allowed  Retries allowed  Two call faxes Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.64.1. Fax leader file ═══ Enter the full pathname of a file to be used as a cover page for faxes. The file might contain an advertisement or standard company information. If you do not want a leader file, leave this blank. ═══ 1.1.64.2. Fax trailer file ═══ Enter the full pathname of a file to be faxed as the last page of every fax job. If you do not want a trailer file, leave this blank. ═══ 1.1.64.3. Faxes allowed ═══ Enter the maximum numbers of faxes that callers will be allowed to request in a single call. ═══ 1.1.64.4. Retries allowed ═══ Enter the maximum numer of transmission retries for two-call faxes. ═══ 1.1.64.5. Two-call faxes ═══ Select this option to enable two-call faxes. A one-call fax occurs when the caller uses a fax phone and receives a fax over the same connection as the orginal call. A two-call fax occurs when a caller requests that a fax be sent to a different number. In this case, the InfoOnCall system must initiate the call and the InfoOnCall operator will be responsible for the connect charges, if any. ═══ 1.1.65. Directory page ═══ On this page, you may set the default directories for different types of files. Whenever InfoOnCall attempts to store or retrieve a file, it uses the directories specified here unless you override this by specifying a full pathname.  Scripts  Voice files  Voice mail  Fax receive  Fax send Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.65.1. Script directory ═══ This is the default directory for all InfoOnCall script files (*.DBF) ═══ 1.1.65.2. Voice file directory ═══ This is the directory for system voice files (*.VOC) ═══ 1.1.65.3. Voice mail directory ═══ This is the directory for voice mail messages (*.MSG) ═══ 1.1.65.4. Fax receive directory ═══ This is the directory where InfoOnCall stores incoming faxes. ═══ 1.1.65.5. Fax send directory ═══ This is the directory where InfoOnCall expects to find outgoing faxes. ═══ 1.1.66. Log page ═══ This page contains the system log settings.  Write log entries to disk  Send log entries to printer  Logging detail Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.66.1. Send log entries to printer ═══ If this option is selected, all script events are written to the printer at the same time that they are written to the log. ═══ 1.1.66.2. Write log entries to disk ═══ Select this option if you want the log to stored in a disk file. The name of this file must be specified in the Port pages. If this option is not selected, the log is kept in memory only, and is not saved. ═══ 1.1.66.3. Log detail ═══ The script execution log can record events with three different levels of detail Detailed Choose this if you want a detailed description of system events to appear in the logging file. Simple If this option is selected, only notifications of incoming and outgoing phone calls are logged. Card desc Choose this if you want the card descriptions to be the log messages. A blank description field will result in no log entry. ═══ 1.1.67. Prefix page ═══ This page stores the prefix codes for your location  Area code  Long distance  Metro codes Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.67.1. Area code ═══ Enter your area code here. The system will automatically delete this area code before dialing if it appears in a phone number, since the call is local. Therefore, all phone numbers can be entered with thier area codes included. Note: Do not include long distance codes in phone numbers. Instead, put them in the long distance prefix blank. ═══ 1.1.67.2. Long distance ═══ Enter the prefix required for long distance dialing (normally "1"). To prevent outgoing long distance calls, leave this field blank. ═══ 1.1.67.3. Metro codes ═══ Enter the area codes for any metro numbers available in your area. (Metro numbers are outside the local area code, but are not long distance.) InfoOncall will NOT add the long distance prefix to phone numbers which begin with these area codes. ═══ 1.1.68. Address page ═══ This page stores your name and address. This information is used when you fax to TTC technical support.  Name  Address  City  State  Zip Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.68.1. Address Page - Name ═══ Enter your name here. ═══ 1.1.68.2. Address Page - Address ═══ Enter the first line of your address here. ═══ 1.1.68.3. Address Page - City ═══ Enter your city here. ═══ 1.1.68.4. Address Page - State ═══ Enter the two letter abbreviation for your state here. ═══ 1.1.68.5. Address Page - Zip ═══ Enter your zip code here. ═══ 1.1.69. Phone page ═══ This page stores your phone numbers. This information is used when you fax to TTC technical support.  Voice  Fax  Modem  Pager  Mobile Configuration options: Save Save the configuration information, then close the notebook. Undo Undo all changes made to the current page since the notebook was opened. Cancel Close the notebook without saving any changes. ═══ 1.1.69.1. Voice phone number ═══ Enter your voice phone number here. ═══ 1.1.69.2. Fax phone number ═══ Enter your fax phone number here. ═══ 1.1.69.3. Modem phone number ═══ Enter the phone number of your modem here. ═══ 1.1.69.4. Pager phone number ═══ Enter the phone number of your pager here. ═══ 1.1.69.5. Mobile phone number ═══ Enter the number of your mobile phone here.