home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc2 / dialv23.lzh / DIAL.DOC < prev    next >
Text File  |  1985-09-05  |  7KB  |  166 lines
  1.                         Turbo DIAL V2.0 for DEC Rainbow
  2.  
  3.                             Ted Weirich, July 1985
  4.  
  5.  
  6. SUMMARY
  7.  
  8. This program presents a screen oriented interface for dialing  a  HAYES  modem.
  9. Use  a letter or the editing keypad, such as the arrows, next screen, help, and
  10. so on, to select the phone number with which to dial the  HAYES.    The  number
  11. will  then  be dialed.  Strike any key during actual dialing to abort the call.
  12. Once the party answers, a carriage return will be sent three times to  autobaud
  13. the  destination.    Then  the command line given in the menu will be passed to
  14. DOS.  This usually invokes a terminal or protocol program such as  LCTERM,  TC,
  15. MINITEL,  KERMIT,  or others.  Your session is then as if DIAL was not present.
  16. When you end your remote session and exit  the  invoked  program  you  will  be
  17. returned to DIAL and can make another selection or exit.
  18.  
  19.  
  20. BUILDING FROM SOURCE
  21.  
  22. There is a COM file in this archive, but you may wish to build your  own  after
  23. modifying  the  sources.    It  is  written  in  Turbo Pascal 3.0 for DOS.  All
  24. operation has been done under DOS 2.11 on my 832kb (previously  256kb)  Rainbow
  25. 100A with 5 mb winnie.
  26.  
  27. The main source is here in DIAL.PAS.  COMMLIB.INC are procedures used  to  deal
  28. with  the  aux port, KEYBOARD.INC are routines used to gather keystrokes, while
  29. KEYDFNS.INC are the character definitions.   FVCONST.INC  are  definitions  for
  30. fast  video.  EXECUTE.INC is the execute lower program function and FINDENV.INC
  31. is the routine to read DOS environment variables.  HELP.INC  is  all  the  help
  32. text.  HAYES.INC are the Hayes SmartModem specific routines.
  33.  
  34. Build this program with compiling to a COM file with min 50 and max free  space
  35. of 100.  The following key strokes to TURBO should suffice.
  36.  
  37.              TURBO <cr> Y O C I 3 0 <cr> A 6 0 <cr> Q C DIAL.PAS Q
  38.  
  39.  
  40. MAX_DIR_ENTRIES  determines  how  many  entries  from  which  you  may  select.
  41. Currently  set  at 100.  AUTOBAUD_CHAR is the character sent NAUTO_TIMES to let
  42. the remote system determine your speed.  MODEM_TYPE is the type  of  modem  you
  43. are  using.    Hayes  is  value  1, no other values implemented or tested.  Hey
  44. there, DF03-AC owners!!  There is an init  string  for  the  Hayes  in  routine
  45. INIT_HAYES.    The  Hayes  is  informed  NOT  to echo commands, and if it does,
  46. rsponse matching will fail.  Other parameters should work in any  setting,  but
  47. I've not tested all possible settings.
  48.  
  49.  
  50. DIRECTORY TEXT FILE
  51.  
  52. DIAL reads a DIALNUM.TXT file at startup to build the list  of  possible  phone
  53. numbers,  their  descriptions,  and  the corresponding DOS command to give upon
  54. successful dialing.
  55.  
  56. To make a DIALNUM.DOC file, use your favorite editor, and make 3 line  entries.
  57. DIAL  currently  supports  100  entries.    The  first letter of each line is a
  58. "record type" or key.  The second  character  is  usually  a  "="  but  can  be
  59. anything  -  it is not checked.  Currently the good letters are N, D, and C.  N
  60. is the number, D is the description, and C is the  command.    Lines  beginning
  61. with  ";"  or  "!" are comments and are ignored.  Blank lines are also ignored.
  62. Sample of a DIALNUM.DOC file.
  63.  
  64.         ;DIALNUM.DOC - Read by Turbo DIAL as phone directory information
  65.         ;       N is the number
  66.         ;       D is a description line
  67.         ;       C is the DOS command to be done at successful connection
  68.         ;
  69.         N=1,6174677437
  70.         D=Market
  71.         C=Kermit Conn
  72.         ;
  73.         N=9739338
  74.         D=FIDO56
  75.         C=Minitel
  76.         ;
  77.         N=12125358924
  78.         D=FIDO79
  79.         C=Minitel
  80.         ;
  81.         N=3376060
  82.         D=TELNET
  83.         C=Kermit Conn
  84.         ;
  85.         N=16174817147
  86.         D=WayStar
  87.         C=Minitel
  88.  
  89.  
  90. INSTALLING DIAL
  91.  
  92. Copy the COM file to whatever directory you wish, presumably  one  included  in
  93. your  path.    Put  the DIALNUM.DOC file in the same or different directory and
  94. create a DOS environment variable called DIAL to point to it.  For example,  if
  95. you  put  DIALNUM.TXT  in  E:\COMM  then  include a "SET DIAL=E:\COMM\" in your
  96. AUTOEXEC.BAT file.  If there is no enviroment variable named  DIAL,  DIAL  will
  97. look for the directory file in the connected directory.
  98.  
  99.  
  100. RUNNING DIAL
  101.  
  102. Invoke this with DIAL <cr> or DIAL name <cr>.  Name will be searched for in the
  103. list  of  descriptions  and if found, it becomes the selected number.  You must
  104. still use DO or RET to start the  dialing.    If  you  omit  any  command  line
  105. parameters,  the  first  entry  will  be  the selected one.  Of course, you can
  106. change this by moving about with the arrows, next screen, prev screen, etc.
  107.  
  108.  
  109. SELECTING AN ENTRY
  110.  
  111. The keys used to select an entry from the menu are:
  112.  
  113.        Up Arrow                Previous entry
  114.        Down Arrow              Next entry
  115.        Previous Screen         Previous screen of entries
  116.        Next Screen             Next screen of entries
  117.        Shift Previous Screen   First screen of entries
  118.        Shift Next Screen       Last screen of entries
  119.        Cancel                  Hangup the phone
  120.        Interrupt               Push to a lower shell
  121.        Help                    Gets this text
  122.        Do                      Dial highlighted entry
  123.        Return                  Same as Do
  124.        Exit                    Exit DIAL completely
  125.        Space                   Same as Exit
  126.  
  127. or enter the letter A through S.  If you enter any other  key,  or  the  letter
  128. does not correspond to a valid number, BEEP.
  129.  
  130.  
  131. WAITING FOR THE MODEM TO CONNECT
  132.  
  133. Once you are waiting, you have two choices.   Wait  for  the  Hayes  to  signal
  134. completion  or  failure,  or abort the call.  It is told at init time to let 25
  135. seconds expire before giving up.  If you don't wish to wait this  long,  strike
  136. any key to abort the wait and you'll be returned to the menu.
  137.  
  138.  
  139. ONCE IT DOES CONNECT
  140.  
  141. Since some programs or commands take a while to get rolling (such  as  an  87kb
  142. Kermit  2.27),  I  will pass three carriage returns to the remote system before
  143. passing the DOS command to  the  lower  shell.    Change  AUTOBAUD_CHAR  and/or
  144. NAUTO_TIMES  if you don't like this.  The DOS command is usually used to invoke
  145. a  program  capable  of  being  a  terminal  emulator  of  sorts.
  146.  
  147. "LCTERM /se:\foobar\login.scr" is a valid command,  as  well  as  KERMIT  CONN,
  148. MINITEL, etc.  Once this is started, the session is as if DIAL wasn't around.
  149.  
  150.  
  151. ENDING YOUR SESSION
  152.  
  153. End your remote session in its normal, prescribed manner.  If  it  neglects  to
  154. hang up the phone, use the CANCEL key to hang it up from this end.  Then select
  155. another entry to dial or enter EXIT to quit altogether.
  156.  
  157.  
  158. CREDITS AND DISCLAIMER
  159.  
  160. I owe much to the authors of several packages I used to  build  this:    mostly
  161. made possible by B.  Eiben of DEC, whose efforts in managing public accounts on
  162. DEC's MARKET system brought together all the tools I  needed.    No  amount  of
  163. thanks  to  Bernie are sufficient.  This program is placed in the public domain
  164. and any are welcome to copy it and/or modify it as long as it is not  used  for
  165. any commercial purpose and distributed freely.
  166.