UPDATE# DIALING AND THE DIALING DIRECTORY

MS-DOS Kermit does not have a built-in DIAL command, but if you installed
Kermit from the distribution disk according to instructions, you'll be able to
use the DIAL macro defined in Kermit's initialization file, MSKERMIT.INI.
DIAL uses two additional files: xxxxx.SCR, a script program for dialing your
modem ("xxxxx" is HAYES, T3000, ROLM, etc, see below for a list), and
DIALUPS.TXT, your dialing directory (see MODEMS.HLP).

If you do not have a modem for which a dialing script is provided, you can
write a new script program for dialing, modelled after one of the other
dialing scripts (see Chapter 14 of "Using MS-DOS Kermit) and set a DOS
environment variable, MODEM, to be the name of your modem; the dialing script
should have the same name, with a filetype of .SCR.  For example, for dialing
an XYZV32 modem, put the following line your AUTOEXEC.BAT file:

  SET MODEM=XYZV32

and install a XYZV32.SCR file in the same directory as your MSKERMIT.INI file.

If you don't have a dialing script for your type of modem, you can also dial
it "manually" in CONNECT mode.

To use a dialing directory, create a plain text file called DIALUPS.TXT.  The
file contains one line per entry:

  name	 number	  speed	   parity   comments

The "name" is the name you want to use for this entry in your DIAL commands.
"number" is the telephone number; "speed" is the dialing speed in bits per
second, "parity" is the parity to use (even, odd, mark, space, or none).  The
name, number, speed, and parity are separated from each other by one or more
spaces.	 Any words after the parity are ignored, so you can use them for
comments.  If trailing fields (speed, parity) are omitted, Kermit's current
values are used (but then you can't have a comment).  If you want to tell
Kermit explicitly to use its current value for speed or parity, use an equal
sign (=).  Examples:

  sprintnet  7654321	  2400	 mark
  oofanet    6543210	  1200	 odd	This entry has a comment.
  tymnet     93,876-5432  2400	 even	You can put punctuation in the phone #.
  hometone   T5551212	  1200	 none	T in number forces tone dialing
  homepulse  P5551212	  1200	 none	P in number forces pulse dialing
  anyspeed   999-9999	  =	 none	Use current speed, whatever it is.
  anyparity  888-8888	  9600	 =	Use current parity, whatever it is.
  whocares   777-7777	  =	 =	Use current speed and parity.
  defaults   987-6543

To use the dialing directory, just type DIAL followed by the name, spelled out
in full (case doesn't matter), for example:

  MS-Kermit>dial tymnet

If you type a name or number that is not in the directory, Kermit dials exactly
the characters you type, for example DIAL 5552370 dials the number 5552370.
DIAL FRED (if FRED is not in the directory) tells Kermit to dial the letters
FRED, which won't accomplish anything useful with most modems.

To view your dialing directory, type LIST.  To view particular entries in your
dialing directory, type LIST XXX, where XXX is a sequence of characters that
appears in the desired entries (usually the name).  In the LIST command, case
is important because it uses the DOS FIND program to list the entries:

  MS-Kermit>list tymnet
  tymnet     93,876-5432  2400	 even	You can put punctuation in the phone #.

In your dialing directory, you can include spaces in the name or number by
enclosing it in braces, as in these examples:

  {my computer}	 555-4321	     2400   none
  your-computer	 {9 1 800 555 1234}  1200   odd
  {our computer} {212 701 0000}	    19200   space

Now you can type commands like DIAL MY COMPUTER, DIAL OUR COMPUTER.

The DIAL command assumes your dialing directory is stored on your PC as
C:\KERMIT\DIALUPS.TXT.	If you want to keep it someplace else or you need to
use some other name, create a DOS environment variable in your AUTOEXEC.BAT
file:

  SET DIALFILE=C:\PHONES\DIALING.DIR

If you want to use the directory sometimes but not others, define a separate
macro for dialing without it:

  define call take \m(_modem).SCR

(where _modem is defined as your modem type, e.g. HAYES, and you have an
appropriate dialing script file in your PATH, e.g. HAYES.SCR).	The _modem
variable is set automatically from your DOS environment variable, MODEM, and
is HAYES by default (i.e. if there is no MODEM environment variable).

As of MS-DOS Kermit 3.13, the DIAL command now supports the following modems:

   Hayes 1200 and 2400 
   Hayes ULTRA 14400
   Penril Alliance V.32 
   Practical Peripherals 14400
   Rolm CBX DCM 
   SupraFAXmodem V.32bis 
   Telebit QBlazer V.32 
   Telebit T3000 V.32bis 
   Vadic VA2400PA 

See MODEMS.DOS (MSMAAA.DOC) for further information.


.