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

   The Spell Text routine causes DECtalk to pronounce  each  letter  of
   the specified text.

      Format:

        DTK$SPELL_TEXT  voice-id ,text [,completion-mode]

      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.

   text

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

   Text to be spelled out by DECtalk.  The text argument is the address
   of a descriptor pointing to the specified string.

   completion-mode

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

   The optional completion mode  characteristic.   The  completion-mode
   argument  is  the  address  of  a  longword  bit mask containing the
   specified mode.  Valid values for the completion-mode argument are:

        DTK$K_IMMED          Return to the user immediately (default).

        DTK$K_WAIT           Wait until the text is completely spoken.

        DTK$K_STATUS         Wait until the text is completely  spoken,
                               and then return a phone status.