CONTENTS

  Title Page

  Copyright Page

  How to Use This Manual

  Audience

  Structure

  Associated Documentation

  Conventions

  1      Introduction

  1.1     Overview of the Computer Integrated Telephony Applications Interface

  1.2     The Applications Interface Routines

  1.3     Controlling the Communications Channel
    1.3.1      Establishing and Releasing Logical Communications Channels
    1.3.2      Setting and Querying Device Characteristics
    1.3.3      Monitoring a Channel Assigned to a Device
    1.3.4      Monitoring Calls Associated with an Assigned Logical Device

  1.4     PBX Functions
    1.4.1      Basic Call Processing
    1.4.2      Holding and Retrieving Calls
    1.4.3      Canceling Calls and Responding to Incomplete Calls
    1.4.4      Transferring and Conferencing Calls
    1.4.5      Answering Calls
    1.4.6      Routing Calls
    1.4.7      Predictive Dialing

  1.5     Voice Functions
    1.5.1      Messages
      1.5.1.1      Identifying Messages
      1.5.1.2      Global Messages
      1.5.1.3      The Structure of Messages
      1.5.1.4      Repositioning Within Messages
    1.5.2      Creating DECvoice Messages
      1.5.2.1      Recording Messages
      1.5.2.2      Text to Speech
    1.5.3      Loading and Unloading Messages
    1.5.4      Playing Messages
    1.5.5      Deleting Message Handles and Contexts
    1.5.6      Voice Channel Services
    1.5.7      DECvoice and Telephony Functions
    1.5.8      Detecting DTMF Tones
    1.5.9      Generating DTMF Tones

  2      How to Call CIT Routines

  2.1     Use of Arguments
    2.1.1      VMS Usage
    2.1.2      Data Type
    2.1.3      Access to Data
    2.1.4      Passing Mechanisms
      2.1.4.1      Passing Arguments by Value
      2.1.4.2      Passing Arguments by Reference
      2.1.4.3      Passing Arguments by Descriptor
      2.1.4.4      Passing Strings as Arguments

  2.2     Structure of CIT Item Lists
    2.2.1      Input and Input/Output Item Lists
    2.2.2      Types of Items in DEC CIT
    2.2.3      Example Item List
    2.2.4      Item Codes

  2.3     Synchronous/Asynchronous Operation
    2.3.1      Asynchronous Parameters

  2.4     Errors from DEC CIT Routines

  2.5     Linking Your Program

  A   Example Programs

  A.1     Making a Telephone Call
    A.1.1      C Example
    A.1.2      MACRO Example
    A.1.3      FORTRAN Example

  A.2     Monitoring a Channel and Conference Calls

  A.3     Monitoring a Channel-a Pascal Example

  A.4     DECvoice Functions

  Glossary of CIT and PBX Terms

  FIGURES

  1-1        A CIT Network

  1-2        Voice Configurations

  2-1        How Item Lists Are Passed

  2-2        Composite Items

  2-3        Example Input Item List

  2-4        Structure of the I/O Status Block

  TABLES

  2-1        VMS Data Structures

  2-2        VAX Data Types in CIT Routines