16.2 Registering an Asynchronous Event Handler

To register a job-specific event handler that will only execute in the current FreeM process, use the following syntax:

  SET ^$JOB($JOB,"EVENT",event-class,event-identifier)=entryref

To register a system-wide event handler that will execute in every FreeM process, use the following syntax:

  SET ^$SYSTEM("EVENT",event-class,event-identifier)=entryref

For example, use the following to register ^RESIZE as an asynchronous event handler for SIGWINCH events:

  SET ^$JOB($JOB,"EVENT","INTERRUPT","SIGWINCH")="^RESIZE"

This by itself will not enable asynchronous event handling, as it merely registers an event handler, associating it with event class INTERRUPT and event identifier SIGWINCH.

This document was generated on September 20, 2023 using texi2html 5.0.