Watchdog (JanosRuntime JavaDOC)

java.lang.Object
- com.integpg.system.Watchdog

```
public class Watchdog
extends Object
```

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`handle` handle
`static int`	`WDT_APPLICATION` WDT_APPLICATION This action indicates that a watchdog timer expiration is to be handled by the application itself.
`static int`	`WDT_BREAK` WDT_BREAK This interrupts the current application (similar to Ctrl-C interruption) when the watchdog timer expires.
`static int`	`WDT_EVENT` WDT_EVENT Watchdog timer expiration will notify the first thread in the application that is waiting for notification using waitOnWatchdogNotify().
`static int`	`WDT_MESSAGE` WDT_MESSAGE When the watchdog timer expires a WM_WATCHDOG (0x11) message will be sent through the system message pump.
`static int`	`WDT_REBOOT` WDT_REBOOT This is the default action.
`static int`	`WDT_RESTART` WDT_RESTART When the watchdog timer expires this will interrupt the current application and restart it.
`static int`	`WDT_TERMINATE` WDT_TERMINATE When the watchdog timer expires the system will terminate the application.

Constructor Summary

Constructors
Constructor and Description

Watchdog()
The default constructor creates a Watchdog instance.

Watchdog(String title)
Constructor creates a Watchdog instance with defined text.

Constructors
Constructor and Description
`Watchdog()` The default constructor creates a Watchdog instance.
`Watchdog(String title)` Constructor creates a Watchdog instance with defined text.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`activate()` Activates (starts) the Watchdog countdown timer.
`void`	`activate(int duration)` Activates (starts) the Watchdog countdown timer with specified duration.
`void`	`deactivate()` Deactivates (stops) the Watchdog countdown timer.
`void`	`delete()` Deletes/removes the Watchdog timer.
`int`	`getAction()` Retrieves the defined action.
`int`	`getDuration()` Retrieves the current timer duration.
`String`	`getText()` Retrieves the defined text reference
`void`	`refresh()` Refreshes the Watchdog countdown timer.
`void`	`removeEventListener()` Removes the event listener for this Watchdog.
`void`	`setAction(int action)` Defines the actions to be taken should the timer expire.
`void`	`setDuration(int duration)` Sets the timer duration (60000 milliseconds is default).
`void`	`setEventListener(WatchdogEventListener listener)` Set an event listener for this Watchdog.
`void`	`setText(String text)` Defines the text used for example when messages are generated.
`String`	`toString()` Returns the string representation of this Watchdog object.
`boolean`	`triggered()` Check if Watchdog triggered.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - handle
```
protected int handle
```
    handle
  - WDT_REBOOT
```
public static final int WDT_REBOOT
```
    WDT_REBOOT This is the default action. Expiration of the watchdog timer causes the unit to reboot.
    
    See Also:
    
    Constant Field Values
  - WDT_APPLICATION
```
public static final int WDT_APPLICATION
```
    WDT_APPLICATION This action indicates that a watchdog timer expiration is to be handled by the application itself. The system takes no action.
    
    See Also:
    
    Constant Field Values
  - WDT_TERMINATE
```
public static final int WDT_TERMINATE
```
    WDT_TERMINATE When the watchdog timer expires the system will terminate the application.
    
    See Also:
    
    Constant Field Values
  - WDT_BREAK
```
public static final int WDT_BREAK
```
    WDT_BREAK This interrupts the current application (similar to Ctrl-C interruption) when the watchdog timer expires.
    
    See Also:
    
    Constant Field Values
  - WDT_RESTART
```
public static final int WDT_RESTART
```
    WDT_RESTART When the watchdog timer expires this will interrupt the current application and restart it.
    
    See Also:
    
    Constant Field Values
  - WDT_MESSAGE
```
public static final int WDT_MESSAGE
```
    WDT_MESSAGE When the watchdog timer expires a WM_WATCHDOG (0x11) message will be sent through the system message pump. The content contains the text associated with the watchdog.
    
    See Also:
    
    Constant Field Values
  - WDT_EVENT
