%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%