Harston Advanced
Disk Filing System
Reference Manual
A Companion Manual to the HADFS Software for the BBC series of micros.

J.G.Harston
Sheffield
Harston Advanced Disk Filing System Reference Manual.
Copyright (C) 1990-98, J.G.Harston.
ISBN 1-899366-40-7
First edition December 1994
Second edition September 1995

The right of J.G.Harston to be identified as the author of this work has been asserted in accordance with sections 77 and 78 of the Copyright Designs and Patents Act 1988.

All rights reserved.  This book is copyright.  Parts of this printed book may be copied for private reference or study, but the whole printed book may not be copied or stored by any means whether mechanical, photographical or electronic without the prior written consent of the publisher.  This copyright restriction is waived in respect of the text files of this manual supplied with HADFS software so long as no attempt is made to pass off the said work as anything other than the work of the author.  Violators will be prosecuted to the full extent of the law... and/or strung up with piano wire opposite a karaoke machine in a Hong Kong holiday apartment occupied by 112 chain-smoking fifth-formers.

Within this text, the following terms:
  Econet, Electron and Tube are registered trademarks of Acorn Computers Ltd.
  BBC refers to the British Broadcasting Corporation.
  BBC micro, Master 128 and Master Compact refer to the computers 	manufactured by Acorn Computers Ltd.
  CP/M is a registered trademark of Digital Research Inc.
  MSDOS is a registered trademark of Microsoft Corporation.
  HADFS refers to the Harston Advanced Disk Filing System.
  BBCBASIC(86) and BBCBASIC(Z80) are products supplied by M-TEC Computer Services and (C)R.T.Russell.
  Solidisk is a trademark of Solidisk Technology Ltd.

While every effort is made to ensure that the information given here and the accompanying software is accurate, no warrenty is given or should be implied as to the suitability of the advice or programs for any application of situation.  No liability can be accepted for any consequential loss or damage, however caused, arising as a result of using the software of the advice given in this book.

Special editions of this publication such as large type, loose leaf, Library bound, etc., are available.  Contact the publisher for details.

	ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
	³    British Library Cataloguing in Publication Data.   ³
	³						        ³
	³  A catalogue record for this book is available from   ³
	³		the British Library.		        ³
	ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

Published by
J.G.Harston
70 Camm Street
Walkley, Sheffield, S6 3TR.
Contents

1  Introduction								 5

2  The filing system								 8

3  Filing system commands							14

4  Low level file entry points							25
	OSFILE								25
	OSARGS								26
	OSBGET								27
	OSBPUT								27
	OSGBPB								28
	OSFIND								29
	FSCV								30
	OSWORD								31
	OSBYTE								32

5  The filing system utilities							34
	BACKUP								35
	COMPACT							35
	Rescue								35
	H-Utils								36
	H-Edit								38
	D_Map								38
	VisCompact							38
	S/Intern								38
	InfoTest								38
	UnArkH								39
	TreeCopy								39
	ETree								40
	MakeLP								41
	*lpS								42

6  Error messages								43

7  HADFS technical information						49

8  HADFS as an Econet environment						55

9  HADFS programming examples						57

	Biblography							68
	Index								69