%OP%BON
%CO:A,12,72%

%H2%IMPORTANT.%H2%  These routines are designed to assist users of the XOB disc 
drive for the Z88.  It is the responsibility of the user of these 
routines to ensure that they have actually saved the files to disc 
BEFORE erasing the originals from RAM or EPROM.  

%H2%Neither I, Michael W. Hey, nor the Z88 Users' Club nor XOB Software
%H2%can be held in any way responsible for any loss or damage to data
%H2%or equipment caused by the use or the misuse of these routines
%H2%nor any consequential damage however caused.

CLI routines on the Z88 provide a way of automating oft-repeated
key-strokes.  Unfortunately there is absolutely no error trapping 
facility, and a routine ploughs blindly on like a runaway bulldozer
until stopped by the user.  Therefore a certain amount of supervision 
is required.

The following routine is supplied in "kit form" and although it
attempts a certain amount of self-assembly it is up to the user to 
check that all device names (e.g. :RAM.1/...) and directory names are 
added to the list of file names produced automatically.

It is quite likely that you will not wish to save all files in the list 
generated by X004B.  This list may be edited to save only a selection 
of your files.  

Attention should be given to the number of files to be saved on each 
disc.  An XOB disc has two banks, each of which will hold up to 40 
files.  In order to save more than 40 files I have added a B
(the instruction for "change banks") in the relevant place - which must 
not be removed.  To save more than 80 files the routine will have to be 
chopped up by you, the user, and the two resulting routines used one 
after the other with a change of disc when appropriate. 

If an error occurs the CLI will try to soldier on regardless, and you 
will have to stop it with <>ESC and try to work out what went wrong.  
The most common errors I found duuring debugging were "No Room" and
"File Not Found" or "Object Not Found".  Filer errors cause a 
double-beep, XOB errors happen in silence.  "Disc Full" and "Already 
Exists" errors are potentially most serious because the CLI routine 
continues to execute without saving the affected files on to your disc.

%P0%

%H4%DETAILED INSTRUCTIONS FOR X004

Run X004B first. This uses the filer's Catalogue Files command 
together with a routine to strip out all the irrelevant stuff ready for 
X004C. (X004C is best described as a "data file".  It holds material 
required for the production of file X004D.)

You will have to spend a little time sorting out Directories.  I keep 
all my files in one directory (the root directory) because I use Z-Tape 
to make back-ups, and that will only handle one directory at a time.  
If you keep your files in various directories and subdirectories they 
will have to be added manually to the file names in the appropriate 
places before saving and executing X004D.

(1) Check the Index to ensure that you have only one Instantiation of 
BASIC and PipeDream, and that BASIC has the XOB discmgr software 
running.  The contents of PipeDream will be lost so save them if
necessary.
(2) From the Filer execute X004B.
(3) Check and tidy up the resulting PipeDream file. 
(4) Save it as Plain Text.  Its name will be %H2%X004D%H2%.
(5) From the Filer execute X004D.
(6) Catalogue the disc to check that all files were correctly saved.


%H4%Conclusion.

This routine was written to simplify use of the XOB disc drive.  
It was designed and written by entirely Michael W. Hey, 
of 18, Woodside Road, Sandiacre, Nottingham,  NG10 5GP, to whom all 
comments and criticism should be addressed.  The routines were not 
written by XOB Software, the authors of the Disc Drive software. 

At the risk of becoming very boring I must repeat that it is 
%H1%your%H1% responsibility as user to ensure that all files specified are 
saved correctly.  Check by cataloguing the disc before erasing any of 
the files.  It is best to save all files twice on to separate discs so 
that you have a "back up set" - just in case.  

Please note that the disc software lists files in ASCII order, not the 
order in which they were saved.

Finally:  there is potential to automate other disc routines - 
deleting, or loading for example.  Why not have a go at writing 
suitable routines?  Don't forget to pass them onto me! 

Have fun!

%H4%M. W. Hey%H4%   (0703)

%CO:B,12,60%%H1%Introduction to CLI Files for XOB Disc Drive
%CO:C,12,48%%CO:D,12,36%%CO:E,12,24%%CO:F,12,12%