Copyright: © Andi Henderson


Contents

About this guide

The Container Manager User Interface

Dialogic Sales Offices

Legal Information


About this guide

About this guide

This Guide is for...

Other CT Media Documents


The Container Manager User Interface

Introduction

Using the Container Manager

Creating a new Container

Data Objects

Container Backup and Restore

View Options


Dialogic Sales Offices

North American Sales

Corporate Headquarters

Northeastern US

Southeastern US

Central US

Western US

Northwestern US

GammaLink Division

Computer-Telephone Division

Spectron Microsystems Division

Dialogic On-Line  Information Retrieval System (fax-on-demand)

GammaLink Fax-on-Demand

computer telephony BBS

CTI@Dialogic WWW Site

Dialogic Sales Internet

Canada

Latin America & Caribbean

European Headquarters  (serving Europe,  Middle East, & Africa)

DTE On-Line Information Retrieval System

DTE BBS

Germany, Switzerland, & Austria

France

Italy

United Kingdom, Ireland, &  Scandinavian Countries

People's Republic of China, Hong Kong, Macau, and Taiwan

Japan & Korea

East Asia, Southeast Asia, West Asia, & Australia

DSEA BBS

New Zealand


Legal Information

Copyright notice

Trademarks


About this guide - About this guide
About this guide


This Guide is for...

•	This guide is intended for CT Media administrators.  It explains how to use the Container Manager.


Other CT Media Documents

The documentation set supplied with CT Media also includes

•	CT Media QuickStart

•	CT Media Application Developer's Guide for Windows NT

•	CT Media API Reference for Windows NT, Volumes 1 and 2

•	CT Media Resource Configuration Guide for Windows NT

•	CT Media Resource Reference for Windows NT


Introduction

Dialogic provides a utility for managing CT Media Containers.  See Chapter 5, CT Media API Reference, Volume 1, for more information on Containers.

Related Topics

Description

Functional Overview


Description

The Container Manager has a GUI interface which is very similar to the File Manager in Windows™, making Container administration straightforward.

The Container Manager will allow you to create and otherwise manipulate Containers needed for your applications without having to use the Container API functions.


Functional Overview

The Container Manager will allow you to:

•	Create Containers

•	Delete Containers

•	Rename Containers

•	Import files as Data Objects into Containers

•	Export Data Objects to files

•	Back up Containers

•	Restore from an existing backup


Using the Container Manager

NOTE:	These instructions assume that you have successfully installed CT Media, and that the CT Server is running.

Start the Container Manager application in the "Dialogic CT Media Applications" program group.

Choose Server | Connect to Server, or use the Connect icon, to connect to the CT Server.  We will connect to the default server, Default_Server.

NOTE:	For better performance when there are large numbers of Containers, the default view will be set to List.  Different views, including Details, are available; see the section on View Options.

You can see the contents of each Container by selecting it.

Double-click on the Root Container icon to expand the contents of Root.

NOTE:	When you have large numbers of Containers (i.e., greater than 100), some Container Manager procedures may take a noticeable amount of time.  In these cases, progress text will be displayed in the progress bar on the bottom right.  During these procedures, Container Manager is not multitasking.


Creating a new Container

You can create a new Container in any existing Container.

1.	Select the "Sample:" Container.

2.	Choose Edit | Create Container (or click on the Create icon on the toolbar).

3.	Enter the name of your new Container; i.e., "Test".  This will create a new Container within Sample, i.e., "Sample:Test:".


Data Objects

Copying/moving Data Objects between Containers

Putting Data Objects into Containers

Storing Data Objects

Data Object Details


Copying/moving Data Objects between Containers

You can copy Containers and Data Objects from one Container and paste them into another Container using Edit | Cut/Copy/Paste in the standard Windows™ Clipboard.

You can also "drag-and-drop" Containers and Data Objects between Containers.

•	Using the left mouse button to drag will move the Container/Data Object to its new location.  (Control + Left Mouse Button will copy.)

•	Using the right mouse button will give you a choice of moving or copying.

NOTE:	"Drag-and-drop" is faster for copying, but the Clipboard can be pasted between multiple Container Manager applications.

CAUTION

Keep your Container full names less than 128 characters.  Complex Container structures may crash the Server.


