SECTION FIVE
SAVING YOUR WORK

5.1:  INTRODUCTION

Now that you've spent time setting the screen and keyboard voices just
the way you like them, it may be time to end your PC work session for
the day.  Does this mean that tomorrow, or the next time you turn on
your PC, you're going to have to repeat the process of setting the voices? 
Not at all.  Not if you take the time to save your settings in a ".SET" file.

In this section of your Vocal-Eyes users' guide we'll explain just what a
.SET file is.  We'll show you how you can create one or several.  Later in
this manual we'll show you how to load up to 9 .SET files automatically
when you first start up Vocal-Eyes, or when you reinvoke the program
from the DOS command line or via a batch file or even from the Voice
Control Panel.  For now, though, we'll keep things simple and show you
just enough to get you going.

5.2:  THE .SET FILE

The .SET file is a special file which contains all of the voice settings
you've made so far working with Vocal-Eyes' Voice Control Panel along
with all the others you'll learn about as you progress through this manual. 
You can create as many .SET files as you like with Vocal-Eyes.  Indeed,
you will probably want to create a different one for each and every
applications program you use.  Here is how easy it is.

5.3:  THE FILES MENU

Have you made some changes to your screen and/or keyboard voice?  If
so, then you'll certainly want to save those changes so they'll be available
to you the next time you start up Vocal-Eyes.  Do this.

Use the CTRL-\ key to call up Vocal-Eyes' Voice Control Panel.  Move to
option 6 - Files and press ENTER.  Cursor your way through the various
options in the Files submenu.  You'll discover that there are only six:  1:
Load SET, 2: Save SET, 3: Load Key Label, 4: Load Character Dic, 5:
Load All, and 6: Autoloading.

When you use the Save SET option, Vocal-Eyes creates a .SET file that
contains all of your current voice settings and writes this file to disk. 
Now, the next time you work with Vocal-Eyes, all you have to do is load
this file back into Vocal-Eyes and all of your voice settings will be restored
exactly the way you like them.

Undoubtedly, you've already made some changes to the way Vocal-Eyes
voices.  Let's save them in a .SET file.

Select the 2: Save SET option and press ENTER.  Vocal-Eyes will prompt
you for the name of the file you want to create.  You can use any legal
DOS file name for your .SET file.  Vocal-Eyes will automatically supply a
.SET extension to your file name unless you specify otherwise.  If you
don't want any extension at all, simply end your file name with a period. 
It's probably a good idea to use the .SET extension, though, to make it
easier to organize what will eventually become a veritable library of .SET
files.  Also, hard drive users-- you'll want to keep your .SET files together
in the SPEECH subdirectory right alongside your Vocal-Eyes program files. 
Floppy drive users--you'll want to insert your Vocal-Eyes diskette at this
point.

Now, type in your desired .SET file name.  Make it something that will
remind you of the applications program you've created it for.  How about
using the same name as the applications program?  For example, WP.SET
would be a good choice for WordPerfect since WP.EXE is the name of the
applications program.  The reason you may want to use the same file
name as the application's file name will become clear when we discuss
the powerful feature of autoloading.  You do not need to specify the .SET
extension since Vocal-Eyes assumes this.  For example, you could simply
supply the name "WP" and Vocal-Eyes would convert the file name to
"WP.SET".

Now press ENTER.  Vocal-Eyes will say "SET File saved to disk."  Vocal-
Eyes saved the .SET file to disk, but where on your disk?  Vocal-Eyes
makes a few assumptions whenever you save or load a .SET file.

Remember that when you startup Vocal-Eyes the first time each session,
you were asked to be in a specific directory because Vocal-Eyes
remembers this location for later use.  For example, it uses this location to
look for the file VE.HLP which contains the help screens.  It also uses this
location when you save or load a .SET file.

If you simply type the file name with no drive or path specification, Vocal-
Eyes will look to see if you have a RAM location set up with the same file
name.  RAM locations will be described in section 12.  If a RAM location
with the same name was found, your file will be saved or loaded from
there.  If it is not found in a RAM location, Vocal-Eyes will load or save
the .SET file in the Vocal-Eyes directory.  If you issued a load and the file
was not found in a RAM location or the Vocal-Eyes directory, Vocal-Eyes
will look in your current active drive and directory for the file.  If found it
will be loaded.  If not found, you will get a disk error indicating Vocal-
Eyes could not find the specified file name to load.

If, when you save or load a file, you include a drive and/or path
specification, Vocal-Eyes will save or load it directly to the location
specified.  Only if the path is not specified will Vocal-Eyes go through the
RAM locations than the default Vocal-Eyes directory and finally the
current active directory.

If you issue a load or save, Vocal-Eyes will display the current file name
as the default.  If this default contains a path, you can be assured it was
loaded from disk.  If however, it does not contain a path, you can be
assured it was loaded from a RAM location.  For example, a file name of
"123.SET" would indicate it was loaded from RAM while a file name of
"C:\SPEECH\123.SET" would indicate it was loaded from disk.

