                         K S M  Helper

Expand and edit keystroke-multiply files quicckley and easily.

   The key stroke multiply filter (KSM/FLT) in Ldos5.1.x and TRSDOS6.2 lets you enter up to 26 frequently used phrases and commands by pressing a single letter key while the clear key is depressed.  It's a great time-saver with a big       drawback: editting the files that load the KSM data is inconvenient at best.
   Not anymore.  With the KSM/FLT patch and Basic prog5ram that I'll describe,  you can combine several KSM sets inot a single neat file and edit them eassily. In  addigtion, a specal directory showing all the modules helps you manage the  expanded KSM file,  If you use more than one KSM file, You'll expeccially like  this utility.

THE SETUP:

   The patches work very simply. A module number is passed to the program via   the N parameter. if this number is greater than one, the patch code reads       Your/KSM, counting through to the desired module. The patch does ont interfere  with the use of KSM/FLT on ordinary KSM files.  When the N parameter is omitted, the default value is on and the first or only module is taken.
   To install the patches, you must prepare pure ASCII files exactly as the     listing for the patch or patches that you need.  Note that the X-type patch at  theof either file is all one line. you can use the fild library command to type in the file; if you use a word processor, be sure it is capable of pure ASCII   output.  Install the  TRSDOS 6 patch with: PATCH KSM/FLT.FILTER:d JLH6:d

   Add strip (Program Listing) adds the help-full alphabetical prompts that KSM/FLT laccks,  You can only use it on the existing KSM file. to create one, start at the DOS level and enter the following command:

         BUILD filename/KSM:d
   This produces a vertical display of letters next to which you would normally type the desired words or character.  Hold the enter key down. When you pass "Z" the file closes and the build sequence terminates.
   Load Basic and Add Strip. Enter the name of your KSM file and choose the Add option.  The program adds letter prompts and Brakest around the original char-  acter sequences and writes a new file having tahe FIL extenstion.  At this stageyou can only look at the file's contents; to edit it, you must use a word-      processing program with an option for saving in ASCII. (Remember: The new  file name has the FIL Extension.)
  While editing the file, insert material immediately after the first bracket   and take special care not to overwrite the second bracket. the same holds for   deleting: Be sure to keep the brackets.  When you have the file looking just    right, save ti back to disk in ASCII, run Add strip again, and choose the strip option.  The program reads form teh new file, strips off the editing promts and writes the root back to the KSM file.
   Since there is no need to keep the fil file, you can back up the KSM file to a memdisk and perform all the Add Strip operation there.  Then write the revised KSM file back to its home disk.
   Before installing the KSM filter in DOS5.1.x you must set the driver withe the following command:

          SET *KI TO KI/.DRV

 Then use the command to install the filter:

        FILTER *KI KSM/FLT filename/KSM
   In TRSDOS 6.2 issue the following two commandt to install the filter:

       SET *KM KSM/FLT filename/KSM
       FILTER *KI *KM

INTRESTION COMBINATIONS

   To combine existing KSM files, use the DOS Append command or Add Strip'S     Append option.
   Suppose you have three KSAM files called a,b and c/KSM on disk in drive 1 and a RAM disk in drive 2.  The following steps yield combined files, Com/fil and  COM/KSM, which add the charcter count and directory to the end of COM/KSM and   let you edit CCOM/FIL.
   First, type in and enter the following:

      COPY A/KSM:1 TO COM/KSM:2

   Run Add Strip from Basic, and answer the "Filename:d>" prompt with COM:2
(the extension is unneccessary).  At the "<A>dd or <S>trip" prompt, press the A key; the program reads form COM/KSM:2 and writes COM/FIL:2
   Hold down the spacebar to advance throught the messages and review the file.  Press the enter key for a module count, and answer the "Append" prompt with 
"A" followed by the next file name, B:1.  The message, "Reading form B/KSM:1 andwriging to COM/FIL:2" will appear.
   COM/FIL now contains tow modules, and character counts appear for both.      Produceed similarly with C/KSM. Answer the "Continue"prompty by pressignt eh Y  key, and enter COM:2 for "Filname:d" then strip COM/FIL:2(press the S key) to    yield COM/KSM:2

   Three character-count lines will appear at the end of the Strip option; after each, type in a name to produce a directory (addStrip adds a line consistling  of the module number, name, and character count).
   The character count AddStrip creates is important if you want to replacae one KSM data set with another.  If the second data set is equal in length or os    shorter thatn the first the KSM installation allows the replacement; otherwise  you have to reboot.  AddStrip compines the counts with an identifying name in a simple directory.
   Use the following DOS command to display the directory neatly at the bottom  of the screen:

       LIST COM/KSM

A typical direcory might read:

      1) Basic 207
      2) DOS Cmds 189
      3) Vendors 503

   If you installed module 2 (DOS Cmds) first, you couldn't replace it with the 207-character Basic file; you could replace module 3, however, with module 1 or 2.
   To install the Vendors KSM file in LDOS5.1.x you would type the following:

       FILTER *KI KSM COM:d (N=3)

   Since the default value of N is 1, tyupeing the following :

      FILTER *KI KSM COM:d

would install the Basic ksm file.   You Can try an intresting trick in LDOS5.1.xto move form the current KSM data set to any other set in COM/KSM.  Set the Z   key to call the following command:

     FILTER *KI KSM(N=2;

Do the same with the Z key in module 2, except for setting n equal to 1; if you invoke KSM with the longer member of the two, pressing control-z whitches you to the other set (ksm interprets the simi-colon as an embedded enter command).
   These file-switching techinques are unavaiable in TRSDOS 6.2 because of the  complexity of the command structure for invoking KSM.  To replacae a KSM data   set in TRSDOS 6.2, enter the following:

     RESET *KI
     RESET *KM
     SET *KM KSM NEW/KSM(N=n)
     FILTER *KI *KM
                                                                                                                                                                           