omni_get_indications(3) — Subroutines
Name
omni_get_indications − The omni_get_indications procedure receives the following indications from a remote application:
•Read/write indications
•Unsolicited status
•Conclude indications
•Abort indications
•Information reports
Syntax
extern unsigned long int omni_get_indications [_a](
omni_l_handle vmd_handle,
omni_l_handle ∗def_handle,
omni_l_context ∗context,
omni_l_attributes ∗indication_type,
char reserved,
omni_r_iosb ∗iosb,
omni_r_ctrl ∗ctrl);
Arguments
vmd_handleaccess: read only mechanism: by value The longword identifier of a loaded VMD definition, indicating the remote VMD for which indications are to be received. The vmd_handle is returned by the omni_define procedure.
def_handle
access: write only mechanism: by reference An object definition handle returned by DEComni. This is the handle of the object referred to by the indication (for example, a read indication would be accompanied by the handle of the variable to read). If the indication does not refer to an object (for example, a conclude indication), this parameter is null on completion.
contextaccess: read/write mechanism: by reference Context information returned by DEComni to be used in subsequent calls.
indication_typeaccess: write only mechanism: by reference One of the following constants listed in the following table to indicate the type of indication received. This field will be set to NULL if an association is aborted or concluded.
| Value | Meaning |
| omni_c_ind_acse_concl | Incoming conclude has completed. |
| omni_c_ind_pres_concl | Incoming conclude has been received. User must accept or reject the conclude. |
| omni_c_ind_abort | Incoming abort has been received. |
| omni_c_ind_read | Incoming read request has been received. |
| omni_c_ind_write | Incoming write request has been received. |
| omni_c_ind_unsol_status | Incoming status report has been received. |
| omni_c_ind_info_report | Incoming information report has been received. |
| omni_c_ind_status | Incoming status request has been received. |
reservedaccess: read only mechanism: by reference A place holder.
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
Issue one omni_get_indications call per remote VMD.