%OP%DEZFU - Z88 File Utility Program Users Guide
%OP%BON
%OP%AMM
%OP%PL64
%OP%TM1
%OP%BM1
%OP%LM5
%OP%HE/%H2%Z88 Users' Club Software Library%H2%/
%OP%FO/%H2%ZS03%H2%//@P@/
%CO:A,5,70%%C%%H2%@T%H2%
%C%%H4%Version 2.02  Copyright 1989,1990 Richard Haw%H4%

%H1%Introduction:%H1%





















%H1%Shareware:%H1%




















%H1%Data Compression:%H1%









%H1%Operation:%H1%



















































%P0%






















































%P0%










































































%H1%Version History:%H1%











%H1%Updates:%H1%







%CO:B,5,65%




   The program ZFU is a utility which provides file archive, 
compression and backup capabilities for the Z88.

   One of the main features of ZFU is its backup capabilities. 
Most of the ways to save data from the Z88 (such as saving to 
EPROM, cassette tape, PDD disk drives, or copying to other 
machines) suffer from the lack of easily storing files across 
many directories, or storing many small files, or storing by 
date. At last count a fully expanded Z88 could hold over 54000 
files (albeit small ones). Backing up all your files every time 
you go somewhere is very awkward if you do use many small files 
spread across several directories. With ZFU you can perform 
full, differential, or incremental backups to an archive file 
and then simply save that archive file. In order to support some 
of the limited devices used by the Z88 (limited in the sense of 
maximum file size or capacity, such as an EPROM or the portable 
disk drive), ZFU has the ability to limit the size of the 
created archive file (automatically creating multiple files if 
necessary).



   This program is distributed under the shareware concept, 
meaning it is distributed freely, but if you use it you are 
under obligation to register it with the author. I have 
deliberately made this program available in a format which can 
be easily copied and distributed by the user community, please 
do not abuse that trust and register this product if you do 
indeed find it useful. Registration supports the development of 
the program, and offers the following advantages. Registered 
users are informed of the next upgrade following the version 
they registered, and registered users can obtain a copy of the 
latest version (see the section on updates for more 
information). To register ZFU, send $30.00 (US) to:




Registration covers the current and all future shareware 
versions of ZFU.



   ZFU uses a compression algorithm to reduce the sizes of the 
files added to the archive. It may be the case in some small 
files that the compressed size of the file goes up, though this 
is rare. In general text and Pipedream files (especially 
spreadsheet files) will compress better than BASIC programs. For 
the sake of speed, file compression can be turned on and off 
using the Options menu. Compressed and regular files can be 
freely mixed in the same archive.


   When ZFU is first started, you will be asked for the name of 
an archive file. If the file does not exist a new file will be 
created. Entering ENTER at this point will exit the program. The 
main menu is then displayed, all operations from this point work 
on the same archive file, to use a new archive file, exit the 
program and run it again. Each of the main menu options is 
described in the follow sections.

   The handling of the ESC key is somewhat drastic in ZFU. Since 
the Z88 has no other abort key, the ESC key is taken as a fatal 
terminate at all points in the program. Pressing ESC any time 
the system is waiting for input will cause all outstanding files 
to be closed and the program to be terminated.

%H2%B%H2%ackups:




































%H2%F%H2%iles:













































































%H2%I%H2%nformation:




%H2%O%H2%ptions:















































Version 1.00


Version 2.00



Version 2.02




    Registered users can receive 1 update (as long as ZFU is 
being maintained as an active Shareware product), free of charge 
by sending a blank EPROM cartridge in a self addressed and 
stamped package to the author at the registration address. The 
EPROM will be erased so if you do this make sure you have 
nothing you want on it.
%CO:C,5,60%






































Richard Haw
2207 Aspen Drive
Champaign IL 61821  U.S.A.































To facilitate backups on the Z88 ZFU has a backup menu, 
which performs addition of files to the archive based on 
date and time, automatically recording the date and time to 
allow for incremental and differential backups. The date 
and time information is maintained in a small file named 
":RAM.0/ZFUBACKINFO.CFG", if this file is deleted the date 
and time information will be lost.

When you select the Backup option from the main menu the 
date and times of the last backups will be listed to the 
screen. If at this point the backup data file does not 
exist one will be created with dates of 1/1/1900. You then 
have the option of performing a full, differential, or 
incremental backup of all of your files. The exact 
operation of each option is described below.

%H2%F%H2%ull:










%H2%D%H2%ifferential:



%H2%I%H2%ncremental:





    This takes you to the files menu, which covers the 
addition and extraction of files from the archive. Each of 
the commands available from the files menu is described 
below.

%H2%A%H2%dd files:




























%H2%E%H2%xtract Files:



































%H2%L%H2%ist:







    The information command puts a single screen listing 
information about the current options, archive file, and 
free memory on the Z88.


    The options menu allows the setting of a number of 
