PROGRAM: CHKMODEM.EXE

DATE: 09-01-1991

PROGRAMMER: Gary G. Hendershot
Soft Sale Limited
7218 Reservoir Road
Springfield, VA 22150
Voice: 703/569-6874
Fax: 703/569-1081
Data: 703/569-1419

IF you like the program a contribution of $10.00
would be appreciated!


PURPOSE: CHECKMODEM is a utility that checks either internal
SERIAL Ports 1-4 or a DESIGNATE Port Address and
Interupt for the existance and response of a MODEM

The program is quite useful in determining which
serial port the modem is attached to and whether
or not it responds as required to Carrier Detect
and Data Terminal Ready changes.

The program can also determine the MINIMUM and
MAXIMUM baud rates at which the MODEM will respond
to commands.

REQUIRED: This program was written to be compiled with the
Microsoft BASIC PDS Ver 7.0/7.1

It has been compiled under Microsoft Quick BASIC Ver 4.5
successfully with no modification.

NUMEROUS SUB-PROGRAMs are "CALLed" by this program that
are contained in third party library code. The libraries
employed are as follows.

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

ProBas Professional Basic Programming Library Ver 4.01
Hammerly Computer Services, Inc.
9309 Jasmine Court
Laurel, MD 20707
301/953-2191

This library provides the file handling and string print
routines.

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

QBSerial Serial Communications Library
Jeff Sumberg
Sysop(2) - SailBoard BBS
Wayne, NJ, 201-831-8152
[ or ]
Box 212
Ringwood, NJ, 07456

This library provides the Serial Communications routines

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

COMMAND: The program is executed with the command "CHKMODEM".
In its default state the program will check serial
ports 1-4 with these specifications ...

COM1 COM2 COM3 COM4

Address 3F8H 2F8H 3E8H 2E8H
Interrupt 4 3 4 3
Hand Shake NONE NONE NONE NONE

Each port will be sent an initialization string and a
response of "OK" will be considered a confirmation ...

A CONFIG file can be named on the command line. The
command "CHKMODEM @MODEM.DAT" will cause the program
to look for a file named MODEM.DAT in the current
DRIVE:\SUBDIR ... the CONFIG file must have the following
layout to be accepted ...

HEX ADDRS; SEND COMMAND; EXPECTED RESULT; HAND SHAKING;

Note that the parameters are seperated by a SEMI-COLON ...
The SEMI-COLON is used as a DELIMITER and must be used.

If MODEM.DAT contains the following data ...

2F8;3;AT;OK;NONE;
2F8;3;AT;OK;XON/XOFF;
2F8;3;AT;OK;CTS;
2F8;3;AT;OK;CTS/XON/XOFF;

the port at 2F8 Hex and interrupt 3 will be sent the message
"AT" with the expectation of getting back an "OK response
with "NONE" hand shaking, "XON/XOFF" hand shaking, "CTS"
hand shaking and "CTS/XON/XOFF" handshaking ...

Each time the serial port is checked, the program tries to
get a response from the modem at 300, 1200, 2400, 4800,
9600, 19200, 38400 and 57600 Baud ... the slowest and
fastest baud rates the modem accepted a command are
reported ...

The modem is also checked with Carrier Detect and Data
Terminal Ready lines enabled and disabled ...

NOTE: With this version of CHKMODEM, it is possible to
REDIRECT the programs output to a printer or file.

Use the DOS "PIPE" facility along with the program s
COMMAND to direct the output to ANY DOS device ...

The COMMAND "CHKMODEM > RESULT.TXT" will cause the
programs output to be routed to a file called "RESULT.TXT"

The COMMAND "CHKMODEM @MODEM.DAT > LPT1:" will cause the
program to use CONFIG File MODEM.DAT and route output to
the printer connected to LPT1:

CAUTION: This program GRABS INTERRUPT VECTORS ... DO NOT EXIT
the program abruptly or your computer may lock up the
next time you try to use the INTERRUPT ...

If you have a SERIAL MOUSE or SERIAL PRINTER you may
have to RE-BOOT your system to get thier functions
back after running CHKMODEM ...