•  Back 
  •  OLGA protocol 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help page 
  •  Show info about hypertext 
  •  View a new file 
Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File13.8.6  OLGA_RENAME                                                TOS

 Name         »OLGA_RENAME« - Report name change of an object.

 Number       0x123a

 Description  This message is sent by the Server to the Manager if the 
              user has renamed or moved a file in the Server. The 
              following apply:

               Parameter  Meaning 
               Word 0     Message number (0x123a) 
               Word 1     AES ID of the program 
               Word 2     0 
               Word 3+4   Pointer to the old filename including absolute 
                          path 
               Word 5+6   Pointer to the new filename including absolute 
                          path 
               Word 7     0 

              Note: It is up to the discretion of the Server whether 
              it sends this message after the 'Save as...' command. It 
              would be sensible in any case if the Server adopts the 
              new path specification, or new filename, for the the 
              document. Though links should exist only for files on 
              non-interchangeable media, in practice this may be 
              difficult or impossible to achieve. If the contents of 
              the file has changed, then additionally the message 
              OLGA_UPDATE has to be sent.

              The Server subsequently receives a reply, to which it 
              can react for instance by releasing the old memory area. 
              Incidentally, the confirmation only means that the 
              Manager has passed on the renaming; if the Client does 
              not react to this, then the corresponding link is dead, 
              i.e. it can no longer be supervised!

 Group        OLGA-Server

 See Also     OLGA_BREAKLINK   OLGA_INFO   OLGA_UPDATE