/sys$common/syshlp/helplib.hlb RTL Routines, DTK$, DTK$READ_KEYSTROKE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   The Read a Key Entered on the Keypad routine reads a key entered  on
   the phone keypad.

      Format:

        DTK$READ_KEYSTROKE  voice-id ,key-code [,prompt-string]
                   [,timeout]

      Arguments:

   voice-id

   OpenVMS usage: identifier
   type:          longword (unsigned)
   access:        read only
   mechanism:     by reference

   Voice identifier of the DECtalk device.  The  voice-id  argument  is
   the address of an unsigned longword containing this identifier.  The
   voice identifier is returned by the DTK$INITIALIZE routine.

   key-code

   OpenVMS usage: longword_signed
   type:          longword (signed)
   access:        write only
   mechanism:     by reference

   The DTK$K_TRM_xxxx code for the key  entered  on  the  keypad.   The
   key-code  argument is the address of a signed longword that receives
   this code.  The valid codes are listed in DTKDEF.

   prompt-string

   OpenVMS usage: char_string
   type:          character string
   access:        read only
   mechanism:     by descriptor

   Text  to  be  spoken  before  waiting  for  input.    The   optional
   prompt-string  argument  is  the address of a descriptor pointing to
   this text.

   timeout

   OpenVMS usage: longword_signed
   type:          longword (signed)
   access:        read only
   mechanism:     by reference

   Number of seconds to wait for input.  The optional timeout  argument
   is  the address of a signed longword containing the specified number
   of seconds the DECtalk device  waits  for  input.   If  the  timeout
   argument    is   omitted,   DTK$READ_KEYSTROKE   waits   for   input
   indefinitely.