Putting Data Objects into Containers

You can import an existing file as a Data Object into a Container.

1.	Select the "Sample:Test:" Container that was created in Section Creating a new Container.

2.	Choose Media | Import or use the Import icon on the toolbar.

The Data Object will be created in the "Sample:Test:" Container.


Storing Data Objects

Data Objects can be exported from their Containers into a file.

1.	Select a Data Object in a Container.

2.	Choose Media | Export or use the Export icon on the toolbar.

3.	Select a filename, and choose OK.


Data Object Details

If you are viewing the data objects in a Container in List View and you want to see the details of one particular data object, you can:

1.	Select the Data Object

2.	Press Alt-Enter

This will show you the details for the selected object.

NOTE:	If you have a large number of Data Objects (i.e., greater than 100) this method will be quicker than switching to Details View, which will show the details of all Data Objects.


Container Backup and Restore

Backup

Restore


Backup

To store all the contents of a Container into a file:

1.	Select the Container

2.	Choose Media | Backup.

3.	Select the file in which the backup should be stored.


Restore

To restore the contents of a Container from a file:

1.	Select the Container to which you want to restore information.

2.	Choose Media | Restore.

3.	Select the file to restore.


View Options

You can view the Containers and Data Objects at various levels of information.

From the View Menu (or the toolbar) you can choose from:

•	Large icon view

•	Small icon view

•	List view

•	Detail view

You can also sort the Data Objects within Containers by

•	Name

•	Type

•	Size

•	Date Created/Modified


North American Sales

1-800-755-4444 or 201-993-3030

fax:  201-631-9631


Corporate Headquarters

1515 Route 10

Parsippany, NJ 07054-4596

USA

201-993-3000

fax: 201-993-3093


Northeastern US

70 Walnut Street

Wellesley, MA 02181


Southeastern US

1040 Crown Pointe Pkwy.

Suite 360

Atlanta, GA 30338


Central US

3307 Northland Drive

Suite 300

Austin, TX 78731


Western US

1314 Chesapeake Terrace

Sunnyvale, CA 94089


Northwestern US

19125 North Creek Parkway #120

Bothell, WA 98011


GammaLink Division

1314 Chesapeake Terrace

Sunnyvale, CA 94089


Computer-Telephone Division

100 Unicorn Park Drive

Woburn, MA 01801


Spectron Microsystems Division

315 Bollay Drive

Santa Barbara, CA 93117

805-968-5100

fax: 805-968-9770


Dialogic On-Line
Information Retrieval System
(fax-on-demand)

1-800-755-5599 or 201-993-1063


GammaLink Fax-on-Demand

408-734-9906


computer telephony BBS

(ctBBS)

201-993-0864


CTI@Dialogic WWW Site

http://www.dialogic.com


Dialogic Sales Internet

sales@dialogic.com


Canada

Dialogic Corporation

1033 Oak Meadow Road

Oakville, Ontario

L6M 1J6

Canada


Latin America & Caribbean

Dialogic Latin America and Caribbean

Av. R. S. Peña

730   3º Piso

Oficina 34

(1035) Buenos Aires, Argentina

541-328-1531 or -9943

fax: 541-328-5425


European Headquarters
(serving Europe,
Middle East, & Africa)

Dialogic Telecom Europe N.V.-S.A.

Airway Park

Lozenberg 23

Building D, 3rd floor

B-1932 Sint Stevens Woluwe

Belgium

32-2-712-4311

fax : 32-2-712-4300


DTE On-Line Information Retrieval System

32-2-712-4322


DTE BBS

32-2-725-7846


Germany, Switzerland, & Austria

Dialogic Telecom Deutschland GmbH

Industriestrasse 1

D82110 Munich

Germany

49-89-894-362-0

fax: 49-89-894-362-77


France

Dialogic Telecom France S.r.l.

42, Avenue Montaigne

F-75008

Paris

France

33-1-53-67-52-80

fax: 33-1-53-67-52-79


Italy

Dialogic Telecom Italy S.a.r.l.

Strada Pavese, 1/3

I-20089 Rozzano

Milan

Italy

39-2-575-54302

fax: 39-2-575-54310


United Kingdom, Ireland, &
Scandinavian Countries

