%OP%WRN
%OP%TM1
%OP%BM1
%OP%LM5
%OP%HE\%H2%Z88 Users' Club Software Library%H2%\\
%OP%FO\Z133\\@P@\
%CO:A,72,72%%H2%%H1%Documentation for the Spectrum-Link 1991 08 19.%H1%

The main function of the programs is archiving of Z88 files on 
microdrive cartridges.

Hardware: Sinclair ZX Spectrum with ZX Interface 1 and ZX Microdrive. 

Serial cable with a 9-pin D-plug, in both ends. Connected as follows:  
2-2, 3-3, 4-4, 5-5, 7-7, 8-9, 9-8. Pin 8 is not used in Interface 1 
but can be connected to Z88 pin 9 to make the plugs interchangeable.

The Spectrum-Link consists of the following files.

SpecLink.doc, this document.
Z88LInit.pro, Spectrum initiating program.
Z88-Link.pro, Spectrum main program.
Zconvert.pro, Spectrum program to convert Z110 files to Z88-Link files.
SpecLink.bas, Z88 program.

 The datafiles used by Z110, Z88-IMPEXP are not suitable for fast Batch 
receiving of individual files, and the file length can not be 
catalogued. Switching to character arrays means on the other hand, 
limited file length to around 36000 bytes on a 48k Spectrum and 4000 on 
a 16k. Backing up 512k to 7 cartridges should take about 45 minutes.
 

%H2%%H1%How to install the programs on the Spectrum.%H1%

Connect the computers with the specified cable.

Turn the Z88 on and go to Panel []S. Set Transmit and Receive baud rate 
to 9600, Parity to None, and Xon/Xoff to No. Press ENTER.

Turn the Spectrum off and on and enter LOAD *"b".

Go to Filer []F. Mark the file Z88LInit.pro.

Enter the command copy <>CO, and new name :COM and press ENTER twice.

After the transfer is complete, save the program by entering 
SAVE *"m";1;"Z88LInit" LINE 1 : VERIFY *"m";1;"Z88LInit"
or SAVE *"m";1;"run" LINE 1: VERIFY *"m";1;"run"

Enter LOAD *"b" on the Spectrum.

Go to Filer []F. Mark the file Z88-Link.pro.

Enter the command copy <>CO, and new name :COM and press ENTER twice.

After the transfer is complete, save the program by entering 
SAVE *"m";1;"Z88-Link" LINE 1: VERIFY *"m";1;"Z88-Link"

Enter LOAD *"b" on the Spectrum.

Go to Filer []F. Mark the file Zconvert.pro.

Enter the command copy <>CO, and new name :COM and press ENTER twice.
After the transfer is complete, save the program by entering 
SAVE *"m";1;"Zconvert" LINE 1: VERIFY *"m";1;"Zconvert"

If you will not keep a copy of SpecLink.bas on EPROM, copy the program 
to a microdrive using Z110 or as follows. Prepare the Spectrum by 
turning off an on. Enter FORMAT "b";9600 : OPEN #4;"b" : OPEN 
#5;"m";1;"SpecLink.b" : MOVE #4 TO #5. Go to ImpExport []X. Enter S)end 
and SpecLink.bas. When the transfer is finnished, enter CLOSE #5 : CLOSE 
#4 on the Spectrum. When transfering back, go to ImpExport []X, enter 
R)eceive file and a new filename. The procedure on the Spectrum is 
almost the same. Just MOVE #5 TO #4.


%H2%%H1%Z88LInit 1.0  91 08 18
Start by entering LOAD *"m";1;"Z88LInit".
If you save "Z88LInit" with the name "run", you can start the program 
by entering RUN after NEW or a reset. 
The program sets up the Spectrum for, and loads Z88-Link or Zconvert.
Version 1.0 91 08 18 changes the line Zconvert jumps to at end of file.


%H1%%H2%Z88-Link 1.1  1991 05 19

%H1%THE COMMANDS%H1% are executed by pressing CAPS SHIFT and the first letter 
of the command.

%H2%K%H2%at-------------------------------------------------------------------
CAT of the cartridge in microdrive 1. Up to 50 filenames are correctly 
displayed and the space left on the cartridge.

%H2%Arrow keys%H2%---------------------------------------
The cursor line can be moved with the arrow keys.

%H2%ENTER%H2%-----------------
Mark or unmark a file.

%H2%U%H2%nmark------------
Unmarks all files.

%H2%V%H2%iew----------------------------------------------------------------
Displays one marked file on screen. File type, length, etc is given. 
Useful if you forget what a file is. In Z88-files saved in character 
arrays, the first 3 bytes tells the dimension and length of the array, 
thus the length of the Z88-file is 3 bytes less then the Spectrum-file. 
Characters outside the range 32-126 are displayed as decimal numbers in 
inverse.