We will cover the steps Vocal-Eyes goes through during a load or save in
detail, when we discuss RAM locations in section 12.

The next time you run Vocal-Eyes, simply use the CTRL-\ key to call up
the Voice Control Panel, select option 6 on the main menu and then
option 1: Load SET.  Vocal-Eyes will prompt you for the name of the file
to load into memory.  Type the name of your .SET file and then press
ENTER.  Voila!  Vocal-Eyes is now talking your language!

Have you changed applications software?  Why not take a moment to
change .SET files.  

As you can see, you don't have to exit to the DOS prompt to load a new
voice configuration.  Remember we stated earlier that the Voice Control
Panel would wait until DOS was not busy before popping up.  Well, this is
one reason why.  This way, if the Voice Control Panel is popped up, you
can be sure that there will be no conflict with DOS.  If you pop up the
Voice Control Panel from Review Mode, DOS may never be ready so the
menus pop up automatically even if DOS is busy.  However, if you try and
load or save a .SET file, you may get the error message "Unable to access
disk, DOS is busy."  Simply exit the Voice Control Panel, exit Review
Mode then pop the Voice Control Panel back up again.  This time, DOS
will be ready for you.  Normally you will not have a conflict since Vocal-
Eyes checks things out first.  However, isn't it better to get Vocal-Eyes'
error message than to try and access DOS when it is busy and lock up
your machine?

Those of you wanting to create macros may also have problems with DOS
being busy.  There are ways around this problem.  Refer to section 16 for
a complete discussion of macros.

5.4:  LOADING .SET FILES THROUGH THE COMMAND LINE

We just showed you how to load in a new .SET file by using the Voice
Control Panel's Files option.  There is another way to do this, however;
one which will allow you to have your favorite .SET file already loaded
and running when you first start up Vocal-Eyes.  Here's how it works:

From DOS, use the CD, change directory command to change into your
SPEECH subdirectory, or whichever subdirectory contains your Vocal-Eyes
program files.  Type VE, but instead of pressing ENTER the way you did
the first time you ran Vocal-Eyes, skip one space and then type:  /F1

We'll explain more about this /F1 parameter in SECTION 12 of this
manual.  For now, without skipping any spaces, simply type in the name
of the .SET file you would like loaded.  Let's say you'd like your DOS.SET
file loaded and running when Vocal-Eyes first starts up.  In this example
you would type the following from the DOS prompt:

VE /F1DOS

Notice that we did not include the .SET extension to our file name. 
Unless instructed otherwise, Vocal-Eyes automatically assumes a .SET file
extension.  If, instead, your .SET file is located in a subdirectory called
C:\SPEECH\SET and has a file extension of .TLK, then your DOS
command would look like this:

VE /F1C:\SPEECH\SET\DOS.TLK

You can see why we encouraged you to store all your .SET files in the
same directory as your Vocal-Eyes program files and with the .SET file
extension.

You can use the DOS command line to reinvoke Vocal-Eyes with a new
.SET file as often and as many times as you like.  Simply type in the VE
program command along with the /F1 and new .SET file name.  If you're
familiar with .BAT batch files, you probably already see the advantage to
loading .SET files directly from the DOS prompt.  Do you have a batch file
called WP.BAT to run WordPerfect and another called 123 to run Lotus
123?  Why not add a line to each reinvoking Vocal-Eyes with the desired
.SET file?

In section 12, we will talk about the very powerful autoloading feature of
Vocal-Eyes.  With this feature, Vocal-Eyes will automatically load your
.SET files.  No batch files are required.

5.5:  WHERE VOCAL-EYES LOOKS FOR YOUR .SET FILES

When you specify a file name either on the command line after the /F1
parameter or at the File Name prompt from the Voice Control Panel, you
can always specify the exact path where the .SET file is located.  If you
do, that is the only place Vocal-Eyes will look for the file.  If it is not
located where you specifically asked, you will get an error message.

When you first started Vocal-Eyes, it noted the current drive and directory
you were in.  When you load a .SET file and don't specify a specific path,
Vocal-Eyes will first look in the RAM locations for the same .SET name.  If
it is there, it will be loaded from that location.  If not in a RAM location,
Vocal-Eyes will look in the drive and directory Vocal-Eyes was started
from.  If the .SET file is located there, it will be loaded.  If however, the
.SET file was not located in your startup location, Vocal-Eyes looks in the
drive and directory you are currently logged onto.  If it is there, it will be
loaded.  If it is not there, you will get an error message and the file will
not be loaded.  Maybe an example will clear this up.

Lets say you have all files relating to Vocal-Eyes including all .SET files in
a directory called SPEECH on your C: drive.  Now to startup Vocal-Eyes,
you may type the following commands:

C:             ;This will log onto drive C:
CD\SPEECH ;This will log onto the directory SPEECH
ECHOPC /!C1    ;This will load the Echo PC driver using COM1
VE             ;This will startup Vocal-Eyes

Lets say you moved to the root directory of C: by typing:

CD\

