PC Today 18

home *** CD-ROM | disk | FTP | other *** search

/ PC Today 18 / SHADOW12.EXE / MANUAL.TXT < prev next >

Wrap

Text File | 1991-08-01 | 26.2 KB | 676 lines

██▐███ █▐███ ██ ██ ██▐███ ██▐███ ██ ▐█ ██▐████ ██▐███ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ▐█ ██ ██ ██ ██▐███ ██ ██ ██ █ ██ ██▐█ ██▐███ ██ ▐█ ██ ██ ██▐█ ██ ██ ██ ██ █ ██ ██ ██ ██ ██ ▐█ ██ ██ ██ ██ █▐███ █▐███ ██▐███ ██ ██ ██▐███ ▐█ ██ ██ ██▐███ Systems Ltd │ │ │ │ │ │ │ │ │ SHADOW Version 1.2 (c) Alteasoft and Powerline Systems Ltd Use of this software is at your own risk. No guarantees are implied or given. This program is SHAREWARE and requires registration for continued use. Please see the end of this file for registration info, or print the PRINT.ME file included in the package. TABLE OF CONTENTS ================= OVERVIEW 1 SHADOW FILES 2 GETTING STARTED - Installation 3 GETTING STARTED - Operation 5 COMMAND LINE SWITCHES 6 WAIT MODE 7 RECORD MODE 8 PLAYBACK MODE 9 PATH and FILE NAMES 11 OPERATING CONSIDERATIONS 12 ERRORS 13 REGISTRATION 14 OVERVIEW ======== Shadow is a memory resident program that operates quietly in the background and yet at the touch of a key can replay all or sections of your previous work.In the event of a power failure or system crash it is a simple matter to retrieve your work .Shadow saves every key stroke to an internal buffer and at a predetermined interval writes this buffer to a disk file.You do nothing until you want to review or retrieve your work. Once you start replaying you can vary the speed ,pause or even single step as well as being able to fast forward or rewind to 'tabs' that you set during record. To switch modes within SHADOW a user defined 'Hotkey' gets the window up and simple menus are displayed. SHADOW is designed for installation in your AUTOEXEC.BAT file and if you wish can be run completely automatically.The only time you need call it up is to recover lost work. The default configuration gives you a buffer of 10 strokes which means every 10 key presses the record file is updated.With this default setting SHADOW occupies just over 8K of memory so you'll still be able to run the big ram hungry applications with the added safety factor of SHADOW. The SHADOW disk contains the main program as well as additional batch files so that you can install SHADOW within minutes.There are also three example replay files that will run in almost any wordprocessor or spreadsheet application.There is also a DOS replay file which will swing you through some simple DOS commands. SHADOW FILES ============ SHADOW is supplied with 14 files :- SHADOW.COM The main program file. FLOPINST.BAT Floppy installation program (Floppy to Floppy). HARDINST.BAT Hard disk installation program (Floppy to Hard). CONFIG.SYS Specimen configuration file. SHADOW.FIN Files used by the installation SHADOW.HIN programs. WORDPROC.SHD Word processing example file. SPRDSHT.SHD Spreadsheet example file. DOS.SHD DOS commands example file. SHADDOS.TXT Files used by DOS.SHD ENDMESS.DOS README.BAT Batch file to read README.DOC README.DOC Further information not in this manual. MANUAL.TXT This file. Type README at the DOS prompt to read the README.DOC file.It contains last minute information that didn't quite make it to this manual. Your attention also drawn to the copyright which prohibits any unlawful use or any alteration to the "Shadow" files. GETTING STARTED (installation) ============================== The simplest way to get going is to run one of the two installation programs, HARDINST or FLOPINST after placing the SHADOW files on the root directory of a floppy disk. However it is very simple to install manually and both methods are outlined below. AUTOMATIC INSTALLATION FROM A FLOPPY ------------------------------------ Place all the Shadow files on the route directory of a formatted floppy disk. This disk is no your SHADOW diskette. Hard disk --------- Place the SHADOW diskette in drive A: and type : HARDINST C: <Enter> SHADOW will be installed on the root directory of your C: drive and the support files will be copied into a subdirectory named SHADOW.The AUTOEXEC.BAT file will also be updated.Obviously if you are installing SHADOW on to D: drive you would replace C: with D:. Floppy disk to Floppy disk -------------------------- Place your DOS system disk in drive B: Place SHADOW diskette in drive A: and type : FLOPINST A: <Enter> SHADOW will be copied onto your system disk and the AUTOEXEC.BAT file modified. You will also need to change your CONFIG.SYS file (if you have one) If you have one it will be in your ROOT directory.To read the contents type : CD \ <Enter> TYPE CONFIG.SYS <Enter> If you see an entry that says something like : files=20 then everything is OK.However if there is no such entry then you need to add a similar line to this file.Refer to your DOS manual for instructions.If you don't have the CONFIG.SYS file at all you can copy the one on the SHADOW file list. MANUAL INSTALLATION ------------------- If you are going to install SHADOW manually we assume that you know what you're doing. It is better to make SHADOW the last resident program if possible as it works better, but if you are already using SIDEKICK it will have to go before as SIDEKICK insists on being loaded last. If you use the /A switch on SHADOW it will load and run from the default settings.However if it finds an error during Boot-up ,loading will halt and you will be prompted to correct the error.One possible cause might be that you've specified a non- existent file in Replay mode. GETTING STARTED (Operation) =========================== The first time you start SHADOW you will be shown an opening screen with the following choices. P - Change Playback speed 10 Units F - Change playback File C:\RECORD.SHD B - Change Buffer size 10 Keystrokes H - Change Hotkey combination LSHT - CTRL A - Automatic load setting Off M - Initial Mode Wait C - Change Colours S - Save changes P - Change playback speed.The playback speed can be anywhere from 1 character every 14 seconds to about 230 characters per second but this will depend on the main program's ability to take keys.The initial speed is set at 10 which represents a number between 1 (the fastest) and 36 (the slowest speed).It is advisable to have a fairly low initial speed as you have less chance of loosing keystrokes with certain programs. F - Change playback file.This is the file that keeps a record of your work and it can be treated as any DOS file.ie copied,deleted etc.You can even use the DOS copy command to join two or more together.When you want to change the name SHADOW checks for legal paths and names and abides by all DOS rules.You can specify Overwrite or Append with the Mode key and if you specify a non existent file in Append mode it will be created.However a non existent file in Playback mode will cause an error message. B - Change buffer size.The buffer holds the keys that you have pressed until it is full when they are then written to disk.The default is 10 strokes but you can specify any number between 1 and 2000.As more information is stored than just the actual key ,each keypress uses up 3 bytes.Consequently having a buffer size of 2000 would increase the resident size of SHADOW by roughly 6K. H - Change hotkey combination.The hotkey combination is the keys that you need to press to get the SHADOW window on to the screen.The default is Leftshift-Control but if you press 'H' you will be asked to press your desired combination.This feature is to allow compatibility with other resident programs. A - Automatic load setting.Pressing 'A' toggles this switch between on and off.When On (and saved) SHADOW will be loaded without stopping at the opening screen (as long as there are no errors).When off ,the opening screen is displayed.If you want to load SHADOW automatically in your AUTOEXEC.BAT file it is better to have this switch on. M - Initial mode.When you first start SHADOW you can be in one of four modes. Wait - Do nothing. Record-overwrite - Create file and record keystrokes. Record-append - Record keystrokes and add to existing - file. Playback - Replay from default file. The Wait mode does nothing but wait for you to change to record or replay.There are two initial record modes.The overwrite mode starts a new file with the default name erasing any existing file.Append adds the keystrokes on to the existing file effectively combining two sessions.Finally Replay mode goes straight into playback provided the default settings are acceptable. C - Change colours.You can change the default colours of SHADOW or if you have Monochrome you can switch between normal and inverse video. If you have mono pressing 'C' toggles between normal and inverse video.If you have colour pressing the same key gives you a sub-menu.There are six sections that can be coloured and to switch between them press 'S'.You can change the relevant colours by pressing 'F' (foreground) or 'B' (background) although in some of the sections only the foreground can be changed.Pressing 'M' will immediately give you a monochrome display.When your happy with your colour scheme press <Enter> and if you want to make it permanent save the configuration. S - Save changes.Once you're happy with your configuration pressing 'S' saves the changes to disk.For the save to be successful you need to be in the current directory or else you will get an error message. COMMAND LINE SWITCHES --------------------- There are three switches that can be added on the command line to enhance SHADOW. /A This selects Automatic mode regardless of the automatic mode setting.This is equivalent of starting SHADOW with automatic mode switch set to on. /M This sets the Manual mode regardless of the automatic mode setting.If you have saved a configuration with the automatic mode set to on this is the only way to switch back to manual. /B This switch overrides the DOS buffer.However it has a limited use as most programs conform to DOS. WAIT MODE ========= In this mode SHADOW merely checks the keyboard for the Hotkey combination.When it is called the following choices are displayed. R - Record keystrokes. P - Playback from file. M - Move Shadow window. C - Change current file. Esc Escape to return. R - Record.This key puts you into record mode and if the file already exists you are prompted from where you want the recording to start. P - Playback.'P' will put you into playback mode and once again you will be given a choice of where to start from .'Start' or 'Here'.Start replays from the beginning of the file whilst Here begins at the current location. M - Move.'' moves the SHADOW window around the screen.Use the arrow keys and press <Esc> when finished. C - Change file.If you want to change the default current file press 'C' and you can then enter the new path/file name.Checks are made to ensure that the filename complies with DOS.See the section on file names. Esc The Escape key always takes you one step back up the menu tree before finally returning to the main program. RECORD MODE =========== In Record mode all keystrokes are recorded to the current file at regular intervals.The menu choices are as follows :- S - Stop recording. T - Set tab marker. M - Move SHADOW window. C - Change record file. Esc to return S - Stop recording.Pressing 'S' updates and closes the file before going into Wait mode. T - To set a tab marker press 'T' and then at the prompt press any key from 0 to 9 ,A to Z or <Enter>.Then during replay you can fast forward or rewind to these tabs. M - Move.As before 'M' allows you to move the window around the screen. C - Change file.Again 'C' lets you change the file.If the file already exists you are prompted whether you want to overwrite or append.The normal checks are made on the validity of the file name. Esc Return to application. PLAYBACK MODE ============= In playback mode keys are read from the disk file and fed into your application. S - Stop replay. T - Reset stop tab. F - Fast forward or rewind C - Change replay file. Esc Return to application. S - Stop playback.'S' stops the replay and puts you back into Wait mode.Some care needs to be taken with this key.If you're replaying a program that won't accept the keys as fast as SHADOW is sending them when you press 'S' it's possible that there are still some keys in the keyboard buffer.SHADOW always checks and if there are keys left it won't pop up.But you will see the replay stop (as if you had pressed the 'P' key).If this happens press the 'S' key again until the SHADOW replay window appears.This will only be necassary when replaying slower programs and ensures that no keys are lost. T - Reset stop tab.You can set the stop marker to any key from 0 to 9 or A to Z as before.When it is set replay will pause whenever a tab marker of the same value is encountered.('P' will restart the playback).Setting it to ? will cancel.During replay ,hard tabs (set with the Enter key) will always pause replay. F - Fast forward or rewind.Press 'F' and you can fast forward or rewind to a particular tab.If the tab doesn't exist it will stop at the start or end of the file.SHADOW will beep if you try to do something wrong ie. fast forward from the end of the file. C - Change file.As in the other modes 'C' lets you change files.In this mode however a further check is made to make sure that the specified file actually exists.Any errors are reported. M - Move.The 'M' key (although not on the menu) still moves the window around as before. During replay there are a number of other keys that affect the replay. P - Pause/restart.The 'P' key will pause and restart the replay at any time during the playback. S - SHADOW.This key will pause replay and pop up the SHADOW window.You are then presented with the usual replay window choices.Pressing <Esc> immediately puts you straight back into replay at the point that you stopped. R - Real time.'R' toggles you in and out of an approximate real time replay speed.The speed is only approximate so as to allow programs that take time to update the screen a greater degree of compatibility.(See the operating considerations on page 11).The timed accuracy has been in the region of 90%. +/- The plus and minus keys (on numeric keypad) or the +(=) and _(-) keys increase and decrease the playback speed.They are only effective if you are in the constant time mode. Spacebar The spacebar can be hit at any time during constant time mode to go into single step.Repeated presses of the spacebar then step through your keystrokes as if you were typing them.If you want to restart the constant speed replay press 'P'.The spacebar has no effect if replaying at real-time speed. DEMONSTRATION FILES =================== Included on the SHADOW diskette are three demonstration replay files.The first one DOS.SHD takes you through a few (relatively harmless ) DOS commands.It won't alter your disk except to write a file that it later erases.To run this you should either have the DOS commands in your path or be in the same directory. The second file , WORDPROC.SHD can be run from inside almost all word processors (as long as they support wordwrap ,which they mostly all do).When replay pauses press 'P' to restart and if you find the going too slow ,press 'R' to get out of real-time mode and then the + key to speed things up.Full instructions and hints are on this file. Finally the SPRDSHT.SHD file can be replayed from inside your spreadsheet program.As the recording was made from cell A1 replay should begin there if you want the other cell refences to match.This replay does nothing more than move around and print a few lines of text. PATH and FILE NAMES =================== SHADOW fully conforms to the DOS path and filename rules but because of the small size of the window slight allowances have to be made. The maximum number of characters you can type for a new path/file name is 27 which may not be enough if you are trying to reach a file such as : C:\SOUTHERN\SALES\EXPENSES\MANAGERS\RECORD.SHD This path and file are obviously too long to enter in the SHADOW window.However if you consider the way DOS accepts paths you will see several simple solutions. Perhaps the most obvious (because you're probably already working in this sub-directory )is to enter the filename without any path.So when prompted for the new file name you can type either:- RECORD.SHD or C:RECORD.SHD SHADOW will check your current sub-directory and include it with your filename. An alternative method is to get closer to the desired sub- directory.With this method you then add part of the path.For example if your current directory is :- C:\SOUTHERN\SALES\EXPENSES you can enter MANAGERS\RECORD.SHD or C:MANAGERS\RECORD.SHD Either one will take you to the same sub-directory. The last method is to use the .. (double period).This will bring you back one level.So if you are at present beyond the desired sub-directory in : C:\SOUTHERN\SALES\EXPENSES\MANAGERS\SMITH entering ..\RECORD.SHD or C:..\RECORD.SHD will once again open the file in the sub-directory that you want. SHADOW can display path\filenames upto 54 characters long so unless you are in a remote sub-directory you will get the full name displayed.However even if the name is not fully displayed it will be used as normal provided there are no errors.Finally if you don't supply an extension to your filename .SHD is added by SHADOW. OPERATING CONSIDERATIONS ======================== With a program of this kind that tries to be compatible with hundreds of others conflicts will occur.However practiced use can overcome most obstacles.The most delicate point is usually the replay speed.Some programs can accept keys a lot faster than others.The recording is relatively straight forward.Shadow works by intercepting all the keystrokes.Whenever you press a key a special interrupt is generated.By recording this before it goes to the main program we can keep an accurate log of all keys pressed.Similarly we can do the reverse to replay a session but this is where the speed consideration is important.For instance many programs ,particularly word processors update the screen whilst you are typing so if you do backspaces and other changes the current cursor position is crucial.Because of this you will find some programs don't replay correctly if you increase the speed too much.A case in point is the Spelling checker in WORDPERFECT.It takes time to present you with alternative spellings and if you feed in the keys too quickly the whole session will drift out of synchronization.Generally speaking it is better to be too slow than too fast.Trial and error is the only real answer although in most cases the real-time will work well. Care should also be taken when deciding on the size of the buffer.If you are using SHADOW as a security backup system you will probably want a fairly small buffer whilst if you only need it for reviewing or demonstrations the size is not so important.Saving to a hard disk takes very little time and even with a 5 stroke buffer you will hardly notice it.Saving to a floppy takes a lot longer so if you want to go that route you will need a bigger buffer.Always bear in mind that if the power goes out or the system crashes you can loose any number of keys upto the buffer size.This means that if the buffer size is 10 you will not lose more than 10 keystrokes. The buffer size directly affects the resident size of SHADOW so if you don't have too much memory to spare a small buffer would help. If you don't have a hard disk and security is not your main concern writing to a ram-disk is a very good way of using SHADOW.Disk access is virtually instant and of course the resultant file can be copied onto your floppies later on.However if you have a power failure or crash you'll almost certainly lose any files on your ram-disk. SHADOW will only pop-up during certain text modes.They are :- 2,3,7,32H,33H and 34H.If you try to call up SHADOW during any other mode you will hear the beep and your request will be ignored.You can still record or replay during these modes but you should remember that if you can't pop-up the SHADOW window you can't stop recording and if you're replaying the only way out is to press Escape. The other important consideration is SHADOW's compatibility with other resident programs (see the README.DOC file on the SHADOW diskette ).If they don't work out you can try changing the order although you should try to put SHADOW last if at all possible.SIDEKICK is an exception and if you're running both it's better to put SIDEKICK last although SHADOW will still run in any position.Once again trial and error is the answer. ERRORS ====== Somewhere along the way you'll no doubt encounter errors and this usually happens when disk access is involved.Most errors will be through you specifying an incorrect drive or perhaps a non- existent path.Any time you open a file checks are run to see that your path/file name conforms to DOS rules and mistakes are reported.However if you get an error whilst SHADOW is in action you'll get a beep (a different tone from the DOS rendering).This can occur if SHADOW is trying to write to file that you've accidently erased or perhaps the disk is full.The best thing to do in these circumstances is to go into Wait mode ,save your other work and investigate.If you're running with floppies you may have changed the wrong one or left the drive door open.The work done on your main application will be unaffected by any write problems encountered by SHADOW but your recording will probably be unreliable. The error messages issued are all derived from DOS so you will find a complete explanation in your DOS manual but we'll give a short explanation here. Invalid path The path you have specified in the filename is non existent or unreachable.Check your directory tree structure. File not found You have specified a file that does not exist (whilst in replay mode).Re-enter the correct filename. Access denied You've probably used a filename that already exists as a read-only file.Either use another name or change the file attribute. Invalid drive You referred to a drive that you don't have. Insufficient memory You haven't got enough memory.Either unload some of your other memory resident programs or buy a bigger computer. Too many files There are no more file handles left.You will need to change the 'files= ' statement in the CONFIG.SYS file.See the installation section of this handbook. Unknown error ??????? REGISTRATION VIA ENGLAND - UK ----------------------------- Enclose a cheque or Postal Order for £20 made out to: 'POWERLINE SYSTEMS LTD' and mail to Powerline Systems. 44 Rydal Way, Ruislip, Middx. HA4 ORU. ENGLAND REGISTRATION VIA CALIFORNIA - USA --------------------------------- Enclose a cheque or money order for $38 made out to: 'Southland Trading Company' and mail to Southland Trading. 900-91 Howard Avenue, Escondido, CA 92025. USA Don't forget to also enclose your name and address. You will be sent a unique registration number to enter into SHADOW to register your copy. Once registered to you the program MUST NOT be passed on to others. Only Shareware copies may be passed on. Registered versions do not display the Shareware banner displayed by the non-registered version. UK FEEDBACK - LATEST VERSIONS ----------------------------- Feedback on this program is welcomed via the Direct-Line Online System. Direct-Line operates on the following numbers (set your communications software for 8/N/1): Address messages to SYSOP. 081-841-1847 Speeds 3/12/1200-75/2400 + MNP5 081-842-2030 Speeds 3/12/24/9600(v32) + HST 9600 & 14.4k + v42bis + MNP5 081-842-4176 Speeds 3/12/24/9600(v32) + HST 9600 & 14.4k + v42bis + MNP5 081-845-5811 Speeds 3/12/24/9600(v32) + HST 9600 & 14.4k + v42bis + MNP5 WORLDWIDE FEEDBACK - LATEST VERSIONS ------------------------------------ The latest version of Shadow is always available via UKFORUM on CompuServe (GO UKFORUM), and feedback on the program is welcomed in the message areas of UKFORUM. Address messages to SYSOP. Copyright (C) Alteasoft & Powerline Systems Ltd.