VMS Help RTL Routines, DTK$, DTK$READ_STRING  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   The Read a Series of Keys Entered on  the  Keypad  routine  reads  a
   series of keys entered on the phone keypad.

      Format:

        DTK$READ_STRING  voice-id ,resultant-string [,prompt-string]
                   [,timeout] [,longword-integer-termin-code]

      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.

   resultant-string

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

   String  into  which  the  keys  being   read   are   written.    The
   resultant-string argument is the address of a descriptor pointing to
   this string.

   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 DECtalk waits for  input.   The  optional  timeout
   argument  is  the address of a signed longword containing the number
   of seconds DECtalk waits for input.   If  the  timeout  argument  is
   omitted, DTK$READ_STRING waits for input indefinitely.

   longword-integer-termin-code

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

   The DTK$K_TRM_xxxx code for terminating key entered.   The  optional
   longword-integer-termin-code  argument  is  the  address of a signed
   longword that receives this code.  The valid codes  are  located  in
   DTKDEF.