
		          README.TXT

               Release Notes for Okeeko Version 1.0

         (C) Copyright Guy Michaud, Bedford NS, CANADA, 1996
									
                Okeeko - A file split/restore tool


----------------------------------------------------------------
This document contains release notes for Guy Michaud's Okeeko
file split and restore program for Microsoft Windows95.
Information in this document is more current than that in the
online help.  There are no hard-copy manuals for this software.
----------------------------------------------------------------

----------------------------------------------------------------
NOTICE: This is a copyrighted program - it is illegal to copy it
	other than for backup purposes.
	This includes this README.TXT file and the online help
	file OKEEKO.HLP.
-----------------------------------------------------------------

Contents
--------
How to Use This Document
Version 1.0 Enhancements
Version 1.0 Limitations
File and other Requirements
Installing Okeeko
Description of Okeeko
How to use Okeeko
Feedback
Getting a Registered Copy
Other Tools from this Author
Contacting the Author


------------------------
How to Use This Document
------------------------

You can view this file using Notepad.EXE, WordPad.EXE, or any 
other text editor.

You can also print README.TXT using the print options of your
text editor software.  You may want to set the font for
this file to 10-point Courier before printing, for best
results.

------------------------
Version 1.0 Enhancements
------------------------

There are no enhancements.  After nearly 30 compiles, this is
the first version of Okeeko.


-----------------------
Version 1.0 Limitations
-----------------------

1.0 Okeeko will use a read/write buffer, equal to the size of the 
floppy disk being used.  Therefore, a 1.44 MB floppy means Okeeko 
will use a 1.44MB read/write buffer.  With this now clear, you 
should note the following points:

	- It may not run at all on systems with only 8MB or less
	- There is no need for a status bar when reading/writing 
	  floppies, since this is done in a singular operation. 
	  The status bar would show 0%, and then 100%.
	- It ran without a problem on my 16MB system

2.0 Okeeko was not tested on network drives.  CDRom drives and
network drives may 'appear' to Okeeko as CDRom drives.  If
Okeeko permits the selection of a given target drive for
write-access, and there is sufficient space on the drive, Okeeko
'may' permit you to continue.


3.0 Okeeko is a 32-bit tool.  It will not work on anything but 
Windows95 or WindowsNT.  A 16-bit version might be available by 
end of 1996.  Although developed under Windows95, Okeeko has
not been tested on a WindowsNT machine.

4.0 Shareware versions of Okeeko are identical to the registered 
versions.  However, this may not remain true forever.  Later 
releases will only be made available to those who register.  
Registration costs US $10 (see below).  

5.0 Okeeko uses the root directory of the target Restore drive to 
place temporary files and the final restored file.  If you split 
a file from c:\temp\myfile.txt, when restored it will be called
c:\myfile.txt.  If a file by the name of "myfile.txt" already 
existed on the root of that drive (c:\), then the file will be 
called OK~Start.Ok.  You can rename the file yourself to the 
original name.

---------------------------
File and other Requirements
---------------------------

Every file you need to run and use Okeeko are included in the 
distribution zip file.  If you are missing any files, send me 
an e-mail at kmichaud@cycor.ca or gmichaud@cisco.com.

Okeeko runs only on Windows95 and WindowsNT (see above
comments).

-----------------
Installing Okeeko
-----------------

Installing from a .ZIPed file:

1) Unpack using PKUNZIP the OKEEKO10.ZIP file in a temporary 
location (ie: C:\TEMP).

2) Run the SETUP.EXE program provided, and follow the prompts.


---------------------
Description of Okeeko
---------------------

Okeeko is a tool I decided to create because of my day-to-day
requirements of having to split router images (router code or
programs) onto floppies for various Cisco customers.  I was 
using a similar utility from Ziff-Davis publishing called
SLICE (version 1.3 by Bob Flanders & Michael Holmes).  My version
of SLICE was dated at 09-10-89, and although very functional, it
is DOS only, and I wanted a W95 tool.  As usual, when I can't find
what I want, and time permitting, I make my own.

What's special about Okeeko?  The coolest thing I could think of 
was that Okeeko should be able to restore split files (splits 
normally to floppies, restores normally to hard disk) by feeding 
each floppy, in no particular order.  And this works well (see 
below - the Okeeko Floppy Split/Restore Algorithm a.k.a.: Okeeko
FSRA).  This means that if you split a file using Okeeko to 4 
(for example) floppies, you would have floppy A,B,C & D. You can 
then restore the file using Okeeko, starting with any of the 
floppies, and then to continue in no particular order:

	Restore (these have all been tested):

	A, B, C, D	B, A, C, D	C, A, B, D	D, A, B, C
	A, B, D, C	B, A, D, C	C, A, D, B	D, A, C, B
	A, C, B, D	B, C, A, D	C, B, A, D	D, B, A, C
	A, C, D, B	B, C, D, A	C, B, D, A	D, B, C, A
	A, D, B, C	B, D, A, C	C, D, A, B	D, C, A, B
	A, D, C, B	B, D, C, A	C, D, B, A	D, C, B, A

I have also tested a split and restore in random order using 6 
floppies, without a problem.

Another good thing about Okeeko:  The files are indeed split onto 
the target, but the resulting split file is intact.  This means 
that an added benefit of the Okeeko FSRA is that restores can be 
done using the DOS COPY /B command to put the original file back 
together.

For example, a four-floppy set would result in the following 
files:

	OK~1.2, OK~2.3, OK~3.4, OK~4.0