Now if you want to load WP.SET, you could use either the Voice Control
Panel or the VE command line.  Each procedure will be covered below:

First from the Voice Control Panel.

Pop up the Panel by pressing CTRL-\.  Select the Files option and then the
Load option.  At the file name prompt, you could type either
'SPEECH\WP' or 'C:\SPEECH\WP' .  Either of these examples would load
the correct .SET file because you specified the exact location.  However,
you should not have to go to all that work.  After all, Vocal-Eyes
remembered where it was loaded from.  Therefore, at the File Name
prompt, why not simply specify "WP?"  After checking RAM, Vocal-Eyes
will look in the drive and directory where Vocal-Eyes was started.  This is
C:\SPEECH and of course there it will find and load the information.

This can all be done at the command line as well.  You could specify:

\SPEECH\VE /F1\SPEECH\WP

or

\SPEECH\VE /F1C:\SPEECH\WP

Again, since you specified the exact path, there would be no problem. 
But remember, we want to type as little as possible.  Why not type:

\SPEECH\VE /F1WP

This would find the WP.SET file in the SPEECH directory for you
automatically.  Notice you still had to start the command with
'\SPEECH\VE'.  This is because VE.COM is located in the SPEECH
directory and you had to tell DOS.  However, if you have a path pointing
to the SPEECH directory, you would not have to specify the '\SPEECH\'
part.  For example:

PATH=C:\SPEECH      This will set a DOS path to C:\SPEECH

Now regardless of what drive you are logged onto or which directory you
are in, you can always type:

VE /F1WP

at the DOS command line or simply specify:

WP

at the Load File prompt from the Voice Control Panel.

Vocal-Eyes will automatically find the specified information.

A note about the DOS PATH statement:  be sure that you change
directories when you run Vocal-Eyes for the first time each session rather
than relying on the PATH statement to find it.  If you don't change
directories, Vocal-Eyes will not know where to find its .SET files, .HLP
file, etc.  

Saving a .SET file is very similar to loading one.  The only way to save a
.SET file however, is from the Save option from the Voice Control Panel. 
If you do not specify the location, Vocal-Eyes will look for a RAM location
with the same name.  If it finds one, it will prompt you, "Save to RAM
and disk (Y/N)?"   If you press "Y," Vocal-Eyes will, as you might expect,
save your .SET file to both the RAM location and a disk file in the
Vocal-Eyes directory.  If you press "N," Vocal-Eyes will save the file to
RAM only.  If no RAM location with the same name was found, Vocal-
Eyes will save the .SET file in the drive and directory you started Vocal-
Eyes up in and say "SET file saved to disk."

If you save a .SET file with the name "123," Vocal-Eyes will save,
assuming no RAM location with the name '123.SET' was found, in the
directory Vocal-Eyes was loaded from.  Now, if you issue another load or
save, you will notice the file name contains the entire drive and directory
where the file is to be saved or loaded.  For example, the file name would
be "C:\SPEECH\123.SET" if you started up Vocal-Eyes on the C: drive in
the SPEECH directory.

5.6:  VOCAL-EYES' DEFAULT .SET FILE

The first time you load Vocal-Eyes each session, if you do not specify a
.SET file to load via the /F1 parameter, Vocal-Eyes will automatically look
for a default .SET file.  The default file is called:

VE.SET

If this file is found in the current drive and directory, Vocal-Eyes will load
the file just as if you had specified:

VE /F1VE

Therefore, if you wish Vocal-Eyes to load your default settings
automatically each time it started up the very first time, name the .SET
file 'VE.SET'.

5.7:  A BRIEF DESCRIPTION OF AUTOLOADING

The formal definition of autoloading will be suspended until section 12 of
this manual.  However, this section will give you a basic feel for what this
feature can do for you.  By default, whenever you execute a program,
Vocal-Eyes will automatically load the .SET file in the default drive and
directory Vocal-Eyes was started from with the same name as the
application program.  For example, if you execute WordPerfect by typing
'WP' at the DOS prompt, Vocal-Eyes will automatically load WP.SET from
the Vocal-Eyes directory.  When you exit  WordPerfect, Vocal-Eyes will
reload the same .SET file you had loaded prior to starting up WordPerfect. 
Also, when you shell to DOS from within WordPerfect, Vocal-Eyes will
sense this and automatically load DOS.SET.  When you exit the shell,
Vocal-Eyes will reload the .SET file prior to shelling to DOS, in our
example, this would be WP.SET.

You should keep this procedure in mind.  For example, if you are sitting at
the DOS command line and manually load a .SET file and then execute a
program, Vocal-Eyes will load the .SET file with the same name as the
application program if such a .SET file exists.  This means, the .SET file
you loaded manually will be replaced.  Once you are fully aware of this
feature, you will wonder how you ever got along without it.  However,
until you understand how Vocal-Eyes is handling the loading  and
reloading of .SET files, it may seem a bit confusing.  It is possible to
disable this feature if you prefer using batch files.

Once we cover RAM locations and character and key label dictionaries,
we will fully describe this powerful feature.