Name

omni_upload − The omni_upload procedure performs the uploading of a domain from a remote VMD. 
 

Syntax

extern unsigned long int omni_upload [_a](
       unsigned long int        ∗invoke_id,
       omni_l_handle            domain_handle,
       omni_t_file_name         domain_file,
       unsigned long int        domain_file_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.  This parameter is used for asynchronous calls only. 

domain_handleaccess: read only mechanism: by value The identifier of a loaded domain definition

domain_fileaccess: read only mechanism: by reference optional argument The file specification for an ULTRIX file to receive the domain.  If you omit this parameter, OMNI uses the file name associated with the domain. 

domain_file_lengthaccess: read only mechanism: by value optional argument The length of the domain_file 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

•Two files are created, one with the list of capabilities and one with the domain contents. 

•If an error occurs during the upload process, the files will be deleted.