IBM ARTIC Support for X.25 on Windows NT and Windows 98 Version 1.4.1 Table of Contents ---------------------- 1. Product Specifications - Overview - ARTIC Adapters Supported - Software Requirements - Latest Software Updates - Related Publications 2. Download the Package File to the Target System 3. Components of the downloaded file: 4. Product Installation 5. Version History 6. Support Information 7. Notices 8. Trademark List 1. Product Specifications Overview -------- Using the IBM ARTIC Support for X.25 on Windows NT and Windows 98 (hereafter referred to as X.25 Support), users of the following Microsoft Windows products can write applications that use the OS/2 Communications Manager X.25 Application Program Interface (API). The API is implemented as a Dynamic Link Library (DLL) and Windows NT Service. - Windows NT Workstation/Server Version 4.0, with Service Pack 3 or later - Windows 98, Version 1.0 or later The X.25 Support provides the use of the following X.25 API calls. - X25APPINIT - X25APPTERM - X25CALL - X25CALLCLEAR - X25DATARECEIVE - X25DATASEND - X25EVENT - X25LINKSTATUS - X25PVCALLOC - X25PVCFREE - X25RESETCONFIRM - X25SEMCLEAR - X25VCSTATUS - X25CALLACCEPT - X25CALLRECEIVE - X25DEAFEN - X25LISTEN - X25NAME For details of the X.25 API calls, see the Communications Manager/2 X.25 Programming Reference (part of the Communications Manager/2 Version 1.11 Online Product Library). ARTIC Adapters Supported ------------------------ The X.25 Support runs on any of the following adapters. - IBM ARTIC X.25 ISA Adapter - IBM ARTIC X.25 PCI Adapter - IBM ARTIC186 8-Port ISA Adapter (one port of V.24 at 19.2 kbps) - IBM ARTIC186 8-Port PCI Adapter (one port of V.24 at 19.2 kbps) The X.25 adapters support the following three electrical interfaces: - X.21 - X.21/bis (V.35) - X.21/bis (V.24) Software Requirements --------------------- Windows NT: - Microsoft Windows NT Workstation/Server Version 4.0, with Service Pack 3 or later Windows 98: - Microsoft Windows 98, Version 1.0 or later The X.25 Support has been tested using the following C compilers: - Microsoft Visual C++ - IBM VisualAge C++ Latest Software Updates ----------------------- - The latest software updates can be downloaded from the Web at: http://www.radisys.com/products/artic/ibm/ Related Publications -------------------- - Communications Manager/2 X.25 Programming Reference (part of the Communications Manager/2 Version 1.11 Online Product Library) 2. Download the Package File to the Target System a: Download the self-extracting file x25141w.exe to a temporary directory. b: Unpack the file by typing: x25141w . /D 3. Components of the Downloaded File license.add License information license.pla Program License Agreement x25141w.txt This file X25INST.EXE Installation executable file ICAX25.DLL X.25 DLL that interfaces to the X.25 service ICAX25.EXE X.25 service that provides the X.25 function ICAX25.LIB API link library X25CONF.EXE Configuration utility GQKENGLI.TXT Text/message file PROTOCOL.DEF Default protocol file for X25A.EXE X25A.EXE Adapter X.25 microcode X25NT_C.H Include file for application development X25READ.ME Technical notes and release information DEFAULT.PRF Default Link Profile ICAX25.INF Windows NT Workstation or Server X.25 INF file ICAX2598.INF Windows 98 X.25 INF file Device Driver Files ------------------- README.1ST Read me first for License Agreement Information LICENSE.ADD License Agreement LICENSE.PLA Program License Agreement RWNT150W.TXT Product information IWNT150W.TXT Installation instructions WNT150W.EXE Compressed installation set of files SETUP.EXE Installation program ARTIC.INF Registry installation file (do not modify this file) ICARICIO.SYS Device driver ICAERROR.H Include file for error codes ICACLIB.H Include file for user-level C library ICAIOCTL.H Include file for IOCTL support README.TXT Contains product information and history ICAAIM.COM Realtime Control Microcode (1.5x) ICARCM.COM Realtime Control Microcode (2.x) ICACLIB.DLL User-level runtime DLL ICACLIB.LIB User-level development library ICADISP.EXE Display Utility ICALDRIC.EXE Loader Utility ICALDRIC.MSG Loader Utility's message file ICADPRIC.EXE Online Dump Utility ICADPRIC.MSG Online Dump Utility's message file FRMTDUMP.EXE Dump Formatter Utility FRMTDUMP.MSG Dump Formatter Utility's message file FRMTDUMP.PRO Dump Formatter Utility's profile ICADIAGN.EXE ARTIC186 co-processor adapter diagnostics MULT.COM Diagnostic task GALE.COM Diagnostic task ICADIAG.TXT Diagnostic information 4. Product Installation Read the X25READ.ME file for release notes and technical guidelines for assistance in writing X.25 applications. Execute the X25INST.EXE file to install the X.25 Support. 5. Version History 1.4.1 This version of the X.25 Support includes: - Fix for connection ID not being released after outgoing call is cleared 1.4.0 This version of the X.25 Support includes: - Additional Copyright Information - The following fixes -- Fix for incorrect handling of odd length in incoming call packets -- Fix for X25SemClear not clearing delayed linkstatus verbs correctly -- Link Initiator fix for countries requiring a DCE initiator -- PVC packet sizes greater than 128 now handled correctly -- Unattended install for Windows 98 users -- Fix for configuring more than 1 PVC per link with new X25conf utility 1.3.0 This version of the X.25 Support includes: - Support for Windows 98 - Configuration Support for V.25bis 1.2.0 This version of the X.25 Support includes: - Support for incoming X.25 SVCs (switched virtual circuits) - M, D and Q bit support on X25DATARECEIVE and X25DATASEND - V.25bis link support -- Fix for bad return code (98) when issuing X25APPINIT -- Fix for X25LINKCONNECT hang -- Fix for cause code > 0x80 accepted on 1984 networks 6. Support Information IBM ARTIC Technical Support Desk (USA and Canada): call 1-800-237-5511 and at the Voice Response Unit enter "0" (ignore all other options). IBM ARTIC Technical Support Desk for all other locations, call your IBM country specialists. 7. Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. 8. Trademark List The following terms are trademarks of the IBM Corporation in the United States or other countries, or both: IBM Micro Channel PS/2 Personal System/2 OS/2 Operating System/2 AIX RISC System/6000 C Set ++ Macro Assembler/2 Portmaster Proprinter IBM VisualAge C++ Other company, product, and service names may be trademarks or service marks of others. C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. PC Direct is a trademark of Ziff Communications Company in the United States, other countries, or both and is used by IBM Corporation under license. ActionMedia, LANDesk, MMX, Pentium, and ProShare are trademarks of Intel Corporation in the United States, other countries, or both. (For a complete list of Intel trademarks, see www.intel.com/tradmarx.htm) UNIX is a registered trademark in the United States, other countries, or both and is licensed exclusively through X/Open Company Limited. SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. (For further information, see www.setco.org/aboutmark.html)