Dialogic Telecom U.K. Ltd.

Dialogic House

Dairy Walk

Hartley Wintney

Hampshire

RG27 8XX

United Kingdom

44-1252-844000

fax: 44-1252-844525


People's Republic of China, Hong Kong, Macau, and Taiwan

Dialogic Corporation

8 North Dongsanhuan Road

Landmark Building, Room 1308

Chaoyang District

Beijing 100004

China

86-10-504-5364

fax:  86-10-506-7989


Japan & Korea

Dialogic Systems K.K.

Suntowers Center

Building 18F

2-11-22 Sangenjaya

Setagayaku, Tokyo 154

Japan

81-3-5430-3252

fax: 81-3-5430-3373


East Asia, Southeast Asia, West Asia, & Australia

Dialogic SEA Pte. Ltd.

150 Beach Road

#17-08 Gateway West Bldg.

Singapore 189720

65-298-8208

fax: 65-298-1820


DSEA BBS

65-291-3249


New Zealand

Dialogic (N.Z.) Ltd.

Level 6

Tower 2

Shortland Towers

55-63 Shortland Street

Auckland

New Zealand

64-9-366-1133

fax: 64-9-302-1793


Copyright notice

© Dialogic Corporation, 1998

This document is copyrighted and all rights are reserved by Dialogic. This document may not, in whole or in part, be reduced, reproduced, stored in a retrieval system, translated, or transmitted in any form or by any means, electronic or mechanical, without the express written consent of Dialogic. The contents of this document are subject to change without notice.  Every effort has been made to ensure the accuracy of this document.  However, due to ongoing Product improvements and revisions, Dialogic cannot guarantee the accuracy of printed material after the date of publication nor can it accept responsibility for errors or omissions.  Dialogic will publish updates and revisions to this document as needed.

The software referred to in this document is provided under a Software License Agreement.  Refer to the Software License Agreement for complete details governing the use of the software.


Trademarks

DIALOGIC ® is a registered trademark of Dialogic Corporation. D/41E, CT Media and CT Server are trademarks of Dialogic Corporation.
Windows NT and Notepad are registered trademarks of Microsoft Corporation.
Intel is a registered trademark of Intel Corporation.

Publication Date: February, 1998

Open Switch

Dialogic (NZ)


Glossary

 ACT

 ADSI

 AIA

 AnswerDemo

 Application

 Application Context Token

 Application Interface Adapter

 Application Profile

 Application Service Block

 Application Service ID

 ASI

 asynchronous mode

 Attribute

 Call Routing

 Catch tag

 Client/Server Link

 Completion Event

 Computer Telephony Media Services

 Computer Telephony Media Services SDK

 Computer Telephony Server

 Container

 CT Server Database

 CT Server

 CT Media SDK

 CTtranInfo

 Data Object

 DTMF

 Event

 Event handler

 Event queue

 first party call control

 glare

 Group

 Group handoff

 Group Information

 Group owner

 Group return

 Group Set Block

 Key

 Key Value Pair

 Key Value Set

 KVPair

 KVSet

 Object

 Parameter

 Phone address

 Primary Resource

 profile

 RAS

 Replaceable Service Provider

 Resource Allocation Service

 Resource

 Resource Attribute

 Resource Parameter

 Resource Profile

 Resources Template

 routing rules

 RTC

 runtime control

 SCR

 SCR Application Profile

 SCR Profile

 secondary Resource

 Session

 Symbol

 synchronous mode

 System Call Router

 Telephony Service Provider

third-party call control

 Time Varying Media

 TranInfo

 TTS

 TVM

 Unsolicited Event


 ACT

Application Context Token - This is a KVPair, the value of which is user-defined, which is included in Event information.  There is a Session ACT, which is a standard KVPair in all Events, and there is a Group ACT, which can be attached by specifying the ACT when calling some of the Group API functions.


 ADSI

(Analog Display Services Interface) A Bellcore standard defining protocol on the flow of information between something (e.g., a switch, a server) and a subscriber's telephone, PC, or other communicating device with a screen.


 AIA

Application Interface Adapter - This is the interface and translation layer between the CT Media APIs and the CT Server.


 AnswerDemo

