Function: USERTEXT Purpose: User input interface routine for characters. Category: USER-INTERFACE File: srvreq.c Author: J.P. Terlouw Declaration: INTEGER USERTEXT Use: INTEGER USERTEXT( ARRAY, Output character array DEFAULT, Input integer KEY, Input character MES ) Input character USERTEXT number of characters entered by the user. ARRAY array, contains output. DEFAULT default code ( 0: no default, 1: default, 2: hidden, 4: exact number, -1: special, see below). KEY keyword prompt. MES message for user. Special: Event-driven tasks can call USERTEXT with DEFAULT=-1. In this case the following information can be obtained from Hermes, depending on the supplied keyword: UCAMESSAGE= obtains the last User Command Area error message, usually a message associated with a rejected keyword; REJECTED= the input text associated with a rejected keyword. LSTMESSAGE= the last status message issued by a deputy task. In order to obtain reliable information from these keywords, the call must take place immediately after the detection of the problem at hand. Updates: Jul 25, 1988: KGB, Creation date. Feb 15, 1990: JPT, Portable version, rewritten in ANSI C. Sep 17, 1990: JPT, Bug in default handling repaired. Apr 17, 1991: JPT, reply buffer check added Oct 15, 1993: JPT, removed reply buffer limitation. Nov 25, 1997: JPT, documented special operation. Jun 10, 1998: JPT, documented LSTMESSAGE=.