home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / PROGRAM / PCL4C30.ZIP / PCL4C.DOC < prev    next >
Text File  |  1992-01-20  |  6KB  |  115 lines
  1.                         *** SHAREWARE DOCUMENTATION ***
  2.  
  3.  
  4.        The  Personal  Communications Library for the C Language ( PCL4C )
  5.        is an asynchronous communications library designed for experienced
  6.        software   developers   programming  in  C.   Four  compilers  are
  7.        supported: Microsoft Optimizing  C,  Microsoft  Quick  C,  Borland
  8.        Turbo  C,  and  MIX  Power  C.   An  IBM PC/XT/AT or compatible is
  9.        required.  The Personal Communications Library takes less than  4K
  10.        bytes and features:
  11.  
  12.           o  SMALL, COMPACT, MEDIUM & LARGE memory models.
  13.           o  30 communication and support functions.
  14.           o  Interrupt driven receiver.
  15.           o  Supports 300 baud to 115,200 baud.
  16.           o  Supports COM1, COM2, COM3, and COM4.
  17.           o  Adjustable receive queues from 8 bytes to 16 KB.
  18.           o  Control-BREAK error exit.
  19.           o  13 communication error conditions trapped.
  20.           o  Allows 2 ports to run concurrently.
  21.           o  Complete modem control & status.
  22.           o  Written in assembly language for small size & high speed.
  23.  
  24.        Eight  example  programs  (  source code ) are provided along with
  25.        the small model library and makefiles for each  of  the  supported
  26.        compilers.  The example programs are:
  27.  
  28.        (1)  SIMPLE  is an extremely simple terminal emulator program.  It
  29.        is provided as the smallest and easiest to understand  example  of
  30.        communications programming using PCL4C.
  31.  
  32.        (2)  INTERCOM  is just slightly more complex than SIMPLE.  Hook up
  33.        two computers via modem or a null modem cable.   INTERCOM  divides
  34.        the  screen horizontally into two areas.  Whatever is typed on one
  35.        machine is displayed in the top half of the screen and  sent  over
  36.        to  the  other  computer. Whatever is received is displayed in the
  37.        lower half of the screen.
  38.  
  39.        (3) MODEM displays the modem status lines (DSR, CTS, DCD, and  RI)
  40.        and the modem control lines (DTR and RTS). Additionally, it allows
  41.        the  user to set or clear the modem control lines. MODEM is useful
  42.        when testing RS232 cable connections.
  43.  
  44.        (4)  NORESET  is  designed  to  "take  over"   a   port   from   a
  45.        communications  program  which  has a DOS gateway.  This is useful
  46.        for implementing external protocols or similar uses.
  47.  
  48.        (5)  TERM  is  a  more  capable terminal emulator than SIMPLE.  It
  49.        functions as a dumb terminal emulator but can exchange files using
  50.        XMODEM ( Standard XMODEM, XMODEM-CRC, and XMODEM-1K ) and YMODEM (
  51.        batch capability ) communication protocols. TERM will also send an
  52.        initialization string to your Hayes compatible modem.
  53.  
  54.        (6) XFER is designed to transfer files between PCs  connected  via
  55.        their  serial  ports  using a null modem cable. It uses a protocol
  56.        similiar to YMODEM and accepts wildcards in the filename.
  57.  
  58.        (7) LOOPBACK performs a loopback test of the selected  port  UART.
  59.        This is useful for testing a serial port UART that is suspected of
  60.        being bad.
  61.  
  62.        (8)  BBS is a simple single caller bulletin board system featuring
  63.        file uploading and downloading via XMODEM and YMODEM. If you  have
  64.        a  Hayes compatible modem, BBS will initialize your modem and wait
  65.        for  an  incoming  call.   BBS  demonstrates   the   communication
  66.        principles  used  in  constructing  a single caller bulletin board
  67.        system as well as XMODEM and YMODEM protocols.
  68.  
  69.        The shareware distribution does not include the source code to the
  70.        library  and  includes  only  the  small  memory   model   library
  71.        PCL4C_S.LIB and PCL_S.MIX. All example code is included.
  72.  
  73.        For more information, refer to the Personal Communications Library
  74.        Users  Manual  (  PCL4C.USR  ) and Personal Communications Library
  75.        Reference Manual ( PCL4C.REF ) which are part of PCL4C30.ZIP.
  76.  
  77.        A  Turbo Pascal version of the library ( PCL4P ) is also available
  78.        but which does not have as many example programs.
  79.  
  80.                         *** Registration ***
  81.  
  82.  
  83.        The  shareware  version  of  PCL4C.LIB is provided so that you may
  84.        personally determine the usefulness of the product  for  yourself.
  85.        If you can use PCL4C.LIB, please register your use with us.
  86.  
  87.                 MarshallSoft Computing, Inc.
  88.                 Post Office Box  4543
  89.                 Huntsville AL 35815
  90.  
  91.        Please  pay by check in US dollars. If your check is made out on a
  92.        bank  outside  of  the  USA,  please  include  any  foreign   bank
  93.        collection  fee  that  your  bank charges.  Payment must accompany
  94.        purchase orders. Print the file PCL4C.INV if an invoice is needed.
  95.        The registered package is $45 plus $3  S&H  ($6  outside  of  USA,
  96.        Canada, and Mexico) and includes:
  97.  
  98.           o  Small, Compact, Medium & Large memory model libraries without
  99.              the shareware screens.
  100.           o  Assembler source code for the library.
  101.           o  Printed Users Manual.
  102.           o  Printed Reference Manual.
  103.           o  Telephone support for one year.
  104.           o  All updates ( with printed manuals ) are $15 plus $3 S&H ($6
  105.              outside of USA, Canada, & Mexico).
  106.  
  107.        PCL4C.ASM is the source code for the library. The source  code  is
  108.        copyrighted  by MarshallSoft Computing, Inc. The user is granted a
  109.        license to use the PCL4C object code in his own application  only.
  110.        PCL4C.ASM  is  not  shareware and may not be sold or given away to
  111.        anyone.
  112.  
  113.        The  registered  user  will receive the latest version of PCL4C by
  114.        return mail.  A 5.25" diskette is provided unless a 3.5"  diskette
  115.        is requested.