Home » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_28.ADF » F/+HINT11
F/+HINT11
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_28.ADF |
| Filename: | F/+HINT11 |
| Read OK: | ✔ |
| File size: | 13C8 bytes |
| Load address: | 48204556 |
| Exec address: | 37544E49 |
File contents
MOVFBK
MOVFBK moves a filename from ViewStore's list into FBLOCK. A summary of the
filenames available and their offsets is given in table 8. Filenames are
not stored with prefixes attached, but they do include the directory. You
must use the routine STXPRE to add a prefix to the filename once it has been
moved to FBLOCK, before calling one of the file routines.
On entry: Y contains the offset of the filename to be
moved into FBLOCK.
On exit: A,X,Y undefined.
MOVNAY
This routine is the inverse of MOVFBK; it moves a filename from FBLOCK into
ViewStore's list of names. The filename in FBLOCK should not include the
prefix when this routine is called. The list of filename offset values is
given in table 8.
On entry: X contains the offset of the filename area in
which the name currently in FBLOCK is to be
stored.
On exit: A,X,Y undefined.
CHKDIR
CHKDIR checks whether the filename in FBLOCK has a directory, and if it
does, it returns the directory. The filename should not include the prefix
when this routine is called.
On entry: filename to check in FBLOCK.
On exit: CS filename contains directory;
directory character found returned
in A; offset from beginning of
FBLOCK to the directory character is
in X.
CC no directory found.
Y undefined.
SETDIR
SETDIR forces a directory into the filename in FBLOCK. It doesn't matter
whether the filename there contains a directory or not; SETDIR will make
space for it. The filename must not include a prefix when SETDIR is called.
On entry: A contains directory character to set into name
in FBLOCK.
On exit: A,X,Y undefined.
STXPRE
This is the routine that you use to add a prefix to a name. The name
itself, including directory, should be in FBLOCK. Normally, adding the
prefix to a name is the last thing you do before calling the filing system
to do some operation on the file: opening or deleting the file, for example.
Names themselves should be stored without prefix attached, the prefix being
added only when calling the filing system itself.
A list of the prefix offsets for different file types is given in table 7.
On entry: X contains the offset of the prefix required.
On exit: A,X,Y undefined.
OPFILE
OPFILE is an equivalent of the filing system "OSFIND" call, used for opening
files. It assumes, however, that the filename is ready in FBLOCK. OPFILE
cannot be used to close a file, as OSFIND can; use the XOSCLS call to close
a file. OPFILE also uses the ViewStore error trapping system.
On entry: A contains file open code, as for OSFIND; eg.
&40 is open for input.
On exit: VS error occurred; error code in A.
VC no error occurred; file handle is in both A
and Y registers; usual OSFIND error of file
handle being zero when the file can't be
found is trapped: V is set, and the
ViewStore "File not found" error code is in
A; Y is zero.
X undefined.
OSHCAL
OSHCAL gives the utility access to the filing system OSFILE routine. It
uses the OSFARA area as its control block. Note that this spills over into
the LWORK area, which will be corrupted after an OSHCAL call. OSHCAL
assumes that the filename (when required) is set up in FBLOCK. OSHCAL also
sets the high order addresses into the control block at OSFARA +4 and +5;
+&C and +&D; and at +&10 and +&11. ViewStore error trapping is also
enabled.
On entry: A contains reason code as for normal OSFILE
(see filing system manual).
OSFARA set up with whatever the reason code action
requires, eg. start and end addresses for
file save.
On exit: VS error occurred; error code in A.
VC completed successfully; file type in A when
relevant.
X,Y undefined.
XOSARG
XOSARG is equivalent to OSARGS, except that ViewStore error handling is
enabled.
On entry: See filing system manual for OSARGS.
On exit: VS error occurred; error code in A.
VC no error; see filing system manual for
results.
00000000 4d 4f 56 46 42 4b 0d 0d 4d 4f 56 46 42 4b 20 6d |MOVFBK..MOVFBK m| 00000010 6f 76 65 73 20 61 20 66 69 6c 65 6e 61 6d 65 20 |oves a filename | 00000020 66 72 6f 6d 20 56 69 65 77 53 74 6f 72 65 27 73 |from ViewStore's| 00000030 20 6c 69 73 74 20 69 6e 74 6f 20 46 42 4c 4f 43 | list into FBLOC| 00000040 4b 2e 20 20 41 20 73 75 6d 6d 61 72 79 20 6f 66 |K. A summary of| 00000050 20 74 68 65 0d 66 69 6c 65 6e 61 6d 65 73 20 61 | the.filenames a| 00000060 76 61 69 6c 61 62 6c 65 20 61 6e 64 20 74 68 65 |vailable and the| 00000070 69 72 20 6f 66 66 73 65 74 73 20 69 73 20 67 69 |ir offsets is gi| 00000080 76 65 6e 20 69 6e 20 74 61 62 6c 65 20 38 2e 20 |ven in table 8. | 00000090 20 46 69 6c 65 6e 61 6d 65 73 20 61 72 65 0d 6e | Filenames are.n| 000000a0 6f 74 20 73 74 6f 72 65 64 20 77 69 74 68 20 70 |ot stored with p| 000000b0 72 65 66 69 78 65 73 20 61 74 74 61 63 68 65 64 |refixes attached| 000000c0 2c 20 62 75 74 20 74 68 65 79 20 64 6f 20 69 6e |, but they do in| 000000d0 63 6c 75 64 65 20 74 68 65 20 64 69 72 65 63 74 |clude the direct| 000000e0 6f 72 79 2e 20 20 59 6f 75 0d 6d 75 73 74 20 75 |ory. You.must u| 000000f0 73 65 20 74 68 65 20 72 6f 75 74 69 6e 65 20 53 |se the routine S| 00000100 54 58 50 52 45 20 74 6f 20 61 64 64 20 61 20 70 |TXPRE to add a p| 00000110 72 65 66 69 78 20 74 6f 20 74 68 65 20 66 69 6c |refix to the fil| 00000120 65 6e 61 6d 65 20 6f 6e 63 65 20 69 74 20 68 61 |ename once it ha| 00000130 73 20 62 65 65 6e 0d 6d 6f 76 65 64 20 74 6f 20 |s been.moved to | 00000140 46 42 4c 4f 43 4b 2c 20 62 65 66 6f 72 65 20 63 |FBLOCK, before c| 00000150 61 6c 6c 69 6e 67 20 6f 6e 65 20 6f 66 20 74 68 |alling one of th| 00000160 65 20 66 69 6c 65 20 72 6f 75 74 69 6e 65 73 2e |e file routines.| 00000170 0d 0d 4f 6e 20 65 6e 74 72 79 3a 20 20 20 20 20 |..On entry: | 00000180 20 20 59 20 20 20 20 20 20 20 63 6f 6e 74 61 69 | Y contai| 00000190 6e 73 20 74 68 65 20 6f 66 66 73 65 74 20 6f 66 |ns the offset of| 000001a0 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 74 6f | the filename to| 000001b0 20 62 65 20 0d 20 20 20 20 20 20 20 20 20 20 20 | be . | 000001c0 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 6f 76 | mov| 000001d0 65 64 20 69 6e 74 6f 20 46 42 4c 4f 43 4b 2e 0d |ed into FBLOCK..| 000001e0 0d 4f 6e 20 65 78 69 74 3a 20 20 20 20 20 20 20 |.On exit: | 000001f0 20 41 2c 58 2c 59 20 20 20 75 6e 64 65 66 69 6e | A,X,Y undefin| 00000200 65 64 2e 0d 0d 0d 4d 4f 56 4e 41 59 0d 0d 54 68 |ed....MOVNAY..Th| 00000210 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 74 68 |is routine is th| 00000220 65 20 69 6e 76 65 72 73 65 20 6f 66 20 4d 4f 56 |e inverse of MOV| 00000230 46 42 4b 3b 20 69 74 20 6d 6f 76 65 73 20 61 20 |FBK; it moves a | 00000240 66 69 6c 65 6e 61 6d 65 20 66 72 6f 6d 20 46 42 |filename from FB| 00000250 4c 4f 43 4b 20 69 6e 74 6f 0d 56 69 65 77 53 74 |LOCK into.ViewSt| 00000260 6f 72 65 27 73 20 6c 69 73 74 20 6f 66 20 6e 61 |ore's list of na| 00000270 6d 65 73 2e 20 20 54 68 65 20 66 69 6c 65 6e 61 |mes. The filena| 00000280 6d 65 20 69 6e 20 46 42 4c 4f 43 4b 20 73 68 6f |me in FBLOCK sho| 00000290 75 6c 64 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 |uld not include | 000002a0 74 68 65 0d 70 72 65 66 69 78 20 77 68 65 6e 20 |the.prefix when | 000002b0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 |this routine is | 000002c0 63 61 6c 6c 65 64 2e 20 20 54 68 65 20 6c 69 73 |called. The lis| 000002d0 74 20 6f 66 20 66 69 6c 65 6e 61 6d 65 20 6f 66 |t of filename of| 000002e0 66 73 65 74 20 76 61 6c 75 65 73 20 69 73 0d 67 |fset values is.g| 000002f0 69 76 65 6e 20 69 6e 20 74 61 62 6c 65 20 38 2e |iven in table 8.| 00000300 0d 0d 0d 4f 6e 20 65 6e 74 72 79 3a 20 20 20 20 |...On entry: | 00000310 20 20 20 58 20 20 20 20 20 20 20 20 20 20 20 20 | X | 00000320 20 20 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 | contains the | 00000330 6f 66 66 73 65 74 20 6f 66 20 74 68 65 20 66 69 |offset of the fi| 00000340 6c 65 6e 61 6d 65 20 61 72 65 61 20 69 6e 20 0d |lename area in .| 00000350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 00000370 77 68 69 63 68 20 74 68 65 20 6e 61 6d 65 20 63 |which the name c| 00000380 75 72 72 65 6e 74 6c 79 20 69 6e 20 46 42 4c 4f |urrently in FBLO| 00000390 43 4b 20 69 73 20 74 6f 20 62 65 0d 20 20 20 20 |CK is to be. | 000003a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000003b0 20 20 20 20 20 20 20 20 20 20 20 20 73 74 6f 72 | stor| 000003c0 65 64 2e 0d 0d 4f 6e 20 65 78 69 74 3a 20 20 20 |ed...On exit: | 000003d0 20 20 20 20 20 41 2c 58 2c 59 20 20 20 20 20 20 | A,X,Y | 000003e0 20 20 20 20 20 75 6e 64 65 66 69 6e 65 64 2e 0d | undefined..| 000003f0 0d 0d 43 48 4b 44 49 52 0d 0d 43 48 4b 44 49 52 |..CHKDIR..CHKDIR| 00000400 20 63 68 65 63 6b 73 20 77 68 65 74 68 65 72 20 | checks whether | 00000410 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 69 6e 20 |the filename in | 00000420 46 42 4c 4f 43 4b 20 68 61 73 20 61 20 64 69 72 |FBLOCK has a dir| 00000430 65 63 74 6f 72 79 2c 20 61 6e 64 20 69 66 20 69 |ectory, and if i| 00000440 74 0d 64 6f 65 73 2c 20 69 74 20 72 65 74 75 72 |t.does, it retur| 00000450 6e 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 |ns the directory| 00000460 2e 20 20 54 68 65 20 66 69 6c 65 6e 61 6d 65 20 |. The filename | 00000470 73 68 6f 75 6c 64 20 6e 6f 74 20 69 6e 63 6c 75 |should not inclu| 00000480 64 65 20 74 68 65 20 70 72 65 66 69 78 0d 77 68 |de the prefix.wh| 00000490 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 |en this routine | 000004a0 69 73 20 63 61 6c 6c 65 64 2e 0d 0d 4f 6e 20 65 |is called...On e| 000004b0 6e 74 72 79 3a 20 20 20 20 20 20 20 20 20 20 20 |ntry: | 000004c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000004d0 20 20 20 20 66 69 6c 65 6e 61 6d 65 20 74 6f 20 | filename to | 000004e0 63 68 65 63 6b 20 69 6e 20 46 42 4c 4f 43 4b 2e |check in FBLOCK.| 000004f0 0d 0d 4f 6e 20 65 78 69 74 3a 20 20 20 20 20 20 |..On exit: | 00000500 20 20 20 20 20 20 20 20 20 20 43 53 20 20 20 20 | CS | 00000510 20 20 20 20 20 20 20 20 20 20 66 69 6c 65 6e 61 | filena| 00000520 6d 65 20 63 6f 6e 74 61 69 6e 73 20 64 69 72 65 |me contains dire| 00000530 63 74 6f 72 79 3b 20 0d 20 20 20 20 20 20 20 20 |ctory; . | 00000540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 00000560 64 69 72 65 63 74 6f 72 79 20 63 68 61 72 61 63 |directory charac| 00000570 74 65 72 20 20 66 6f 75 6e 64 20 72 65 74 75 72 |ter found retur| 00000580 6e 65 64 0d 20 20 20 20 20 20 20 20 20 20 20 20 |ned. | 00000590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000005a0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 41 | in A| 000005b0 3b 20 6f 66 66 73 65 74 20 66 72 6f 6d 20 62 65 |; offset from be| 000005c0 67 69 6e 6e 69 6e 67 20 6f 66 0d 20 20 20 20 20 |ginning of. | 000005d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 000005f0 20 20 20 46 42 4c 4f 43 4b 20 74 6f 20 74 68 65 | FBLOCK to the| 00000600 20 64 69 72 65 63 74 6f 72 79 20 63 68 61 72 61 | directory chara| 00000610 63 74 65 72 20 69 73 0d 20 20 20 20 20 20 20 20 |cter is. | 00000620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 00000640 69 6e 20 58 2e 0d 20 20 20 20 20 20 20 20 20 20 |in X.. | 00000650 20 20 20 20 20 20 20 20 20 20 20 20 20 20 43 43 | CC| 00000660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f | no| 00000670 20 64 69 72 65 63 74 6f 72 79 20 66 6f 75 6e 64 | directory found| 00000680 2e 0d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |.. | 00000690 20 20 20 20 20 20 20 20 20 20 59 20 20 20 20 20 | Y | 000006a0 20 20 20 20 20 20 20 20 20 20 75 6e 64 65 66 69 | undefi| 000006b0 6e 65 64 2e 0d 0d 0d 53 45 54 44 49 52 0d 0d 53 |ned....SETDIR..S| 000006c0 45 54 44 49 52 20 66 6f 72 63 65 73 20 61 20 64 |ETDIR forces a d| 000006d0 69 72 65 63 74 6f 72 79 20 69 6e 74 6f 20 74 68 |irectory into th| 000006e0 65 20 66 69 6c 65 6e 61 6d 65 20 69 6e 20 46 42 |e filename in FB| 000006f0 4c 4f 43 4b 2e 20 20 49 74 20 64 6f 65 73 6e 27 |LOCK. It doesn'| 00000700 74 20 6d 61 74 74 65 72 0d 77 68 65 74 68 65 72 |t matter.whether| 00000710 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 74 68 | the filename th| 00000720 65 72 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 64 |ere contains a d| 00000730 69 72 65 63 74 6f 72 79 20 6f 72 20 6e 6f 74 3b |irectory or not;| 00000740 20 53 45 54 44 49 52 20 77 69 6c 6c 20 6d 61 6b | SETDIR will mak| 00000750 65 0d 73 70 61 63 65 20 66 6f 72 20 69 74 2e 20 |e.space for it. | 00000760 20 54 68 65 20 66 69 6c 65 6e 61 6d 65 20 6d 75 | The filename mu| 00000770 73 74 20 6e 6f 74 20 69 6e 63 6c 75 64 65 20 61 |st not include a| 00000780 20 70 72 65 66 69 78 20 77 68 65 6e 20 53 45 54 | prefix when SET| 00000790 44 49 52 20 69 73 20 63 61 6c 6c 65 64 2e 0d 0d |DIR is called...| 000007a0 4f 6e 20 65 6e 74 72 79 3a 20 20 20 20 20 20 20 |On entry: | 000007b0 41 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |A | 000007c0 63 6f 6e 74 61 69 6e 73 20 64 69 72 65 63 74 6f |contains directo| 000007d0 72 79 20 63 68 61 72 61 63 74 65 72 20 74 6f 20 |ry character to | 000007e0 73 65 74 20 69 6e 74 6f 20 6e 61 6d 65 0d 20 20 |set into name. | 000007f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e | in| 00000810 20 46 42 4c 4f 43 4b 2e 0d 0d 4f 6e 20 65 78 69 | FBLOCK...On exi| 00000820 74 3a 20 20 20 20 20 20 20 20 41 2c 58 2c 59 20 |t: A,X,Y | 00000830 20 20 20 20 20 20 20 20 20 20 75 6e 64 65 66 69 | undefi| 00000840 6e 65 64 2e 0d 0d 0d 53 54 58 50 52 45 0d 0d 54 |ned....STXPRE..T| 00000850 68 69 73 20 69 73 20 74 68 65 20 72 6f 75 74 69 |his is the routi| 00000860 6e 65 20 74 68 61 74 20 79 6f 75 20 75 73 65 20 |ne that you use | 00000870 74 6f 20 61 64 64 20 61 20 70 72 65 66 69 78 20 |to add a prefix | 00000880 74 6f 20 61 20 6e 61 6d 65 2e 20 20 54 68 65 20 |to a name. The | 00000890 6e 61 6d 65 0d 69 74 73 65 6c 66 2c 20 69 6e 63 |name.itself, inc| 000008a0 6c 75 64 69 6e 67 20 64 69 72 65 63 74 6f 72 79 |luding directory| 000008b0 2c 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 20 46 |, should be in F| 000008c0 42 4c 4f 43 4b 2e 20 20 4e 6f 72 6d 61 6c 6c 79 |BLOCK. Normally| 000008d0 2c 20 61 64 64 69 6e 67 20 74 68 65 0d 70 72 65 |, adding the.pre| 000008e0 66 69 78 20 74 6f 20 61 20 6e 61 6d 65 20 69 73 |fix to a name is| 000008f0 20 74 68 65 20 6c 61 73 74 20 74 68 69 6e 67 20 | the last thing | 00000900 79 6f 75 20 64 6f 20 62 65 66 6f 72 65 20 63 61 |you do before ca| 00000910 6c 6c 69 6e 67 20 74 68 65 20 66 69 6c 69 6e 67 |lling the filing| 00000920 20 73 79 73 74 65 6d 0d 74 6f 20 64 6f 20 73 6f | system.to do so| 00000930 6d 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f 6e 20 |me operation on | 00000940 74 68 65 20 66 69 6c 65 3a 20 6f 70 65 6e 69 6e |the file: openin| 00000950 67 20 6f 72 20 64 65 6c 65 74 69 6e 67 20 74 68 |g or deleting th| 00000960 65 20 66 69 6c 65 2c 20 66 6f 72 20 65 78 61 6d |e file, for exam| 00000970 70 6c 65 2e 20 0d 4e 61 6d 65 73 20 74 68 65 6d |ple. .Names them| 00000980 73 65 6c 76 65 73 20 73 68 6f 75 6c 64 20 62 65 |selves should be| 00000990 20 73 74 6f 72 65 64 20 77 69 74 68 6f 75 74 20 | stored without | 000009a0 70 72 65 66 69 78 20 61 74 74 61 63 68 65 64 2c |prefix attached,| 000009b0 20 74 68 65 20 70 72 65 66 69 78 20 62 65 69 6e | the prefix bein| 000009c0 67 0d 61 64 64 65 64 20 6f 6e 6c 79 20 77 68 65 |g.added only whe| 000009d0 6e 20 63 61 6c 6c 69 6e 67 20 74 68 65 20 66 69 |n calling the fi| 000009e0 6c 69 6e 67 20 73 79 73 74 65 6d 20 69 74 73 65 |ling system itse| 000009f0 6c 66 2e 0d 0d 41 20 6c 69 73 74 20 6f 66 20 74 |lf...A list of t| 00000a00 68 65 20 70 72 65 66 69 78 20 6f 66 66 73 65 74 |he prefix offset| 00000a10 73 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 |s for different | 00000a20 66 69 6c 65 20 74 79 70 65 73 20 69 73 20 67 69 |file types is gi| 00000a30 76 65 6e 20 69 6e 20 74 61 62 6c 65 20 37 2e 0d |ven in table 7..| 00000a40 0d 4f 6e 20 65 6e 74 72 79 3a 20 20 20 20 20 20 |.On entry: | 00000a50 20 58 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | X | 00000a60 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6f 66 | contains the of| 00000a70 66 73 65 74 20 6f 66 20 74 68 65 20 70 72 65 66 |fset of the pref| 00000a80 69 78 20 72 65 71 75 69 72 65 64 2e 0d 0d 4f 6e |ix required...On| 00000a90 20 65 78 69 74 3a 20 20 20 20 20 20 20 20 41 2c | exit: A,| 00000aa0 58 2c 59 20 20 20 20 20 20 20 20 20 20 20 75 6e |X,Y un| 00000ab0 64 65 66 69 6e 65 64 2e 0d 0d 0d 4f 50 46 49 4c |defined....OPFIL| 00000ac0 45 0d 0d 4f 50 46 49 4c 45 20 69 73 20 61 6e 20 |E..OPFILE is an | 00000ad0 65 71 75 69 76 61 6c 65 6e 74 20 6f 66 20 74 68 |equivalent of th| 00000ae0 65 20 66 69 6c 69 6e 67 20 73 79 73 74 65 6d 20 |e filing system | 00000af0 22 4f 53 46 49 4e 44 22 20 63 61 6c 6c 2c 20 75 |"OSFIND" call, u| 00000b00 73 65 64 20 66 6f 72 20 6f 70 65 6e 69 6e 67 0d |sed for opening.| 00000b10 66 69 6c 65 73 2e 20 20 49 74 20 61 73 73 75 6d |files. It assum| 00000b20 65 73 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 61 |es, however, tha| 00000b30 74 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 69 |t the filename i| 00000b40 73 20 72 65 61 64 79 20 69 6e 20 46 42 4c 4f 43 |s ready in FBLOC| 00000b50 4b 2e 20 20 4f 50 46 49 4c 45 0d 63 61 6e 6e 6f |K. OPFILE.canno| 00000b60 74 20 62 65 20 75 73 65 64 20 74 6f 20 63 6c 6f |t be used to clo| 00000b70 73 65 20 61 20 66 69 6c 65 2c 20 61 73 20 4f 53 |se a file, as OS| 00000b80 46 49 4e 44 20 63 61 6e 3b 20 75 73 65 20 74 68 |FIND can; use th| 00000b90 65 20 58 4f 53 43 4c 53 20 63 61 6c 6c 20 74 6f |e XOSCLS call to| 00000ba0 20 63 6c 6f 73 65 0d 61 20 66 69 6c 65 2e 20 20 | close.a file. | 00000bb0 4f 50 46 49 4c 45 20 61 6c 73 6f 20 75 73 65 73 |OPFILE also uses| 00000bc0 20 74 68 65 20 56 69 65 77 53 74 6f 72 65 20 65 | the ViewStore e| 00000bd0 72 72 6f 72 20 74 72 61 70 70 69 6e 67 20 73 79 |rror trapping sy| 00000be0 73 74 65 6d 2e 20 20 20 20 20 20 20 20 0d 0d 4f |stem. ..O| 00000bf0 6e 20 65 6e 74 72 79 3a 20 20 20 20 20 20 20 41 |n entry: A| 00000c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 | c| 00000c10 6f 6e 74 61 69 6e 73 20 66 69 6c 65 20 6f 70 65 |ontains file ope| 00000c20 6e 20 63 6f 64 65 2c 20 61 73 20 66 6f 72 20 4f |n code, as for O| 00000c30 53 46 49 4e 44 3b 20 65 67 2e 0d 20 20 20 20 20 |SFIND; eg.. | 00000c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000c50 20 20 20 20 20 20 20 20 20 20 20 26 34 30 20 69 | &40 i| 00000c60 73 20 6f 70 65 6e 20 66 6f 72 20 69 6e 70 75 74 |s open for input| 00000c70 2e 0d 0d 4f 6e 20 65 78 69 74 3a 20 20 20 20 20 |...On exit: | 00000c80 20 20 20 56 53 20 20 20 20 20 20 20 20 20 20 20 | VS | 00000c90 20 20 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 | error occurre| 00000ca0 64 3b 20 65 72 72 6f 72 20 63 6f 64 65 20 69 6e |d; error code in| 00000cb0 20 41 2e 0d 20 20 20 20 20 20 20 20 20 20 20 20 | A.. | 00000cc0 20 20 20 20 56 43 20 20 20 20 20 20 20 20 20 20 | VC | 00000cd0 20 20 20 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 | no error occ| 00000ce0 75 72 72 65 64 3b 20 66 69 6c 65 20 68 61 6e 64 |urred; file hand| 00000cf0 6c 65 20 69 73 20 69 6e 20 62 6f 74 68 20 41 0d |le is in both A.| 00000d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | * 00000d20 61 6e 64 20 59 20 72 65 67 69 73 74 65 72 73 3b |and Y registers;| 00000d30 20 75 73 75 61 6c 20 4f 53 46 49 4e 44 20 65 72 | usual OSFIND er| 00000d40 72 6f 72 20 6f 66 20 66 69 6c 65 0d 20 20 20 20 |ror of file. | 00000d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000d60 20 20 20 20 20 20 20 20 20 20 20 20 68 61 6e 64 | hand| 00000d70 6c 65 20 62 65 69 6e 67 20 7a 65 72 6f 20 77 68 |le being zero wh| 00000d80 65 6e 20 74 68 65 20 66 69 6c 65 20 63 61 6e 27 |en the file can'| 00000d90 74 20 62 65 20 0d 20 20 20 20 20 20 20 20 20 20 |t be . | 00000da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000db0 20 20 20 20 20 20 66 6f 75 6e 64 20 69 73 20 74 | found is t| 00000dc0 72 61 70 70 65 64 3a 20 20 56 20 69 73 20 73 65 |rapped: V is se| 00000dd0 74 2c 20 61 6e 64 20 74 68 65 0d 20 20 20 20 20 |t, and the. | 00000de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000df0 20 20 20 20 20 20 20 20 20 20 20 56 69 65 77 53 | ViewS| 00000e00 74 6f 72 65 20 22 46 69 6c 65 20 6e 6f 74 20 66 |tore "File not f| 00000e10 6f 75 6e 64 22 20 65 72 72 6f 72 20 63 6f 64 65 |ound" error code| 00000e20 20 69 73 20 69 6e 0d 20 20 20 20 20 20 20 20 20 | is in. | 00000e30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00000e40 20 20 20 20 20 20 20 41 3b 20 59 20 69 73 20 7a | A; Y is z| 00000e50 65 72 6f 2e 0d 20 20 20 20 20 20 20 20 20 20 20 |ero.. | 00000e60 20 20 20 20 20 58 20 20 20 20 20 20 20 20 20 20 | X | 00000e70 20 20 20 20 20 75 6e 64 65 66 69 6e 65 64 2e 0d | undefined..| 00000e80 0d 0d 4f 53 48 43 41 4c 0d 0d 4f 53 48 43 41 4c |..OSHCAL..OSHCAL| 00000e90 20 67 69 76 65 73 20 74 68 65 20 75 74 69 6c 69 | gives the utili| 00000ea0 74 79 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 |ty access to the| 00000eb0 20 66 69 6c 69 6e 67 20 73 79 73 74 65 6d 20 4f | filing system O| 00000ec0 53 46 49 4c 45 20 72 6f 75 74 69 6e 65 2e 20 20 |SFILE routine. | 00000ed0 49 74 0d 75 73 65 73 20 74 68 65 20 4f 53 46 41 |It.uses the OSFA| 00000ee0 52 41 20 61 72 65 61 20 61 73 20 69 74 73 20 63 |RA area as its c| 00000ef0 6f 6e 74 72 6f 6c 20 62 6c 6f 63 6b 2e 20 20 4e |ontrol block. N| 00000f00 6f 74 65 20 74 68 61 74 20 74 68 69 73 20 73 70 |ote that this sp| 00000f10 69 6c 6c 73 20 6f 76 65 72 20 69 6e 74 6f 0d 74 |ills over into.t| 00000f20 68 65 20 4c 57 4f 52 4b 20 61 72 65 61 2c 20 77 |he LWORK area, w| 00000f30 68 69 63 68 20 77 69 6c 6c 20 62 65 20 63 6f 72 |hich will be cor| 00000f40 72 75 70 74 65 64 20 61 66 74 65 72 20 61 6e 20 |rupted after an | 00000f50 4f 53 48 43 41 4c 20 63 61 6c 6c 2e 20 20 4f 53 |OSHCAL call. OS| 00000f60 48 43 41 4c 0d 61 73 73 75 6d 65 73 20 74 68 61 |HCAL.assumes tha| 00000f70 74 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 28 |t the filename (| 00000f80 77 68 65 6e 20 72 65 71 75 69 72 65 64 29 20 69 |when required) i| 00000f90 73 20 73 65 74 20 75 70 20 69 6e 20 46 42 4c 4f |s set up in FBLO| 00000fa0 43 4b 2e 20 20 4f 53 48 43 41 4c 20 61 6c 73 6f |CK. OSHCAL also| 00000fb0 0d 73 65 74 73 20 74 68 65 20 68 69 67 68 20 6f |.sets the high o| 00000fc0 72 64 65 72 20 61 64 64 72 65 73 73 65 73 20 69 |rder addresses i| 00000fd0 6e 74 6f 20 74 68 65 20 63 6f 6e 74 72 6f 6c 20 |nto the control | 00000fe0 62 6c 6f 63 6b 20 61 74 20 4f 53 46 41 52 41 20 |block at OSFARA | 00000ff0 2b 34 20 61 6e 64 20 2b 35 3b 0d 2b 26 43 20 61 |+4 and +5;.+&C a| 00001000 6e 64 20 2b 26 44 3b 20 61 6e 64 20 61 74 20 2b |nd +&D; and at +| 00001010 26 31 30 20 61 6e 64 20 2b 26 31 31 2e 20 20 56 |&10 and +&11. V| 00001020 69 65 77 53 74 6f 72 65 20 65 72 72 6f 72 20 74 |iewStore error t| 00001030 72 61 70 70 69 6e 67 20 69 73 20 61 6c 73 6f 0d |rapping is also.| 00001040 65 6e 61 62 6c 65 64 2e 0d 0d 4f 6e 20 65 6e 74 |enabled...On ent| 00001050 72 79 3a 20 20 20 20 20 20 20 41 20 20 20 20 20 |ry: A | 00001060 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 61 69 | contai| 00001070 6e 73 20 72 65 61 73 6f 6e 20 63 6f 64 65 20 61 |ns reason code a| 00001080 73 20 66 6f 72 20 6e 6f 72 6d 61 6c 20 4f 53 46 |s for normal OSF| 00001090 49 4c 45 0d 20 20 20 20 20 20 20 20 20 20 20 20 |ILE. | 000010a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000010b0 20 20 20 20 28 73 65 65 20 66 69 6c 69 6e 67 20 | (see filing | 000010c0 73 79 73 74 65 6d 20 6d 61 6e 75 61 6c 29 2e 0d |system manual)..| 000010d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000010e0 4f 53 46 41 52 41 20 20 20 20 20 20 20 20 20 20 |OSFARA | 000010f0 73 65 74 20 75 70 20 77 69 74 68 20 77 68 61 74 |set up with what| 00001100 65 76 65 72 20 74 68 65 20 72 65 61 73 6f 6e 20 |ever the reason | 00001110 63 6f 64 65 20 61 63 74 69 6f 6e 0d 20 20 20 20 |code action. | 00001120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001130 20 20 20 20 20 20 20 20 20 20 20 20 72 65 71 75 | requ| 00001140 69 72 65 73 2c 20 65 67 2e 20 73 74 61 72 74 20 |ires, eg. start | 00001150 61 6e 64 20 65 6e 64 20 61 64 64 72 65 73 73 65 |and end addresse| 00001160 73 20 66 6f 72 0d 20 20 20 20 20 20 20 20 20 20 |s for. | 00001170 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001180 20 20 20 20 20 20 66 69 6c 65 20 73 61 76 65 2e | file save.| 00001190 0d 0d 4f 6e 20 65 78 69 74 3a 20 20 20 20 20 20 |..On exit: | 000011a0 20 20 56 53 20 20 20 20 20 20 20 20 20 20 20 20 | VS | 000011b0 20 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 | error occurred| 000011c0 3b 20 65 72 72 6f 72 20 63 6f 64 65 20 69 6e 20 |; error code in | 000011d0 41 2e 0d 20 20 20 20 20 20 20 20 20 20 20 20 20 |A.. | 000011e0 20 20 20 56 43 20 20 20 20 20 20 20 20 20 20 20 | VC | 000011f0 20 20 20 63 6f 6d 70 6c 65 74 65 64 20 73 75 63 | completed suc| 00001200 63 65 73 73 66 75 6c 6c 79 3b 20 66 69 6c 65 20 |cessfully; file | 00001210 74 79 70 65 20 69 6e 20 41 20 77 68 65 6e 0d 20 |type in A when. | 00001220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 00001230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 | r| 00001240 65 6c 65 76 61 6e 74 2e 0d 20 20 20 20 20 20 20 |elevant.. | 00001250 20 20 20 20 20 20 20 20 20 58 2c 59 20 20 20 20 | X,Y | 00001260 20 20 20 20 20 20 20 20 20 75 6e 64 65 66 69 6e | undefin| 00001270 65 64 2e 0d 0d 0d 58 4f 53 41 52 47 0d 0d 58 4f |ed....XOSARG..XO| 00001280 53 41 52 47 20 69 73 20 65 71 75 69 76 61 6c 65 |SARG is equivale| 00001290 6e 74 20 74 6f 20 4f 53 41 52 47 53 2c 20 65 78 |nt to OSARGS, ex| 000012a0 63 65 70 74 20 74 68 61 74 20 56 69 65 77 53 74 |cept that ViewSt| 000012b0 6f 72 65 20 65 72 72 6f 72 20 68 61 6e 64 6c 69 |ore error handli| 000012c0 6e 67 20 69 73 0d 65 6e 61 62 6c 65 64 2e 0d 0d |ng is.enabled...| 000012d0 4f 6e 20 65 6e 74 72 79 3a 20 20 20 20 20 20 20 |On entry: | 000012e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000012f0 53 65 65 20 66 69 6c 69 6e 67 20 73 79 73 74 65 |See filing syste| 00001300 6d 20 6d 61 6e 75 61 6c 20 66 6f 72 20 4f 53 41 |m manual for OSA| 00001310 52 47 53 2e 0d 0d 4f 6e 20 65 78 69 74 3a 20 20 |RGS...On exit: | 00001320 20 20 20 20 20 20 56 53 20 20 20 20 20 20 20 20 | VS | 00001330 20 20 20 20 20 20 65 72 72 6f 72 20 6f 63 63 75 | error occu| 00001340 72 72 65 64 3b 20 65 72 72 6f 72 20 63 6f 64 65 |rred; error code| 00001350 20 69 6e 20 41 2e 0d 20 20 20 20 20 20 20 20 20 | in A.. | 00001360 20 20 20 20 20 20 20 56 43 20 20 20 20 20 20 20 | VC | 00001370 20 20 20 20 20 20 20 6e 6f 20 65 72 72 6f 72 3b | no error;| 00001380 20 73 65 65 20 66 69 6c 69 6e 67 20 73 79 73 74 | see filing syst| 00001390 65 6d 20 6d 61 6e 75 61 6c 20 66 6f 72 0d 20 20 |em manual for. | 000013a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | | 000013b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 | re| 000013c0 73 75 6c 74 73 2e 0d 0d |sults...| 000013c8
F/+HINT11.m0
F/+HINT11.m1
F/+HINT11.m2
F/+HINT11.m4
F/+HINT11.m5
.