```
public static final int WDT_EVENT
```
    WDT_EVENT Watchdog timer expiration will notify the first thread in the application that is waiting for notification using waitOnWatchdogNotify().
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Watchdog
```
public Watchdog()
```
    The default constructor creates a Watchdog instance. The string representation of the object is used as a reference. Note that you may supply a more descriptive text using the alternative constructor.
  - Watchdog
```
public Watchdog(String title)
```
    Constructor creates a Watchdog instance with defined text. This is the preferred constructor.
    
    Parameters:
    
    title - String to be associated with this Watchdog
- Method Detail
  - getAction
```
public int getAction()
```
    Retrieves the defined action. This returns an integer specifying the actions associated with this watchdog as follows: 0=WDT_REBOOT, 1=WDT_APPLICATION, 2=WDT_TERMINATE, 3=WDT_BREAK, 4=WDT_RESTART, 5=WDT_MESSAGE, and 6=WDT_EVENT.
    
    Returns:
    
    defined action
  - setAction
```
public void setAction(int action)
```
    Defines the actions to be taken should the timer expire. This must be one of Watchdog.WDT_REBOOT - Expiration causes reboot (default). Watchdog.WDT_APPLICATION - Application will handle expiration. Watchdog.WDT_TERMINATE = Expiration terminates the application. Watchdog.WDT_BREAK - expiration interrupts the application. Watchdog.WDT_RESTART - expiration restarts the application. Watchdog.WDT_MESSAGE - expiration issue WM_WATCH message to other applications. Watchdog.WDT_EVENT - expiration notifies waiting thread.
    
    Parameters:
    
    action - specified action
  - getDuration
```
public int getDuration()
```
    Retrieves the current timer duration.
    
    Returns:
    
    the current time duration in milliseconds
  - setDuration
```
public void setDuration(int duration)
```
    Sets the timer duration (60000 milliseconds is default).
    
    Parameters:
    
    duration - new timer duration in milliseconds
  - getText
```
public String getText()
```
    Retrieves the defined text reference
    
    Returns:
    
    defined text
  - setText
```
public void setText(String text)
```
    Defines the text used for example when messages are generated.
    
    Parameters:
    
    text - specified text
  - activate
```
public void activate()
```
    Activates (starts) the Watchdog countdown timer.
  - activate
```
public void activate(int duration)
```
    Activates (starts) the Watchdog countdown timer with specified duration.
    
    Parameters:
    
    duration - new timer duration in milliseconds
  - deactivate
```
public void deactivate()
```
    Deactivates (stops) the Watchdog countdown timer.
  - refresh
```
public void refresh()
```
    Refreshes the Watchdog countdown timer.
  - triggered
```
public boolean triggered()
```
    Check if Watchdog triggered.
    
    Returns:
    
    TRUE if the watchdog had been triggered and caused the last action.
  - delete
```
public void delete()
```
    Deletes/removes the Watchdog timer.
  - setEventListener
```
public void setEventListener(WatchdogEventListener listener)
```
    Set an event listener for this Watchdog.
    
    Parameters:
    
    listener - WatchdogEventListener class containing the method to handle this event
  - removeEventListener
```
public void removeEventListener()
```
    Removes the event listener for this Watchdog.
  - toString
```
public String toString()
```
    Returns the string representation of this Watchdog object.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    String representation

Class Watchdog

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

handle

WDT_REBOOT

WDT_APPLICATION

WDT_TERMINATE

WDT_BREAK

WDT_RESTART

WDT_MESSAGE

WDT_EVENT

Constructor Detail

Watchdog

Watchdog

Method Detail

getAction

setAction

getDuration

setDuration

getText

setText

activate

activate

deactivate

refresh

triggered

delete

setEventListener

removeEventListener

toString