Tandy 1000 Programmer's Reference Guide

Chapter 1 I System Calls
Rename
Move a Directory Entry Function Call 56H
Renames a file andlor moves it to another directory. This is done
by giving the file
a new filename, path, or both. The drive for
both paths must be the same.
Entry Conditions:
AH = 56H
DS:DX = pointer to ASCIIZ pathname of existing file
ES:DI = pointer to new ASCIIZ pathname
Exit Conditions:
Carry set:
AX
= error code
Carry not set:
No error.
Error Returns:
AX = 2
File not found. The filename specified by DS:DX was not
found.
AX
= 17
Not same device. The source and destination are on different
drives.
Access denied:
(1) the path specified in DS:DX was a direc-
tory,
(2) the file specified by ES:DI already exists or,@) the
destination directory entry could not be created.
AX = 5
Example:
Rename equ 56H
Ids dx, source
le5 di, destination
mov ah, Rename
Int
21 H
135

Tandy 1000 Specifications

General

Processor	Intel 8088
Processor Speed	4.77 MHz
RAM	128 KB (expandable to 640 KB)
Operating System	MS-DOS 2.11
Manufacturer	Tandy Corporation
Release Year	1984
Storage	Single or double 5.25" floppy disk drive (360 KB), optional hard drive
Sound	Tandy 3-voice sound
Ports	Parallel, Serial
Graphics	CGA (Color Graphics Adapter)
Graphics Modes	320x200, 640x200