parameters controlling how ZFU performs. Each of the 
options is described below:

c%H2%O%H2%mpress:






%H2%C%H2%re Date:





%H2%M%H2%od Date:






%H2%S%H2%ize:























Initial release


Major rewrite, backup and split file features, improved 
user interface.


Bug fix in handling of error conditions and file closure.
%CO:D,5,55%

























































































Selecting this option will add all files which were 
created after 1/1/1900 to the archive file. Under all 
normal circumstances this will be all of the files in 
the computer. However, if you do have some large file 
you wish to be ignored you can change the date on the 
file to something prior to 1/1/1900 and it will be 
ignored. (The date on a file can be changed by 
changing the system date, copying the file, then 
setting the system date back).


This option will add all files which have been created 
or modified since the last full backup was performed.


    This option will add all files which have been 
created or modified since the last incremental or 
differential backup was performed.








This command adds files to the archive. You will be 
prompted for the name of the files to add, and all 
matching files will be added to the archive. Wildcards 
following standard Z88 conventions can be used.

The addition of files is limited by the current 
modification and creation date limits set in the 
options menu.

The way in which the file names are stored in the 
archive (and handled upon extraction) is dependant on 
how it is specified when the file is added. If there 
is any path information specified when the file is 
added (ie. :ram.1/myfile.txt, /subdir1/myfile.txt, or 
:*//*) the path name will be stored with the file, and 
when extracted the %H2%file%H2% %H2%will%H2% %H2%be%H2% %H2%extracted%H2% %H2%to%H2% %H2%the%H2% %H2%same%H2% 
%H2%device%H2% %H2%and%H2% %H2%directory%H2% %H2%it%H2% %H2%is%H2% %H2%currently%H2% %H2%in.%H2% For example, 
if the current device was :RAM.1/ and you added a file 
using the file spec /subdir1/myfile.txt, the file 
would be stored in the archive as 
:RAM.1/subdir1/myfile.txt.

If when the file is added to archive just the file 
name is specified with no path information (ie. 
myfile.txt or *.*), no path information will be saved 
in the archive and when the file is extracted it will 
be extracted to the current directory at that time.


This command will extract files from the archive. You 
will be prompted for the name of the file to extract, 
Wildcards can be used to specify multiple files, but 
are only compared with the file name, path information 
is ignored. For example extracting with a file spec of 
data.dat will extract all files named data.dat from 
the archive, even if multiple copies from different 
directories exist in the archive. 

The handling of wildcards during the extraction 
process is somewhat different than normal on the Z88. 
The wildcard * specifies all files with no extensions, 
while *.* specifies all files %H2%with%H2% extensions. Which 
means to get all files you need to do two extractions, 
one with *.* and one with *. This may be somewhat 
confusing and if so I apologize, it will likely be 
cleared up in a later release.


Whether the file is extracted to the current directory 
or to the original device and directory it was saved 
from is dependant on how the file was originally added 
to the archive, see the section on adding files for 
more information on this subject.

If the file is to be extracted to the original device 
and directory and that directory does not exist, a 
directory by that name will automatically be created.

A 16 bit CRC checksum is stored with each file, if the 
extracted files checksum does not match, an error 
message is displayed, and the program will pause at 
this point displaying an error message under 'Status'. 
The file is not deleted, but is left as extracted.
                                                

This command lists out all of the files in the archive 
in the form file name, uncompressed size, compressed 
size, and CRC checksum. The display does not pause at 
the end of a page, to pause the display hold down the 
shift and diamond keys simultaneously.












This option toggles data compression. The default when 
ZFU is started is to perform data compression. While 
data compression reduces the size of the resulting 
archive file it is time consuming. When compression is 
active a mark will appear next to the word c%H2%O%H2%mpress.


This allows you to input a specific limit for the 
creation date. All files created after this date and 
matching the add file input specification will be 
added to the archive.


The same as the creation date, but sets the limit for 
the modification date. For a file %H2%NOT%H2% to be added to 
the archive, both the creation date %H2%and%H2% the 
modification dates must be before the specified 
limits.


This brings up a menu of sizes which can be selected 
as a maximum size for the resulting archive file. If, 
while adding files, ZFU expects to exceed this size, 
the current archive file will be closed and a new file 
started by adding a number to the end of the archive 
file name. The default for the size limit is no limit.

The primary reason behind this feature is to allow for 
backups to limited capacity devices, such as EPROMS or 
the portable disk drive.

If the %H2%P%H2%ause option is active (indicated by a mark 
next to it in the %H2%S%H2%ize menu) whenever an archive file 
is closed out and a new one started the program will 
pause and wait for user acknowledgement to continue. 
If there is a limited amount of free memory on the Z88 
the archive file just created can then be saved to 
EPROM or disk or wherever, deleted, and ZFU told to 
continue.
%CO:E,52,52%