 






    Software
    Product
    Description

 _____________________________________________________________________

 PRODUCT NAME:   DEC Computer Integrated Telephony      SPD 29.92.03
                 Applications Interface for VMS,[*] Version 2.1


DESCRIPTION                         and recognize tones on the tele-
DEC Computer Integrated Telephony   phone line.

(CIT) Applications Interface is     Note: Support of the DECvoice
a software product which provides   features is available in North
programmers with an applications    America only.
interface comprising a library of   The CIT Applications Interface passes
VMS routines. These routines al-    the application's requests to the
low the applications programmer     DEC CIT Server software, which must
to establish and control logical    be installed on a VAX system con-
communications channels between     nected to a CIT-compatible PBX over
a user process on a VAX and de-     a synchronous communications link.
vices attached to a CIT-compatible  For more information, refer to the
PBX.                                DEC CIT Server for VMS Software

These channels can be used for      Product Description (SPD 29.91.xx).
the following:

   o  Basic call processing
      such as making and
      accepting telephone
      calls

   o  Additional call
      processing such as
      transfer calls and
      conference calls

   o  Monitoring the status of
      telephones

The CIT Applications Interface
routines also allow the
programmer to establish
communications channels with
one or more DECvoice modules
installed on a MicroVAX II.

A DECvoice module provides a voice
response unit that can be used for
voice digitization. For example,
messages are recorded over a tele-
phone and the voice synthesis con-
verts text messages to speech. Us-
ing CIT routines, the DECvoice mod-
ule can also make, answer and hangup
telephone calls and can generate

                               DIGITAL                   January 1991

                                                          AE-LN54D-TE

 


 DEC Computer Integrated Telephony                       SPD 29.92.03



DEC CIT Applications Interface            -  Set or Cancel Message
Routines                                     Waiting
DEC CIT Applications Interface               lamp/Indicator

routines can be grouped                   -  Set ACD agent status

according to the following             o  Get Device Attributes
functions:                             o  Get Channel Information

   o  Control of the                   o  Get Event
      Communication Channel
      -  Establishing and           The Get Event routine returns
         releasing logical          call progress information
         communications             which includes call states,
         channels                   events, and call party
                                    information.
      -  Monitoring a channel       Basic Call Processing
         which is assigned to       functions set up calls,
         a telephony device         disconnect calls, and include

   o  Basic Call Processing         the following routines:

      -  Making calls                  o  Make Call

      -  Hanging up calls              o  Go offhook (DECvoice

   o  Holding and retrieving              specific)
      calls                            o  Hangup Call

   o  Canceling calls and           Routines for holding and
      responding to incomplete      retrieving calls include:
      calls

   o  Transferring and                 o  Suspend Call

      conferencing calls               o  Resume Call

   o  Answering calls                  o  Pickup Call

   o  Voice digitization               o  Swap-with-Held
      (recording voice)                o  Retrieve Held

   o  Voice synthesis (text to      Routines for canceling calls
      speech)                       and responding to incomplete

   o  Voice message handling        calls include:

   o  Generating and                   o  Cancel Call
      recognizing tones
Supported Routines                     o  Respond to Inactive Call

The following routines are          For transferring and
supported for controlling the       conferencing calls, the
communications channels:            following routines are
                                    available:

   o  Assign                           o  Initiate Transfer Call

   o  Deassign                         o  Transfer Call

   o  Set Device Attributes            o  Initiate Conference Call

      -  Set Monitor                   o  Conference Call

      -  Set Call Forward

      -  Do-not-disturb

                                  2

 


 DEC Computer Integrated Telephony                       SPD 29.92.03



For answering calls, the               o  Free Context
routine provided is:                   o  Free Message

   o  Answer Call                      o  Load Data

Although all of the above              o  Unload Data
routines are available through      The following routines are
the DEC CIT Applications            available for generating and
Interface, not all PBXs             detecting tones:
support the full range of
functions over their                   o  Make Tone
CIT-links. In addition, only           o  Make DTMF
some of the above telephony            o  Get DTMF Key
routines are available for use
with a DECvoice module.