A sample application supplied with the CT Media SDK.  This application simulates the behavior of a simple answering machine.


 Application

A software program designed to perform a certain function.


 Application Context Token

See ACT.


 Application Interface Adapter

See AIA.


 Application Profile

A file to be created by the application developer which contains application configuration information. This profile will usually be supplied in text format.  Application profiles must be added to the CT Server before the application is started.  When these profiles are added, they are automatically parsed into a format which is readable by the CT Server.


 Application Service Block

The section of the Application Profile which specifies the call routing requirements of the application.  This information is used by the SCR for call routing.


 Application Service ID

See ASI.


 ASI

A CT Media-standard or user-defined string to identify an Application's services for Group handoff purposes.  The ASI is defined in the Application Service Template in the Application Profile.


 asynchronous mode

Interrupted functionality.  An application calling a function in asynchronous mode can call other functions before the first function completes.  Termination information on functions which are called asynchronously can be returned to the application via a handler function.  Alternatively, the application can poll for the termination events.


 Attribute

(or Resource Attribute) is a feature or capability of a CT Media Resource.  Specific Attributes can be requested when defining Resource requirements in the Application Profile.


 Call Routing

This can mean any of the following 1. Directing an inbound telephone call to a particular application. 2. Directing an outbound call from an application to a particular line on the telephone network. 3. Passing a call from one application to another.


 Catch tag

A user-defined identifier used in call handoff and return between cooperating applications.


 Client/Server Link

The communications path established between the client machine and the CT Server.


 Completion Event

This is an Event which is the direct result of an API function call.  Most commonly, this is a completion Event for a function which has been called asynchronously.  The completion Event for an asynchronous function will contain the same information as the TranInfo structure does for the same function called synchronously.


 Computer Telephony Media Services

(CT Media) - Dialogic's S.100 based computer telephony server product.


 Computer Telephony Media Services SDK

See CT Media SDK.


 Computer Telephony Server

See CT Server.


 Container

A logical vessel holding one or more Data Objects.  Analogous to a file system or directory.


 CT Server Database

Configuration information stored on the CT Server. Includes Service configuration information, and board and resource profiles.


 CT Server

Dialogic's software platform for running Computer Telephony Applications in a client-server environment. The Dialogic CT Server enables the development of computer telephony applications and core signal processing technologies, such as speech recognition and audio compression, in an object oriented, client-server environment.


 CT Media SDK

Dialogic's Software Development Kit for developing S.100-compliant applications and resources.


 CTtranInfo

This is a defined structure for encapsulating Event information for presentation to an application.  The standard Event information is extracted from its KVSet and made more accessible through the CTtranInfo structure.  See also TranInfo.


 Data Object

A Data Object consists of TVM data and a set of attributes (which describes the properties of the data).  Data Objects reside in Containers, in a manner analogous to a file within a file system or directory.


 DTMF

(Dual Tone Multi Frequency) Telephony term for tone dialing as opposed to rotary dialing.


 Event

A special type of message used to notify the application of a noteworthy occurrence.  Event information is delivered to and from the CT Server in a Key Value Set (KVSet), and is packaged into a CTtranInfo structure for presentation to applications.


 Event handler

Part of application code which handles received unsolicited Events.


 Event queue

Each application's Session has an Event queue where received Events wait to be processed.


 first party call control

The situation where an application issues call control commands while being a party in the "conversation."


 glare

Going offhook to make an outbound call, but instead of dial tone, there is an inbound call.


 Group

A logical collection of Resources.  CT Media Resources can only be accessed indirectly through the Group which contains them.


 Group handoff

The process which occurs when an application is finished with a Group and specifically directs the Group to another application.


 Group Information

This is a KVSet with specific information about a Group.  The KVPairs in the Group Information KVSet are entirely user-defined.


 Group owner

