Name

omni_connect − The omni_connect procedure initiates an association with a remote VMD. 

Syntax

extern unsigned long int omni_connect [_a](
       omni_l_handle   vmd_handle,
       char            reserved,
       omni_l_handle   calling_vmd_handle,
       omni_r_vmd_def  ∗negotiated_vmd_struct,
       omni_b_boolean  conclude_flag,
       omni_r_iosb     ∗iosb,
       omni_r_ctrl     ∗ctrl);

Arguments

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

reservedReserved for future use. 

calling_vmd_handleaccess: read only mechanism: by value optional argument The handle of a VMD that the application wants to make available during the association.  If the calling_vmd_handle is included, the application can receive client requests from the remote peer to operate on the VMD.  The handle also enables DEComni to service network objects --- such as variables --- for the user. 

negotiated_vmd_struc
access: write only mechanism: by reference optional argument A VMD data structure to receive negotiated service parameters.

conclude_flagaccess: read only mechanism: by value optional argument One of the values shown in the following table  to specify the way OMNI handles conclude indications. 

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 calling VMD specifies network objects.