HE REMOTE MODEM DRIVER COPYRIGHT (C) 1985, S. KLUGER
FO REMDRV DOCUMENTATION PAGE #



    REMDRV�� i� � modul� which�� whe� use� i� plac� o� th� CONREM� �
modul� i� � TurboDO� 1.4� maste� operatin� system�� allow� al� o� �
tha� master'� slav� t� acces� u� t� 1� I/� devices�� On� possibl� �
applicatio� woul� b� (i� conjunctio� wit� th� appropriat� soft�
ware� acces� o� multipl� modem� b� an� slave� Wit� a� intelligen� �
termina� program�� mode� selectio� woul� b� transparen� t� th� �
user�� s� tha� activatin� th� utilit� woul� selec� th� firs� �
availabl� modem� unti� al� modem� ar� busy.



                    INSTALLATION of REMDRV

    Installatio� o� REMDRV� i� straightforwar� an� require� onl� �
� mino� chang� i� OSMASTER.GEN�� Pleas� not� tha� th� releas� �
version of REMDRV consists of three serialized .REL files:
         REMDRV.REL     the remote modem driver
         REMCH0.REL     master comm port "0" driver
         REMCH1.REL     master comm port "1" driver
         NOTE: For the 16-bit package, the files are named .O
I� addition� th� followin� file� ar� par� o� th� releas� softwar� �
package:
         REMCH0.MAC     an example of a REMDRV  companion module
                        using the OEM-supplied drivers  (via the
                        COMDRV## entry point)
         ATTREM.MAC     an example of a simple  terminal program
                        with modem select capability
         ATTREM.COM     object code of above
         ATTREM.CMD     same, for 16 bit systems
         REMDRV.DOC     this text


    T� install� simpl� ad� th� followin� lin� t� OSMASTER.GEN

REMDRV,REMCH0,REMCH1


Wit� thi� change�� tw� remot� mode� channel� becom� activ�.
pa �

                      THEORY OF OPERATION

    REMDRV�� allow� an� use� o� an� slav� i� � smal� TurboDO� �
networ� t� acces� u� t� 1� seria� channel� (commonl�� use� fo� �
modems)�� provide� th� channe� i� free�� REMDRV� i� accesse� vi� �
DEFDID�� therefore� th� statio� requestin� acces� mus� b� � slav� �
o� th� maste� whic� run� REMDRV� (rathe� tha� th� slav� o� � �
second master networked into the first).

    REMDRV provides the following functions:

    1. attach to remote driver
    2. detach from remote driver
    3. set remote baud rate
    4. interrogate remote baud rate
    5. character buffer I/O

    Th� followin� tex� explain� eac� functio� i� grea� detail� �
includin� al� parameter� t� b� passed�� Note� tha� fo� al� REMDRV� �
functions the C register (CL in 8086) must be set to 33 (21H).


1 - ATTACH TO REMOTE DRIVER

    Thi� functio� initiate� � remot� I/� sessio� an� must�� b� �
calle� prio� t� an� remot� activit� fo� th� desire� port.

    entry:
    reg D (DH)     0FEH
    reg B (CH)     channel number 00..0FH
    return:
    reg A (AL)     000H = successful attach
                   0FFH = requested channel busy
                   0FEH = requested channel not implemented


2 - DETACH FROM REMOTE DRIVER

    Thi� functio� i� use� a� th� conclusio� o� � remot� I/� �
sessio� t� 1� fre� th� por� fo� anothe� use� an� 2�� unlin� th� �
port so as not to waste processing power in the master

    entry:
    reg D (DH)     0FDH
    reg B (CH)     channel number 00..0FH
    return:
    none (channel is detached)
pa �

3 - SET REMOTE BAUD RATE

    Allow� settin� o� th� attache� channel'� bau� rate� Th� bau� �
rat� specificatio� paramete� i� identica� t� th� on� use� i� T-�
functio� 3� (se� bau� rate).

    entry:
    reg D (DH)     0FCH
    reg B (CH)     channel number 00..0FH
    reg E (DL)     baud rate code (ex. 9600=0EH)
    return:
    none (baud rate is set)


4 - GET REMOTE BAUD RATE

    Return� th� remot� bau� rat� cod� (th� cod� i� identica� t� �
the one returned by T-function 38).

    entry:
    reg D (DH)     0FBH
    reg B (CH)     channel number 00..0FH
    returb:
    reg A (AL)     baud rate code (ex. 9600=0EH)


5 - CHARACTER BUFFER I/O

    Thi� functio� i� use� t� transfe� dat� betwee� th� selecte� �
por� an� th� callin� software� Pleas� not� tha� th� transfe� FROM� �
th� deciv� alway� involve� � bloc� o� data� u� t� 12� characters� �
written to the current DMA address.

    entry:
    reg D (DH)     0FAH
    reg B (CH)     channel number 00..0FH
                   bit 7 set if output is desired
    reg E (DL)     output character (if any)
    return:
    reg A (AL)     number of input characters read into buffer
    DMA ADDRESS    count (same as A) followed by the input data
pa �

SAMPLE PROGRAM ATTREM

    Thi� sampl� attach-program�� supplie� i� sourc� an� objec� �
format� allow� yo� t� attac� t� an� detac� fro� an� activ� REMDR� �
por� o� th� master�� Th� progra� ca� b� use� fro� an� slav� tie� �
t� tha� master�� I� wil� rejec� attemp� t� attac� t� � bus�� o� �
non-existan� port.

USAGE

Th� followin� i� � sampl� sessio� wit� ATTRE͠ (bold=computer� �
light=user):

0A}attrem

ONLY PORTS A..P ALLOWED

0A}attrem a

