Name

omni_frename − The omni_frename procedure renames a file on the remote system. 

Syntax

extern unsigned long int omni_frename [_a](
       unsigned long int        ∗invoke_id,
       omni_l_handle            vmd_handle,
       omni_t_file_name         original_remote_file_name,
       unsigned long int        original_remote_file_name_length,
       omni_t_file_name         new_remote_file_name,
       unsigned long int        new_remote_file_name_length,
       omni_l_handle            modifier_object,
       omni_r_iosb              ∗iosb,
       omni_r_ctrl              ∗ctrl);

Arguments

invoke_id
  access: write only mechanism: by reference optional argument An identifier assigned by DEComni.  The parameter is used for asynchronous calls only.

vmd_handleaccess: read only mechanism: by value Longword identifier of a loaded VMD definition of the remote peer.  The VMD handle is returned by the omni_define procedure. 

orginal_remote_file_name
access: read only mechanism: by reference The file specification (in native format) for the remote file to rename.

orginal_remote_file_name_length
access: read only mechanism: by value The length of the original_remote_file_name parameter in characters.

new_remote_file_name
access: read only mechanism: by reference The file specification (in native format) for the new name.

new_remote_file_name_length
access: read only mechanism: by value The length of the new_remote_file_name parameter in characters.

modifier_objectaccess: read only mechanism: by reference optional argument Reserved for future use. 

iosbaccess: write only mechanism: by reference optional argument The DEComni I/O status block.  The iosb parameter is the address of the status block. 

ctrlaccess: read only mechanism: by reference optional argument A control structure to specify an event flag.  The ctrl parameter is the address of the control structure.