%H2%Q%H2%uit---------
Quit viewing.

%H2%E%H2%rase---------------
Erases marked files.

%H2%S%H2%end--------------------------------------------------------------
Sends marked files to a Z88 with Spectrum-Link, Batch receiving. A 
11040 bytes file is sent in 65 seconds. Before sending a file, make the 
receiving computer ready first.

%H2%B%H2%atch receive--------------------------------------------------------
Files sent with the Z88's SpecLink.bas program are received and saved 
in character arrays on microdrive until 'End batch' is received from 
the Z88, or if there isn't space for the next file, you are told to put 
a new cartridge in drive 1 and continue. The file will not be received 
until a cartridge with sufficient space is inserted. The saved filename 
is the first 10 characters of the Z88 filename. A file, 11040 bytes 
long, is received in about 53 seconds.

%H2%C%H2%opy----------------------------------
Copies a file from drive 1 to drive 2.

re%H2%N%H2%ame-----------------------------------------------------
Copies a file from drive 1 to drive 1 or 2 with a new name.

If something goes wrong during transfer, or you don't know what to do, 
you should press CAPS SHIFT and BREAK then RUN and ENTER.

Version 1.1 1991 05 19 adds the Copy and reName commands and fixes some 
bugs. There are still a few left.

The main program might, in the future be split up in more programs, to 
allow bigger files. It will be trimmed down and the programming will be 
difficult to understand.


%H1%%H2%Zconvert 1.1  1991 08 18
Converts Z110 datafiles to Z88-Link character arrays. Microdrive 1 is 
always the source. You can input the number of the destination drive. 
If you chose drive 1 you are prompted to change cartridges. 

If you get the error report 'File not found', the datafile is either 
not closed or corrupted, enter GOTO 15 to save and continue. After 
saving you will get 'File not found' again, this time enter GOTO 19 to 
continue. 

If you get 'Microdrive full', change cartridge and enter GOTO 15.

For some reason I don't understand, the program stops with error report 
'Memory full' when approximately 12700 bytes of a long file are 
converted. Enter GOTO 15 to save and continue. When the rest of the 
file is converted, the program stops with the error report 'Wrong file 
type'. Enter LET d$="fnamepart2" and GOTO 15 to save the rest of the 
file and continue. I think it is not possible to put the files together 
correctly in PipeDream. Use Z110 to send the whole file back to the 
Z88.

A cartridge with software library files was converted from drive 1 to 2 
in 20 minutes? (Don't remember). The source datafiles occupied 87kb and 
the destination character arrays only 72kb.

Version 1.1 is maybe ten times faster. Now I don't remember if the 
memory full problem disappeared to.


%H2%%H1%The Z88 program SpecLink.bas 1.1

%H2%C%H2%atalogue-------------------------------------------------------------
Invites you to catalogue all files in all directories on all RAM, 
matching the string :RAM.*//* You can edit this to catalogue the files 
you want. Cataloguing 500kb takes about 10 minutes. Filenames, length, 
devices and directories are displayed in a scrolling window. 

%H2%Arrow keys, SHIFT %H2%and %H2%<>.
-------------------------
Moves the cursor bar.

%H2%V%H2%iew---------------------------------------------------------------
View file under cursor bar. Characters outside the range 32-126 are 
displayed as decimal numbers in inverse.

%H2%Q%H2%uit---------
Quit viewing.

%H2%R%H2%ename--------------------------------------------------------------
Renames the file under cursor bar if it is in the current directory.

%H2%E%H2%rase--------------------------------------------------------------
Erases the file under cursor bar if it is in the current directory.

%H2%ENTER%H2%-------------------
Marks or unmarks a file.

%H2%M%H2%ark------------
Marks all files.

%H2%U%H2%nmark------------
Unmarks all files.

e%H2%X%H2%port--------------------------------------------------------
Sends marked files from any device or directory to PC disk for 
individual archiving archiving in Imp-Export serial format.

%H2%S%H2%end--------------------------------------------------------
Sends marked files from any device or directory to Spectrum.

%H2%B%H2%atch receive-------------------------------------------------------
Files are Batch-received and saved in the current directory with the 
Spectrum filename until an 'End of batch' is sent from the Spectrum.

When finished the Z88 will have faster cataloguing, free space 
calculation on receiving, maybe controlling of the Spectrum from the 
Z88 and EPROM-files handling.

Version 1.1 5th August 1991 fixes some bugs and speeds up Batch 
receiving a little.

You are welcome to send me advise on improvements in language, commands 
and function of the programs. A machine code routine to speed up 
transfer to the Z88 would be great. Using BGET and BPUT is too slow.

Z88 Users' Club Member No 1080
Dennis Groning
Ranglebyn 5482
S-661 00  Saffle
Sweden