The owner of a Group is the Application (or Application's Session) who has control of the Group.   The original owner of a Group is the Session which created the Group.  The ownership will change if the Group is transferred, returned, or handed off.


 Group return

The process which occurs when an application is finished with a Group and allows it to return to another application (determined by the previous flow of control of this Group).


 Group Set Block

The section of the Application Profile which specifies the grouping of Resources required by the application.  This information is used by the SCR when the application requests a Group.


 Key

The identification portion of a Key Value Pair.  A Key is always a CTsymbol.


 Key Value Pair

See KVPair.


 Key Value Set

See KVSet.


 KVPair

A data structure consisting of a key and an associated value; similar to a variable.


 KVSet

A data structure consisting of an unordered list of Key Value Pairs.


 Object

In terms of CT Media and Object-Oriented Programming, an Object is one of the various "services" which is accessed using the CT Server.  This includes the System Services (e.g., Session) and the Resources (e.g., Player).  Thus, a CTsymbol is of format Object_VENDOR_Item, where Object is as defined here.


 Parameter

(or Resource Parameter)  This is a defined KVPair, the value of which may either be read to find out information about a Resource, or altered to modify the behavior of a Resource.


 Phone address

The phone number as specified in the SCR Profile. This can be a complete or partial number, without or without wildcard characters.


 Primary Resource

The Resource in a Group which carries out the communication within the Group.  Any secondary Resources in the Group can communicate with each other only through the primary Resource, not directly to each other.  The primary Resource must be specified in the Group Set section of the Application Profile.


 profile

A file that specifies an object's configuration and requirements. Profiles exist for the System Call Router, for applications, and for resources.  Profile information is parsed and added during installation.  The CT Server uses this information during runtime.


 RAS

See Resource Allocation Service.


 Replaceable Service Provider

A Service Provider that can be added or removed from the CT Server. Usually used to support a technology-specific board, or a particular type of application. See Service Provider.


 Resource Allocation Service

The System Service which handles the allocation of Resources.


 Resource

An abstraction of the standardized interfaces of a physical device used for call processing.  For example, a Signal Generator Object is a Resource.


 Resource Attribute

See Attribute.


 Resource Parameter

See Parameter.


 Resource Profile

A file containing configuration information for a board. Resource Profiles are added to the CT Server before the service that the board provides is started.


 Resources Template

The section of the Application Profile which specifies which Resources are required by the application and how those Resources are to be configured.  This information is used by the SCR when the application requests a Group.


 routing rules

The rules, maintained by the Systems Administrator, which instruct the SCR how to direct calls to applications.


 RTC

(or runtime control) is the mechanism by which one Resource can affect the behavior of another during runtime, using defined conditions and actions.


 runtime control

See RTC.


 SCR

The System Call Router is a  System Service which provides the basic necessities of inbound and outbound call processing and call sharing to client applications, without those applications needing to worry about the underlying telephony interface operations.


 SCR Application Profile

The file that contains configuration information for mapping types of boards to inbound and outbound telephone calls.


 SCR Profile

The file that contains configuration information for mapping inbound and outbound telephone calls to applications. It also contains information for transferring calls between applications.


 secondary Resource

A Resource in a Group which is not the Primary Resource.  The secondary Resource can only communicate with the Primary Resource, not with the other secondary Resources in the Group.


 Session

A Session is a logical binding between an application and the CT Media Services.  This binding provides a context for the delivery of CT Media Services.


 Symbol

An enumerated constant used for KVSet Keys and other identifiers.  A Symbol is of type CTsymbol and in format Object_VENDOR_Item.


 synchronous mode

Uninterrupted functionality.  An application calling a function in synchronous mode will not receive control back until the function completes.


 System Call Router

See SCR


 Telephony Service Provider

(TSP)  The TSP is the piece of software that provides a call control API which the SCR uses to perform call control on a network interface device.  The TSP is capable of communicating with the actual device to pass on requests from the SCR to the device and pass back events from the device to the SCR.


third-party call control

Call control in which the controller of the call is not necessarily a party in the "conversation."


 Time Varying Media

See TVM.


 TranInfo

This is a standard argument passed with most of the CT API functions.  TranInfo is a structure of type CTtranInfo.  It is used to return information about the progress and status of the API function call.


 TTS

(Text to Speech) Conversion of textual (ASCII) information into synthetic speech output.


 TVM

TVMs are encapsulations of atomic pieces of time-varying media such as voice data.  When a CTrcdr_Record( ) is performed, the record goes into a TVM, which is stored in a Container.


 Unsolicited Event

Any Event which is not a Completion Event.  Unsolicited Events are not a direct result of a function call.