Appendix h: Program Files/Directory Structure
By default the program loads into the c: drive in the stplus directory (c:\stplus). If you chose a different drive for your installation, then the following will be under that drive\stplus - for example d:\stplus. Under this directory are the following files:
stplus.exe - this file runs the Voice Service Bureau program
prompts.txt - this is the file that you see when you click on Maintain, Prompts. It can be edited with any DOS editor. However, it is recommended that you make a copy of the original. You can change the wording of the system prompts, but the digit entries and where they go cannot be changed. For example, if a prompt reads: press 1 to hear your messages, press 2 to send a message, etc. you can change it to read: "please enter a one to listen to your messages, enter a two to deliver a message." You cannot change it to say 'press 1 to send and press 2 to listen'. You can re-record any of those prompts in your voice.
pbx.txt - this file is used for pbx integration and inband signaling only - see Appendix c.
watch.exe - this is a program that will 'watch' the Voice Service Bureau program. The voice Service Bureau program creates a file (\stplus\system\watch.tmp) every 5 minutes. The watch.exe looks for that file. If that file does not appear, the watch.exe assumes there is a problem and will re-start Windows NT. To run this program, you will need to create a shortcut for it and be sure it is entered in your Start-up window, along with the program \stplus\stplus.exe. (see your Windows NT for information on those options.)
background.exe, report.exe, traffic.exe - see Chapter 24:Logging, Background Processing.
\stplus\ntmanual.htm - you will find many .htm files in this directory. They are the files you see when you open the on-screen Help. The screen shots are housed in the \stplus\images directory (see below).
Directories under \stplus:
\stplus\system - the watch.tmp file which the program creates every 5 minutes is listed in this directory. See 'watch.exe' above.
\stplus\prompts - this is where all the system prompts reside. These are the default prompts provided with the program. These are files you will see listed under Maintain, Prompts. These are not the voice files you record as greetings, etc. in individual boxes. those files reside in each of those box subdirectories under \stplus\boxes\10 (for box 10 voice files).
\stplus\prompts\lang2 - this is where the system prompts for language 2 will reside if you record them from the Maintain, Prompts menu - see the section under Access Box tweaks for multiple languages. By default the program looks for system prompt files in the \stplus\prompts subdirectory. If language 2 has been chosen by the caller, then the program will default to always look first in the \stplus\prompts\lang2 subdirectory. If the program cannot locate the file there it will look to the \stplus\prompts subdirectory. If not located there, the program will play the prompt \stplus\prompts\nomsg.voi ("no message recorded"). If THAT file is not there, the program will disconnect the call.
\stplus\db - this is where major program database files reside. The program database files are written in Borland's Paradox format. These files house some of the program information that you enter from the screen. Other, equally important database files reside in the individual box directories. The files in the \stplus\db directory coordinate with the files in the individual box directories. One set is of no use without the coordinating set. All database files have supporting files, as well. For example, if you need to make a change to the master.db, you need to be sure you also have access to the master.* files. If for any reason you take any database files to another machine or directory to work on, be sure you have ALL files that begin with that file name. Also, be sure the program is closed and remains closed until you replace the files. To illustrate the relation of the database files, for example, information you enter on the main access box screens is contained in the \stplus\db\access.db. Information you enter after clicking on the tweaks button in an access box, will be held in \stplus\boxes\10\accssdgt.db (for access box 10). So, you can see that information in the master.db, access.db, and accssdgt.db (including their support files) are required to make one access box function properly.
see** Note below.
\stplus\db\queue - this directory is where all of the outbound call queuing database files are stored. For example, when a message is left in a mailbox and the owner of the mailbox needs to be notified, that information is sent to a file in this directory. The program is always scanning these files to see if it has any outbound calls to make - paging, outbound box, message notification, etc. The outbound calls that the program makes are determined by Line Groups. Each mailbox and outbound box needs to have a Line Group chosen to make the associated calls. Mailboxes send message notifications, pager calls, and message waiting lamp calls to the Line Group listed in the mailbox under message notification. The lines to be used in a given line group is determined under Maintain, Line Groups. If Line Group 1 is chose in the mailbox and Lines 1 and 2 are checked under Maintain, Line Groups, Line Group 1, then calls from that mailbox will be sent to the out_1.db. Calls using Line Group 2 go to out_2.db, etc.
All outbound calls originating from a mailbox go either to the out_x.db file as described above, if the call needs to be made 'right now'. If the call can't be made until later, then the call information goes to the schedule.db. All Line Group calls go there first, if they cannot be made right away. An example of such a call would be if a message is left in a mailbox at 10 pm, but the mailbox notification is set to notify the box owner only between the hours of 9 am to 5 pm. The call information would be sent to the schedule.db. The voice program is constantly polling that file to see if there are any 'jobs' to be sent to the out_x.db. Call information in the out_x.db is made right away.
All outbound calls originating from an Outbound Box go either to the schedout.db (if scheduling is setup in the Outbound Box) or to the out_x.db file if they are to be made right away (click on the start button with no scheduling set.
**Note:
If you are making any quantity of calls (hundreds or thousands of number in an Outbound Box, or if you have several dozen or more mailboxes trying to notify box owners of messages), it is important to use a separate Line Group for each Outbound Box, and a separate Line Group for your mailbox notifications. Otherwise, your message notification could get stuck at the end of a file with a thousand calls set to go out first.
Calls that reached a no answer or busy will be sent to the retry.db. The program is always polling that file as well to send items to the out_x.db file(s)
\stplus\log - this is where all logging files reside - traces, etc.
see Chapter 24 on Logging, Background processing, etc.
backgrnd.log, trace_x.log, globalx.log, func.log, func_xxxxxx.log, current.dbf, dberr.txt, debug.dat, remote.log are files you will find in this directory
\stplus\log\backup - when log=yes in the \winnt\stplus.ini file, all system activity goes to \stplus\log\current.dbf. Each night at midnight, the program renames the current.dbf to today's date (022300.dbf) and moves the file to the \stplus\log\backup subdirectory - see also Chapter 24 on Logging.
\stplus\fonebar - you will only use this subdirectory if you have purchased the optional FoneBar module. There can only be ONE Fonebar box on the system. The voice files you record from the screen will be in this directory, along with the temporary files callers record when they enter the Fonebar, such as their name and description. Any messages they record and send to others in the Fonebar are also housed in this directory. When the caller exits the Fonebar, all their related files are deleted. In some cases some of those files may not be able to get deleted at that exact time - files which are being played, for example. Every hour the program will poll this directory and delete any left over files. Also, each time the program is opened it deletes any files in this directory.
\stplus\icverify - you will create this directory if you have purchased the optional Credit Card module. This is the directory where the request and answer files are housed. See Part III a: Online Credit Card Authorization.
\stplus\images - this is where the screen shots are housed that you will see when you run the on-screen help manual, which is in htm format.
\stplus\reports - you will only have this subdirectory if you have run the 'report.exe' and requested that box database information be sent to text files. By default, the program will create the reports subdirectory and put the .txt file in there. When you run the report.exe, will have the option to create the .txt files in a different path.
\stplus\tollbridge - you will only have this directory if you have purchase the optional TolllBridge module. There can only be ONE TollBridge box on the system. Voice files recorded in the TollBridge Box and database information is housed in this directory.
\stplus\boxes\10 - this is where the database files and voice files for box 10 reside. Files for box 300000 would be in \stplus\boxes\300000. When you make a new box, a new directory is created. Where the boxes are created is determined by the path in the \winnt\stplus.ini file under
[Main]
Path= c:\stplus
or , if there is no path listed in the [Main] section, the program will default to c:\stplus, unless there is a [Path] section.
[Path]
Path=c:\stplus
Also, whenever you create a new box from the screen, you have the opportunity to choose a new path.
Database files in each box subdirectory do not operate alone. They require information from database files in the \stplus\db directory as well. See that section above.
Below is a listing of possible boxes on the system and examples of database files and voice files you may find in the subdirectories, if you have recorded them. Remember that ALL .db files have support files which carry various file extensions (.px, .xgo, etc). Voice Files can be recorded elsewhere and copied to the appropriate directory with the appropriate file name. Be sure your recording file format is correct for the setting you have in your \winn\stplus.in file under 'samplingrate='
**Note:
NEVER DELETE ANY DIRECTORIES OR FILES FROM WINDOWS NT EXPLORER OR FROM A DOS PROMPT, unless you have been directed to do by voicestamps Technical Support. Also, NEVER add or subtract any information from any database files unless voicestamps Technical Support has directed it.
NEVER tamper with any program files while the program is running.
Boxes should ONLY be deleted from with the program. The \stplus\master.db has a list of all boxes and their paths. The program does not search the hard drive for information. It looks first to the master.db.
When you are setting up the program, you may have inadvertently created several boxes you do not want, or after your initial setup, you might simply want to get rid of ALL boxes and start over. This is possible. You can deleted all database information in the program and start fresh.
Close the program. Then, using Windows NT Explorer, you can delete the following subdirectories under \stplus:
\stplus\db
\stplus\boxes
\stplus\log
Then, when you re-open the program you will see the program create one of every kind of box you are entitled to. The program will create 4 mailboxes. The default box numbers and general box file names are as follows:
Access Boxes:
\stplus\boxes\10:
greet_1.vox - greeting file, language , if not using multiple greetings
greet_2.vox - greeting file, language 2
g1_l1.vox - if using multiple greetings, greeting #1, lang 1
g2_l2.vox - if using multiple greetings, greeting #2, lang 2
accssdgt.db - contains information for the access box under 'tweaks'
Client Boxes:
\stplus\boxes\0:
this client box and directory SHOULD NOT be deleted. The voice program defaults to this client 0 (zero).
Conference Boxes:
\stplus\boxes\50:
50 is the default conference box. The conference box feature will only function if you have purchased the optional FoneBar module.
Fax Boxes:
\stplus\boxes\60:
6o is the default fax box.
Group Mailboxes:
\stplus\boxes\40:
40 is the default group box.
IVR Boxes:
\stplus\boxes\100:
100 is the default IVR box. This box will only be created when you have purchased the optional IVR module.
greeting = greet_1.vox
Mailboxes:
\stplus\boxes\1:
1 - 4 are the default mailboxes.
g1_l1.vox - filename when you record the greeting 1, language 1
g2_l2.vox - filename for greeting 1, language 2
mailgrt.db - this file contains information that has been entered on the screen you see after clicking on 'greeting 1' in the mailbox (transfer yes/no, after mailbox go to, etc.)
msgqueue.db - this file contains all information about messages that have been left for the mailbox (the mailbox # it is from, the path to the voice message files, etc.)
xxxxxxxxx.msg - filename for each message left in the mailbox. The program does not look for the presence of these files in and of themselves. The program first looks in the msgqueue.db to see what, if any, messages there are. The program then uses the path listed in the msgqueue.db file to look for and play the individual messages. The actual voice message files for a mailbox could be in the mailbox directory itself, or they could be in a group box directory, or in the mailbox directory of the person that sent the message, depending upon how the message originated. The path in the msgqueue.db file tells the program where to find the message.
g1_hld1.vox - this is the file played when 'allow holding' is set for the mailbox when greeting number 1 is in force. The caller would be told that the transfer number dialed was busy and if they press the key to hold, this file is played. Additional hold files should be labeled g1_hld2.vox, etc. and could be recorded using the program VFEdit. Hold files for greeting number 2 would be called g2_hld1.vox, g2_hld2.vox, etc.
The remaining information for the mailbox - message notification, pager info, etc. is kept in the \stplus\db\mail.db.
Outbound Boxes:
\stplus\boxes\80
80 is the default outbound box.
TollBridge Box:
\stplus\tollbridge - contains the voice files for the TollBridge Box. You will only have a TollBridge Box if you have purchased the optional TollBridge module. There can only be ONE TollBridge box/directory.
Credit Card Boxes:
\stplus\boxes\90
90 is the default credit card box, but you may multiple boxes.
greeting - greet_1.vox
box name - boxname.vox
ending - end_1.vox
charge prompt - inst_1.vox
question #1 - q1_l1.vox
question #1 error - qer1l1.vox
question name #1 - qnam1.vox
hold prompt - hld_1.vox
database files:
question.db,px - info for questions
menu.db,px - info under charge menu button
info on the main screen contained in \stplus\db\ccbox.db
Question Boxes:
\stplus\boxes\70
70 is the default question box
voice filenames are as follows:
box name - boxname.vox
greeting - greet_1.vox
question 1 - q1_l1.vox (quest 1 language 1)
question 1 error message - qer1l1.vox (quest 1 language 1)
if using contest feature:
correct answer - qco1l1 (correct answer quest 1 lang 1)
wrong answer - qwr1l1.vox (wrong answer quest 1 lang 1)
value prompts only in one language:
f1_v1.vox - prompt to be played for value #1
database files:
question.db, px - file where information for each question is kept,
after clicking on the individual question. information shown on the main question box screen is kept in \stplus\db\quest.db
answer.db, px - database where answer information is kept
f1_val.db,px - file where value prompt numbers, names, and voice filenames are kept
Capture Boxes:
\stplus\boxes\20
20 is the default capture box
boxname.vox - capture box name
greet_1.vox - survey intro
end_1.vox - survey ending
q1_l1.vox - question 1 language 1
qer1l1.vox - question 1, error message, language 1
qnam1.vox - name for question 1(same for all languages)
question.db - this file contains all the information you see on the screen after you have clicked on a particular question in the capture box
xxxxxxxxxx.svy - this is the survey description a caller records in a capture box. The program does not search the capture box directory to locate these files. The program looks into the survey.db to determine how questions were answered and looks for the path filename listed in that database. The filename is taken from the time - the number of seconds since January 1, 12 am, 1980.
survey.db - this file contains the listing of all the survey descriptions (the path names for the recorded files, as listed above xxxxxxx.svy) the mailbox number attached, etc. and all information that you see on the screen under Messages, Screening Box Messages for a particular capture box.
Search Boxes:
\stplus\boxes\30
30 is the default search box
greeting - greet_1.vox
ending - end_1.vox
question #1 - q1_l1.vox
question #1 error message - qer1l1.vox
question name - qnam1.vox
matching criteria files:
general message - gen_1.vox
high message - high_1.vox
low message - low_1.vox
database files:
question.db,px - info for all questions
other info in search box contained in \stplus\db\scrnsrch.db
Fonebar Box:
The system can only have one Fonebar box. All corresponding files are held in the \stplus\fonebar subdirectory.
fonebar inro - greet_1.vox
fonebar ending - end_1.vox
waiting message - hld_l1.1 (additional hold messages can be recorded using the VFEDit program as hld_l1.2, etc.)
question #1 - q1_l1.vox
question #1 error message - qer1.l1.vox
question #1 name - qnam1.vox