VEWD Readme File

This file has been extracted from Chapters 1 and 2 of the manual.
It contains:
	Hardware/Software Requirements
	Installation
	Starting and Stopping VEWD
	Memory Considerations
	Converting Databases from Version 2.0/2.01 to Version 2.2
	Converting your FORM 610 printer control files



Hardware/Software Requirements
At a minimum, the program requires:
  IBM PC-XT, PC-AT, or clone, with an Intel 8086, 8088, 8086,
       286, 386, or 486 processor.  A numeric coprocessor is not needed.
  640 KB of memory, preferably 1 MB or more.
  A Hard Drive and a floppy drive.
  MS-DOS, or IBM-DOS, Version 3.3 or later. 

Actually, it might run on earlier versions. Its just never been tested.
A  hard  drive  is  a must, and the faster the  better.   A  fast
computer  won't hurt either.  This program will run on  a  floppy
based  system,  but the point is to speed up your exam  sessions,
not  make them take forever.  The reason for this is that program
does  not keep things in memory.  Everything is written to  disk,
and everything is read from it.  Except for the time between when
you  first  enter  something, and the time you complete  whatever
screen  you  are  on,  you can't lose information  from  a  power
failure.


Installation is fairly simple.
1)   Insert the installation floppy into your disk drive.
2)   Type "A:" or "B:" depending on which floppy drive you use,
     followed by a return,
3)   Type "VEWDINST   " followed by a
     return, where  is the drive letter of the installation
     floppy,  is the drive letter of the hard disk,
      is directory on the hard drive where you want the
     program to be stored.  Include the colons after the two drive
     letters.
4)   Edit your CONFIG.SYS file and make sure the line "FILES =
     x", is at least 40.
     VEWD uses many open files, about 32.  If you are running VEWD in
     a DOS window under Microsoft Windows the value may need to be
     even higher.
     For  example, "VEWDINST A: C: \VEWD" will install into  the  VEWD
     directory on hard drive C from floppy drive A.

Starting and Stopping
To  start VEWD, change to the VEWD directory and type VEWD at the
DOS prompt.  VEWD supports the following command line options.
 
Option  Description
/B=NO   Inhibits the beep on errors
/V=n    Sets the screen saver to n
        minutes.
        Zero disables the screen save
        option.
/L      Disables setting of keyboard
        locks.
/E      Specifies that an enhanced
        keyboard is being used.

                                
Making Room for a Memory Hog
Although VEWD fits entirely in the lower 640 KB of DOS memory, it
is  somewhat of a memory hog.  If you run with many Terminate and
Stay Resident (TSR) programs, you may find yourself running short
of  memory.  At bottom right corner of the screen, below the date
and  time,  is the number of bytes of free memory remaining.   If
there  is  less than 32000 bytes free at the top level menu,  you
need  to  make  more room.  Each pop-up menu or form  causes  the
portion  of  the  screen that it covers to  be  saved  for  later
restoration.  By default this is in the low 640 KB  memory.   You
can  specify five alternate locations by including Virtual Memory
environment  variables in your AUTOEXEC.BAT file.  Each  variable
is of the form:
                    SET CLAVMx=path,size[,ram-indicator]
Where,
x is 0 to 4.  A value of 0 indicates the first used virtual
  memory region, 4 indicates the last used.  Once all the storage
  is used in the 1st region, the second it used, and so on.
Path is the drive and directory of the RAM drive or hard
  disk area, or the word MEMORY to indicate conventional (low 640
  KB) memory area.
Size is the number of KB available.
Ram-indicator is M for a RAM Drive, blank otherwise.

For example, the line:
          SET CLAVM0=D:\,1024,M
defines the first virtual memory region as the root directory  of
a 1 megabyte RAM disk.  Another example is the line:
          SET CLAVM1=C:\TEMP,768
specifies  the second virtual memory region as a 768 KB  area  in
the TEMP subdirectory of drive C.
If  you  have  the  memory,  setting up  a  RAM  disk  is  highly
recommended.  The  RAM disk should be at  least  64  KB  in  size
(preferably 128 KB).  To create a RAM disk you need to include  a
line in your CONFIG.SYS file similar to:
          DEVICE=C:\DOS\RAMDRIVE.SYS 1024 128 /E
This defines a 1024 KB RAM disk using extended memory.


Without  specifying a virtual memory region on disk or in  a  RAM
disk,  the  odds of being able to successfully access every  VEWD
screen is virtually NIL!


Converting Databases from Version 2.4 to Version 3.0
Between Version 2.4 and Version 3.0 changes were made to the
SESSION, VICTIMG, and VICTIMS databases.  Attempting  to
start  Version 3.0 using a prior version will result in an 
invalid record declaration error display.

A  conversion program called VXT030.EXE is available  to  convert
the  older database format to the newer format.  To convert  your
older databases:
1)   Finish up any active session.  There cannot be any active
     session in progress during the conversion.
2)   BACKUP ALL YOUR EXISTING DATA!  This includes all the .DAT,
     .MEM, and .Knn files.  If something goes horribly wrong during
     the conversion process you still have the original data.
3)   Delete all the key files.  These are the files with the K0n
     extensions.  The DOS command "del *.k0?" will do this.
4)   Start up VEWD and let it rebuild all the key files.  Once
     this is done, exit.
5)   Create a sub-directory OLD underneath the VEWD directory.
6)   Move all the DEFAULT, and VICTIMG files (data, memo,
     and key indices) to the directory created in step 2.
7)   Delete all the VICTIMS files.
8)   Rename each file.  The VICTIMG.* files become OVICTIMG.* and 
     the DEFAULTS.* files become ODEFAULT.*.
9)   Run the VXT030.EXE program from the VEWD directory.
10)  Select the "Convert All Files" Option.
11)  You're done.  Delete the OLD sub-directory.  You can also
     delete the VXT030 program.

The  DOS batch command file VXT030.BAT will automatically perform
steps 5 through 7.