Name

omni_kill − The omni_kill procedure kills a program invocation on the VMD. 

Syntax

extern unsigned long int omni_kill [_a](
       unsigned long int        ∗invoke_id,
       omni_l_handle            pi_handle,
       omni_l_handle            modifier_object,
       omni_r_iosb              ∗iosb,
       omni_r_ctrl              ∗ctrl);

Arguments

invoke_idaccess: write only mechanism: by reference optional argument An identifier assigned by DEComni.  This parameter is used for asynchronous calls only. 

pi_handleaccess: read only mechanism: by value The identifier of a loaded program definition. 

modifier_objectaccess: read only mechanism: by value optional argument Reserved for future use. 

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

Omni_kill terminates a program invocation by causing it to transition to the unrunnable state.