omni_get_indications(3sh1) — Subroutines
Name
omni_get_indications − The omni_get_indications procedure receives the following indications (related to AP services) 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_load_definitions procedure.
The vmd_handle parameter is the handle.
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: write only 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.
| 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 (AP only). |
| 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_msg_exch | Incoming exchange message request has been received (AP only). |
| omni_c_ind_unsol_status | Incoming status report has been received (AP only). |
| 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 handle an The ctrl parameter is the address of the control structure.
Usage Notes
Issue one omni_get_indications call per remote VMD.
The omni_c_ind_read (omni_c_ind_write) indication specifies that the remote client application has issued either a read (or write) variable request for a Variable Access service, or a read (or write) message request for a Serial Transfer service. The DECosap application must first check whether the returned object handle refers to a variable or to a message, and then perform the appropriate actions.
The omni_c_ind_info_report indication specifies that the server application has issued an unacknowledged send value request either for a variable or a message. The DECosap client application must first check whether the returned object handle refers to a variable or to a message, and then perform the appropriate actions.