ZiLOG Z80-RIO Operating System User's Manual page 69

DEBUG (continued)
• SAVE file name (starting address ending_address)
+
[E=entry] [RL=record_rength]
The SAVE command copies segments of memory to diskette so that they
may be restored later. Segments are saved beginning at the
specified starting address, and terminating on a record
boundary~
In a case, therefore, where the starting address is 2000H, the
ending addres~ is 20PPH, and the recotd length is SOH, memory will
be copied from the starting address to the ending address. But if
the ending address is 2100B, then lOla bytes are being requested"
and the next record must be completed, causing 2000 to 2l7F to be
saved. Up to five such segments may be saved by repeating the
start address and end address pair. The default record length for
ZDOS-based systems is SOH, and the maximum record length is 400B.
Other valid record sizes are 100H and 200H. The default record
,length for DPS-based systems 'is 200H. If no entry address is
specified, the system assumes an entry address of O.
If the entry address and record length 'parameters are both
specified, they must be specified in the syntactical order
specified above. If the system encounters a syntax error in the
command line, it displays a Question-Mark character, and returns to
Debug. Such syntactical errors might include incorrect or
incorrectly entered file names or numbers, incorrect pairing of
starting and ending addresses, failure to enter "RL=" or "E=", or
failure to specify a value after "RL=" or "E=".
Any disk I/O error will cause the system to display the message
"PILE ERR code", where "code" is one of the operating system error
codes. One exception: if the diskette is full, the system may
display the message "DISK PULL'~ rather than "FILE ERR D3.
It
***
USAGE NOTE
***
SAVE does not set the values LOW ADDRESS, HIGH ADDRESS, or
STACK SIZE in the file's descriptor record. These values must be
set before the file can be loaded by RIO (see SET command
description, Section 5.39).
***
WARNING
***
SAVE uses diskette allocation information retrieved ~irectly from
the diskette, whereas ZOOS uses a copy of the same information
stored in memory. If ZDOS activities have immediately preceded the
SAVE attempt, e.g., if the Debug environment is invoked by a Break
from an operating system program, or will be returning immediately
E3-0072-0l,
Rev. A
- 57 -
02/13/79