home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / kaypro / dumpkp1.lbr / DUMPK1.DZC / DUMPK1.DOC
Text File  |  1988-03-15  |  5KB  |  105 lines
  1. Note: This program (DUMPk1) is actually a rename of one of the 
  2.     many screen dump programs for the '84 series Kaypros.
  3.     The reason for the rename is that it is the only one
  4.     i've found which actually works on a Kaypro 1 (2.2u1 rom).
  5.     The compiled version included here uses ^W (control-w)
  6.     as a trigger key to dump the screen memory to the parallel
  7.     printer port (unless you alter with stat).  Enjoy, fellow
  8.     KP1 users (P. LaViscount; Multiuser Business Solutions; 15Jan87).
  9. ------------------------------------------------------------------------
  10.  
  11. Program name:  DUMPK2.COM version 2.61
  12. Function:  Screen dump for Kaypro 2X
  13. Based on DUMP10. Modified by Jon Lindsay (3/12/86)
  14.  
  15. The library file for DUMP1084 as received in version 2.6
  16. contained the following programs:
  17.  
  18.      DUMP10.OBJ
  19.      DUMP1084.DQC
  20.      DUMP1084.MQC
  21.      DUMP484.OBJ
  22.  
  23. The source code was set up for either the K-10 or K-484. Both
  24. these units use a BIOS jump table different from that used in the
  25. K-2X. Also, the source code, DUMP1084.MAC, contained several
  26. blatant errors. Version 2.61 release is meant to repair these,
  27. which are noted in the source code. At least this gets this
  28. useful program working on the Kaypro 2X.
  29.  
  30. The object code was originally loaded at FF10H, above both BDOS
  31. and BIOS. This location on the K-2X appears taken so the program
  32. is loaded just below the CCP (which on the K-2X begins at D800H).
  33. No attempt has been made to protect the code at this position.
  34. The program appears to work with most of my own software. It
  35. should be noted that other parasitic programs attempt to do what
  36. DUMPK2 is doing, namely, intercept the CONIN and CONOUT BIOS I/O.
  37. If this happens, your computer will most likely "hang." Unless
  38. coordinated, only one parasitic program at a time.
  39.  
  40. The source code can be assembled as is with Microsoft's MACRO-80.
  41. The DUMPK2.COM file assumed Kaypro CP/M version 2.2U1. <JL>
  42.  
  43. Original DOC file follows:
  44. ---------------------------------------------------------------------
  45. Using Dump10 OR Dump484
  46.  
  47. To use the screen to printer dump simply enter DUMP10 <carriage return>
  48. if you have a 10 (or DUMP484 if you have a new 4-84).
  49. From then until you either reset your computer (with the button in back)
  50. or turn it off, every time you hold the control key down and strike the W
  51. (enter control W) the ascii characters that you see on the screen of your
  52. Kaypro will be sent to the printer. This is true even if you are in another
  53. program such as DDT or your text editor. This version does not dump graphics
  54. characters.
  55.  
  56. Some people will not want to use control W for the screen dump character.
  57. You may change the character to any thing you want but realize that the
  58. character you use will be unavailable for its old purpose. Using control
  59. W has worked for me because the only time I use to use control W was in
  60. my text editor to move the cursor to the end of the next word. When the
  61. screen dump is on this is no longer the case. Control W dumps the screen
  62. to the printer and the editor never sees it.
  63.  
  64. To change the screen dump character use DDT. The process goes as follows.
  65. Everything behind the semicolons are my comments:
  66.  
  67. A>DDT DUMP24.COM    ;1. Enter this...DDT.COM must be on the disk
  68. DDT VERS 2.2
  69. NEXT PC     ;2. DDT prints this information about the program
  70. 0200 0100    ;    and itself
  71. -S160        ;3. The minus sign is DDT's prompt I entered "S160"
  72. 012E 17 00    ;4. DDT printed the first 2 #'s I entered the number
  73.         ;   of the new character to use for the ScreenDump (00)
  74. 012F C0 .    ;5. DDT printed the first 2 numbers I entered the period
  75. -^C        ;6. I enter a control C to exit DDT
  76. Warm Boot    ;7. The computers response
  77.  
  78. A>SAVE 1 NEWDS.COM    ;8. Now save as a file called NEWDS.COM
  79. A>
  80.  
  81. In the above I changed the dump screen character form 17 hex(control W) to
  82. 00 hex (control @). The hex numbers for the control characters are listed
  83. below. Now if I hit the reset button and enter NEWDS a control @ will dump
  84. the screen to the printer.
  85.  
  86. HEX  CHAR     ASCII DESIGNATION     HEX  CHAR    ASCII DESIGNATION
  87. 00 - control @     NUL               10 - control P    DLE
  88. 01 - control A     SOH               11 - control Q    DC1
  89. 02 - control B     STX               12 - control R    DC2
  90. 03 - control C     ETX               13 - control S    DC3
  91. 04 - control D     EOT               14 - control T    DC4
  92. 05 - control E     ENQ               15 - control U    NAK
  93. 06 - control F     ACK               16 - control V    SYN
  94. 07 - control G     BELL               17 - control W    ETB
  95. 08 - control H     BackSpace           18 - control X    CAN
  96. 09 - control I     HorizontalTab           19 - control Y    EM
  97. 0A - control J     LineFeed           1A - control Z    SUB
  98. 0B - control K     VerticalTab           1B - control [    ESCape
  99. 0C - control L     FormFeed           1C - control \    FS
  100. 0D - control M     CarriageReturn        1D - control ]    GS
  101. 0E - control N     SO               1E - control ^    RS
  102. 0F - control O     SI               1F - control _    US
  103. geReturn        1D - control ]    GS
  104. 0E - control N     SO               1E - control ^    RS
  105. 0F - control O     SI               1F - c