Avaya VTCPD Features (Software Release 2.1 on MPS 2.1) User Manual

Avaya Business Communications ManagerRelease 6.0Document Status: StandardDocument Number: P0602483Document Version: 03.41Date: June 2010Avaya VTCPD Fe

VTCPD Features User ManualPage 10 P0602483 Ver: 03.41VTCPD Features User ManualConventions Used in This ManualThis manual uses different fonts and sy

VTCPD Features User ManualPage 100 P0602483 Ver: 03.41VTCPD Features User ManualThis page has been intentionally left blank.

This chapter covers:VTCPD Debugging and Maintenance1. Debugging2. Fault Tolerance3. VTCPD Status and Exception Conditions Reference4. VTCPD Troublesho

VTCPD Features User ManualPage 102 P0602483 Ver: 03.41VTCPD Features User ManualDebuggingThe current status of the internal VTCPD tables can be obtai

VTCPD Debugging and MaintenanceP0602483 Ver: 03.41 Page 103amu request debug aTo disable this feature, enter the command:amu request debug n.To displ

VTCPD Features User ManualPage 104 P0602483 Ver: 03.41VTCPD Features User ManualTo simplify development of the host side processes sample code is inc

VTCPD Debugging and MaintenanceP0602483 Ver: 03.41 Page 105Pinging the VTCPD from the HostIn cases where ping messages are initiated by hosts, the me

VTCPD Features User ManualPage 106 P0602483 Ver: 03.41VTCPD Features User ManualVTCPD Status and Exception Conditions ReferenceThe following table li

VTCPD Debugging and MaintenanceP0602483 Ver: 03.41 Page 107VTCPD Troubleshooting The VTCPD Troubleshooting is composed of two parts. A listing of Typ

VTCPD Features User ManualPage 108 P0602483 Ver: 03.41VTCPD Features User ManualThe reply from the host is not routed to the application:• Check that

VTCPD Debugging and MaintenanceP0602483 Ver: 03.41 Page 109Questions and AnswersCheck the listing of Questions and Answers to see if your problem is

