home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / MEMORIA / PKII_127.ZIP / PKII.DOC < prev    next >
Encoding:
Text File  |  1989-06-14  |  32.7 KB  |  581 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       POWERKIT II (PKII.MOD) Documentation
  8.  
  9.  
  10.                                     May 1989
  11.                                   Version 1.24
  12.  
  13.  
  14.                       Copyright 1987-89 by John H. Brooks.
  15.                               All rights reserved.
  16.                    Permission is granted to distribute copies
  17.                       of this documentation, and unaltered
  18.                     copies of the full POWERKIT II package.
  19.  
  20.  
  21.     DISCLAIMER: This software is sold "as is."  No warranty is given, either 
  22.     express or implied, that any specific POWERKIT feature will work on any 
  23.     particular machine.  The manufacturer will not be liable for any damage 
  24.     caused by the use of POWERKIT. 
  25.     
  26.     The names of hardware and software products, and companies mentioned in 
  27.     this document are trademarks or service marks of the respective companies.
  28.  
  29.     To users registered prior to December 22, 1988, POWERKIT II is a $5 upgrade.
  30.  
  31.     FORWARD: Welcome, I'll be brief.  I'm asking you to please pay for POWERKIT
  32.     II if you use it.  At $19.95 (for the entire POWERKIT II package), I be-
  33.     lieve the price is fair.  Give POWERKIT II a good workout, then remit to: 
  34.     
  35.                              CENTRAL DATA SERVICES
  36.                                1641 WINONA COURT
  37.                                DENVER, CO 80204
  38.                                 (303) 595-4218
  39.  
  40.     SUPPORT FOR POWERKIT: Since there are so many different video cards, 
  41.     versions of PC/MS-DOS, flavors of the BIOS ROM, hardware configurations, 
  42.     all calling themselves "PC (or AT) compatible," the "non-guarantee" above 
  43.     is regrettable but necessary.  Obviously, you won't buy POWERKIT if it 
  44.     doesn't work on your machine, but if you could spare a few moments to let 
  45.     me know what would not work, and what kind of machine you have, I'll do my 
  46.     best to get POWERKIT to work on your machine.  As many registered users of 
  47.     POWERKIT have already discovered, I intend to have POWERKIT be one of the 
  48.     best supported SHAREWARE (or commercial, for that matter) programs in the 
  49.     business.  SEE PAGE 11 FOR INFORMATION ON POWERKIT II'S ONLINE SUPPORT.
  50.  
  51. INTRODUCTION: PKII.MOD is small, about 2100 bytes of it stay in memory. If each 
  52.         of PKII.MOD's tasks were to be done by separate "COM" programs, many 
  53.         thousands of bytes would be used.  Almost all of PKII.MOD's operations 
  54.         may be controlled from the command line (the DOS prompt or a line in 
  55.         AUTOEXEC.BAT), with a keyboard "hot" key, or from a pop-up "1-2-3" 
  56.         style menu, even while you are inside another program.  Many can be 
  57.         disabled, if your favorite utility program does the same thing.  After 
  58.         all, PKII.MOD uses very little memory. 
  59.  
  60. Page 2 
  61.  
  62.         
  63.         You will like the way PKII.MOD handles your keyboard.  A key, when 
  64.         pressed, starts to repeat after a waiting period whose length you set, 
  65.         accelerates smoothly at a rate you set to a top speed you set, and when 
  66.         released, "stops on a dime."  Keystrokes also may be made to repeat 
  67.         very slowly, or to repeat not at all.  PKII.MOD's AutoPilot lets you 
  68.         teach your machine how to do a repetitive task, while you sit back and 
  69.         relax.  If that's not enough, add an extra large keystroke buffer and 
  70.         an ability to view what's in it, a way to route printer output to your 
  71.         screen, an escape hatch from programs that falter, a screen blanker, a 
  72.         floppy disk motor early shut-off, a way to protect your machine from 
  73.         prying eyes and mischievous fingers (even at bootup), a few other 
  74.         things, and there's HOOK. 
  75.         
  76.         HOOK is unique.  HOOK will open up many of those programs that won't 
  77.         let your "can't live without" pop-up utilities pop up.  HOOK will do 
  78.         other things too (see /K)eyboard redefine, and KEYPAD 5, H, page 8). 
  79.  
  80. LESS EXPERIENCED PC USERS: Don't be put off by the wealth of more or less 
  81.         technical data which follows.  You already know how to get PKII.MOD 
  82.         working, and almost everything else you need to know is at your finger-
  83.         tips, by pressing ALT-/.  Also, if you press KEYPAD 5, then the F1 key, 
  84.         a help screen, independent of the menus, will pop up. 
  85.  
  86. COMMANDING PKII.MOD: Most PKII.MOD parameters may be set by including them 
  87.         after the "PKII.MOD" when you call it, and several MUST be set from 
  88.         there.  For example, typing: 
  89.  
  90.                      LOAD C:\PKII\PKII.MOD/M15/W5/d2/f110/e68 
  91.         
  92.         will set the floppy disk motor to shut off after 1.5 seconds (15 
  93.         tenths), the wait before repeating a keystroke to 1/2 second (5 
  94.         tenths), the display to switch off after 2 minutes (if no keys have 
  95.         been pressed during that time), the keystroke repeat speed to a maximum 
  96.         of 110 keystrokes per second, and sets the default drive, where 
  97.         PKII.MOD looks for COMMAND.COM when it "shells" out of a program, to 
  98.         "D" (68 is the decimal ASCII code for "D").  The commands may be 
  99.         entered in any order, in lower or UPPER case.  The C:\PKII\ means you 
  100.         have stored PKII.MOD on Drive C:, in directory PKII.  The commands may 
  101.         be entered in any order, in lower or UPPER case. 
  102.  
  103.         The following commands can be given ONLY from the command line.
  104.  
  105.         /An, n = 0 to 9 (or thereabouts) tells PKII.MOD the number of phony 
  106.         keystrokes to insert between each "real" keystroke.  This is a means to 
  107.         curb repeating key overshoot in especially recalcitrant programs. 
  108.  
  109.         /Rn, n = 0 to 9 (or more) tells PKII.MOD the number of times to "lie" 
  110.         to an application about the status of the keystroke buffer.  Its 
  111.         purpose is the same as /An above.  See page 8 for further details. 
  112.  
  113. Page 3
  114.  
  115.         /Cn, n = 0 or 1 toggles CAPS/SHIFT LOCK (see KEYPAD 5, C, page 9) When 
  116.         ON, and when CAPS is ON too, pressing a SHIFT key will NOT produce a 
  117.         lower case letter. 
  118.         
  119.         /En, n = 65 to 90 (these are the ASCII codes for A-Z), sets the drive, 
  120.         floppy, "ram", or hard, where PKII.MOD looks for COMMAND.COM when it 
  121.         exits an application program and allows you to load and run another 
  122.         program, format a disk, etc.  COMMAND.COM must be in the "root" dir. 
  123.  
  124.         /M)otor off after 1 to 255 tenths seconds.  This command has nothing 
  125.         to do with speeding up floppy disk input or output, it merely allows 
  126.         the computer to turn off the floppy disk drive motor after so many 
  127.         tenths of a second.  I included this command in PKII.MOD to let you get 
  128.         back to work more quickly after a disk access (the keyboard sometimes 
  129.         won't work while the drive motor is on).  Also, it is not always safe 
  130.         to remove a disk from the drive while the motor is on (stray magnetic 
  131.         fields produced by the motor could garble the data on your disk).  If 
  132.         you tell PKII.MOD nothing about motor shutoff, PKII.MOD will set it to 
  133.         one second.  /M0 makes PKII.MOD ignore motor shut off. 
  134.         
  135.         /Nn, N = 0 or 1, forces shell to DOS to use current active display page 
  136.         (n = 0), or change to a new display page (n = 1).  Also see page 10. 
  137.         
  138.         /On, n = 0 to 25 (1 = top of screen), sets the line on which the cursor 
  139.         will appear after PKII.MOD completes its initialization.  The default 
  140.         is line 25.  If you don't like that "CURSOR VANISH?" message, set /O25 
  141.         (or any other setting) to make it go away.  /O0 clears the screen and 
  142.         puts the cursor at the top of the screen. 
  143.         
  144.         /K)eyboard redefine, from its name, you might think is a replacement 
  145.         for ANSI.SYS. It is NOT, it is a supplement to ANSI.SYS and the other 
  146.         similar keyboard redefinition programs.  For the technically inclined, 
  147.         ANSI.SYS redefines the keyboard by replacing the (extended) ASCII code 
  148.         generated by one key, with the extended ASCII code generated by a dif-
  149.         ferent key.  However, some programs don't even bother to look at ASCII 
  150.         codes, so /K)eyboard redefine (used with HOOK, see page 9) works by 
  151.         replacing the "scan" code generated by one key with the scan code of a 
  152.         different key. 
  153.  
  154.         From here on the going gets kind of tough for awhile, so I'll go slow-
  155.         ly.  There is a type of program let's call a KIM, a Keyboard Interrupt 
  156.         Monopolizer.  If you own SIDEKICK, or a similar program, and you tried 
  157.         to call it up by pressing CTRL-ALT (or some other HOT key) while in-
  158.         side another program, and it either wouldn't pop up or your machine 
  159.         froze, that program you were inside was a KIM.  KIM's have other prob-
  160.         lems, too.  The older KIM's have no way of recognizing the larger key-
  161.         boards that come with many of the newer PC compatibles, except for the 
  162.         keys corresponding to the old 83 key "standard PC keyboard."  This 
  163.         means you can't use that nice separate cursor keypad while working 
  164.  
  165. Page 4 
  166.  
  167.         within the KIM, for example.  PKII.MOD's /K)eyboard redefine, in 
  168.         conjunction with the HOOK command could help you with that problem. 
  169.         /K)eyboard redefine takes two forms.  One, you can put pairs of scan 
  170.         codes on the "PKII.MOD" command line; a "/" then the decimal scan code 
  171.         you wish to redefine, followed by "/" plus the decimal scan code you 
  172.         wish it to be, repeating this for each key to be redefined.  For 
  173.         example, what you see below makes the keyboards of TANDY 1000's or 
  174.         2000's work just fine inside most KIM's: 
  175.  
  176.      /K41/72/43/75/74/80/78/77/88/71/89/41/90/43/85/78/83/74/87/28/86/83/84/70 
  177.        ^ NOTE: no slash needed for first number 
  178.  
  179.         Obviously, you need to know something about scan codes to do this, 
  180.         which leads to the second way /K can be used.  Putting /K on the 
  181.         "PKII.MOD" command line, followed by nothing at all, or followed by 
  182.         another PKII.MOD command (like /k/h, for example) causes PKII.MOD to 
  183.         help you find the scan codes.  First, the machine will start its normal 
  184.         boot-up procedure. When it loads PKII.MOD, a beep will occur, and the 
  185.         display will read: 
  186.  
  187.         Press key to be changed, ESC to quit: 
  188.  
  189.         /k 
  190.         
  191.         Press a key, and its scan code (in decimal) will appear behind the /k, 
  192.         you will hear another beep, and the display will show: 
  193.  
  194.         Press key to change to: 
  195.  
  196.         /kXX 
  197.  
  198.         The XX above represents the scan code of the first key pressed.  Press 
  199.         a second key; its scan code will appear as /kXX/YY.  Another beep, and 
  200.         the "Press key to be changed, ESC to quit:" prompt will reappear.  In 
  201.         this way you can tell PKII.MOD which keys you want redefined.  For 
  202.         example, to get that long line of redefined scan codes shown above (on 
  203.         a TANDY 1000), do the following (keypad means the numeric keypad): 
  204.         
  205.         PRESS           THEN PRESS      ACTION 
  206.         up arrow        keypad 8        fixes up arrow key 
  207.         down arrow      keypad 2        fixes down arrow key 
  208.         left arrow      keypad 4        fixes left arrow key 
  209.         right arrow     keypad 6        fixes right arrow key 
  210.         HOME            keypad 7        fixes HOME key 
  211.         F11             up arrow        makes F11 print ` and ~ 
  212.         F12             left arrow      makes F12 print \ and | 
  213.         INSERT          right arrow     changes INSERT to grey + 
  214.         DELETE          down arrow      changes DELETE to grey -
  215.         keypad ENTER    ENTER           fixes keypad ENTER 
  216.         keypad .        DELETE          changes keypad . to DELETE 
  217.         BREAK           HOLD            fixes CTRL-BREAK 
  218.         ESC                             saves scan codes and exits 
  219.         (inside a KIM, keypad 0 will probably act like INSERT) 
  220.  
  221. Page 5 
  222.  
  223.         In general, for any extended keyboard, you can use the first five 
  224.         sequences above for the ARROW and HOME keys, and in addition: 
  225.  
  226.         PRESS           THEN PRESS      ACTION 
  227.         END             keypad 1        fixes END key 
  228.         PG UP           keypad 9        fixes PG UP key 
  229.         PG DN           keypad 3        fixes PG DN key 
  230.         INSERT          keypad 0        fixes INSERT key 
  231.         DELETE          keypad .        fixes DELETE key 
  232.         ESC                             exits
  233.  
  234.         PKII.MOD has enough room for 15 redefined keys.  After all this, the 
  235.         line on the display starting with /k will show the necessary scan codes 
  236.         to put on the "PK" command line before you next run the KIM; but there 
  237.         is no need to reboot the computer now, just write down the /k line for 
  238.         future reference.  PKII.MOD has saved these codes, and after you do 
  239.         just one more thing, you can load the KIM and have your keyboard work 
  240.         properly.  That final task is to activate HOOK while the CAPS key is 
  241.         turned ON.  HOOK is activated by KEYPAD 5, H.  See page 8 for a 
  242.         complete discussion of HOOK.  Turning on HOOK with CAPS ON tells 
  243.         PKII.MOD to feed the new scan codes to the KIM. 
  244.         
  245.         /L)ock machine at bootup, like /K above, takes two forms.  Putting /L 
  246.         on the line with no parameters will show the (decimal) scan codes of 
  247.         the keys you press, until you press ESC, to use in a password that will 
  248.         have to be entered before the machine will continue booting up.  Using 
  249.         parameters with /L will define the password.  For example: 
  250.  
  251.         /l30/48/46/32
  252.           ^ NOTE: no slash needed for first number 
  253.  
  254.         will define the password "ABCD".  The password may contain up to eight 
  255.         keystrokes.  This password will protect only against children or casual 
  256.         meddling.  However, on a machine with a hard disk, and with some addit-
  257.         ional hardware/software changes, this password could provide one more 
  258.         "layer" of protection for "sensitive" data.  BE SURE to put ECHO OFF in 
  259.         your AUTOEXEC.BAT file when using this feature. 
  260.  
  261.         /Sn, n = 18 to 255 is a speedup factor.  It does this by stretching the 
  262.         time between memory refreshes in your machine.  It works on IBM PC's 
  263.         and AT's, and a few clones that are SO COMPATIBLE, they even use the 
  264.         same refresh interval.  Modern memory chips no longer need to be re-
  265.         freshed as often as the IBM machines do it.  /S255 should work on any 
  266.         machine whose memory chips have been manufactured in the last five 
  267.         years.  If not, lower the n in /Sn, until it does work.  The speedup is 
  268.         5% on 4.77 Mhz machines (PC's), up to 20% on some 12 Mhz AT clones. 
  269.  
  270.         /Tn enables an algorithm that blanks HERCULES brand display adaptors.  
  271.         If you have an Hercules "compatible" adaptor, it probably can be 
  272.         blanked without invoking this command. 
  273.  
  274. Page 6 
  275.  
  276.  
  277.         /T1 -- Tests for an Hercules adaptor.  If present, enables blanking.
  278.         /T2 -- Activates Hercules blanking without testing first.
  279.  
  280.         /Vn, n = 91 to 255, is the number of timer ticks your machine makes in 
  281.         5 seconds.  The default is 91. 
  282.  
  283.         /Xn adjusts the time it takes repeating keystrokes to get up to top 
  284.         speed, (a speed you can set according to your own taste, see KEYPAD 5, 
  285.         F page 7). 
  286.  
  287.         /X0 -- Repeating keystrokes start out at top speed.
  288.         /X1 -- Repeating keystrokes accelerate smoothly, but quickly, to their 
  289.                top speed.
  290.         /X2 -- Repeating keystrokes accelerate rather more slowly than with 
  291.                the /X1 setting.  This is the default setting.
  292.  
  293.         /Y0 turns off PKII.MOD's Scroll Lock key handler (see page 9).
  294.  
  295.         /Z1 -- Turns on the much louder "system beep" and turns off PKII.MOD's.
  296.         
  297. OTHER COMMANDS that may be put on the "PKII" command line are:
  298.  
  299.         /D)isplay off 
  300.         /F)ast repeat
  301.         /H)ook  
  302.         /P)rinter output to screen, 0 (off) or 1 (on).
  303.         /W)ait before repeating
  304.  
  305.         NOTES: To redefine PKII.MOD's hot key, use the utility NEWHOTKY.COM 
  306.         (see NEWHOTKY.DOC for an explanation of the simple procedure).  Note 
  307.         also that when HOOK is placed on the command line, and you wish it to 
  308.         be used with /K)eyboard redefine, make sure the CAPS key is ON while 
  309.         your machine is booting up. 
  310.         
  311. COMMANDS ACCESSED BY PRESSING AND RELEASING KEYPAD 5:  What follows are 
  312.         descriptions of the PKII.MOD commands accessed from the keyboard.  
  313.         First, the "5" key on the numeric keypad (SHIFT KEYPAD 5 when NUM LOCK 
  314.         is "on") must be pressed, RELEASED, then the indicated COMMAND key 
  315.         pressed and released.  If the command needs more input (numbers or 
  316.         letters), enter them when you hear a beep.  Press ENTER when finished.  
  317.         If you press KEYPAD 5 by accident, press it AGAIN to cancel. 
  318.  
  319. KEYPAD 5, ESC: Many times can bring you back to the DOS prompt from a hung or 
  320.         crashed program.  When KEYPAD 5, ESC does succeed, when you have pre-
  321.         cious unsaved data on a ramdisk for example, PKII.MOD will have earned 
  322.         its keep.  If KEYPAD 5, ESC doesn't work, and if PKII.MOD's scroll lock 
  323.         key handler is active (see page 9), press SCROLL LOCK (HOLD on some 
  324.         machines), then ESC.  If you hear a "beep" when you press KEYPAD 5 or 
  325.         SCROLL LOCK,  it's almost certain you will escape from your trouble. 
  326.         
  327.         NOTE: A few programs have their own escape routines.  If they exist, 
  328.         they are invoked by either CTRL-BREAK or CTRL-C (usually). 
  329.  
  330. Page 7
  331.  
  332. KEYPAD 5, W: At the beep, entering a number from 1 to 60, followed by ENTER, 
  333.         will set the delay before keystrokes begin to repeat to that many 
  334.         tenths of a second.  Enter zero if you wish to go back to your old, 
  335.         sluggish keyboard.  But then, PKII.MOD tasks associated with KEYPAD 5 
  336.         W, F, S, A, and R will no longer work. 
  337.  
  338. KEYPAD 5, F: At the beep, entering a number from 5 to 255, followed by ENTER, 
  339.         will set the maximum speed a keystroke repeats to that many repeti-
  340.         tions per second, give or take 2 reps./second.  The actual repetition 
  341.         rate will be determined by how fast the application program can handle 
  342.         keystrokes (ANSI.SYS slows the repeat rate, for example).  Enter zero 
  343.         and the keyboard will work like an old-fashioned typewriter keyboard 
  344.         (no auto-repeat, a more comfortable mode for those with disabilities). 
  345.  
  346.         NOTE 1: Use KEYPAD 5, S (see below) for 1 rep./sec, or slower.
  347.  
  348.         NOTE 2: Some repeat speeds are smoother than others.  This is deter-
  349.         mined by the tick rate of the system clock.  For most PC compatibles, 
  350.         5, 10, 19, 37, 55, 74, 92, 110 reps./sec. are the smoothest.  Also, 
  351.         adding 2 or 3 lies/rep. (KEYPAD 5, B, 2 or 3) smooths things out. 
  352.  
  353. KEYPAD 5, S: At the beep, entering a number from 1 to 255, followed by ENTER, 
  354.         will repeat a keystroke (or a sequence of keystrokes) every that many 
  355.         seconds.  This is used mainly with AutoPilot (KEYPAD 5, A below). 
  356.  
  357. KEYPAD 5, A: Activates AutoPilot.  At the beep, enter a keystroke.  The key-
  358.         stroke may represent a MACRO thousands of bytes long, but it doesn't 
  359.         matter, the keystroke (or MACRO) will repeat until you touch another 
  360.         key. 
  361.  
  362.         NOTE: Because of the peculiar nature of the programs we have dubbed 
  363.         KIM's (page 3, or see KEYPAD 5, H, page 8), there are actually two 
  364.         AutoPilot routines.  Therefore, an AutoPilot sequence that has been 
  365.         defined outside a KIM won't work inside a KIM, and vice versa.  Use 
  366.         KEYPAD 5, A, with CAPS turned ON, to destroy saved keystrokes before 
  367.         "hooking" and entering a KIM, or before leaving a KIM.  PRESSING and 
  368.         RELEASING the CTRL, ALT, or SHIFT keys will count as ONE of the six-
  369.         teen permitted keystrokes while inside a KIM, while these key presses 
  370.         DON'T count against the sixteen when outside a KIM. 
  371.  
  372.         I am certain that AutoPilot will be used in ways I could never dream 
  373.         of.  If you must dump your "KEY" program to load a large application, 
  374.         AutoPilot will be there to restore some of its function by using Auto-
  375.         Pilot together with the at least rudimentary MACRO capability most 
  376.         application programs now have.  A single PG DN keystroke can be set to 
  377.         repeat at a comfortable pace, to let you read a document in your word 
  378.         processor without touching the keyboard.  To snoop through the BIOS ROM 
  379.         using DEBUG's UNASSEMBLE command, set the keystrokes to U, and RIGHT 
  380.         SHIFT-ENTER.  When something interesting appears, press RIGHT SHIFT, 
  381.         examine it more closely, then continue snooping with KEYPAD 5, A.  
  382.         Suppose you would like to eliminate an entire column of a table in one 
  383.         of your applications.  You know the application has a very slick method 
  384.         of doing this, but you can remember only how to eliminate one line of
  385.  
  386. Page 8
  387.  
  388.         the column at a time.  You can go to the user's manual, or it might be 
  389.         quicker to go to AutoPilot, enter the single line commands, plus a DOWN 
  390.         ARROW keystroke. 
  391.  
  392. KEYPAD 5, R: At the beep, enter A or B.  This sets the "plan" to use to inhib-
  393.         it repeating key overshoot, when inside certain programs.  Plan "A" 
  394.         inserts unusable "null" keystrokes between each "real" keystroke. How-
  395.         ever, some programs are just too smart for their own good and discard 
  396.         these null keystrokes before they can fill its buffer and prevent "run-
  397.         on".  Hence the need for Plan "B".  Plan "B" tells the program a 
  398.         "little white lie", but it's "for its own good".  It sends a "no key-
  399.         stroke in buffer" report back to the program, several times, before 
  400.         sending the "true" message.  You can use these two plans together.  If 
  401.         CAPS = ON when choosing a plan, the values for the other plan will not 
  402.         be erased.  After entering A or B (after the second beep), enter the 
  403.         number of null keystrokes (or fibs) to insert between each "real" 
  404.         keystroke, then press ENTER. 
  405.         
  406.         You may never use this command.  The majority of programs use the 
  407.         keystroke buffer supported by the BIOS (delineated by the two words at 
  408.         40h:80h).  PKII.MOD sees to it that, while a key is repeating, this 
  409.         buffer never contains more than one keystroke. Hence, overshoot is 
  410.         impossible. 
  411.  
  412.         However, KIM's (see page 3 or below) and some non-KIM's maintain their 
  413.         own keystroke buffers and couldn't care less that your cursor keeps 
  414.         moving after you release it.  Experiment with combinations of KEYPAD 5, 
  415.         F (repeat speed)  and KEYPAD 5, R, A, B, and n.  Overshoot may not be 
  416.         eliminated, but is almost always reduced.  For example, setting KEYPAD 
  417.         5, F to 92 and KEYPAD 5, R to "A,3" eliminates overshoot in QuickBASIC 
  418.         3.0, a non-KIM which, nevertheless, keeps its own 8 key-stroke buffer.  
  419.         Setting KEYPAD 5, F to 37 and KEYPAD 5, R to "A,5" only reduces over-
  420.         shoot in QuickBASIC 2.0, a KIM which must be "hooked" (see below), and 
  421.         which keeps a 16 keystroke buffer.  BRIEF (v2.01) works fine with 
  422.         PKII.MOD's default setting (2 fibs, 0 nulls), but on slower machines, 
  423.         your cursor will move faster using 1 null, 0 fibs. 
  424.  
  425.         NOTE: Some programs object mightily to the null keystrokes Plan A uses 
  426.         to control overshoot.  PC-Write (and LIST), for example, sounds like a 
  427.         moonstruck cricket when nulls are set to greater than zero.  These 
  428.         plans may also be used to make repeats look smoother.  LOTUS 1-2-3 has 
  429.         the WORST overshoot problem I've ever seen (44 extra repeats).  It 
  430.         "chokes" on Plan A, but Plan B, with "fibs" set to 5, fixes things 
  431.         right up. 
  432.  
  433. KEYPAD 5, H: The HOOK command is designed to outwit those application programs 
  434.         I call Keyboard Interrupt Monopolizers, or KIM's for short.  You prob-
  435.         ably have a KIM in your library. It's a program such that after you 
  436.         load it, your favorite pop-up utilities won't work until you exit it.  
  437.         Activate HOOK just before you load the KIM.  If you hear a beep when 
  438.         the KIM starts to execute, then HOOK probably has intercepted the pro-
  439.         gram successfully and your pop-ups (including PKII.MOD) should work. 
  440.         Deactivate HOOK after you leave the KIM by entering KEYPAD 5, H again.  
  441.         No beep this time. 
  442.  
  443. Page 9
  444.  
  445.         FOR ADVANCED USERS: If CAPS LOCK is ON when you invoke HOOK, the KIM 
  446.         will be fed SCAN CODES determined from the table developed from data 
  447.         entered with the /K)eyboard redefine command.  See page 3 for a dis-
  448.         cussion of this command. This solves most of the problems many KIM's 
  449.         have with keyboards possessing more than the standard 83 "PC" keys. 
  450.         Some keyboards omit either the "make" or "break" signal when the lights 
  451.         (called LED's) in the CAPS or NUM LOCK keys are turned off or on.  
  452.         These keys will still have to be pressed four times to put them through 
  453.         a complete cycle (while inside a KIM). 
  454.  
  455.         SAD NOTE 1: No "keyboard macro" program (these programs usually have 
  456.         "KEY" somewhere in their name) that I am aware of will work inside a 
  457.         KIM, even a "hooked" KIM.  AutoPilot produces a (repeating) keyboard 
  458.         macro and that is why two separate AutoPilot routines were necessary. 
  459.  
  460.         SAD NOTE 2: PKII.MOD will not "hook" some KIM's.  These are KIM's that 
  461.         do not use DOS services to attach themselves to interrupts.  Also, 
  462.         hooking a non-KIM will sometimes hang the machine. 
  463.  
  464.         QuickBASIC APPLICATIONS: Programs compiled with any QuickBASIC 
  465.         compiler, and which use the ON KEY command, must be "hooked" before 
  466.         pop-up utilities will work properly. 
  467.  
  468. KEYPAD 5, V: Opens (and closes) a view-port into the keystroke buffer.  Your 
  469.         most used applications probably have become so familiar to you, you 
  470.         know long beforehand what comes next and what you want to do about it.  
  471.         However, distractions occur and you can "lose your place" while typing 
  472.         "blind" into the keystroke buffer.  At these times a view-port is use-
  473.         ful. The view-port expands and contracts according to how many unused 
  474.         keystrokes are left in the buffer.  Reenter the command to close the 
  475.         view-port. 
  476.  
  477. KEYPAD 5, L: Lets you blank the screen and lock up the keyboard.  After 
  478.         pressing KEYPAD 5, L, the screen will blank (if you haven't disabled 
  479.         blanking).  At the beep, just press ENTER if you want no password pro-
  480.         tection, or enter up to a four keystroke password, then press ENTER.  
  481.         To get your machine back, PRESS and RELEASE the RIGHT SHIFT key and 
  482.         reenter the password.  Incidentally, your machine will go on computing 
  483.         while locked, if no keyboard input is needed. 
  484.  
  485. KEYPAD 5, D: At the beep, entering a number from 1 to 60, followed by ENTER, 
  486.         sets the display to turn off after one to sixty minutes of keyboard 
  487.         inactivity.  KEYPAD 5, D, 0 disables screen blanking.  Blanking is im-
  488.         portant for monochrome displays, to preserve their phosphor coatings.  
  489.         PKII.MOD's default setting is screen blanking DISABLED.  See page 5, 
  490.         /Tn, for instructions on enabling Hercules brand MGA card blanking. 
  491.  
  492. KEYPAD 5, C: Toggles a feature that, when ON (beep), and when CAPS is ON too, 
  493.         pressing a SHIFT key will NOT produce a lower case letter. 
  494.  
  495. KEYPAD 5, Y: Toggles PKII.MOD's SCROLL LOCK key handler on/off.  PKII.MOD turns 
  496.         the Scroll Lock key into what (I think) it should have been all along.  
  497.         Pressing the key will freeze a scrolling display until you press SCROLL 
  498.         LOCK again, allowing you to examine its contents at your leisure (now 
  499.  
  500. Page 10
  501.  
  502.         that's much easier than CTRL-NUM LOCK, isn't it?).  A beep will tell 
  503.         you when the display has been frozen, and beeps will greet your every 
  504.         key press, until you press SCROLL LOCK again.  Toggle it OFF, when a 
  505.         program has its own designs on the SCROLL LOCK key (but then, you 
  506.         cannot take advantage of what is mentioned in the NOTES below). 
  507.  
  508.         SCROLL LOCK NOTES: Pressing SCROLL LOCK, then ESC, is probably a surer 
  509.         way of escaping from a lockup, than KEYPAD 5, ESC. 
  510.  
  511.         Pressing SCROLL LOCK, then F1, "warm boots" your machine (you must set 
  512.         the /w1 option for KYBD.BUF, in CONFIG.SYS, first).  This is mainly for 
  513.         Tandy 1000 users, or for users of other machines whose warm boot rou-
  514.         tines are SLOW.  However, if your machine lacks a clock/calendar chip, 
  515.         you too might wish to use it, as it preserves the time and date.  Also, 
  516.         this warm boot takes a much shorter path, so is likely to work when 
  517.         CTRL-ALT-DEL does not. 
  518.         
  519. KEYPAD 5, P: Directs output normally destined for the printer, to the screen.  
  520.         This is handy when no printer is available and you must use a program 
  521.         that demands a printer be attached (when you are using a PC compatible 
  522.         laptop away from the office, for instance).  It also lets you preview 
  523.         the formatting of a document without wasting a lot of time and paper, 
  524.         if you don't have a WYSIWYG (what you see is what you get) text editor. 
  525.         Pressing KEYPAD 5, P a second time turns off this feature. 
  526.  
  527.         NOTE: I always boot up with /P1 on the "PKII.MOD" command line, because 
  528.         it's easy to activate Print Screen inadvertently, with no printer 
  529.         online. 
  530.  
  531. KEYPAD 5, E: Exits an application program, and puts you at the DOS prompt.  
  532.         There, you can perhaps do some little thing that you forgot to do be-
  533.         fore you entered the application (like format a new disk if the disk 
  534.         you are using is full, and the application wants to write more data).  
  535.         To return to the application, type "exit" at a DOS prompt.  If you have 
  536.         a graphics adaptor (CGA, EGA, etc.), PKII.MOD exits to a different dis-
  537.         play page, so as not to mess up your screen.  With a single page adap-
  538.         tor (MDA), there is no choice, sorry.  However, a less confusing dis-
  539.         play will result if you place the cursor at the bottom of the screen 
  540.         prior to exiting to DOS.  See also the switch, /N on page 3. 
  541.         
  542.         PKII.MOD has to find COMMAND.COM in order to do this little trick, and 
  543.         it is not very smart, it looks for COMMAND.COM only in a "root" direc-
  544.         tory (the directory you are in when you type "B:", say, at the DOS 
  545.         prompt).  The default is the "root" directory on drive "A", but you can 
  546.         change this drive at bootup with the "/E" switch (see page 3). 
  547.  
  548.         CAUTION: Don't shell to DOS at the DOS prompt (doesn't make sense), and 
  549.         especially, NOT at bootup. 
  550.  
  551. CONFLICTS WITH OTHER PROGRAMS: Other times when PKII.MOD and other TSR's or 
  552.         application programs don't work well together occur because the other 
  553.         program is trying to do some of the same things PKII.MOD is doing, such 
  554.         things as enlarging the keystroke buffer, blanking the screen, or 
  555.         speeding up the cursor.  When this happens, disable the contested 
  556.         function, either in PKII.MOD or in the other program (in the case of 
  557.         ANSI.MOD's extended keystroke buffer, simply don't enable it). Finally, 
  558.         you must change PKII.MOD's HOT key if it means something to the other 
  559.         program. 
  560.  
  561. Page 11
  562.  
  563. ONLINE SUPPORT FOR POWERKIT II: If you have a modem, you can get prompt answers 
  564.         to your questions by contacting me on Dr. File Finder's Black Bag (tm) 
  565.         BBS.  The phone number is: (901) 753-0213.  You need not be a register-
  566.         ed user to ask me a question or two.  The easy way to register POWERKIT 
  567.         II is right online, with your VISA or Master Card. 
  568.  
  569. That's it, you're on your own.  Enjoy POWERKIT II and please don't forget to 
  570.         send $19.95 (this price is for the entire POWERKIT II package, not 
  571.         just PKII.MOD).
  572.  
  573.  
  574.                                  CENTRAL DATA SERVICES
  575.                                    1641 WINONA COURT
  576.                                    DENVER, CO 80204
  577.                                     (303) 595-4218
  578.  
  579.  
  580.  
  581.