Programming Guide - Actian

How You Can Communicate with an External Program Using External User EventseventnameSpecifies the name of the user event. If you do not specify the eventname, all registered events for the frame are removed from the list. Thisparameter is case sensitive.The following example illustrates this:CurFrame.UnRegisterUserEvent(eventname ='external_update');UserEvent Event BlockThe UserEvent event block for an external user event is the same as the eventblock for an internal user event. In this event block, you provide the code thatis executed when the event is triggered. The syntax follows:on userevent ['eventname']beginstatement listend;eventnameSpecifies any string of up to 32 characters enclosed in quotes. If youspecify the event name, OpenROAD executes the event block wheneverthe frame receives that particular user event. This name must be the sameas the one you use when you register the frame to receive the event withthe RegisterUserEvent method as described in RegisterUserEvent Method(see page 349). The following example illustrates this:on userevent 'external_update'beginprogram statementprogram statementprogram statementend;If you do not specify an event name, OpenROAD executes the blockwhenever the frame receives a user event for which there is no specificevent block in the frame script. You can specify any number of user eventblocks in the frame script, although each must have a unique event name,or no event name at all.You can discover the name of the event that caused the execution of anunnamed user event block by referencing the EventName attribute of theframe's FrameExec object.350 Programming Guide