AMSTRAD cpc 6128 User Instruction page 370

The <RAMrecord number> specifies which record is written. If the parameter is
omitted, then the current record number is used. The current record number is then
set to point at the next record.
If the <string expression> does not completely fill the record, then old characters
(which have not been overwritten) will remain at the end of the record. If the <string
expression> is longer than the record, then the excess characters are discarded to
avoid spillage into the next record.
<return code> is an integer variable which returns the record number written to (if the
operation was successful), or a negative error code ifthe write operation has failed in
some way.
-1 End of File error. The requested record number's address exceeds 64K.
- 3 Bank switching failure (should never happen).
Examples:
IBANKOPEN,111J
IBANKWRITE,@r%,"123 testing",11J
IBANKWRITE,@r%,w$
The command:
I BAN K REA D , @<returncode> , @<stringvariable>[, <RAMrecord number>]
.... reads a record into the <string variable> from the RAMfile.
The <RAMrecord number> specifies which record is to be read. If the parameter is
omitted, then the current record number is used. The current record number is then
set to point at the next record.
If the record contents do not completely fill the <string variable> then old characters
(which have not been overwritten) will remain at the end of the <string variable>. If
the record contents are longer than the length of <string variable>, the excess
characters are discarded, as it is not possible to increase the length of a string
variable during an external command.
<return code> is an integer variable which returns the record number read from (ifthe
operation was successful), or a negative error code if the read operation has failed in
some way.
-1 End of File error. The requested record number's address exceeds 64K.
- 3 Bank switching failure (should never happen).
Example:
IBANKREAD,@r%,i$,11J
More About the Bank Manager .... Chapter 8 Page 5