omni_event_notify(1) — Commands
Name
omni_event_notify − .PP The initiator issues an Event notification using the omni_event_notify call.
The responder must be ready to receive an indication of the type omni_c_ind_event_notification. The handling and processing of the notification is local to the application.
Event notification is an unconfirmed service and does not wait for an error or response from the peer.
Syntax
omni_event_notify[_a] (
long int ∗invoke_id,
omni_l_handle vmd_handle,
omni_l_handle EvEnrolHandle,
omni_r_iosb ∗iosb,
omni_r_ctrl ∗ctrl);
Arguments
invoke_idaccess: write only mechanism: by value invoke_id is a unique identifier assigned by DEComni API for each outbound MMS request PDU. This parameter is the value of an invoke_id returned by a previously called DEComni API function.
vmd_handleaccess: read only mechanism: by value The longword identifier of a loaded VMD definition of the remote peer of an association. The vmd_handle is returned by the omni_define procedure.
EvEnrolHandleaccess: read only mechanism: by value Points to an Event enrollment object. The vmd_handle is returned by the omni_define procedure.
iosbaccess: read/write mechanism: by reference optional argument The DEComni API 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 and, under OpenVMS, an AST routine and AST parameter.
The ctrl parameter is the address of the control structure.