
                            READ ME

*****************************************************************************

    INTRODUCTION

*****************************************************************************

         This  diskette  contains two  separate  sets of  sample programs.

         Sample Program Set 1 is contained in sub-directory SAMPLDOS and
         includes two sample programs;  one using the NETBIOS interface and
         the other using the IEEE 802.2 (802.2) interface.  These sample 
         programs are written for use with the Disk Operating System (DOS)
         and LAN Support Program (LSP).

         Sample Program Set 2 is contained in sub-directory SAMPLOS2 and also
         includes two sample programs;  one using the NETBIOS interface and
         the other using the IEEE 802.2 (802.2) interface.  These sample
         programs are designed to run only in protected mode of OS/2 2.x with 
         ES, LS or NTS/2 for OS/2. 

         Both program sets are for demonstration purposes only and are
         intended to help programmers learn how to develop software for use
         with IBM local area network adapters.  A full description of the
         commands used with the network adapters is given in the IBM Local
         Area Network Technical Reference.

         The materials on this diskette could include technical inaccuracies,
         typographical errors, or incompatibilities with IBM products, and
         could be modified or excluded from the generally available reference
         materials.  IBM expressly reserves the right, without notice to you,
         to modify the information contained in the IBM Local Area Network
         Technical Reference in a manner that affects the compatibility or
         usability of the application programs developed by you using the
         materials on this diskette.

         INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS DISKETTE
         "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
         INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF 
         MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

         It is possible that this diskette may contain reference to, or
         information about IBM products (machines and programs), programming,
         or services that are not announced in your country.
         Such references or information must not be construed to mean that
         IBM intends to announce such IBM products, programming, or services
         in your country.

         System Administrators may copy and distribute the sample programs on
         this diskette in any form without payment to IBM, for the purpose of
         developing, using, marketing, or distributing application programs 
         that utilize the 802.2 and NetBIOS interfaces.

         Attach a label that contains the following copyright notice to each
         copy:

     Version 3.0 (C) 
     Copyright International Business Machines Corp. 1986, 1990, 1993

*****************************************************************************

    FILE DESCRIPTIONS

*****************************************************************************



 *****************    SAMPLE PROGRAM SET 1 FOR USE WITH DOS   ***************

         BUILDSAM.BAT   Batch file to build sample EXEs

         NETSAMPL.C     NETBIOS main program
         NETSAMPL.MAK   NETBIOS build file
         NCB.H          NCB structure
         NCBCMDS.H      NCB command codes
         NETERROR.H     NETBIOS error messages

         DLCSAMPL.C     DLC main program
         DLCSAMPL.MAK   DLC build file
         DLCINTF.C      802.2 interface functions
         DIRINTF.C      Direct interface functions
         APPENDS.ASM    Adapter interrupt appendages
         DLCPTBLS.H     Parameter table structures
         DLCCONST.H     802.2 and Direct command codes
         DLCERROR.H     802.2 and Direct error messages
         DLCGBLV.H      Program global declarations

         SAMPLUTL.C     Utility functions
         CODETBL.H      Code table structure


 *****************    SAMPLE PROGRAM SET 2 FOR USE WITH OS/2   **************


         NETSAMPO.C     NETBIOS main program
         NETGBLV.H      NETBIOS program global declarations
         NETERROR.H     NETBIOS error messages
         NETBIOS.DOC    The NetBIOS interface instructions
         NETB_1_C.H     LAPS header file 
         NETB_2_C.H     LAPS header file 
         NETB_4_C.H     LAPS header file 
         NETSAM16       16 bit make file for NETSAMPO
         NETSAMPO.DEF   sample program module definition file 

         DLCSAMPO.C     DLC main program
         DLCINTF.H      DLC interface commands
         DIRINTF.H      Direct interface commands
         DLCGBLV.H      Program global declarations
         DLCERROR.H     802.2 and Direct error messages
         DLCSAM16       16 bit make file for DLCSAMPO.C
         DLCSAMPO       32 bit make file for DLCSAMPO.C
         DLCSAMPO.DEF   sample program module definition file
         IEEE8022.DOC   The 802.2 interface instructions
         LAN_1_C.H      LAPS header file
         LAN_2_C.H      LAPS header file 
         LAN_3_C.H      LAPS header file 
         LAN_4_C.H      LAPS header file 
         LAN_6_C.H      LAPS header file 
         LAN_7_C.H      LAPS header file 


*****************************************************************************

