home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / MODEMS / MODEM7 / CHGLIB22.LBR / CHGLIB22.DQC / CHGLIB22.DOC
Text File  |  2000-06-30  |  7KB  |  153 lines
  1.                 DOCUMENTATION FOR CHGLIB22
  2.                     Revision 2.2 3/12/84
  3.  
  4. Original 2/82 by Tony Ribeiro
  5. Revised  2/83 by Bruce Ratoff for MODEM79x
  6. Revised  5/83 by Dave Holmes to work with MDM707
  7. Revised  5/83 by Mark Pulver added LIBLEN Equate
  8. Revised  6/83 by Mark Pulver added real case conversion
  9. Revised  7/83 by Dennis Recla for Automatic Space Testing
  10. Revised  8/83 by Mark Pulver  file cleanup, modifiable search ranges
  11. Revised  2/84 by Robert Moroney  allow 36 entries in number list 
  12. Revised  2/84 by Charlie Polete  allow 26 or 36 entries in list
  13. Revised  2/84 by Dennis Recla... Fully automatic universal version
  14. Revised  3/84 by Sigi Kluger..   Fixed POP bug with a patch
  15. Revised  3/84 by Dennis Recla..  Fixed POP and setup single input file
  16.  
  17.  
  18.      The purpose of CHGLIB is to make insertions and deletions to 
  19. the dial library of MODEM7 without having to reassemble the 
  20. entire file.
  21.  
  22.      The program uses and changes the COM file and does not touch 
  23. or use the ASM file at all.
  24.  
  25.      NOTE:  This program will function properly only if the dial 
  26. library is faithfully constructed as spelled out in the MODEM7 
  27. documentation. It will search for the first character A and then 
  28. do a test for spacings of 30-40, (See below for more on this), 
  29. between the letters A, B, and C of the Number library. These 
  30. spacing values will meet most of the various MODEM7 programs that 
  31. have been written to now and including MDM724.  The newer versions
  32. of MDM7xx since MDM722 have larger number lists which include the
  33. numbers 0 to 9 to add an additional 10 phone numbers available.
  34. This revised version will check to see if it is an OLD version of
  35. Modem7 or one of the newest versions of MDM7xx and only allow the
  36. proper entry of alphabetic characters and or numbers.
  37.  
  38. This program will also replace M7LIB.COM as was found with later
  39. versions of MDM7xx.  It is universal in that it works with both the
  40. earlier versions and the more recent versions of MDM7xx or MODEM7.
  41.  
  42. Note:  When the directory of numbers appears on the screen it may
  43. vary from what appears when you use the CAL or NUM command when in
  44. MDM7xx.  The later versions of MDM7xx added a subroutine to organize
  45. the numbers on the screen in order from A to 9 going in a top to
  46. bottom sequence replacing the original left to right sequence of 
  47. phone numbers.  This utility program was not modified, since it is
  48. only used when it is necessary to modify the phone number listing.
  49.  
  50.      CHGLIB operates by loading the present COM version of MODEM7 
  51. into ram,allows you to make your changes to the library, and then 
  52. saves the new COM file on disk. It does not delete your orig 
  53. MODEM7 COM file. For example... 
  54.  
  55.           CHGLIB MODEM7.COM B:MODEM7A.COM
  56.  
  57.      Note that two(2) arguments can be used when invoking 
  58. CHGLIB. The first is the current file name, the second is the 
  59. file name you assign to the new version. As for the second 
  60. argument CHGLIB will not accept any file name that is currently 
  61. active on that disk. If you wish to keep the same file name, you 
  62. must delete the old version and then 'REN' the new version after 
  63. using CHGLIB.
  64.     
  65.      This new version as of Ver. 2.2 now only requires a single
  66. input file be named.  It will take the input file as the file
  67. to bring into memory for changes and before it writes the modified
  68. file to the disk it will rename the original file that exists on
  69. the disk to a .BAK extension.  This will improve the ease that the
  70. program can be used.  If you require the newfile to be on a different
  71. drive then use the original method of entry.
  72.  
  73.         CHGLIB MODEM7.COM
  74.  
  75.  
  76.      CHGLIB will do an automatic test to find the proper spacing 
  77. search for the start of the dial library.NOTE--CHGLIB searches 
  78. only the first 4K bytes of the MODEM7 file as this is where the 
  79. library is generally located. When CHGLIB beleives that it has 
  80. found the library it will display the start address and the 
  81. library on the console. It will then ask you if the library looks 
  82. ok(in other words,has CHGLIB found the correct start).If you 
  83. answer no,then the program will continue the search. If you 
  84. answer 'Y',CHGLIB will keep track of the address and jmp to the 
  85. command function.After the start address has been established you 
  86. will then get a command prompt. The COMMANDS are as follows. 
  87.  
  88.           NOTE:   *  denotes a valid char A-Z
  89.  
  90.      1)^C      Exit to CP/M, (with file change checking).
  91.      2)D*      Delete one phone number line
  92.      3)I*      Insert one phone number line
  93.      4)P       Prints dial library on list device
  94.      5)R       Rereads source file(current changes are lost)
  95.      6)V*      View one line 
  96.      7)V?      View entire library
  97.      8)W       Write new file to disk 
  98.  
  99.  
  100.     NOTE:  User can leave INSERT mode without changes if a CR is 
  101. typed with no characters entered on command line. For example,if 
  102. user has started to type in chars and decides not to make any 
  103. changes, just delete chars typed in and hit a CR.  If user enters 
  104. 'I' but has not typed in any chars,then just hit a CR.The program 
  105. will return to the command mode. Follow the the format shown on 
  106. the INSERT mode command line. You must enter exactly 30 
  107. chars.Align your input with the guide chars located above the 
  108. cursor. I have been using this program for awhile and find it 
  109. very satisfactory. It makes changes to the library very fast.
  110.  
  111.  
  112.                     TRY IT,YOU WILL LIKE IT                    
  113.  
  114.                     TONY RIBEIRO
  115.                     AVENEL NJ
  116.                     FEB 1982
  117.  
  118. And Others........
  119.  
  120. -----------------------
  121. ; Modification Note:  ;
  122. -----------------------
  123.  
  124.      Starting with version 1.6 of this program, it is possible to 
  125. change the number library search ranges without having to re-
  126. assemble the program. There are two bytes up front in the memory 
  127. image, the first occurs at address 0103H and holds the lower 
  128. limit, while the next byte, 0104H, holds the upper spacing limit.
  129.  
  130.      You can use DDT to make the mods as in the following 
  131. example, ( lowercase text is what you type in )...
  132.  
  133.  
  134.      A>DDT CHGLIB.COM<cr>          ; load CHGLIB into memory
  135.      DDT VERS 2.2           ; DDT signon
  136.      NEXT  PC       
  137.      0C80 0100                               
  138.      -s103<cr>                     ; the lower limit is at 0103H
  139.      0103 1E xx<cr>                ; 'xx' is the HEX value for the
  140.                                    ; lower limit
  141.  
  142.      0104 28 xx<cr>                ; 'xx' is the HEX value for the 
  143.                                    ; upper limit
  144.      0105 31 .<cr>                 ; a '.' will get you out of set mode
  145.      -^C                           ; a control C will put you at CP/M
  146.      A>save 12 chglib.com<cr>      ; and save the file to disk
  147.      
  148.  
  149.      The program will now search, in 1 byte increments, the range 
  150. that you have specified.
  151.  
  152.  
  153.