This program is shareware NOT freeware.  If you use this library, please send
$10.00 to:
Tony Pitman
15248 N. 35th Street
Phoenix, AZ  85260
CIS:71441,741

If you have any questions, leave me e-mail on Compuserve at the above CIS
address.


CCOMOPEN(port, baud_rate, parity, stopbits, data_len)
This function opens the comm port.
 port      = 1 or 2 for COM1 or COM2
 baud_rate = 300, 1200, 2400, 4800, 9600, 19200 for baud rate
 parity    = 0 - none, 1 - odd, 2 - even
 stopbits  = 1 or 2
 data_len  = 5, 6, 7 or 8

CCOMCLOSE(port)
Close the communication port.

CCOMSWRT(string)
Write a string to the currently open port.
 string = character string from clipper

CCOMBWRT(c)
Write a single byte to the currently open port.
 c = a numeric value representing the character to send.
     (i.e. the letter A would be 65, you could use ASC("A"))

CCOMSRD(string, delims, length)
Reads a string from the currently open port.
 string = variable to hold the result
 delims = string containing delimeters to stop receiving at
 length = maximum length to receive

you must pass both the string variable and the length variable by
reference (i.e. CCOMSRD(@MSTRING, MDELIMS, @MLENGTH)).  the received
string is contained in string and the number of characters actually
received is contained in length upon return.  the function returns the
following:
 1 - hit one of the delimeters
 2 - hit the length you specified

note that you MUST supply a length.  if you didn't supply a length or
delimeters, then the computer could potentially go into an infinite loop.
this is because the only way out of the loop is to hit the length or
a delimeter.  if you want to have a control character as your delimeter,
such as a 'return', you could enter CHR(13) + CHR(10) as the delims
parameter.  this way if either a CHR(13) or CHR(10) was received, the 
function would return all of the characters up to and including the
CHR(13) or CHR(10) depending on which on it received.

CCOMBRD()
Read the next single byte from the currently open port.
 this function returns the ASC character code of the next character
 in the input buffer.  if this function returns 0, there are now
 waiting characters.

CCOMHANG()
Causes a 'hardware' hangup of the currently open port.

CCOMCARR()
Returns 0 if there is no carrier, non-zero if there is.

CCOMSTATUS()
Returns the status register of the modem.  i do not know all the results,
but they are standard.  i do know that if bit 7 is on, that is the
carrier detect flag.  that is the flag that is used for the CCOMCARR
function.


