;
                                  Z3KEY.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              14k        A490  1.4        Arnold Bailey 5/86       Z3RCP1 

  1- Z3KEY.RCP  2- Z3KEY.COM  3- Super-Shift Mode  4- Source Files            


   Z3KEY is  a keyboard redefinition program designed for ZCPR3.  Z3KEY.RCP is 
a resident  command processor that  allows you  to assign character strings to 
keys.  Z3KEY.COM allows you  to save  definitions, re-define the attention and
lead-in characters, set/reset the case flag, and set the delay time.

   Key definitions may  be  loaded  from  files  containing  previously  saved
definitions, or they  may  be  defined  on-the-fly,  even  while  a program is 
running.  Both normal  keys (i.e., keys  generating  a single  character)  and
keys  generating escape  sequences  are supported.  Also  supported are Super-
Shift sequences for keyboards without function keys.   
:1


Z3KEY.RCP Commands:

   KEY+    - turns on the key redefinition program.  The user may then 
             redefine keys as necessary.

   KEY-    - turns off the key redefinition program.  This must be done
             before replacing Z3KEY.RCP with another RCP to avoid trashing 
             the BIOS conin and const pointers.

   CASE+   - turns on the case translation flag.  Any char sent as part of a
             lead-in char sequence will be automatically upcased.  For 
             example, if '\' was used as the lead-in char, the sequence '\a'
             and '\A' would be equivalent.

   CASE-   - turns off the case translation flag.

   KSTAT   - displays whether Z3KEY is active and the status of the case flag.

   KEYS    - displays the present key definitions a page at a time.
:2


                              Z3KEY.COM Utility

Installation

   Z3KEY.COM  is  installed  for  the first time by typing 'Z3KEY HHHH', where 
'HHHH' is the address  of  the Environment Descriptor  in hexadecimal.  It can
also be installed with Z3INS.COM in the usual manner.


Options

S  -  save  key definition.  User  will  be  prompted for the name to save the 
      definition to.  The name will always have the extension .RCP appended to
      it.  This name will  be inserted  in the file and displayed when KEY+ is 
      run to activate it at a later time.

A  -  change the  attention character.   Use a very unlikely character such as 
      ^] or ^_.

L  -  change the  lead-in  character.  Use the first character of the function 
      key sequences  your terminal produces.  For  example, the  Wyse terminal 
      uses ^A as the first character of its F1 through F16 characters.  If you
      want to use the Super-Shift mode, use  any key you like.  The '\'  is  a 
      good choice on most machines.

D  -  change delay times.  User will be prompted for a new delay loop number
      and any number from 0 to 32,000 may be entered.  For normal function key
      use, a delay of 200 is good for most machines.  For Super-Shift mode, a
      number of 1000 is usually good.  


Options (continued):

R  -  change  expansion  rate  count.  Any  number  between  0  and 255 may be
      entered.  The expansion rate count  is the number  of times that the new
      Console Status routine will be called before a macro expansion character
      will be flagged as available.  This prevents programs  that try to flush
      the incoming  characters  on  startup  from  throwing  away  part of the
      definition.  Turbo Pascal is  an example of such a program.  If a key is
      defined to start up Turbo Pascal  as 'TURBO^MYE' and the expansion count
      is set to 0,  the 'Y' and 'E' will be discarded by the program.  Setting
      the expansion count to 2 will result in proper operation.

F  -  compile definitions from a text file.  The user will be prompted for the
      name of a text file containing key definitions.  

K  -  display key definitions.  

:3
Super-Shift Mode

   The Super-Shift  mode  is  created  by  increasing the delay time using the 
Z3KEY.COM utility.  Normally the delay is  set  so that it is just long enough
to allow the next character sent  by  a function  key to be received but times
out before another  key can be entered manually.  This  allows  the program to
tell the  difference  between  an  ESCAPE  key  being  pressed  and  an escape 
charcater that is the beginning of a function key sequence.

   When the  delay  time  is increased  sufficiently, you  can enter the other
characters in a sequence manually.  For example,  if you define the '\' as the
lead-in character, entering '\p' could be  used to generate 'procedure'.  This
gives you the equivalent of a whole keyboard full of function keys.

   Just increasing the delay allows multiple character sequences to be entered
after a lead-in character as long as they are entered quickly enough.

   Setting the  delay to 0 makes the program wait after a lead-in character as
long as necessary  for the  next  character.  Such sequences  are  always  two
characters, the  lead-in  character  and  the  following  character.  This  is 
similar to the SmartKey method of Super-Shift.
:4

                               Z3KEYRCP.LIB

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               3k        F117  1.4        Arnold Bailey 5/86       Z3RCP
==============================================================================



                                Z3KEYRCP.Z80
       
             Size (recs) CRC   Version    Author/Latest Issue      Disk
              12k        0F21  1.4        Arnold Bailey 5/86       Z3RCP
==============================================================================
 D2 17 3A 5D 00 FE 2F 20 06   <*........:]../ .>
00 0120 - 21 5C 09 C3 AA 01 CD 0C 1E 22 B1 09 28 0