omni_listen(3sh1) — Subroutines
Name
omni_listen − The omni_listen procedure receives an association request from a remote application.
Syntax
extern unsigned long int omni_listen [_a](
omni_l_handle called_vmd_handle,
unsigned long int translate_flag,
omni_l_handle calling_vmd_handle,
omni_r_vmd_def ∗incoming_vmd_struc,
omni_r_iosb ∗iosb,
omni_r_ctrl ∗ctrl);
Arguments
called_vmd_handleaccess: read only mechanism: by value The handle of the VMD that the called application will make available to the remote peer. (On an omni_listen, the called application is the local application that has issued the omni_listen request.)
translate_flagaccess: read only mechanism: by value One of the values shown in the following table to specify the way DEComni handles initiation indications received from a remote VMD.
| Value | Meaning |
| 0 | DEComni rejects the initiation if the calling application specifies a VMD whose definition is not currently loaded. |
| non 0 | If the calling application specifies a VMD that is not currently loaded, DEComni returns the initiation indication, creates a dummy VMD definition, and passes the handle of the dummy definition to the user. |
calling_vmd_handleaccess: read only mechanism: by value Handle of a VMD specified by the calling application (the remote peer). During the association, the remote peer will accept client requests to operate on this VMD.
incoming_vmd_strucaccess: write only mechanism: by reference optional argument Service parameters proposed by the calling (remote) application.
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 handle an The ctrl parameter is the address of the control structure.