
                              ATSEND V2.1
             By Joseph Sheppard, jsheppard@shepdec.com


___________
DESCRIPTION
___________

ATSEND.EXE allows users to send "AT" commands to Hayes compatible modems
from the DOS command prompt, or from batch files.

ATSEND.EXE does not need a DTR utility to make it work.  DTR is handled
directly by ATSEND.

ATSEND.EXE follows the DSZPORT= setting if it's found in the DOS
environment.

ATSEND.EXE works with non-standard COM ports via environment
variables COMBASE and COMIRQ.

ATSEND.EXE can be used to dial a telephone.  It is small enough
to be shelled out to by most database programs to create dialing
routines.

ATSEND.EXE copies the results of a command to the modem to the screen,
and to a text file called ATSEND.OUT.

ATSEND.EXE is written with Borland's Turbo Pascal  using communication
routines from Prokit, (c) Samuel Smith.

ATSEND.EXE is Freeware.  You are allowed to use it, but you may not sell it.

____________
HOW IT WORKS
____________

To send a command to the modem, the user runs ATSEND.EXE by
typing ATSEND at the DOS command prompt followed by the command to be sent
to the modem, and the port the modem is connected to.

The default port is COM1 at standard address 3F8/IRQ4, so if your modem is
attached to COM1 then you don't need to specify a port on the command line,
or put it in the DOS environment using the DSZPORT variable.

If your modem is connected to COM2 at standard address 2F8/IRQ3, then you
will always need to follow the command to be sent with the number 2, or
have DSZPORT=2 in your DOS environment.  Non-Standard COM Ports are
supported and explained later in this document.

An environment variable called ATOK is used to disable the
time-out routines.  This is useful when ATSEND is to be used to
dial a telephone.  To keep the modem from waiting for the modem
to return an "OK" place ATOK=NO in your environment.

________
EXAMPLES
________

ATSEND H1               (Take modem connected to COM1 off the hook)

ATSEND H1M0 2           (Take modem connected to COM2 off hook and turn-off
                        speaker)

ATSEND M1DT18185551212  (Tell modem connected to COM1 to dial
                        1-818-555-1212). Use the ATOK environment
                        variable when using ATSEND to dial a
                        telephone.

ATSEND Z 2              (Perform a reset on the modem connected to COM2)

To use the DSZPORT variable, and avoid having to type the port
number on the command line, put the following line in your
AUTOEXEC.BAT file:  SET DSZPORT=<PORT>.  For example, if you are
using COM2:

SET DSZPORT=2

___________________________
NON-STANDARD PORT SETTINGS:
___________________________

ATSEND works with standard and non-standard serial port configurations.
Here are the defaults:

Port    Base Address    IRQ

COM1    3F8             IRQ4
COM2    2F8             IRQ3
COM3    3E8             IRQ4
COM4    2E8             IRQ3
COM5    Undefined       Undefined
COM6    Undefined       Undefined
COM7    2E8             IRQ5
COM8    3E8             IRQ5

If you use these setups, you can simply specify the port number in your
ATSEND command line (Example: ATSEND Z 8 to reset a modem on COM8:):

If your port is setup differently, then ATSEND will look for two
environment variables called COMBASE and COMIRQ.

COMBASE must be converted from hex to decimal in order to work properly
(Example 744 for 2E8).  A utility called HEX2DEC.EXE is included to assist
in changing your hex port address to decimal.

COMIRQ is simply the IRQ number being used.

For example, if you were going to run COM7 with a Base Address of 2F8 on
IRQ2, at the DOS prompt, or in a batch file you would type:

SET COMBASE=760
SET COMIRQ=2

This setting will override any DSZPORT, or command line commands.
I have included a program called HEX2DEC.EXE that can be used to
convert your hex port address into decimal.  If COMBASE and COMIRQ are in
the environment, there is no need to put the port number on the command
line.

___________
ATBATCH.EXE
___________

ATBatch is the easy way out.  It will create batch files for you
that send the proper commands to ATSEND, including COMIRQ and
COMBASE, including automatic hex to decimal conversion.  Use
ATBATCH to create a batch file called ATH1.BAT.  Then you can
just type ATH1 from DOS just like you were inside your favorite
terminal program!

____
USES
____

I wrote this as a utility to take my modem off the hook during BBS mail
runs so that callers wouldn't ring the line during the event.  I'm sure
there are other uses for it, and would be interested in hearing from
users who find new ways to use this program.

_______
SUPPORT
_______

AtSEND was shareware for $10.00 for many years.  I no longer actively support
the program, so I have made it Freeware. You may use the program for free, but
you may not sell it or include it with a commercial program.  You may 
contact me if you like if you have questions about the program, but I am no 
longer providing new features or fixes.  

Internet: jsheppard@shepdec.com

Postal:
-------
Joseph Sheppard
6858 Acco Street
Los Angeles, CA 90040


_______
WARNING
_______

I make no warranty of any kind, express or implied, including without
limitation, any warranties of merchantability and/or fitness for a
particular purpose.  I shall not be liable for any damages, whether
direct, indirect, special or consequential arising from a failure of
this program to operate in the manner desired by the user.  I shall
not be liable for any damage to data or property which may be caused
directly or indirectly by the use of this program.

IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR
FOR ANY CLAIM BY ANY OTHER PARTY.



