User`s guide

BDOS FUNCTION 23: RENAME FILE
Entry Parameters:
Registers C: 17H
DE: FCB Address
Returned Value-.
Registers A: Directory Code
H: Physical or Extended Error
The Rename function uses the FCB, addressed by register pair DE, to change all
directory entries of the file specified by the filename in the first 16 bytes of the FCB
to the filename in the second 16 bytes. If the file specified by the first filename is
password protected, the correct password must be placed in the first eight bytes of
the current DMA buffer, or have been previously established as the default password
(see Function 106). The calling program must also ensure that the filenames specified
in the FCB are valid and unambiguous, and that the new filename does not already
exist on the drive. Function 23 uses the dr code at byte 0 of the FCB to select the
drive. The drive code at byte 16 of the FCB is ignored.
3-36
BDOS Function Calls CP/M 3 Programmers Guide