Skip to main content

Hot-Key Intercept Program (*CONTROL)

*CONTROL is the hot-key intercept utility program. It is invoked internally by the PxPlus executive whenever a terminal input encounters a CTL value between -1 and -999. It processes the following:

CTL ValueProcessing
-1Calls the system utilities main menu *U.
-2Prints the contents of the current screen.
-3Line-switch (on some systems).
-4Display current statistics.
-5Input field help (Calls *HELP).
-6Input field query (Calls *QUERY).
-7Program help (Calls *HELP.PRG).
-8Resets screen.
-9(Reserved for future usage.)
-10 thru -999Calls the program $CTL -nnn where '-nnn' is the CTL value. Before calling this program, a new window consisting of the entire screen is created. It is dropped when the program returns.

Once *CONTROL has completed processing the CTL function, PxPlus will re-execute the INPUT (or OBTAIN) directive that initiated the process.

If the program reads raw data directly from the keyboard using the mnemonics 'BI' or 'ME' or the directives READ RECORD or ACCEPT, the program must call *CONTROL to handle all CTL values between -1 and -999.

Example:

Read single character but detect hot-key call to system functions.