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

6.19
RENAME
RENAME
Request vector:
Logical unit
Request code - 2A or 2B
Data transfer area - ignored
Length - ignored
Completion return address
Error return address
Completion code
Supplemental parameter information - a pointer to
an area configured as follows
Action:
1st byte - length of name
2nd and following bytes - new name
The file on the unit requested is given the new
name which is contained in the supplemental
parameter vector. The file may be open. If
it is not, there must be a pending assignment
for it, so that it can be opened. If it is
not already open, it will be activated, then
its directory entry removed from the directory
and a new one created. An open scratch file
may be recovered (requiring its descriptor
record to be created), but a named file cannot
be renamed to a scratch file. Finally, if the
file was not open at the start of the
operation, it is deactivated.
Possible errors:
All DISK ERRORs are possible.
FILE NOT FOUND (code C7) - the unit being
accessed was not open and the file assigned to
it does not exist. Will also occur if the
unit is assigned to a scratch file which has
not yet been created. No action is taken.
- 158 -