ATTACHED TO PORT A AT 1200 BAUD
         (communication takes place)
         ......
         (now ATTN-ABORT is typed on console)
DETACHED FROM PORT A

0A}attrem c

ERROR: PORT C DOES NOT EXIST

0A}attrem b              (assume you are attached to B on
                        another terminal)

ERROR: PORT B IS BUSY

0A}
pa �.HE SOFTWARE RELEASE NOTES, LEGALITIES




                         RELEASE NOTE



    REMDRV�� i� � copyrighte� produc� o� S�� Kluger�� Dalla� TX� �
Reproductio� (othe� tha� fo� archiva� us� o� fo� syste� genera�
tion� withou� writte� authorizatio� i� prohibited� Disassembl� o� �
unauthorize� reserializatio� i� prohibited��� Note�� tha� thi� �
applies only to REMDRV.REL or REMDRV.O!

    REMDRV�� i� availabl� i� tw� forms�� 1� fo� us� wit� 8-bi� �
masters and 2) for use with 16-bit 80186 (!) masters.
Bot� version� includ� th� sampl� ATTREM� progra� i� 8- an� 16-bi� �
flavors, but only ATTREM.MAC is supplied.

    REMDRV�� ma�� periodicall�� b� update� o� improve� withou� �
notice�� Update� ar� fre� i� th� origina� maste� dis� wit� �
sufficien� retur� postag� i� sent��  � d� no� expec� an�� majo� �
updates to be more frequent than one per 3 months.

    BUG REPORTS are strongly encouraged!
pa �.HE REMDRV ORDER FORM

        (fill out completely and send the whole sheet)

Pleas� sen� _____� copie� o� REMDRV�� Serializatio� an� version� �
are as follows: (NOTE: only one copy per serial #)

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

TurboDOӠseria� numbe� ____/___� REMDR� versio� (��o�16� _______

(continue on back if more room needed)

Name: __________________________  Company: ______________________

Address: ________________________________________________________

        ________________________________________________________

        ________________________________________________________

Phone number: (____) _____ - ________


    Total number of copies:       _______ at $25.00 each

    Check or Money Order enclosed for  $ _________.00
or
    Please ship COD     (postage/COD fees added to total)


Please sign here to accept the restrictions
place�o�th�produc�o�th�previou�pag堺 ___________________

NOTE�� pleas� chec� her� i� yo� have�� (__� �� differen� dis� �
drivers or (__) 4 different circuits defined in your master.
pa �.HE RELEASE NOTES FOR DEMO VERSION "REMDRVT.REL"


    Thi� i� � dem� version� Licens� i� grante� fo� noncommercia� �
use and distribution for demonstration purposes only.


    REMDRVT operates like the real REMDRV with the following
important differences:

-    REMCH�� onl� i� supplie� fo� us� wit� com� channe� � o� th� �
�����master.
-    Only one remote driver (normally REMCH0) can be used
-    Attempt� t� acces� an� function� wit� th� B-registe� not� se� �
�����to 00H (channel 0) may result in a total system crash.

    REMDRVT�� allow� fre� acces� t� remot� channe� "A�� wit� n� �
restrictions.