;
NuKey 2.05
Copyright (c� 1986-89 Alph� Systems
Al� right� reserved
1 - Introduction 5 - System Requirements
2 - Getting Started 6 - Using NuKey/NuKey Commands
3 - Examples of Using a Keychanger 7 - Newword Information
4 - Customizing NuKey 8 - Deactivating NuKey
Select number for desired topic.
(Control-C exits HELP)
Alpha Systems Corporation
711 Chatsworth Place
San Jose, California 95128
(408) 297-5594
:1
Introduction
� �keychange� �i� � specia� kin� o� progra� tha� place� itsel� �betwee� �you� �
keyboar� an� th� othe� softwar� runnin� i� you� computer� I� intercept� wha� �
i� type� a� th� keyboar� an� ca� transfor� whateve� wa� type� int� �somethin� �
else� �dependin� �o� �ho� �yo� hav� i� �programmed� � Fo� �example� �usin� �� �
keychange� �yo� coul� redefin� you� keyboar� t� b� Dvora� layou� �instea� �o� �
th� standar� "QWERTY".
Mos� keychanger� allo� yo� t� generat� a� entir� strin� o� character� fro� �� �
specifi� �keyboar� input� Thus� th� strin� "frequently� coul� �b� �generate� �
wheneve� �yo� �typ� contro�-F� Thi� i� th� rea� �advantag� �o� �keychangers� �
The� �reduc� �th� amoun� o� typin� yo� nee� t� d� b� �providin� �"shortcuts"� �
Yo� ca� pres� � ke� tha� actuall� onl� generate� � singl� character� an� tha� �
singl� characte� i� redefine� t� b� a� entir� sentence� phrase� paragraph� o� �
sequenc� o� commands�
Introduction (continued)
I� th� previou� example� contro�-� wa� redefine� t� b� th� wor� "frequently"� �
Thi� �exampl� �probabl� �wouldn'� b� usefu� i� yo� �ar� �usin� �WordStar� �a� �
contro�-� i� � comman� yo� nee� unde� WordStar� T� cop� wit� thi� situation� �
advance� �keychanger� �offe� wha� i� calle� a� "extend� key� Onl� �whe� �th� �
exten� �ke� i� type� immediatel� prio� t� th� desire� ke� (contro�-� i� �thi� �
example� doe� th� redefinitio� tak� place� So� thi� mean� tha� yo� ca� stil� �
us� �contro�-� �normall� �a� �� comman� unde� WordStar� �an� �whe� �yo� �wan� �
contro�-� t� generat� "frequently"� yo� firs� typ� th� "extend� ke� an� �the� �
contro�-F�
Othe� sophisticate� feature� o� professiona� keychanger� includ� th� �abilit� �
t� �sav� �definition� �t� dis� fo� late� r�-use� an� th� abilit� �t� �ad� �o� �
delet� ne� definition� eve� whil� othe� program� (lik� WordStar� ar� running.
Introduction (continued)
NuKe� �i� �suc� �� sophisticate� keychanger� I� support� �al� �th� �feature� �
previousl� �mentione� �an� �more� � A� importan� �featur� �o� �NuKe� �i� �th� �
capabilit� �t� �redefin� �key� tha� generat� mor� tha� �on� �character� � Fo� �
example� som� terminal� hav� arro� key� tha� generat� mor� tha� on� characte� �
whe� �pressed� �usin� �NuKey� �thes� �key� ca� �b� �redefine� �t� �b� �singl� �
character� o� an� strin� o� character� yo� desire.
:2
Getting Started
Befor� doin� anythin� wit� NuKey� mak� � cop� o� th� maste� yo� hav� recieve� �
usin� � fil� cop� program� The� pu� th� maste� i� � saf� place� an� �procee� �
usin� th� copy� NEVE� US� YOU� MASTE� FO� ANYTHIN� OTHE� THA� MAKIN� COPIES.
NUKE� �2.� �consist� �o� NUKEY.CO� an� NUKEY.RE� files� � I� �yo� �ar� �stil� �
runnin� th� olde� ZCPR3� yo� mus� 'install� NUKEY.CO� wit� Z3INS� I� yo� ar� �
usin� ZCPR33� o� N�-COM� n� installatio� i� necessary.
NUKEY.CO� �i� �th� loade� an� contro� program� NUKEY.RE� i� �th� �keychange� �
itsel� whic� i� loade� a� a� extende� Z� IOP� Whe� yo� invok� NUKEY.CO� �fo� �
th� �firs� �time� �NUKEY.RE� wil� b� loade� an� yo� wil� b� �aske� �fo� �you� �
definitio� o� th� DEFin� an� EXTen� keys� Thes� definition� wil� b� �writte� �
t� a� otherwis� blan� NUKEY.KE� file� Whe� yo� invok� NUKE� th� secon� �tim� �
an� withou� � keyfil� name� NUKEY.KE� th� blan� keylis� i� loaded.
Getting Started (continued)
Whe� �aske� �fo� �th� DEFin� key� pres� an� ke� o� �you� �keyboar� �yo� �wis� �
assigne� �t� thi� specia� function� Althoug� an� ke� wil� do� � goo� �choic� �
i� th� shifte� character(s� o� � rarel� use� functio� key� M� keyboar� ha� � �
PRINT/Sen� functio� ke� whic� � use� Shifte� PRIN� fo� DEFin� an� �unshifte� �
Sen� fo� EXTend.
Onc� yo� hav� answere� th� DEFin� an� EXTen� ke� questions� NuKe� i� running� �
Yo� ma� no� perfor� � variet� o� operation� wit� it� Se� th� sectio� �"Usin� �
NuKey� fo� precis� instructions.
:3
Examples
T� �ge� �yo� �starte� �i� th� wonderfu� worl� �o� �keychangers� �here'� �som� �
excerpt� fro� a� articl� b� Te� Silveir� tha� originall� appeare� i� PROFILE� �
magazine� � I� th� examples� <SP� mean� space� <CR� mean� return� �an� �<ESC� �
mean� �th� escap� key� � care� (^� befor� � lette� indicate� th� �succeedin� �
characte� �i� � contro� character� Fo� exampl� ^� indicate� contro�-F� � Th� �
example� ar� intende� fo� us� wit� WordStar� Mos� als� wor� wit� Newword.
Move to Beginning of Paragraph
"Often� whe� I'� i� th� middl� o� � paragraph� � fin� � wan� t� jum� bac� an� �
alte� �th� �paragrap� opening� Sinc� � star� eac� o� m� �paragraph� �wit� �� �
fiv�-spac� inden� (that'� ho� WordSta� interpret� � TAB)� it'� eas� enoug� t� �
fin� �th� �paragrap� �beginning� � � �se� �u� �� �ke� �t� �sen� �th� �comman� �
^QF<SP><SP><SP><SP><SP><CR>B<CR>^F� Afte� th� searc� backward� WordSta� wil� �
leav� �m� a� th� beginnin� o� th� fiv�-spac� indent� s� � adde� � ^� t� �mov� �
t� th� firs� word."
Examples (continued)
Reforming Paragraphs
"� lov� thi� command� An� tim� � star� editin� � WordSta� paragrap� � addin� �
an� �deletin� word� an� s� fort� � th� paragrap� formattin� get� �al� �messe� �
up� �� S� �� �se� �on� �ke� �t� �sen� �th� �comman� ��^QF<SP><SP><SP><SP><SP� �
<CR>B<CR>^B� � Thi� comman� clean� u� th� mes� b� zippin� th� curso� �t� �th� �
beginnin� o� th� paragrap� an� the� reformin� i� wit� ^B."
Mark Paragraph as a Block
"Thi� �comman� �i� �hand� �becaus� yo� ca� us� i� a� �� �prelud� �t� �moving� �
copying� �o� deletin� you� curren� paragraph� Fo� paragraph� wit� �onl� �on� �
carriag� ��retur� �a� �th� �end� �us� �th� �comman� ��^QF<SP><SP><SP><SP><SP� �
<CR>B<CR>^KB^B^KK� An� fo� paragraph� wit� tw� carriag� return� a� th� �end� �
us� th� comman� ^QF<SP><SP><SP><SP><SP><CR>B<CR>^KB^B^X^KK."
Examples (continued)
Delete from Cursor to End of Paragraph
"Thi� �comman� �let� �m� delet� everythin� i� � paragrap� �fro� �th� �presen� �
curso� positio� t� th� end� � se� on� ke� t� sen� th� comman� ^KB^B^A^KK^KY� �
T� �pla� i� safe� eliminat� th� ^KY� The� th� comman� wil� �mar� �everythin� �
fro� you� curso� t� th� en� o� th� paragrap� a� � block� an� yo� ca� giv� th� �
delet� �comman� yourself� afte� makin� sur� yo� haven'� marke� �anythin� �yo� �
wan� t� keep."
Print a Marked Block
"Sometime� �it'� �hand� t� b� abl� t� prin� ou� � shor� sectio� o� �th� �fil� �
you'r� workin� on� withou� havin� t� exi� th� fil� o� sto� wha� you'r� doing� �
Th� ��followin� �comman� �wil� �prin� �an� �marke� �bloc� �o� �tex� ��withou� �
interruptin� �yo� �fo� �mor� tha� � fe� seconds� Se� on� �ke� �t� �sen� �th� �
comman� ^KWA:PRINT.FIL<CR>Y^KPA:PRINT.FIL<ESC>.�
:4
Customizing NuKey
Advance� �user� ca� customiz� som� o� th� interna� characteristic� o� �NuKey� �
Thi� i� unnecessar� i� mos� circumstances� bu� i� yo� hav� difficult� gettin� �
NuKe� t� wor� properl� wit� certai� applicatio� program� yo� shoul� �conside� �
experimentin� �wit� �th� followin� options� Yo� mak� thes� �selection� �fro� �
withi� �th� NUKEY.CO� program� NuKe� ha� thre� interna� delay� tha� �ma� �b� �
programme� �wit� �th� Instal� function� Th� defaul� value� o� �thes� �delay� �
wer� chose� afte� muc� testin� wit� man� program� an� terminals� Yo� �shoul� �
no� hav� t� chang� the� unles� NuKe� simpl� doesn'� wor� i� you� environment� �
Thes� delay� ar� discusse� i� detai� o� th� followin� screens.
Typin� NUKE� /� wil� repor� th� curren� dela� value� an� allo� yo� t� �chang� �
the� (� simpl� <RETURN� wil� leav� the� unchanged)� Thes� value� ar� writte� �
int� �NUKEY.CO� itsel� an� wil� b� copie� t� th� keychange� eac� tim� �i� �i� �
loaded.
Remember� Normall� i� i� no� require� tha� an� o� thes� option� b� changed!
Customizing NuKey (continued)
FUNDEL� �Yo� �migh� thin� o� NuKe� a� � 'string� changer� � NuKe� �accept� �� �
'keystring� (� t� 1� characters� fro� � particula� ke� an� convert� i� t� ye� �
anothe� �'string� �(� �t� ove� 50� characters� t� b� sen� whe� �tha� �ke� �i� �
pressed� � NuKe� assume� � ke� ma� produc� mor� tha� on� character� �an� �so� �
wait� fo� th� nex� one� NuKe� wil� wai� FUNDE� millisecond� befor� givin� u� �
an� �presumin� �th� �previou� �characte� t� b� th� las� �on� �fo� �tha� �key� �
Choosin� th� precis� valu� o� FUNDE� i� no� a� eas� a� on� migh� assume�
Som� �terminal� sen� thei� functio� ke� string� a� th� bau� rat� s� �tha� �a� �
19,20� �bau� �(1,92� �char� pe� sec� yo� ca� expec� �� �characte� �ever� �50� �
microseconds� �o� so� Othe� terminal� migh� sen� the� a� � muc� lowe� �rate� �
Th� �Wys�-50� i� ADD� emulatio� mode� send� functio� ke� character� full� �1� �
millisecond� �apart� �I� �selectin� �th� �defaul� �valu� �o� �FUNDE� �a� ��3� �
milliseconds� NuKe� expect� t� accommodat� th� slowes� o� terminals� I� �th� �
defaul� �doesn'� wor� i� you� case� yo� ma� chang� i� t� an� valu� fro� � �t� �
25� milliseconds.
Customizing NuKey (continued)
CTLDEL� I� i� ofte� usefu� t� creat� � 'string� whic� invoke� � program� the� �
supplie� �it� initia� commands� Fo� example� yo� wis� t� invok� WordSta� �t� �
edi� �� documen� fil� name� TEXT� A� th� keyboard� yo� woul� typ� �'WS<cr>'� �
wai� fo� WordSta� t� load� 'D� fo� documen� mode� the� 'TEXT<cr>'� � However� �
i� �yo� �ente� 'D� to� quickly� WordSta� discard� i� becaus� i� �flushe� �al� �
keyboar� �inpu� �a� �soo� �a� �i� loads� � NuKe� �wil� �mislea� �WordSta� �b� �
respondin� 'false� t� it� consol� statu� request� � fe� time� afte� sendin� � �
C� �code� �s� tha� i� think� i� ha� flushe� th� keyboard� Thu� �th� �string� �
'ws<cr>dtext<cr>� doe� wha� yo� wan� i� to� Th� defaul� numbe� o� deception� �
i� 10� Yo� ma� chang� i� t� an� valu� fro� � t� 255.
Customizing NuKey (continued)
KEYDEL� �Som� program� (dBAS� II� flus� th� keyboar� afte� �ever� �character� �
probabl� �t� �trea� ke� 'bounce� problems� Thi� �laudabl� �pursui� �discard� �
ever� secon� characte� i� � norma� keystring� causin� DISPLA� AL� t� com� ou� �
a� �DSLYA� �whic� �i� no� ver� useful� So� w� mislea� �agai� �b� �respondin� �
'false� �� numbe� o� time� betwee� characters� dBAS� require� a� �leas� �on� �
deception� Th� defaul� numbe� o� deception� i� 5� Yo� ma� chang� i� t� �an� �
valu� fro� � t� 255.
:5
System Requirements for NuKey
NuKe� require� tha� yo� ru� � ZCPR� implementatio� o� � �-8� syste� wit� �IO� �
spac� allocate� (1.5�-byte� o� more)� Further� NuKe� require� tha� you� �IO� �
an� BIO� confor� t� th� Echelo� publicatio� "ZCPR� an� IOPs"� chapte� 5.
NuKe� work� wit� �-Com� N�-CO� an� wit� Echelon'� bootabl� �-Syste� disk� fo� �
Kaypr� an� Morro� machines� an� Micromint'� SB18� computer� withou� change�
Note� � NuKe� itsel� require� abou� 1� o� cod� spac� i� th� 1.5� IO� �leavin� �
jus� �ove� �50� �byte� fo� th� keybuffer� I� yo� defin� � �large� �IOP� �th� �
increase� �siz� �i� allocate� t� th� buffe� allowin� �eve� �mor� �definition� �
and/o� longe� strings� � 2.5� IO� wil� hav� ove� 150� byte� available.
:6
Using NuKey/Explanation of Commands
View Current Definitions
T� �se� �� displa� o� curren� NuKe� definitions� typ� th� DEFin� �ke� �twice� �
Thi� ca� b� don� withi� applicatio� program� (eg� WordStar� o� a� th� comman� �
lin� promp� o� th� operatin� system� CAUTION� I� "Vie� Curren� Definitions"� �
"Defin� �Ne� Key"� o� "Delet� Ol� Key� i� don� insid� o� a� application� �th� �
scree� �displa� �i� �altere� �fro� wha� th� �applicatio� �"thinks� �i� �bein� �
displayed� Thi� ma� necessitat� issuin� � comman� t� rewrit� th� screen� �i� �
th� applicatio� ha� suc� � command� WordSta� 4.� use� ^\� Newwor� <ESC>.
Deleting Old Keys
T� delet� a� existin� definition� firs� typ� th� DEFin� key� an� the� th� ke� �
t� �b� deleted� I� i� use� th� EXTen� prefix� typ� th� EXTen� ke� �prio� �t� �
th� �ke� �bein� �deleted� � The� typ� DE� o� �RUB� �whic� �delete� �th� �key� �
Deletion� �ca� �b� performe� whil� othe� application� ar� running� � Se� �th� �
previou� cautio� abou� th� scree� displa� bein� altered.
Using NuKey/Explanation of Commands (continued)
Defining New Keys
Ne� definition� ca� b� adde� a� an� tim� fro� withi� application� o� fro� th� �
operatin� syste� prompt� T� ad� � definitio� t� NuKey� typ� th� DEFin� �key� �
Next� �typ� th� EXTen� ke� i� i� i� t� b� use� i� th� ne� definition� � Next� �
typ� �th� ke� tha� i� t� b� redefined� An� ke� tha� generate� a� �leas� �on� �
characte� �ca� �b� �redefined� � Then� ente� �th� �character� �yo� �wis� �th� �
redefine� �ke� �t� �generate� � NuKe� �initiall� �ha� �abou� �55� �character� �
availabl� �fo� �ne� definitions� Eac� redefinitio� i� �allocate� �fro� �thi� �
pool� Yo� ca� us� th� DE� o� RU� ke� o� th� backspac� ke� t� backspac� whil� �
enterin� ne� definitions� Se� th� previou� cautio� abou� th� scree� �displa� �
bein� altered.
Redefinition Notes
NuKe� �ca� �redefin� �key� tha� generat� fro� � t� 1� �characters� � Th� �ne� �
definitio� �ca� �contai� �u� �t� approximatel� �55� �characters� � NuKe� �ca� �
distinguis� �key� tha� generat� character� wit� value� i� th� rang� o� � �(^� �
o� �SOH� �t� 12� an� fro� key� tha� generat� character� wit� �value� �i� �th� �
rang� o� 12� t� 255� i� you� computer/termina� ca� generat� them.
Using NuKey/Explanation of Commands (continued)
Ke� �definition� ma� b� save� t� disk� Suppos� yo� hav� r�-define� � �numbe� �
o� key� especiall� fo� you� wor� wit� WordStar� Yo� migh� sav� the� t� �dis� �
wit� �th� �command� �NUKE� �W� � whic� wil� �creat� �WS.KE� �i� �th� �curren� �
directory� � Definition� especiall� fo� dBAS� I� migh� b� save� i� DB.KE� �i� �
th� �sam� manner� A� note� i� Sectio� 2� NUKEY.KE� (blank� wa� create� �whe� �
yo� �firs� ra� NUKEY� No� NUKEY<cr� wil� loa� NUKEY.KEY� NUKE� �WS<cr� �wil� �
loa� WS.KE� and� o� course� NUKE� DB<cr� wil� loa� th� dBAS� I� keys.
:7
Special Information for Newword an� WordSta� 4.� Users
Newwor� �an� WordSta� hav� a� interna� keychange� o� 'Macr� Generator� �whic� �
ca� �conflic� �wit� �NuKey� Yo� shoul� r�-instal� �Newwor� �o� �WordSta� �a� �
follows�
Invok� �th� installatio� progra� (NWINSTAL.CO� o� WSCHANGE.COM� an� fin� �th� �
men� �o� �'Specia� Patches� o� whatever� Loo� fo� �th� �selection� �allowin� �
change� �t� �item� name� "FUNDLY� an� "AHEAD"� Se� FUNDL� t� �� �(zero� �an� �
AHEA� t� F� (decima� 255).
Pleas� �refe� �t� �th� Newwor� o� �WordSta� �installatio� �documentatio� �fo� �
precis� �instruction� �o� ho� t� chang� thes� values� Onc� the� ar� �se� �a� �
indicate� above� yo� wil� experienc� n� difficult� usin� NuKey.
:8
Deactivating NuKey
A� wit� al� ZCPR3/�-Syste� IOP's� NuKe� i� remove� b� loadin� anothe� IO� �o� �
to� �o� it� Thus� i� yo� activat� anothe� IO� suc� a� BPRINTe� o� �RECORDer� �
NuKe� i� deactivated� an� an� curren� ke� definition� no� previousl� save� t� �
dis� ar� lost.
Yo� ma� effectivel� remov� NuKe� b� clearin� th� curren� ke� definition� wit� �
th� comman� NUKE� /C.