Readme
211-159-02
September 2007



                 Eiconcard SNA Development Tools
          


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

This Readme provides information for developers wanting to use
Dialogic Corporation Eiconcard(r) products and the SNA protocols.



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

The Dialogic Corporation Eiconcard products and services offer support on
the following operating systems:

-Win32	Windows(r) 2000/XP/2003 (32 bit systems only)




New Return Codes
==========================================================================
The following new return codes are defined in the file snarc.h

#define RC2_ECLAN_CLIENT_NOT_READY  0x0270 // ECLAN client has not 
                                           // completed its initialization
                                              
#define R2C_ECLAN_SERVER_NOT_READY  0x0271 // ECLAN server is not 
                                           // responding (down or 
                                           // LAN problem)

#define RC2_ECLAN_SERVER_NOT_FOUND  0x0272 // ECLAN server is not defined 
                                           // in the configurator
                                           
#define RC2_ECLAN_CLIENT_BUSY       0x0282 // ECLAN is busy executing 
                                           // Attach. Subsequent Attach 
                                           // should retry
                                           
The following return codes are commented from the file snarc.h.

//#define RC2_NOT_SUSPENDED         0x0001 // Resume (no longer applicable)
//#define RC2_NUMLU_OUT_OF_RANGE    0x0001 // (no longer applicable)
//#define RC2_NO_TIMER_AVAILABLE    0x0004 // (no longer applicable)
//#define RC2_INITIALIZE_TABLE_FULL 0x0005 // (no longer applicable)


Win32 Support
==========================================================================

Installation
------------
The Eiconcard SNA Development Tools for Win32 can be copied manually
by following the steps below:

1. From the root of your hard disk create the new folder structure 
\Eiconcards\Devtools\Sna.

2. From the Eiconcard Development Suite CD, copy the entire contents of 
the Sna 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. The Eiconcard SNA Development Tools User's Guide (Sna\SnaDevTools.pdf) 
can also be copied to the folder created in step 1.  

4. Copy the Esna.dll from C:\Eiconcards\Devtools\Sna\Dll to the System32 
folder for Windows 2000/XP/2003.


Known Problems
--------------
The Eiconcard SNA Development Tools behaves unpredictibly if the numlu 
parameter to the SnaInitialize2 is set to zero. Make sure to correctly 
specify the required number of LU.


Inconsistent Behavior
---------------------
While serving a blocking synchronous verb, Eicon ECLAN client executes the
Windows API GetMessage() and DispatchMessage() in a loop. Therefore, an 
application calling a synchronous Development Tools verb may be blocking 
and still receive Windows messages if executed from a LAN workstation 
running ECLAN client. However, the same application will not receive 
Windows messages when executing on a standalone Eiconcard Gateway.



############### 211-159-02 ###############################################

Copyright(c) 2007 Dialogic Corporation