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