Name

omni_delete − The omni_delete procedure deletes a specific object on a VMD.  Omni_delete does not delete the definition obtained by omni_define.

Syntax

extern unsigned long int omni_delete [_a](
       unsigned long int        ∗invoke_id,
       omni_l_handle            obj_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. 

obj_handleaccess: read only mechanism: by value The identifier of a loaded variable definition. 

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

iosbaccess: read 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

Only objects with no dependencies can be deleted.  For example, a domain with an associated program invocation cannot be deleted until the program invocation is deleted.