Release Notes
211-064-04
September 2007


                Frame Relay development information


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

These Release Notes provide information for developers wanting to use
Eiconcard(r) products and the Frame Relay protocol.

These Release Notes are organized as follows:

o Operating Systems
o Specs/Ref
o Configuration
o Samples


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

The Eiconcard products and services offer support for the Frame
Relay protocol on the following operating systems:

-Win32	(Windows(r) 2000 , XP (32 and 64 bit), 2003 (32 and 64 bit) )
-Linux  (See distributions supported in the Connections for Linux Software Package)


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

To be able to write a Frame Relay application to interface with the Eiconcard,
the following Dialogic Corporation documents are needed:

-Frame Relay Interface Software	  204-018
-Using the NCB Interface          204-014

The Frame Relay Interface software can be found in the Specs
directory of the FRELAY section of the Eiconcard Development Suite CD.

NOTE: Contact Dialogic's 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 the Developer Support Group. The
      document will only be sent if and when the Non-Disclosure
      Agreement Form is completed.

             Dialogic 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

Linux: ncb_unix.h and libEec.a
       (libEec.a is installed on the system when installing
       Eiconcard Connections for Linux)



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

To be able to use the Frame Relay 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 Frame Relay
protocol and configure the required DLCI settings.


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

Included in the FRelay section of the Eiconcard Development Suite are
some sample applications that show the usage of the NCB and Frame Relay
interface for the Linux, and Win32/64 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. --


Linux: The name of the sample is Frchat. It is a simple chat program that
       uses Frame Relay to connect, send, and receive messages. WAIT mode
       is used as a completion method; a blocking mode that waits
       for the request to be completed.

       To be able to compile and test this sample, the corresponding
       directory and its contents need to be copied on the system. It is
       also necessary that Eiconcard Connections for Linux be installed
       on the system. This will make sure that the needed library file is
       present on the system.
       The included makefile is formatted in such a way that it will find
       and use the proper source code, header, and library files.
       
       Untar frelay.tar in the root directory (/) of your system to ensure
       the header files and samples are placed in their default locations.
       The frelay.tar file contains only relative paths.  If you prefer,
       it may be extracted in a subdirectory of your choice.
       In this case you will have to modify the makefile include and library
       paths in order to compile the samples.

Windows: The name of the samples are FRchat and FrMchat.

       FRchat is a chat program that uses Frame Relay to connect, send,
       and receive messages. NOWAIT mode with manual polling is used as
       a completion method.

       FrMchat is a sample that allows user to establish multiple Frame
       Relay connections and exchange data. DLCI and port values are
       used to establish and poll the different connections. NOWAIT mode
       with manual polling is used as a completion method.

       To be able to compile and test the FRchat and FrMchat samples,
       the Frame Relay\Win32 directory needs to be copied, in its entirety, to the
       system. The Common directory should also be copied to the same location
       The projects of each sample were built using Microsoft
       Visual C++ 6.0 (Microsoft Developer Studio Project - *.dsp).
       The project settings are defined to use relative paths as
       formatted by the Frame Relay\Win32 directory structure.
       
       For example, if using a working directory named FR_Dev, the resulting
       directory layout should be the following:
       
       \FR_Dev\Common
       \FR_Dev\Frame Relay\Win32
       
       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-064-04 #########################################

Copyright (c) 1998-2007 Dialogic Corporation