IBM Realtime Interface Co-Processor Extended Services Samples Version 1.05 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 and Configuration 5. Version History 6. Release Notes 7. Support Information 8. Notices 9. Trademark List 1. Product Specifications Overview -------- The contents of this package provide the source, include files, and executable modules for each sample program. These programs demonstrate the IBM Realtime Interface Co-Processor Extended Services. ARTIC Adapters Supported ------------------------ - IBM ARTIC X.25 PCI Adapter - IBM ARTIC X.25 ISA Adapter - IBM ARTIC186 Model II ISA/PCI Adapter - IBM ARTIC 8-Port PCI Adapter - IBM ARTIC 8-Port Adapter Software Requirements --------------------- IBM Realtime Interface Co-Processor Extended Services IBM Realtime Interface Co-Processor DOS Support IBM Realtime Interface Co-Processor OS/2 Support Latest Software Updates ----------------------- - The latest software updates can be downloaded from the Web at: http://www.pc.ibm.com/us/support/options/artic.html Related Publications -------------------- - ARTIC Extended Services User's Guide Publications can be obtained by sending an e-mail to artic@radisys.com. 2. Download the Package File to the Target System How to download "IBM Realtime Interface Co-Processor Extended Services Samples" to the target system. a. Download the self-extracting file ES105S.exe as a binary file to the working directory. b. Uncompress the package file by typing: ES105S x (where x is the temporary directory) 3. Components of the Downloaded File license.add - License Agreement license.pla - PLA License Agreement readme.1st - Read me es105s.txt - This file sample.txt - Instructions on how to load and execute the sample programs. history.fil - A history file of the IBM Realtime Interface Co-Processor Extended Services Sample Programs. mail.cfg - This configuration file is used with MAILSU and MAILPRT sample programs to configure the asynchronous communications support driver. sync.cfg - This configuration file is used with SYNCSU and SYNCPRT sample programs to configure the synchronous communications support driver. async.cfg - This configuration file is used with the RASYNC sample program to configure the asynchronous communications support driver. mailsu.c - C source code file for sample task which uses Realtime Interface Co-Processor Programming Services (RICPS) and Realtime Interface Co-Processor Communications Support (RICCS) (asynchronous). mailsu.h - Include file for MAILSU.C. Contains structures and variable definitions. mailsu.exe - Sample task executable. Must be run with MAILPRT.EXE. mailprt.c - C source code file for sample task which uses RICCS and RICPS. mailprt.h - Include file for MAILPRT.C. Contains structures and variable definitions. mailprt.exe - Sample task executable. Must be run with MAILSU.EXE. syncsu.c - C source code file for sample task which uses Realtime Interface Co-Processor Programming Services (RICPS) and Realtime Interface Co-Processor Communications Support (RICCS) (synchronous). syncsu.h - Include file for SYNCSU.C. Contains structures and variable definitions. syncsu.exe - Sample task executable. Must be run with SYNCPRT.EXE. syncprt.c - C source code file for sample task which uses RICCS and RICPS. syncprt.h - Include file for SYNCPRT.C. Contains structures and variable definitions. syncprt.exe - Sample task executable. Must be run with SYNCSU.EXE. icastruc.h - Include file for MAILPRT.C, MAILSU.C, SYNCPRT.C, and SYNCSU.C. Contains system structures and variable definitions. rasync.asm - Assembly source code for a sample task that uses RICCS only. rasync.exe - Sample task executable. inc.asm - Include file for RASYNC.ASM. Contains RICCS structures. os2async.c - C source code for the sample program that runs on the system unit. The operating system must be OS/2. This program communicates with the asynchronous sample tasks running on the co-processor adapter. os2async.exe - OS/2 system unit executable sample program. dosasync.c - C source code for the sample program that runs on the system unit. The operating system must be DOS. This program communicates with the asynchronous sample tasks running on the co-processor adapter. dosasync.exe - DOS system unit executable sample program. pcasync.h - Include file for OS2ASYNC.C and DOSASYNC.C. input.c - Source file used with DOSASYNC.C and OS2ASYNC.C for reading input. Must be linked with these programs. os2sync.c - C source code for the sample program that runs on the system unit. The operating system must be OS/2. This program communicates with the synchronous sample tasks running on the co-processor adapter. os2sync.exe - OS/2 system unit executable sample program. dossync.c - C source code for the sample program that runs on the system unit. The operating system must be DOS. This program communicates with the synchronous sample tasks running on the co-processor adapter. dossync.exe - DOS system unit executable sample program. pcsync.h - Include file for OS2SYNC.C and DOSSYNC.C. sinput.c - Source file used with DOSSYNC.C and OS2SYNC.C for reading input. Must be linked with these programs. 4. Product Installation and Configuration You do not have to install the sample programs. If you choose to install the samples, create a separate directory and copy the sample program files to it. 5. Version History 1.05 ---- Updated es105s.txt file. 6. Release Notes Not Applicable 7. 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. 8. 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. 9. 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)