Date: Fri, 29 Mar 2024 07:18:27 +0000 (UTC) Message-ID: <2139971621.15.1711696707691@f725ed78bc69> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_14_1558216323.1711696707691" ------=_Part_14_1558216323.1711696707691 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
IN: &nb= sp; A =3D reason code FA_PTR ($01) return sequential pointer (32bit integer) FA_EXT ($02) return extent (size) of file (32bit integer) FA_EOF ($03) end of file enquiry FA_BST ($04) buffer status (internal OZ usage) DE =3D 0, return result in DEBC registers (D =3D MSB, C =3D LSB) =09 DE < $8000, return result in (DE) =20 IX =3D file handle (previously obtained with GN_Opf) IX =3D $FFFF then system values are returned OUT, if call successful: Fc =3D 0 Fz =3D 1, end of file (FA_EOF) Fz =3D 0, not end of file (FA_EOF) DEBC =3D 32bit result (returned by FA_PTR, FA_EXT, FA_BST) (D =3D most significant byte, C =3D least significant byte) OUT, if call failed: Fc =3D 1 A =3D error code: RC_HAND ($08), bad handle Registers changed after return: ......HL/IXIY same AFBCDE../.... different
System information:
If IX(in) =3D $FFFF then the following informat=
ion is obtained:
FA_PTR:
DE =3D number of fre=
e handles
BC =3D OZ version nu=
mber (OZ version is embedded in C register as two hex nibbles, ie. 44H for =
OZ V4.4)
FA_EXT:
DEBC =3D estimate of=
free memory
FA_EOF:
Fz =3D 1, if Z88 is =
expanded, else Fz =3D 0
Buffer status
FA_BST only works with serial comms handle in IX (else Fc=3D1 and A=
=3DRC_Hand). It returns:
D =3D Tx buffer used slots
E =3D Tx buffer free slots
H =3D Rx buffer used slots
L =3D Rx buffer used slots
This information can also be obtained by OS_Si/SI_Enq.
DE must be in segment 0 or 1, otherwise the call is unreliable.
GN_Cl, close file
GN_Del, delete a file from memo=
ry
GN_Opf, open file/resource (wildcard search)
=
GN_Ren, rename file
OS_Cl, internal close (OZ usage)
OS_Fwm, file wri=
te miscellaneous
OS_Gb, get byte from file (or devic=
e)
OS_G=
bt, get byte from file (or device) with timeout
OS_Mv, move bytes be=
tween stream and memory
OS_Op=
, internal open (OZ usage)
OS_Pb, write byte to file=
, device
OS_Pbt, write byte to file, device with tim=
eout
OS_Ren, file rename (inte=
rnal OZ usage)