all on separate floppies (plus several other small files).  These 
are the actual 'data' files, left untouched.  Using the DOS COPY 
command as follows would put the file back together:

	Copy each floppy as follows:
	- Copy floppy_drive:*.* harddrive:\temp_path\*.*
	
	After each diskette is done:
	- goto the hard drive you used and use the DOS COPY:
	- COPY /B OK~1.2 + OK~2.3 + OK~3.4 + OK~4.0 NEWFILENAME

Okeeko's Restore ensures that each file added together during a 
restore process is part of the same set.  Since each SPLIT always 
creates the same file names on floppies, a Serial Number sequence 
is generated for each SPLIT job.  The Restore process checks for 
consistency using that serial number.  Serial Numbers are stored 
as a file name on the target SPLIT floppy, and they have the 
format OK~SNxxx.xxx.

-----------------
How to use Okeeko
-----------------

Split a large file
------------------

- Start Okeeko
- Select File, then select "Split a File"
- Choose the file you wish to split across floppies
- Okeeko displays the selected file and its complete path, as well
  as its size in bytes.  Okeeko prompts you for a target floppy 
  drive for the process to start (notice that only removable 
  drives are shown for the SPLIT process).
- Select the target floppy drive by clicking on it once, and then 
  click OK
- Okeeko begins splitting the file, always starting with file 
  OK~1.2.
- A WRITING / READING indicator shows what Okeeko is currently 
  doing.
- Okeeko will prompt you for the next diskettes as required.
- Insert another floppy and continue the split process.  

NOTE: if you attempt to use the same floppy twice, Okeeko will 
respond with the following:

  "This floppy has already been used for this file split set.
   Please insert a different floppy and select split from the 
   menu."

  - Click OK if this happens, after you have placed a different 
    floppy into the disk drive.  Okeeko will resume 
    automatically.

- On the last diskette, Okeeko will prompt you for a description 
  for the file set.  Enter whatever description you would like.
- You are done.


Restore a split file
--------------------

- Start Okeeko
- Select File, then select "Restore a File"
- Okeeko prompts you for a source floppy drive for the
  process to start (notice that only removable drives are shown 
  for the source RESTORE process).
- Select the source floppy drive by clicking on it once, and then 
  click OK
- Okeeko now prompts you for a target drive (usually a hard drive)
  (notice that only fixed drives are shown for the target RESTORE 
  process)
- Select the target drive by clicking on it once, and then click 
  OK
- Okeeko begins restoring the file to the target drive (remember 
  that Okeeko   does not care in which order you supply the 
  floppies)
- Insert floppies until Okeeko no longer asks for any.
- A WRITING / READING indicator shows what Okeeko is currently 
  doing.

NOTE: if you attempt to use the same floppy twice, Okeeko will 
respond with the following:

   "No valid Okeeko restore file was found.
   Replace this floppy and select Restore from menu."

   - Click OK if this happens, after you have placed a different 
     floppy into the disk drive.  Select File, and the Restore to 
     continue.

- On the last diskette, Okeeko checks that the resulting restored 
  file is equal to the original file, and if it doesn't match, 
  Okeeko will warn you.  Okeeko then attempts to rename the temp 
  file(s) used to the original name.
- You are done.



--------
Feedback
--------

Send all found bugs, errors, suggestions, etc. to 
kmichaud@cycor.ca or to gmichaud@cisco.com.

Please forward your ideas as well as to how the product could be 
made easier to use, esthetics, etc. 


-------------------------
Getting a Registered Copy
-------------------------

Send a U.S. $10.00 cheque, drawn from a U.S. bank account, or a
CDN $14.00 cheque, drawn from a Canadian bank account to the
address above.  Add ' c/o Okeeko Registration' to the address.


        GUY MICHAUD
        139 Duffus Drive
        Bedford, Nova Scotia
        B4A 3T6 CANADA


IMPORTANT FACT:

Only version 1.0 of Okeeko will be made available as 
Copyright shareware.  All subsequent versions will made
available only to those who have registered copies.
Subsequent versions may include bug fixes which belong to 
version 1.0, and critical enhancements.  The 16-Bit version
1.0 of Okeeko will be handled similarly.


-----------
Other tools
-----------

Subnet Pro 	- TCP/IP subnet tool
		  Use this tool to generate host lists,
		  broadcast and subnet addresses based on the
		  subnet mask you intend to use.

FtpGm	   	- FTP Client (16 bit and 32 bit versions)
		  FTP client with a Star-Trek-like console
		  appearance.  The 32-bit version supports
	 	  Windows95 long file names.

FtpOleServer	- Windows OLE server providing FTP services
		  Provides a programmatic interface to 32-bit
		  applications which may require FTP services.
		  The FTP OLE Server is compiled as a 16-bit
		  application, which offers OLE access from
		  32-bit and 16-bit applications.


Look for these tools at ftp.cdrom.com and Simtel Coast-to-Coast
repositories.  Search the WEB for these tools and/or for
'gmichaud' for other tools and technical notes.



-------------------------------
Contacting Guy Michaud (Author)
-------------------------------

Contact Guy Michaud at (902) 835-8667 or (902) 835-5757.
E-Mail is gmichaud@cisco.com or kmichaud@cycor.ca.

Snail-Mail:

        GUY MICHAUD
        139 Duffus Drive
        Bedford, Nova Scotia
        B4A 3T6 CANADA


If you haven't registered one of my tools, and plan on asking
for help, I will be greatly dissapointed ... but I will help.




