Readme Notes 211-068-04 September 2007 Eiconcard X.25 Development Tools for Windows Introduction ========================================================================== These Readme Notes provide the latest information for developers wishing to use Eiconcard(r) products and the X.25 protocol, on a Windows operating system (Windows(r) 2000 , XP/2003 (32 and 64 bit) ). These Readme Notes are organized as follows: o Installation o Compiler support o Specific to Win32 o Known limitations o Samples Installation ========================================================================== The X.25 toolkit DLL ( Ex25.dll ) is now included in the Connections for Windows package. No separate DLL installation is required or recommended. The library and include files (see below) as well as the X25\Win32 subdirectory can be copied in a subdirectory of your choice on the target system. In order to ensure that the samples compile without changes, the relative directory relationship must be maintained. For example, if you want to setup your X25 development environment in a subdirectory named X25Development, the following layout should be created: \X25Development\Common\Include \X25Development\Common\Lib \X25Development\X25\Win32 Compiler support ========================================================================== The Eiconcard X.25 Development Tools for Windows supports the Microsoft Visual C++ 6.0 and up compilers, including 64 bit support where available. Specific to Windows ========================================================================== A programmer's reference guide (Ex25.chm), for function description and other specific development information, can be found in the X25\Help\Winhelp folder on the Eiconcard Development Suite CD. The guide is an on-line help file with reference information for the Eiconcard X.25 Development Tools package and its usage. It is also available as an HTML help file (index.htm) under X25\Help\HTML. It is also strongly recommended for new developers to refer to the Getting Started section of the Ex25.chm on-line help. This part of the Readme Notes has some specific information for Windows development that may not be found in the above mentioned documentation. This information is very important and should be read. This section is organized as follows: -Library files -Include files -Compilation Definition Library files ------------- From the root of the CD, the folder Common\Lib, will contain the libraries for the Microsoft compiler. File Directory ex25.lib The main X.25 toolkit library ex25_64.lib 64-bit version of the X.25 toolkit library ecncb.lib The NCB library that is used by the toolkit library ecncb_64.lib 64-bit version of the NCB library Include files ------------- Include files are contained in the \Common\Include folder. File Description: X25.H Include file defining the variable structures X25ERR.H Include file defining X.25 error messages X25PROTO.H Include file defining prototype for each function NETERR.H Include file defining network error messages ECNCB.H Include file for the NCB programming interface Compilation Definitions ----------------------- When compiling an application, the /DEC_WIN32 option must be used. This will activate the appropriate #defines for the Win32 environment. Known limitations ========================================================================== The X25 development tools do not support running 32 bit programs on 64-bit platforms. If using a 64-bit Windows platform, use of the 64-bit version of Connections for Windows is required and compilation of your X.25 application for 64-bit is also required. When running an application, developed with the Eiconcard X.25 Development Tools for Win32, on a workstation using the Eiconcard LAN Client (32 Bit), the X.25 library APIs can return the following return code, 82h. This error code is not documented in the on-line help and is not mapped to a string in the X.25 library. Description: error code 82h (ENET_ECLAN_BUSY) Error code 82h (ENET_ECLAN_BUSY) is returned by one of the X.25 library functions when the Eiconcard LAN Client software is busy trying to establish a first session (issuing x25xcall, x25xlisten, x25gatewcall, or x25gatewlisten) to the server and it tries to submit another request (x25xcall, x25xlisten, x25gatewcall, or x25gatewlisten) to that server. Solution: The request needs to be resubmitted. Resubmitting the request after a small delay will give time for the Eiconcard LAN Client software to find the server and then accept any request. Samples ========================================================================== Included in the x25\Win32\Samples folders, are some sample applications that show the usage of the X.25 library for the Windows platform. This folder has a set of the sample source code and their correponding projects. The samples can be compiled for 64 bit platforms by importing the project files into a 64 bit development environment and using the 64 bit versions of the libraries. 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. -- Multithreaded sample applications --------------------------------- ..\Filetrsf Multithreaded application, shows usage of NOWAIT mode using polling ..\FileTxfr Multithreaded C++ application, shows usage of NOWAIT mode using post routine and the xi_ref pointer ..\Posttrsf Multithreaded application, shows usage of NOWAIT mode using post routine and the xi_ref pointer ..\Thrchat Multithreaded application, shows usage of NOWAIT mode using post routine PVC sample applications ----------------------- ..\Pvcpoll Shows usage of PVC and NOWAIT mode using polling ..\Pvcpost Shows usage of PVC and NOWAIT mode using post routine Other sample applications ------------------------- ..\Inpost Shows usage of NOWAIT mode using post routine X.25 function application tool (32 bit EXE file only) ---------------------------------------------- ..\X25utils Demonstrates the usage of some of the more important functions of the X.25 library. All request that are submitted to the Eiconcard are in NOWAIT mode using polling (the polling with x25done() is manually done by the user). This application can be used to reproduce scenarios/situations that can be encountered during the development of an application. Eiconcard Tester application (32 bit EXE file only) ---------------------------- ..\ECTester Checks if your Eiconcard is correctly installed and configured, by allowing the user to perform 3 different tests. - Test the connection to an X.25 network - Test a back-to-back X.25 connection - Test the HDLC link level for a specific port ############## End of 211-068-04 ######################################### Copyright (c) 1998-2007 Dialogic Corporation