PrefaceP0602483 Ver: 03.41 Page 11Solaris and Windows 2000 ConventionsThis manual depicts examples (command line syntax, configuration files, and scr

VTCPD Features User ManualPage 110 P0602483 Ver: 03.41VTCPD Features User Manual• There are two servers on the host side, but one only receives reque

Index

PeriView Reference ManualPage 112 # P0602566 Ver: 2.7Aadministrative application, VTCPD 89administrative line 64amu request debug 102amu request statu

Index# P0602566 Ver: 2.7 Page 113server mode 27UDP mode 33requesting dynamically 82specifying 81allowing VTCPD 82from the application 81host driven ap

PeriView Reference ManualPage 114 # P0602566 Ver: 2.7troubleshooting 107UUDP mode 33UDP. see VAS/TCP daemon (VTCPD)unexdata 62unexdata 89, 106unidenti

VTCPD Features User ManualPage 12 P0602483 Ver: 03.41VTCPD Features User ManualThis page has been intentionally left blank.

This chapter covers:Avaya VTCPD Over-view1. Host Communications Overview2. Avaya MPS Software Architecture3. Avaya VTCPD Features4. Connection Types

VTCPD Features User ManualPage 14 P0602483 Ver: 03.41VTCPD Features User ManualHost Communications OverviewThe Avaya Media Processing Server (Avaya M

Avaya VTCPD OverviewP0602483 Ver: 03.41 Page 15The applications control the actions of the MPS. They contain program instructions that tell the MPS h

VTCPD Features User ManualPage 16 P0602483 Ver: 03.41VTCPD Features User ManualMPS Software ArchitectureThe MPS Communications Software Subsystem is

Avaya VTCPD OverviewP0602483 Ver: 03.41 Page 17Avaya VTCPD and the MPS Communications Subsystem are separate software entities. At any one time, an a

VTCPD Features User ManualPage 18 P0602483 Ver: 03.41VTCPD Features User ManualAvaya VTCPD FeaturesThe Avaya VTCPD process facilitates communication

Avaya VTCPD OverviewP0602483 Ver: 03.41 Page 19This document only deals with the Avaya VTCPD daemon process. For information about application commun

© 2010 Avaya Inc.All Rights Reserved.NoticesWhile reasonable efforts have been made to ensure that the information in this document is complete and ac

VTCPD Features User ManualPage 20 P0602483 Ver: 03.41VTCPD Features User ManualApplication-Defined ModeWhen all or some host specifications are unava

This chapter covers:Avaya VTCPD Con-figuration and Options1. Configuration2. Options Overview3. Connection Options4. Application-Host Options

VTCPD Features User ManualPage 22 P0602483 Ver: 03.41VTCPD Features User ManualConfigurationThe services FileThe services file contains configuration

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 23Protocol Defines the protocol used when accessing each process.Example: services File

VTCPD Features User ManualPage 24 P0602483 Ver: 03.41VTCPD Features User ManualOptions OverviewThe Avaya VTCPD options support a wide range of applic

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 25Connection to VMST -v [node:]mps MPS number with optional remote node name.-s # Port

VTCPD Features User ManualPage 26 P0602483 Ver: 03.41VTCPD Features User ManualConnection OptionsThe Avaya VTCPD daemon can run as a client or server

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 27Server ModeIn the server mode, the Avaya VTCPD daemon accepts connections on the spec

VTCPD Features User ManualPage 28 P0602483 Ver: 03.41VTCPD Features User ManualSingle Host ConnectionThe Avaya VTCPD daemon connects to a single host

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 29Application-Defined ModeThe Avaya VTCPD daemon can start when all or some host specif

P0602483 Ver: 03.41 Page 3Table of contentsChapter 1 — Preface 7Scope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

VTCPD Features User ManualPage 30 P0602483 Ver: 03.41VTCPD Features User ManualA specific host link can be differentiated from other host links by th

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 31For the server type connections, set the assignment using:If CHANNEL is specified and

VTCPD Features User ManualPage 32 P0602483 Ver: 03.41VTCPD Features User ManualAt the beginning of each call, use the CONTROL operation in the PeriPr

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 33To close the connection, use: If the host and port are not specified, it means that t

VTCPD Features User ManualPage 34 P0602483 Ver: 03.41VTCPD Features User Manualfrom a host in a single package.The following figure is an example of

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 35To attach to the VMST, the Avaya VTCPD daemon has to use one of the Avaya VTCPD servi

VTCPD Features User ManualPage 36 P0602483 Ver: 03.41VTCPD Features User ManualApplication-Host OptionsThis document only provides an overview of app

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 37During the interval between acquiring the resource (GET) and when the resource is rel

VTCPD Features User ManualPage 38 P0602483 Ver: 03.41VTCPD Features User ManualMonitoring Host ConnectionsIn case a host process fails, the kernel on

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 39Time-OutsThe following VENGINE command line option specifies timeout values in second

VTCPD Features User ManualPage 4 P0602483 Ver: 03.41VTCPD Features User ManualChapter 4 — VTCPD Messages 45Message Format . . . . . . . . . . . . .

VTCPD Features User ManualPage 40 P0602483 Ver: 03.41VTCPD Features User ManualWhen time-outs are specified, the VENGINE starts its internal timer wh

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 41

VTCPD Features User ManualPage 42 P0602483 Ver: 03.41VTCPD Features User Manual

Avaya VTCPD Configuration and OptionsP0602483 Ver: 03.41 Page 43

VTCPD Features User ManualPage 44 P0602483 Ver: 03.41VTCPD Features User ManualWhen the application receives the data for RECEIVE request, the daemon

This chapter covers:VTCPD Messages1. Message Format2. Message Routing3. ISSUE-SEND-RECEIVE (ISR)4. ISSUE-RECEIVE-SEND (IRS)

VTCPD Features User ManualPage 46 P0602483 Ver: 03.41VTCPD Features User ManualMessage FormatTwo message formats are available - fixed length, and va

VTCPD MessagesP0602483 Ver: 03.41 Page 47The default setting does not pass the header to the application. VTCPD strips the header before passing the

VTCPD Features User ManualPage 48 P0602483 Ver: 03.41VTCPD Features User ManualMessage Format Optionsvtcpd-f {# | d:D | l:{#|lf[:hp[:hl]]} |

VTCPD MessagesP0602483 Ver: 03.41 Page 49Args (cont): A:Lf[:hp[:hl]] Specifies that the (ASCII) length field is embedded within the message header.A:

P0602483 Ver: 03.41 Page 5Chapter 6 — VTCPD Debugging and Maintenance 101Debugging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

VTCPD Features User ManualPage 50 P0602483 Ver: 03.41VTCPD Features User ManualMessage Identification (ID)VTCPD uses a Message ID to associate receiv

VTCPD MessagesP0602483 Ver: 03.41 Page 51All messages must include a Message ID field. The length and location of the ID field is specified by: -i N:

VTCPD Features User ManualPage 52 P0602483 Ver: 03.41VTCPD Features User Manualoption: For example, -i 48:1 specifies an identification field of leng

VTCPD MessagesP0602483 Ver: 03.41 Page 53Message RoutingConnection capacity means the number of outstanding host requests that can be associated with

VTCPD Features User ManualPage 54 P0602483 Ver: 03.41VTCPD Features User ManualISSUE-SEND-RECEIVE (ISR) The ISSUE-SEND-RECEIVE model assumes the idea

VTCPD MessagesP0602483 Ver: 03.41 Page 55This allows the daemon to:• Reserve an available host connection. • Send data to the host and associate Mess

VTCPD Features User ManualPage 56 P0602483 Ver: 03.41VTCPD Features User Manual

VTCPD MessagesP0602483 Ver: 03.41 Page 57This allows the line to receive two messages with the specified Message ID-field.Reserving a SlotSlots can b

VTCPD Features User ManualPage 58 P0602483 Ver: 03.41VTCPD Features User ManualIf the message is sent to the host, requests are either physically sto

VTCPD MessagesP0602483 Ver: 03.41 Page 59The option -d sec allows VTCPD to start using the connection again after a specified time period. The option

VTCPD Features User ManualPage 6 P0602483 Ver: 03.41VTCPD Features User ManualThis page has been intentionally left blank.

VTCPD Features User ManualPage 60 P0602483 Ver: 03.41VTCPD Features User ManualThe channel number # has to be in the range from 1 to the total number

VTCPD MessagesP0602483 Ver: 03.41 Page 61Asynchronous Replies and Reply NotificationWhen a response is received from the host, the VTCPD may handle t

VTCPD Features User ManualPage 62 P0602483 Ver: 03.41VTCPD Features User ManualUnidentified Host DataIf host data contains a Message ID which cannot

VTCPD MessagesP0602483 Ver: 03.41 Page 63For administrative applications, start the VENGINE using option -l 0:0.If the line restarts, all messages ar

VTCPD Features User ManualPage 64 P0602483 Ver: 03.41VTCPD Features User ManualAdministrative LineThe option -A # sends all host data to the specifie

VTCPD MessagesP0602483 Ver: 03.41 Page 65This informs the VTCPD daemon of the application’s availability. When the host data arrives, the VTCPD daemo

VTCPD Features User ManualPage 66 P0602483 Ver: 03.41VTCPD Features User ManualApplication Connection ChoiceThe VTCPD option -m l forces the daemon t

VTCPD MessagesP0602483 Ver: 03.41 Page 67Choosing the DaemonThe operations GET, CONTROL, FREE or SEND broadcast send requests to all VTCPD daemons at

VTCPD Features User ManualPage 68 P0602483 Ver: 03.41VTCPD Features User Manual

VTCPD MessagesP0602483 Ver: 03.41 Page 69Releasing Connection Slot and Handling ExceptionsIn addition to the situations mentioned above, the allocate

Preface

VTCPD Features User ManualPage 70 P0602483 Ver: 03.41VTCPD Features User Manual•A new GET operation is received by the daemon. • The application unbi

This chapter covers:VTCPD Application Programming1. Communicating with the Host2. Establishing or Changing the Host Specifications3. Specifying the Ho

VTCPD Features User ManualPage 72 P0602483 Ver: 03.41VTCPD Features User ManualCommunicating With the HostVTCPD uses the message ID to route host mes

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 73If the applications set the message ID, the applications must ensure that no two requests use

VTCPD Features User ManualPage 74 P0602483 Ver: 03.41VTCPD Features User ManualIn Get Host Slot, the application instructs VTCPD to reserve the host

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 75Soliciting Host Data on page 73.)An application that solicits data from the host can reserve

VTCPD Features User ManualPage 76 P0602483 Ver: 03.41VTCPD Features User ManualHost Driven ApplicationsA typical host driven application waits for un

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 77In Send Data, the application sends data to the host. The application can send additional mes

VTCPD Features User ManualPage 78 P0602483 Ver: 03.41VTCPD Features User ManualReceiving the Next Available Host MessageThe host driven application c

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 79Establishing or Changing the Host SpecificationsThe system can start a VTCPD when all or some

VTCPD Features User ManualPage 8 P0602483 Ver: 03.41VTCPD Features User ManualScopeThe Avaya Voice Transmission Control Protocol Daemon (Avaya VTCPD)

VTCPD Features User ManualPage 80 P0602483 Ver: 03.41VTCPD Features User ManualTo set the host to the IP address 192.84.160.127:Channel Number

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 81Specifying the Host ConnectionVTCPD can be configured to pool requests for each connection to

VTCPD Features User ManualPage 82 P0602483 Ver: 03.41VTCPD Features User Manualoptions), the application can request the connection dynamically.For e

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 83Since the application does not specify a channel, VTCPD chooses the connection and the slot i

VTCPD Features User ManualPage 84 P0602483 Ver: 03.41VTCPD Features User ManualSending MessagesUse Resource blocks to send messages to the host.In mo

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 85To send and receive messages on a system configured for multiple VTCPD, the application must

VTCPD Features User ManualPage 86 P0602483 Ver: 03.41VTCPD Features User ManualVariable Length MessagesVTCPD can be configured to support either fixe

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 87Receiving MessagesUse Resource blocks to receive messages from the host (see Replies Routing

VTCPD Features User ManualPage 88 P0602483 Ver: 03.41VTCPD Features User ManualIf the host sends a message before the application executes a Resource

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 89Host Responses From Any ConnectionThe host response normally arrives through the connection t

PrefaceP0602483 Ver: 03.41 Page 9perirev command.Organization of This ManualThe following briefly outlines the structure of this manual: Chapter 1—Av

VTCPD Features User ManualPage 90 P0602483 Ver: 03.41VTCPD Features User Manual

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 91Configurations That Require Multiple VTCPDEach instance of VTCPD supports a single message fo

VTCPD Features User ManualPage 92 P0602483 Ver: 03.41VTCPD Features User ManualData SetupTo parse the condition data, this application uses a composi

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 93To communicate with VTCPD, this application uses a character data card initialized to the VTC

VTCPD Features User ManualPage 94 P0602483 Ver: 03.41VTCPD Features User ManualImplementationFirst, this application uses VTCPD.serv-def, initialized

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 95Freeing the Host ConnectionUse a Resource block to free the host connection slot (see Releasi

VTCPD Features User ManualPage 96 P0602483 Ver: 03.41VTCPD Features User ManualVTCPD Message TimingThe VENGINE can be configured to maintain a resour

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 97Setting Resource Timers from an ApplicationUse Environment blocks to modify resource message

VTCPD Features User ManualPage 98 P0602483 Ver: 03.41VTCPD Features User ManualWhen an application receives ertimeout, the application should explain

VTCPD Application ProgrammingP0602483 Ver: 03.41 Page 99contact the hostreceive the data