Function:     keystatus

Purpose:      Obtain user input error code.

Category:     USER-INTERFACE

File:         srvreq.c

Author:       J.P. Terlouw

Use:          #include "srvreq.h"
              int result;
              
              result = keystatus();

              result =  0 :  no error
                       -2 :  last user input request failed.

Description:  keystatus() is intended to be used in event-driven
              tasks. In this case when a user input failure occurs, e.g.
              bad input, no default allowed, etc., the user input
              function (e.g. userreal_c) returns zero after which
              keystatus() can be called to find out whether 
              a problem has occured.
              In "normal", not event-driven, tasks the user input
              function does not return until any error condition has
              been removed by Hermes.

Updates:      Nov 24, 1997: JPT, Original document