Readme
211-158-02
September 2007



              Transport Development Information


Introduction
==========================================================================

This Readme provides information for developers wishing to use
Dialogic EiconCard products and the Transport protocol.

These Release Notes are organized as follows:

o Operating Systems
o Specs/Ref
o Installation
o Configuration
o Samples


Operating Systems
==========================================================================

The Eicon Networks products and services offer support for the Transport
protocol on the following operating systems:

-Windows 2000,  XP/2003 (32 and 64 bit)



Specs/Ref
==========================================================================

To be able to write an Transport application to interface to the 
Eiconcard(r) the following Eiconcard documents are needed:

-Transport Interface Software	204-013
-Using the NCB Interface	204-014

NOTE:	Contact Eiconcard Developer Support Group to be able to get the
        Using the NCB Interface documentation. At that time a
        Non-Disclosure Agreement form will be sent. The form will have to
        be completed and send back to Dialogic Corporation. The document will
        only be sent if and when the Non-Disclosure Agreement Form is 
        completed.

		Eiconcard Developer Support Group
		Email: devsup@dialogic.com

*** IMPORTANT DEVELOPMENT INFORMATION ***
When developing an application using the NCB interface, the project needs
to include the proper header file and link to the corresponding library
file (please refer to the samples).

NCB Header and Library files:

Windows: ecncb.h and ecncb.lib or ecncb_64.lib



Installation
==========================================================================

The Transport Interface software is copied manually by following the steps below:

1. From the root of your hard disk create the new folder stucture
\Eiconcards\Devtools\Transport.

2. From the Eiconcard Development Suite CD, copy the Transport\Win32 folder to the
folder created in Step 1. The subdirectory structure should not be modified.
If changes are made, the samples may not build correctly.

3. From the Eiconcard Development Suite CD, copy the Common folder to the 
\Eiconcards\Devtools folder. The resulting folder structure should look like
the following:

\Eiconcards\Devtools\Transport\Win32
\Eiconcards\Devtools\Common

4. The Transport Interface Specification (Transport\transport.pdf) can
also be copied to the folder created in step 1.



Configuration
==========================================================================

To be able to use the Transport protocol and interface with the Eiconcard, 
the Eiconcard needs to be configured with the help of the configuration
program that comes with the gateway. Select the Transport protocol under 
the "High-Level Protocol" configuration section of the Eiconcard.



Samples
==========================================================================

Included in the Transport section of the Eiconcard Development Suite are 
some sample applications that show the usage of the NCB and Transport 
interface for the Windows platform.

These sample applications are for testing purposes only and
should not be used in a production environment.

-- It is strongly recommended to look at the sample source code and read 
the comments before using them. --


Windows: The name of the sample is Xportchat. It is a chat program that uses
       Transport frames to connect, send, and receive messages. NOWAIT 
       mode with manual polling is used as a completion method.

       To be able to compile and test the Xportchat sample, the above
       setup guidelines should be followed.  
       The sample was written and built using Microsoft 
       Visual C++ 6.0 (Microsoft Developer Studio Project - 
       xportchat.dsp). The project settings are defined to use relative 
       paths as formatted by the Samples directory structure.

       Specific project files for 64-bit environments are not provided.  In order
       to compile the samples for a 64-bit environment, in addition to the above,
       complete the following steps:
       
       Open the project file and modify the project settings to create a new 64 bit
       configuration and select the 64-bit platform.  
       
       Remove the ecncb.lib library from the project and add the ecncb_64.lib library.

############## End of 211-158-02 #########################################

Copyright (c) 2007 Dialogic Corporation