- 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
- 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.
- 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.
- 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.
- 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.
- 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 |