Name

omni_download − The omni_download procedure initiates the downloading of a domain to a remote VMD. 

Syntax

extern unsigned long int omni_download [_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 of a remote peer. 

domain_fileaccess: read only mechanism: by reference optional argument The file specification for an ULTRIX file containing the domain contents. 

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

1You cannot download a domain that already exists on the VMD. 

2If a domain file specification is not included in the omni_download call DEComni returns an error code. 

3If, on completion of the download service, the domain has been discarded by the remote application, the user will be notified in the iosb. 

4DEComni supports only one download to a domain at a time.