$RunIdle Event

PLBCMP GUI Only, 9.9

The $RunIdle event is generated using a PL/B Web Server runtime. This event is generated when the PLBWEB_IDLE_TIMEOUT expires resulting in the event being pushed onto the top of the PLB user stack as the next event to be dispatched and the idle timeout is reset. Therefore, the PLBWEB_IDLE_MAX_TIMEOUT will never occur when this event is registered. The PLB end-user program must determine when to terminate the program using a STOP or SHUTDOWN instruction.

Note the following:

1. This event is only registered for the RUNTIME object using the EVENTREGISTER instruction.

2. This event is implemented to prevent the PWS runtime default idle action for a child task. The PLB end-user program take responsibility for all actions to determine when a client UI operations are no longer occurring.

3. If a PWS PLB program is in an ALERT, error dialog, or in a MENU popdown, the $RUNIDLE event cannot be generated because the PWS program is in an inactive state waiting for an end-user action. Therefore, $RUNIDLE cannot detect nor generate an event while a PLB program is in one of these PLB program instructions or state waiting for a UI action.

4. The $RunIdle event is referenced using an event value of thirty-six (36).

See Also: EVENTREGISTER, Object Events, Object IO Instructions, Object Definitions