═══ 1. About WatchDog ═══ The WatchDog application is a utility which detects a hung desktop and calls DosShutdown to cleanly shut the file system down and re-enable CTRL-ALT-DEL. The program works by registering a PM timer for a set interval. Because PM is a single input queue, WM_TIMER messages will not be sent when the desktop is hung. Another watchdog thread blocks on a semaphore with a timeout greater than this interval. At each WM_TIMER message, the semaphore is cleared. If this semaphore wait times out, the program assumes the desktop is hung. A beep tone will sound and after a delay, the program calls DosShutdown. A legitimate (but poorly written) program might block the PM message queue longer than the selected timeout. To handle this case, select the Disable menu option before starting the program. The Watchdog program will be inactive until the Enable menu option is selected. There is also a selectable delay before shutdown that allows you to terminate the application through CTRL-ESC before the Watchdog application shuts the system down. ═══ 2. Help Menu ═══ Use the choices on the Help pull-down to display: Help index Displays the index of help menu. General Help Displays some information about Watchdog program. Keys Help Displays a list of keys usage. Using Help Provides detailed information on the kinds of help available and how to use help. ═══ 3. General Help ═══ Use this choice to get general help for the program. General help provides general information about the Watchdog program. ═══ 4. Extended ═══ Use this choice to obtain information on how to use the Help facility. ═══ 5. Tutorial of Keys ═══ Use this choice to see a list of keys and a description of the function of the keys. ═══ 5.1. Key Assigments ═══ The list of keys is arranged in groups. ACCELERATOR KEYS HELP KEYS F1 Get help Esc Previous Help Panel, or End help if only one panel Alt Switch IN/OUT action bar Alt+F4 End help or End program SYSTEM KEYS Alt+Esc Switch to the next program, including full-screen programs Ctrl+Esc Switch to the Task List WINDOW KEYS Underlined letter Move among the choices on the action bar and pull-downs submenu or execut the function chosen ═══ 6. Index ═══ Use this choice to display the help index. The help index lists the titles of the help information that is available. ═══ 7. Information ═══ This dialog displays information about the application, such as version number and copyright notice. ═══ 8. Information ═══ The OK button closes the dialog box. ═══ 9. Information ═══ Settings to control behaviour of Watchdog. Heartbeat Interval Sets the interval between "heartbeat" (WM_TIMER) messages from OS/2. The minimum time period is 5 seconds. A larger value results in a slightly lower processor load. The largest value OS/2 can accept is 65 seconds. Hang detection Interval Controls the delay after a missing heartbeat message before considering the desktop hung. Note that the total time to detect a hang can be as large as the sum of the Heartbeat interval and the hang detection interval. Shutdown delay Time interval after detecting hang until shutdown. Allows termination of an application through CTRL-ESC if desktop is not really hung. Play Shutdown tones Sound descending tones as shutdown period approaches. The first and last tone will always be generated. Start Minimized Start minimized by default. Ok Accept new settings Save Accept new settings and save them to disk Cancel Abandon all changes made to this screen. Help Display this help screen ═══ 10. Information ═══ This key will enable the "hang detection" in the Watchdog program. ═══ 11. Information ═══ This key will temporarily disable the "hang detection" in the Watchdog program until ENABLE is selected. ═══ 12. Information ═══ This dialog displays the user settings for the Watchdog program characteristics.