EventMonitorDelete — Delete an Event Handling Environment

EventMonitorDelete
retcode
reascode
monitor_token

Purpose

Use the EventMonitorDelete function to delete a previously created event monitor.

Parameters

retcode
(output,INT,4) is a variable where the function stores the return code.
reascode
(output,INT,4) is a variable where the function stores the reason code.
monitor_token
(input,INT,4) is a variable for specifying the token that identifies the event monitor to delete. A value of 0 may be used to identify the active event monitor most recently activated on the current thread.

Usage Notes

  1. When an event monitor is deleted, all bound signals of broadcast events are discarded, and any other bound signal is either propagated to the next qualifying event monitor or discarded if no other qualifying event monitor exists.
  2. If EventMonitorDelete is issued against an active event monitor, the deletion does not occur until processing of the current signal set has been completed and the event monitor has been returned to the inactive state or explicitly reset.
  3. If an event monitor is deleted while there is an outstanding EventWait associated with it, the EventWait function is terminated with a reason code indicating that the event monitor has been deleted.
  4. If an event monitor is deleted while there is an outstanding event trap associated with it, the trap routine is driven on the thread that invokes the EventMonitorDelete function and must determine from the information returned by EventTest that the event monitor has been deleted. When the EventMonitorDelete function is issued against an active event monitor, the trap routine is invoked on the thread that resets the monitor.
  5. When a process is terminated, all its event monitors are deleted and all unprocessed signals are discarded.

Return Codes and Reason Codes

Return Code Reason Code Meaning
vm_evn_success vm_evn_success EventMonitorDelete completed successfully
vm_evn_warning vm_evn_monitor_still_active The specified monitor is currently active. The monitor is not deleted until it is reset.
vm_evn_error vm_evn_no_monitor Monitor_token is unrecognizable
vm_evn_error vm_evn_no_active_monitor No monitor is active on the current thread

Programming Language Bindings

Language Language Binding File
C VMCEVN H
Assembler VMASMEVN MACRO
REXX VMREXEVN COPY