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

   The Dial the Telephone routine dials the  specified  number  on  the
   telephone.

      Format:

        DTK$DIAL_PHONE  voice-id ,phone-number [,dial-mode] [,text]
                   [,timeout]

      Arguments:

   voice-id

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

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

   phone-number

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

   Phone number to dial.  The phone-number argument is the address of a
   descriptor pointing to the specified phone number.

   dial-mode

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

   Mode to use when dialing the phone.  The optional dial-mode argument
   is the address of an unsigned longword containing this mode.

   text

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

   Text to be spoken after the phone is answered.  The text argument is
   the address of a descriptor pointing to the specified text.

   timeout

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

   Number of seconds to  wait  for  the  phone  to  be  answered.   The
   optional  timeout  argument  is  the  address  of  a signed longword
   containing this timeout value.  If omitted, DECtalk dials the  phone
   and then returns control to the calling program immediately.