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

%H1%Introduction

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 X005B.  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 during 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 but without saving the affected files on to your 
disc.

%P0%

%H4%HOW TO DRIVE X005

(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 X005B.  This catalogues the EPROM in slot 3 
and combined the list with X005C.  (X005C holds material required for 
the production of file X005D.)

(3) Check and tidy up the resulting PipeDream file. 
(4) Ensure that all subdirectories specified in the EPROM file names 
exist in the currently selected RAM and that sufficient space exists
to hold the largest file on the EPROM.
(4) Save the resulting PipeDream file (called %H2%X005D%H2%) as Plain Text. 
(5) From the Filer execute X005D.
(6) Catalogue the disc to check that all files were saved correctly.

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

May I take this opportunity to 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 your EPROM.  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 on to 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%