Library Files

    There are separate versions of the Faxual II libraries for different
    versions of CA-Clipper.  We supply versions to work with CA-Clipper
    version 5.01 and 5.2.

    Files in the CA-Clipper 5.2 version of Faxual II
    ----------------------------------------------------------------------
    Filename        Description
    ----------------------------------------------------------------------
    FAX2CL52.LIB    Faxual II for CA-Clipper 5.2.
    FAX2ROOT.LIB    Non-overlayable (root) code used by the built-in serial
                    interface layer.
    SERBLX.OBJ      Extra code required for Blinker 3 protected-mode or
                    dual-mode executables.
    SEREXO.OBJ      Extra code required for CA-ExoSpace protected-mode
                    executables.
    SERTP.OBJ       Replacement serial interface layer for use with
                    Telepathy.
    ----------------------------------------------------------------------

    Files in the CA-Clipper 5.01 version of Faxual II
    ----------------------------------------------------------------------
    Filename        Description
    ----------------------------------------------------------------------
    FAX2CL50.LIB    Faxual II for CA-Clipper 5.01.
    FAX2ROOT.LIB    Non-overlayable (root) code used by the built-in serial
                    interface layer.
    SERBLX.OBJ      Extra code required for Blinker 3 protected-mode or
                    dual-mode executables.
    SEREXO.OBJ      Extra code required for CA-ExoSpace protected-mode
                    executables.
    SERTP.OBJ       Replacement serial interface layer for use with
                    Telepathy.
    ----------------------------------------------------------------------

    Files with the same names in both versions are identical files.

 The Serial Interface Layer

    Faxual II communicates with a modem through a set of procedures we call
    the serial interface layer.  It contains routines for opening, closing,
    and controlling serial ports, and sending and receiving data.

    You have two options for the serial interface layer.  Faxual II contains
    a set of built-in serial I/O routines; this built-in serial interface
    layer is the default.  As an alternative, if you own Telepathy (our
    serial communications library for CA-Clipper), you can use it instead of
    the built-in serial interface layer.

    For most purposes, the built-in routines are the better choice.  They
    are smaller and, in some cases, faster than the corresponding code in
    Telepathy.  On the other hand, Telepathy is capable of working with
    multi-port serial cards and network serial redirectors.  The built-in
    serial code works only with conventional serial ports and internal
    modems.

 Linking In Real Mode

    This information applies to all linkers except CA-ExoSpace, Blinker
    version 3, and CauseWay.  These include RTLink, Blinker 2, WarpLink,
    Microsoft LINK, and others.

    .   To use the built-in serial interface layer, link with FAX2CL5x.LIB
        and FAX2ROOT.LIB.

    .   To use Telepathy as the serial interface layer, link with SERTP.OBJ
        and FAX2CL5x.LIB, and the appropriate Telepathy libraries.

    FAX2CL5x.LIB can be overlaid by Blinker or WarpLink.  FAX2ROOT.LIB must
    not be overlaid.  SERTP.OBJ also can be overlaid.  RTLink is not capable
    of overlaying Faxual II.

    Note: With WarpLink, you must add "FAX2CL5x:SERREAL.C" to the list of
    libraries.  See the example later in this note.

 Linking with CA-ExoSpace or CauseWay

    Faxual II works with all versions of CA-ExoSpace, and with CauseWay
    versions later than 1.2a.  To use CauseWay 1.2a or earlier, you must use
    Telepathy as the serial interface layer.

    .   To use the built-in serial interface layer, link with SEREXO.OBJ,
        FAX2CL5x.LIB, and FAX2ROOT.LIB.

    .   To use Telepathy as the serial interface layer, link with SERTP.OBJ
        and FAX2CL5x.lib, and the appropriate Telepathy libraries.

    .   If your program does not send faxes or perform serial I/O (e.g., if
        it only produces fax files for use by some other program), the only
        file you need to link is FAX2CL5x.LIB.  Leaving out the serial
        interface files will reduce the size of the program by about 2K.

 Linking with Blinker Version 3

    .   To use the built-in serial interface layer, link with SERBLX.OBJ,
        FAX2CL5x.LIB, and FAX2ROOT.LIB.

    .   To use Telepathy as the serial interface layer, link with SERTP.OBJ
        and FAX2CL5x.lib, and the appropriate Telepathy libraries.

    .   If your program does not send faxes or perform serial I/O (e.g., if
        it only produces fax files for use by some other program), the only
        file you need to link is FAX2CL5x.LIB.  Leaving out the serial
        interface files will reduce the size of the program by about 8K.

    When using Blinker 3 to produce real-mode executables, you can treat it
    the same as Blinker version 2 (see Linking In Real Mode, above).  When
    creating dual-mode executables, FAX2CL5x.LIB, SERBLX.OBJ, and SERTP.OBJ
    can be overlaid, but FAX2ROOT.LIB cannot.  For extended-mode programs,
    overlaying considerations do not apply.

 Examples

    All these examples show link scripts for a simple program containing one
    object file, called MYOBJ.OBJ, plus the Faxual II library.

    .   Link scripts for RTLink.  None of Faxual II is overlaid.

        Using the built-in serial interface:

        OUTPUT MYPROG
        FILE MYOBJ
        LIB FAX2CL52
        LIB FAX2ROOT

        Using Telepathy for the serial interface:

        OUTPUT MYPROG
        FILE MYOBJ
        FILE SERTP
        LIB FAX2CL52
        LIB TPOVL52
        LIB TPROOT52

    .   Link scripts for Blinker 2, or Blinker 3 in REAL mode.

        Using the built-in serial interface:

        OUTPUT MYPROG
        BEGINAREA
          FILE MYOBJ
          LIB FAX2CL52
        ENDAREA
        LIB FAX2ROOT

        Using Telepathy for the serial interface:

        OUTPUT MYPROG
        BEGINAREA
          FILE MYOBJ
          FILE SERTP
          LIB FAX2CL52
          LIB TPOVL52
        ENDAREA
        LIB TPROOT52

    .   Link scripts for WarpLink.

        Using the built-in serial interface:

        MYOBJ C5OVLMGR /OI /R /OP:M /CLP5
        MYPROG
        NUL
        (FAX2CL52:SERREAL.C FAX2CL52) FAX2ROOT

        Using Telepathy for the serial interface:

        MYOBJ SERTP C5OVLMGR /OI /R /OP:M /CLP5
        MYPROG
        NUL
        (FAX2CL52:SERREAL.C FAX2CL52 TPOVL52) TPROOT52

    .   Link scripts for CA-ExoSpace.

        Using the built-in serial interface:

        OUTPUT MYPROG
        FILE MYOBJ
        FILE SEREXO
        LIB FAX2CL52
        LIB FAX2ROOT

        Using Telepathy for the serial interface:

        OUTPUT MYPROG
        FILE MYOBJ
        FILE SERTP
        LIB FAX2CL52
        LIB TPOVL52
        LIB TPEXO52

        Using no serial interface:

        OUTPUT MYPROG
        FILE MYOBJ
        LIB FAX2CL52

    .   Link script for Blinker 3 in DUAL or PROTECTED mode.

        Using the built-in serial interface:

        OUTPUT MYPROG
        BLINKER EXECUTABLE EXTENDED     # or DUAL
        BEGINAREA
          FILE MYOBJ
          FILE SERBLX
          LIB FAX2CL52
        ENDAREA
        LIB FAX2ROOT
        SEARCH BLXCLP52

        Using Telepathy for the serial interface:

        OUTPUT MYPROG
        BLINKER EXECUTABLE EXTENDED     # or DUAL
        BEGINAREA
          FILE MYOBJ
          FILE SERTP
          LIB FAX2CL52
          LIB TPOVL52
        ENDAREA
        LIB TPBLX52
        SEARCH BLXCLP52

        Using no serial interface:

        OUTPUT MYPROG
        BLINKER EXECUTABLE EXTENDED     # or DUAL
        BEGINAREA
          FILE MYOBJ
          LIB FAX2CL52
        ENDAREA
        SEARCH BLXCLP52