.UTIL TIMEOUT EXIT

This subroutine exits the current process or logs a user off after a set timeout period.

Usage:

      PASS         <action>                   FIELD            SHARE? N
      PASS         <action_delay>             FIELD            SHARE? N
      GOSUB    --- .UTIL TIMEOUT EXIT
      *        Check for errors
      IF       --- .UTIL TIMEOUT EXIT         NE

  

Description:

This subroutine exits the current process or logs a user off after a set timeout period. The <action> parameter is required, and the subroutine will CANCEL if it is not PASSed. The <action_delay> parameter is optional.

This subroutine should only be called in the Option Intercept or Global Option Intercept event points. You must have set a keyboard timeout via .UTIL TIMEOUT SET first, otherwise this routine does nothing.

<action> is the action that should be performed if a TIMEOUT has occurred (Required). It must be one of End or Logout. If it is End and the timeout has occurred, the current process will END. If it is Logout and the timeout has occurred, then the user will be logged out.

You may want to use Logout on Menus, and End on input processes. Thus, an unattended session at an Input process will first return to the menu, then log the user off.

<action_delay> is an optional parameter that represents the number of minutes before the action is taken. If this parameter is PASSed, then a message will be displayed to the user advising them how much time is left before the program exits. If there is no further activity, then the <action> will be taken when <action_delay> minutes has expired.

Note: If you use <action_delay> then:

• After the warning, the <action_delay> becomes the new timeout.
• Prior to 5.4.5 the warning only appears once. If the user does something to reset the timer after the warning has appeared, the next time the timer expires the specified <action> will be taken immediately. After 5.4.5, the warning will be repeated as required.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-01-31