Atari ST series Technical Reference Manual page 296

Frename()
C h a n g e s t h e n a m e o f a file .
C macro format
i n t s t a t u s ;
c h a r * o l d n a m e ;
c h a r * n e w n a m e ;
s t a t u s = F r e n a m e ( 0 , o l d n a m e , n e w n a m e ) ;
Machine language format
m o v e . l n e w n a m e , - (s p )
m o v e . l o l d n a m e , - (s p )
c l r .w - (s p )
m o v e . w # $ 5 6 , - ( s p )
t r a p # 1
a d d .l # 1 2 , s p
Inputs
l o n g
n e w n a m e
l o n g
o l d n a m e
z e r o w o r d m u s t a l s o b e p a s s e d a s a p l a c e h o l d e r .
N o t e t h a t a
Results
DO s t a t u s w o r d
288
Frename
Rename File
A p o i n t e r to th e s t r i n g c o n t a i n i n g t h e fi­
l e n a m e to c h a n g e to . T h i s f ile n a m e m a y
b e in a n e w d i r e c t o r y p a t h ,
A p o i n t e r t o a s t r i n g c o n t a i n i n g t h e n a m e
o f th e file t o b e c h a n g e d .
If s u c c e s s f u l , a 0 is r e t u r n e d . If n o t , a n e g a t i v e
G E M D O S e r r o r c o d e .
Opcode = 86 ($56)