Name

omni_fput − The omni_fput  procedure copies a file from the local system to the remote system. 

Syntax

extern unsigned long int omni_fput [_a](
       unsigned long int       ∗invoke_id,
       omni_l_handle           vmd_handle,
       omni_t_file_name        remote_file_name,
       unsigned long int       remote_file_name_length,
       omni_t_file_name        local_file_name,
       unsigned long int       local_file_name_length,
       omni_l_handle           modifier_object,
       omni_r_iosb             ∗iosb,
       omni_r_ctrl             ∗ctrl);

Arguments

invoke_idaccess: 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. 

remote_file_nameaccess: read only mechanism: by reference The file specification (in native format) for the remote file to receive the copy. 

remote_file_name_length
access: read only mechanism: by value The length of the remote_file_name parameter in characters.

local_file_nameaccess: read only mechanism: by reference The file specification for the local file to copy. 

local_file_name_length
access: read only mechanism: by value The length of the local_file_name parameter in characters.

modifier_objectaccess: read only mechanism: by value 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. 

Usage Notes

The local file must be an FTAM-3 documentation type.