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