5th August 1992 ----------------------------------------------------------------------------- Support Group Application Note Number: 044 Issue: 3 Author: D J Bell ----------------------------------------------------------------------------- ANFS Application Note ----------------------------------------------------------------------------- Applicable Hardware: BBC Master Series Related Application Notes: ----------------------------------------------------------------------------- Copyright (C) Acorn Computers Limited 1992 Neither whole nor any part of the information contained in this note may be adapted or reproduced in any form except with the prior written approval of Acorn Computers Limited. Every effort has been made to ensure that the information in this leaflet is true and correct at the time of printing. However, the products described in this leaflet are subject to continuous development and improvements and Acorn Computers Limited reserves the right to change its specifications at any time. Acorn Computers Limited cannot accept liability for any loss or damage arising from the use of any information or particulars in this leaflet. ACORN, ECONET and ARCHIMEDES are trademarks of Acorn Computers Limited. ----------------------------------------------------------------------------- Support Group Acorn Computers Limited Acorn House Vision Park Histon Cambridge CB4 4AE ----------------------------------------------------------------------------- ADVANCED NETWORK FILING SYSTEM The Advanced Network Filing System contains the features of the NFS with the following additions: * Local buffering. All open files will be buffered in RAM in the I/O processor. All uses of OSBGET and OSBPUT calls will be significantly faster. Up to 16 buffers are allocated dynamically. If only one file is open, for example, 16 pages of data are buffered on that file. * New machine entry points for automatic retries of packets. * File server extensions. * Extra commands in ROM: ANFS: *CDIR () - create directory. Number can be between 1 & 245 entries, with 19 as default. *FS () - changes file server number. Enables user to be logged on to more than one file server. *FLIP - exchanges CSD and CSL. Useful when files which are to be loaded, via OSFILE, are stored in the Library. *HELP - has sublevels Net & Utils. *LCAT () - catalogue the current library, or pathname. *LEX () - examine the current library or pathname. *WIPE - () - Deletes files or directories also: *I am () ((:)) - now accepts and CTRL U during invisible input. *PASS (:) . Now accepts a ":" within the line to allow invisible passwords. UTILS: These now work when ANFS is the currently selected FS or not: *POLLPS (:) - shows CSPS number and type. Also lists all network printers and their state. *PROT ().... - protects against some/all ops. *PS (:) - selects PS. *UNPROT ()... - converse of PROTECT. *WDUMP ( (
)). *CONFIGURE: FS - selects default file server. PS - selects default printer server. SPACE - moves OSHWM to use old FS utilities. NOSPACE - converse of SPACE. *STATUS: FS - returns station number at default file server. PS - returns station number at default printer server. SPACE - returns "Space" or "NoSpace". * Extra Filing System interfaces: *OPT 5 - Additional bootstrap, by *RUNning 'FindLib'. For FS Library compatible with this machine. CMOS RAM bit. *OPT 6 - OPT 6,1 claims &200 space instead of using &B and &C. OPT 6,0 reverts to normal. CMOS RAM bit. OSFILE - with A=&7 on entry, a file is created. This behave similarly to 'save' (A=&0) but no data is transferred. OSARGS A=&FF - Now functions and ensures all open files to the file server. A call with Y=0 and A=2 returns 0 to differentiate from NFS 3.nn. OSARGS A=3 - performs BASIC "EXT#channel=value". OSARGS A=4 - returns space allocated to file. OSARGS A=&80 - returns variety of file/FS info. OSWORD A=&E - Read the time. OSWORD A=&10 - extended for zero length transmissions. OSWORD A=&13 - returns fault indication. * Extended error messages: * 'Not listening' & 'No Reply' now have the station number added. * 'Won't' (&93,147) - occurs when trying to *RUN a file with load address of &FFFFFFxx and trying to execute address which isn't &FFFFFFxx. * 'Bad parameter' (&94,148). * 'Station not present' (&A4,164) * 'Printer busy' (&A6,166) * 'Printer jammed' (&A7,167) * 'Bad net checksum' (&AA,170) * 'Bad rename' (&B0,176) * 'No more FCBs' (&C0,192) * 'Outside file' (&B7,183) * 'Bad station number' (&D0,208) * 'Bad net number' (&D1, 209) * 'Write only' (&D4,212) * 'Syntax (&DC,210) - recognised command by wrong syntax. * 'Net channel' 'On channel' 'Not on this file server' (&DE,222) * 'Bad number' (&F0,240) * 'Bad hex' (&F1,241) * 'Bad address' (&FC,252) * 'Bad string' (&FD,253) * 'Remoted' (&0) * Fatal error caused by OSWORD A=&14 function code 2 now produces 'Remoted'. * Additional library functionality: * Any file with exec address of &FFFFFFFF that is *RUN, */ or * will be *EXEC'd. * Screen saving: To differentiate between 'standard' and shadow screen modes, the following is used: * FFFExxxx - current screen RAM * FFFFxxxx - User RAM or non-shadow mode screens. * Auto action during Logon can now be stopped using CTRL key. * Number of "retries" is now adjustable. * 'Help' extensions so that help text can be held on FS disc.