For recording voice messages        Documentation

(digitization), the following       DEC CIT Applications Interface
routines are available:             documentation includes:

   o  Record                           o  DEC CIT for VMS -

   o  Record End                          Programming

   o  Record Pause                     o  DEC CIT Applications
   o  Record Resume                       Interface for VMS -
                                          Installation
For creating voice messages
from text (voice synthesis)         PTT Requirements
the following routines are
available:                          Although the PBX manufacturers
   o  Speak String                  are responsible for ensuring
                                    that the PBX software meets
   o  Create text message           PTT regulations, some of those

For playing text or digitized       regulations may apply to
voice messages:                     application software. If in
                                    doubt, refer to the
   o  Play                          appropriate documentation

   o  Play End                      supplied by the PTT
   o  Play Pause                    authorities for specific
                                    details.
   o  Play Resume

   o  Position

The following voice message
handling routines enable an
application to control voice
data on the client and server,
identify voice messages,
concatenate messages, and
display information on the
structure of a message:

   o  Create Context

   o  Get Context Information

   o  Get Message Information

                                  3

 


 DEC Computer Integrated Telephony                       SPD 29.92.03



INSTALLATION                        ORDERING INFORMATION

Only experienced customers             Software Licenses:
should attempt installation of         QL-VGXA*-**
this product. Digital                  Software Media: QA-VGXA*-**
recommends that all other              Software Documentation:
customers purchase Digital's           QA-VGXAA-GZ
Installation Services. These           Software Product Services:
services provide for                   QT-VGXA*-**
installation of the software           *  Denotes variant fields.
product by an experienced                 For additional
Digital Software Specialist.              information on available

In addition, the installation             licenses, services, and
requirements of the DEC CIT               media, refer to the
Server for VMS (SPD 29.91.xx)             appropriate price book.
must be met before using the
CIT Applications Interface.

HARDWARE REQUIREMENTS

VAX, MicroVAX, VAXstation or
VAXserver configuration as
specified in the System
Support Addendum (SSA
29.92.03-x).

SOFTWARE REQUIREMENTS*

   o  VMS Operating System.

   o  DECnet-VAX (end-node or
      full-function node
      license) if more than
      one VAX is part of the
      configuration.

   o  DEC CIT Server for VMS
      (CITSR) software must be
      installed either on the
      same node as the CIT
      Applications Interface
      software, or on another
      node linked by DECnet to
      the CIT node with the
      Applications Interface
      software.

   *  Refer to the System
      Support Addendum for
      availability and
      required versions of
      prerequisite/optional
      software (SSA
      29.92.03-x).

                                  4

 


 DEC Computer Integrated Telephony                       SPD 29.92.03



                                    For more information about
                                    Digital's licensing terms and
SOFTWARE LICENSING                  policies, contact your local
This software is furnished          Digital office.

under the licensing provisions
of Digital Equipment                SOFTWARE PRODUCT SERVICES

Corporation's Standard Terms        A variety of service options
and Conditions. For more            are available from Digital.
information about Digital's         For more information, contact
licensing terms and policies,       your local Digital office.
contact your local Digital          SOFTWARE WARRANTY
office.
                                    Warranty for this software
LICENSE MANAGEMENT FACILITY         product is provided by Digital
                                    with the purchase of a license
This layered product supports       for the product as defined in
the VMS License Management          the Software Warranty Addendum
Facility.                           of this SPD.

License units for this product         *  Formerly VAX Computer
are allocated on a                        Integrated Telephony
CPU-capacity basis.                       Applications Interface

For more information on the               (VAX CIT Applications
License Management Facility,              Interface).
refer to the VMS Operating
System Software Product                [TMThe DIGITAL Logo, CI,
Description (SPD 25.01.xx) or             DEC, DECnet-VAX, VAX,
the License Management                    MicroVAX, VAXstation,
Facility manual of the VMS                VAXserver, and VMS are
Operating System documentation            trademarks of Digital
set.                                      Equipment Corporation.






















                                  5
