home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / a / dial.lbr / DIAL.DZC / DIAL.DOC
Encoding:
Text File  |  1993-10-26  |  5.5 KB  |  207 lines
  1.  
  2.  
  3.  
  4. DIAL is an extension to any terminal program allowing
  5.      3 dialing options and then the automatic load
  6.      and execution of the terminal program itself.
  7.      Of course the program that is loaded does not
  8.      have to be a terminal or 'modem' program. I have
  9.      had occasion to load and run 'wash', 'osd' and
  10.      other utilities after dialing.
  11.  
  12.  
  13. Features and functions:
  14.  
  15. 1.  Continual dialing of a number or list of
  16.     numbers from a file until one answers.
  17.  
  18. 2.  Searching of a range of numbers for a carrier.
  19.  
  20. 6.  Z80 code.
  21.  
  22. 7.  Typing of files.
  23.  
  24. 8.  Directory with disk system reset.
  25.  
  26.  
  27. This program will only run on z80 based machines.
  28.  
  29. As distributed DIAL will run as-is on an Osborne-1
  30. double-density machine with a Hayes Smartmodem
  31. connected to the rs232 port.
  32.  
  33. A patch-list follows which should allow other
  34. auto-dial modems to be used. Other patches are
  35. indicated for video control on non-Osbornes.
  36.  
  37. I would appreciate hearing from anyone who gets
  38. this program up and running on other hardware
  39. combinations as this will allow me to update
  40. DIAL towards a more universal version.
  41.  
  42.  
  43. Patches:
  44. -------
  45.  
  46.  
  47. 106h = screen/keyboard iobyte value
  48.        (assigns CON: to screen/keyboard)
  49.  
  50. 107h = modem (rs232) iobyte value
  51.        (assigns CON: to rs232)
  52.  
  53. 108h = 5 byte escape or 'off-line' string
  54.     (must end with 0)
  55.  
  56. 10dh = 10 byte disconnect string
  57.     (must end with 0)
  58.  
  59. 117h = 21 byte modem initialize string
  60.        (must end with 0)
  61.  
  62. 12ch = number of characters in (terminal)
  63.        program name to load with X option.
  64.  
  65. 12dh = 10 bytes for terminal program name
  66.     (must end with a 0)
  67.  
  68. 137h = 5 byte clear screen string
  69.     (must end with a 0)
  70.  
  71. 13ch = 4 byte delete cursor string
  72.        (your terminal's hex sequence to delete
  73.         from the cursor to the end of the line)
  74.     (must end with a 0)
  75.  
  76. 141h = 6 byte dial string
  77.        (your modem's command string to dial the
  78.         number that follows)
  79.  
  80.  
  81. The following is an assembly listing of the patch
  82. area which you could modify with the values you
  83. need and after assembling it overlay the .hex file
  84. onto dial.com using ddt. After modifying dial.com
  85. enter:
  86.        A>SAVE 31 DIAL.COM
  87.  
  88.  
  89.     org    0108h
  90. ;
  91. conin:    db    10010100b ;Screen/keyboard iobyte value
  92. ;
  93. rdrin:    db    10010101b ;Modem (rs232) iobyte value
  94. ;
  95. escstr:    db    '+++',0,0        ;escape or 'go off-line' string
  96. ;
  97. hngmsg:    db    'AT H0',13,0,0,0,0    ;disconnect string
  98. ;
  99. dinit:    db    'AT T S7=15 '        ;modem initialize string
  100.     db    0,0,0,0,0,0,0,0,0,0
  101. ;
  102. filrun:    db    5,'MODEM',0,0,0,0,0    ;name of program to run
  103.                     ;1st byte MUST be length of name
  104. ;
  105. clrscr:    db    26,0,0,0,0    ;clear screen string
  106. ;
  107. dellin:    db    27,54h,0,0,0    ;delete from cursor to end-of-line string
  108. ;
  109. dile:    db    'ATD   '    ;dial code
  110. ;
  111. ;........
  112.     end
  113.  
  114.  
  115.  
  116. As coded above, a Smartmodem with an Osborne will
  117. run dial as described.
  118.  
  119. The program is pretty well self prompting but a brief
  120. explanation of the functions follows:
  121.  
  122. 1: The repeat option prompts for the number to
  123.    dial. The number is dialed until a carrier is
  124.    detected or the user aborts with ^C.
  125.  
  126. 2: The file dial option will dial numbers
  127.    sequentially from a file. At the end of the file
  128.    the program loops back to the start again.
  129.    This continues until a carrier is detected.
  130.    The file must be structured as follows:
  131.         #231-9538;comments etc.
  132.    ie a # sign followed by the number,
  133.       followed by a ; (semicolon)
  134.       followed by any comments.
  135.       Comments may continue for as many lines as
  136.       you like as the program ignores all up to
  137.       the next # sign. Example:
  138.  
  139.         #231-9538;.......RCP/M 1 Toronto
  140.         #231-1262;.......RCP/M 2 Toronto
  141.         #232-2644;.......Heath Toronto
  142.         #423-3265;.......ETI Toronto
  143.         #223-2625;.......Pet UG Toronto
  144.         #624-5431;.......PSI Word-Pro Toronto
  145.         #499-7023;.......PC Canada Toronto
  146.         #222-3626;.......Nightowl Toronto
  147.         #226-9260;.......Willowdale RCP/M, Toronto
  148.  
  149.  
  150.        I keep two files on my modem disk,
  151.  
  152.  
  153.       1: phn.lst
  154.        Which is a list of all phone numbers I have for
  155.        Bulletin Boards &/or RCP/M Systems.
  156.  
  157.        If I want a number from a file I just use the
  158.        Type option and get it.
  159.  
  160.  
  161.       2: phn.dil
  162.        Which has those more commonly called numbers in it.
  163.  
  164.        If I want to just dial until I get a carrier
  165.        I run the File dial option with the phn.dil
  166.        file as the specified file.
  167.  
  168.  
  169. 3: The search function prompts for area code and
  170.    whether or not it is long distance and then
  171.    searches that area for carriers. If one is found
  172.    it is stored to a disk file structured as shown
  173.    for number 2: above.
  174.  
  175. 4: Type will type a file one 'page' at a time.
  176.  
  177. 5: Directory displays the directory for the
  178.    selected drive and resets the disk system.
  179.    (Any disk action also relogs the drives)
  180.  
  181. 6: "M" will allow you to temporarily change the name
  182.    of the program to be loaded when a carrier is found.
  183.  
  184. 7: "I" will allow the temporary change of the modem
  185.    initialization string.
  186.  
  187. 8: "X" will jump to the named program without
  188.    waiting for a carrier.
  189.  
  190. 9: "K" will delete a file from the specified drive.
  191.  
  192.  
  193. When a carrier is found for all but the search option
  194. a bell is sounded until a key is struck at which time
  195. the named program is loaded.
  196.  
  197.  
  198. Simon Ewins,         08/13/83
  199. 676 Oriole Parkway,
  200. Toronto, Ontario.
  201.  
  202. Phone: 416-484-9427
  203.  
  204.  
  205. -------- end --------
  206.  
  207.