KEYSET v3.4 (c)1984 by Charles "Zeke" Miller 5500 Keydet Dr. Virginia Beach, VA 23462 Thió prograí ió iî thå publiã domain¬ iî aó mucè aó iô ió permitteä tï bå copù anä distributå aó lonç aó thió copyrighô noticå ió iî tacô anä foò non-commerciaì purposes® Thió ió "User-Supported¢ software» iæ yoõ feeì thaô thió prograí haó valuå tï you¬ á donatioî oæ $1µ woulä bå appreciateä anä wilì helð supporô thå developmenô oæ usefuì anä accessablå software. ***** !!!!! WARNING !!!!! ***** Thió prograí maù rendeò SETUP.COÍ useless® Iæ thå booô commanä ió altered¬ shorteneä oò lengtheneä SETUÐ wilì noô recognizå thå systeí anä returî á baä versioî message® SETUÐ expectó á siø (6© characteò booô commanä anä wilì noô worë withouô it® Iæ yoõ wisè tï uså SETUÐ theî yoõ musô instalì á siø characteò booô commanä (i.e® AUTOST)¬ usinç KEYSET¬ sï thaô SETUÐ won'ô geô upseô anä che÷ yoõ out. Anù problemó shoulä bå reporteä tï må aô thå abovå address® Iæ á responså ió requesteä pleaså includå á SASE® É havå beeî usinç thió prograí witè thå 1.4ø romó anä differenô sizeä CP/Í systemó iî doublå anä singlå densitù formaô anä havå haä nï troubles® É woulä likå tï heaò froí someonå usinç iô oî á singlå densitù systeí witè thå 1.3ø rom. I hope you enjoy and find KEYSET a useful tool. KEYSET v3.4 An Osborne 1 Utility Program. KEYSEÔ ió á utilitù thaô allowó easù definitioî oæ thå Osbornå ± functioî keys¬ arro÷ keys¬ anä thå booô commanä (that'ó righô iô doesn'ô havå tï bå AUTOSÔ anù more)® Theså definitionó maù bå saveä tï á disë filå anä loadeä froí á disë filå oò writteî tï thå systeí trackó oæ thå desireä disë sï theù wilì bå activå oî colä boot® KEYSEÔ wilì alsï displaù thå functioî keyó currentlù iî memorù anä indicatå thå numbeò oæ availablå characters® KEYSEÔ alsï allowó multiplå commandó iî thå commanä linå tï allo÷ quicë anä hasslå freå installatioî oæ speciaì functioî keys® Thió featurå addó greaô speeä tï thå functioî keù definitioî process® KEYSEÔ ió writteî iî thå 'C§ programinç languagå anä haó somå oæ thå flavoò oæ thå UNIØ operatinç systeí througè thå uså oæ '-§ (dash© options® Thå desigî oæ KEYSEÔ waó borî oæ thå desirå tï changå functioî keù definitionó withouô thå hasslå oæ á menõ driveî program® Thuó alì commandó tï KEYSEÔ arå giveî viá thå commanä linå wheî KEYSEÔ ió invoked. Osborne 1 Special Function Keys Thå Osbornå ± ió capablå oæ assigninç commandó oò texô tï anù oæ teî speciaì keys® Theså keyó arå thå numbeò keyó (1-¹ anä 0)® Tï activatå onå oæ thå speciaì keyó yoõ musô presó thå CTRÌ keù anä thå numbeò key¬ assigneä thå commanä oò texô yoõ want¬ simultaneously® Thå systeí wilì automaticallù typå thå characteró associateä witè thaô speciaì key® Whaô thió means¬ ió thaô thå functioî keyó (1-¹ anä 0¬ wheî typeä whilå holdinç thå CTRÌ keù down© caî bå programeä tï represenô á sequencå oæ characters® Thió caî theî becomå á quicë methoä oæ enterinç commandó oò ofteî typeä text® So¬ iæ yoõ frequentlù typeä thå worä KEYSET¬ yoõ coulä enteò thaô sequencå oæ characteró foò á giveî functioî key® Theî wheî yoõ wanô tï typå thå worä KEYSEÔ yoõ simplù presó thå associateä functioî keù (i.e¬ holdinç dowî thå CTRÌ key while pressing a number key). Thå doublå densitù versioî haó abouô 1³ lesó characteró thaî thå singlå densitù versioî witè onlù 8³ characteró availablå foò functioî keù definitions® Iæ yoõ trù tï enteò á functioî keù definitioî thaô ió tï lonç KEYSEÔ wilì aborô anä displaù thå existinç keyó anä thå numbeò of unused characters. Page 1 KEYSET v3.4 Limitations: Therå arå, aô thió timå, somå limitationó tï thå distributeä versionó oæ KEYSET. Version 3.4 DOES NOT supporô changinç thå I/Ï bytå tï changå portó oò thå printeò type. WILL NOT change printer initialization. DOEÓ NOÔ supporô anythinç thaô ió noô supporteä bù anù subsequenô versions. Version 3.0x DOES NOT supporô changinç thå I/Ï bytå tï changå portó oò thå printeò type. WILL NOT change printer initialization. DOES NOT supporô changinç thå screeî sizå oò settinç autï scrolì oî oò off. DOES NOT support baud rate changes. DOEÓ NOÔ supporô anythinç thaô ió noô supporteä bù anù subsequenô versions. Version 2.x Not distributed, developmental version only. Version 1.x DOES NOT accept more than one command at a time from the command line. DOEÓ NOÔ supporô anythinç thaô ió noô supporteä bù anù subsequenô versions. Page 2 KEYSET v3.4 Displaying Function Key Definitions Thió ió thå firsô oæ thå '-§ (dash© optionó anä onå thaô wilì probablù bå useä quitå á lot® Tï uså á dasè optioî jusô placå á '-§ (dash© iî fronô oæ thå letteò foò thå optioî desired® Iî thió caså thå optioî ió 's§ sï thå dasè optioî wilì bå '-s§ anä ió useä wheî invokinç KEYSEÔ (whicè ió shorteneä tï KS.COÍ foò simplificatioî oæ thå commanä linå anä becauså É aí lazy© froí thå Á prompô likå this: A>KS -s Thió wilì displaù thå booô command¬ iæ any¬ anä indicatå whetheò iô ió warm¬ cold¬ both¬ oò neither» thå functioî keù definitions» thå arro÷ keù definitionó anä telì yoõ ho÷ manù characteró arå lefô unuseä iî the function definition table. Defining Arrow Keys Defininç arro÷ keyó ió á littlå morå compleø buô haó á similaò syntaø foò thå commanä line® Tï indicatå whicè arro÷ keù ió tï bå defineä jusô uså thå firsô letteò oæ thå keù namå (L¬ R¬ U,anä D)® Foò example¬ defininç thå Lefô arro÷ aó á bacë spacå (CTRÌ H): A>KS -L "^H" Tï enteò thå definitioî uså '^§ (SHIFÔ-6© followeä bù thå characteò desired. The following characters will give the effects shown: ^H backspace (CP/M & WordStar) ^S backspace (WordStar only) ^R Abort current line and display the characters that have been entered and allow additional characters to be typed. (CP/M). ^X Abort current line, backspace/erase to start of line (CP/M). Move down one line (WordStar). ^L Line feed (same as RETURN key in CP/M). ^I Advance to next tab column. ^M Carriage return. ^P Toggle printer on/off (CP/M). ^E Up one line (Wordstar). ^D Right one character (WordStar). ^U Abort current line, start over on next line (CP/M). Page 3 KEYSET v3.4 Defining Function Keys Tï definå onå oæ thå functioî keyó (0-9© therå ió á simplå syntaø thaô musô bå useä sï thaô KEYSEÔ wilì kno÷ whaô yoõ wanô done® Á definitioî foò thå '1§ keù mighô looë likå this: A>KS -1 "DIR *.*<" Thió wilì definå á CTRÌ-± (^1© aó 'DIÒ *.*'® Thå optionaì '<§ wilì bå converteä tï á carriagå returî wheneveò iô ió founä iî thå commanä line® Thå desireä definitioî musô bå encloseä iî doublå quoteó oò iô will not be accepted. Setting The Boot Command Tï seô thå booô command¬ onå oæ fouò dasè optionó musô bå useä anä thå commanä musô bå encloseä iî doublå quoteó jusô aó iî thå functioî keù definitions® Sï thå commanä linå tï seô thå colä booô commanä woulä bå likå this: A>KS -c "DIR *.*<" Thå '-c§ optioî telló KEYSEÔ tï seô thå colä booô commanä tï thå definitioî founä iî thå quotes® Herå agaiî thå '<§ ió converteä tï á carriage return. The dash options related to the boot command are: -c "definition" Sets the cold boot command and it executes only on a cold boot. (Not very useful unless installed in the system tracks). -w "definition" Sets the warm boot command and will execute when ever a program terminates with a warm boot or when ever a CTRL C is typed on the console. -b "definition" Sets the boot command to execute on both warm and cold boot (Once again not very useful unless written to the system tracks). -n Sets no boot command and does not accept any definition. This will turn off any warm boot command in memory and will not affecô thå colä booô commanä unlesó iô ió writteî tï thå systeí tracks® Thió                               functioî warí bootó wheî completed¬                               ignorinç thå resô oæ thå commanä line. Page 4 KEYSET v3.4 Creating A Function Key File Anù oæ thå definitionó entereä witè KEYSEÔ takå immediatå effecô becauså theù arå puô directlù intï thå workinç functioî table® Howeveò therå maù bå timeó wheî differenô setó oæ functioî keù definitionó maù bå requireä anä thå oneó iî memorù saveä foò quicë recalì wheî needeä again® Witè thaô iî minä KEYSEÔ caî savå thå definitionó currentlù iî memorù tï á disë filå witè á namå oæ youò choice. This is another of the dash options used with KEYSET. A>KS -m "d:filename" Thå '-m§ telló KEYSEÔ tï makå thå functioî keù definitioî tablå tï thå filå nameä iî quoteó oî thå specifieä drivå (drivå specificatioî ió optional)® Thå filenamå anä drivå conventionó arå thå samå aó thoså requireä bù CP/Í anä WordStar® Loading From A Function Key File Loadinç functioî keù definitionó froí á disë filå ió mucè thå samå aó creatinç á definitioî file® Thå onlù differencå ió thå dasè optioî used. A>KS -o "d:filename" Thå '-o§ telló KEYSEÔ tï opeî thå filå nameä iî quoteó oî thå specifieä drivå (drivå specificatioî ió optional© anä loaä thå functioî keù definitioî tablå intï memorù® Thå filenamå anä drivå conventionó arå thå samå aó thoså requireä bù CP/Í anä WordStar® Putting Definitions On The System Tracks Thió dasè optioî allowó yoõ tï makå thå definitionó residinç iî memorù permanentlù parô oæ thå systeí (untiì yoõ changå theí again© sï thaô they are in memory when you boot the system. A>KS -p "A" Thå '-p§ telló KEYSEÔ tï makå thå definitionó permanenô oî thå drivå specifieä iî quotes® Thå nexô timå thaô disë ió useä tï booô thå systeí witè á colä booô thoså definitionó wilì bå activå iî memory® Thió ió thå optioî thaô wilì alsï seô thå ne÷ colä booô commanä foò á disk. Page 5 KEYSET v3.4 Multiple Options KEYSEÔ allowó morå thaî onå option tï bå entereä oî thå commanä linå aô á time® Thió ió donå bù typinç iî eacè option, separateä bù á space¬ jusô aó yoõ woulä enteò theí onå aô á time® Thå numbeò oæ optionó thaô caî bå entereä ió limiteä bù thå sizå oæ thå CP/Í command buffer (127 characters) and not more than 30 separate strings. Characteò stringó withiî quotes (i.e® "chaò string"© arå considereä onå string® Thå ordeò thaô thå options occuò iî thå commanä linå ió thå ordeò oæ execution® Options maù alsï bå repeateä iî thå samå commanä linå aó manù timeó yoõ wanô (withouô exceedinç thå maximuí oæ 3° optionó and/oò 12· characters)® Itó noô likelù thaô yoõ wilì eveò enter enough options at one time to exceed the limits. Let'ó looë aô aî examplå oæ multiplå optionó iî á commanä linå (iî bolä print© entereä aô thå A¾ prompô oæ CP/Í: A>KÓ -± "definition1¢ -´ "definition2¢ -³ "definition3¢ -ó Thió commanä linå wilì seô thå '^1§ functioî keù tï 'definition1'¬ thå '^4§ functioî keù tï 'definition2'¬ thå '^3§ functioî keù tï 'definition3'¬ anä theî displaù thå functioî keù table® An example of repetitivå commandó maù look like this: A>KS -m "B:first" -5 "^QS^KB^X^KK^QC^KV^QV" -m "A:second" Thió commanä wilì savå thå currenô functioî keyó iî thå filå 'first§ oî drivå 'B'¬ changå thå '^5§ functioî keù tï '^QS^KB^X^KK^QC^KV^QV'¬ and save the new function key table as file 'second' on drive 'A'. Page 6 Summary of Dash Options Boot Command Options -c "definition" Sets the Cold boot command and it executes only on a cold boot. (Not very useful unless installed in the system tracks). -w "definition" Sets the Warm boot command and will execute when ever a program terminates with a warm boot or when ever a CTRL C is typed on the console. -b "definition" Sets the boot command to execute on Both warm and cold boot (Once again not very useful unless written to the system tracks). -n Sets No boot command and does not accept any definition. This will turn off any warm boot command in memory and will not affecô thå colä booô commanä unlesó iô is written to the system tracks. Display Function -s Shows the special function keys and the boot command. Also shows the number of characters available in the function key table. Page 7 Summary of Dash Options Defining Arrow Keys -l "^?" Sets the Left arrow key to the (?) desired control character or any other characteò desired® Thió functioî wilì define only one character for an arrow key (the '^' does not count as a char- acter). -r "^?" Sets the Right arrow key to the (?) desired control character or any other characteò desired® Thió functioî wilì define only one character for an arrow key (the '^' does not count as a char- acter). -u "^?" Sets the Up arrow key to the (?) desired control character or any other characteò desired® Thió functioî wilì define only one character for an arrow key (the '^' does not count as a char- acter). -d "^?" Sets the Down arrow key to the (?) desired control character or any other characteò desired® Thió functioî wilì define only one character for an arrow key (the '^' does not count as a char- acter). Page 8 Summary of Dash Options Special Function Key File Functions -m "d:filename.typ" Makes a function key file from the def- initions currently in memory. The drive designation and file type are optional. -o "d:filename.typ" Opens a function key file and loads the definitions into memory. The drive designation and file type are optional. Saving to System Tracks -ð "d¢ Putó thå speciaì functioî keù defin- itionó currentlù iî memorù ontï thå sys- tem tracks of the designated drive (d). Defining Function Keys -# "definition" Defines the special function keys, where '#§ ió á digiô (0 - 9)® Iæ tï manù charac- ters are used KEYSET will display the key tablå anä indicatå thå numbeò oæ charac- ters available. -A Wilì togglå Autï scrolì oî anä off® Warí                               bootó oî completon. -X Wilì togglå thå baudratå froí 30° tï                               1200® Warí bootó oî completon. -Z "nn" Wilì seô thå screeî siZå tï thå valuå                               specifieä bù "nn¢ (froí 1-128)® Iæ thå                               valuå ió greateò thaî 12¸ oò lesó thaî ±                               thå valuå wilì bå seô tï 128® Page 9 Summary of Dash Options Multible Command Syntax Thå followinç commanä entereä aô thå A¾ prompô oæ CP/Í A>KÓ -± "definition1¢ -´ "definition2¢ -³ "definition3¢ -ó wilì seô thå '^1§ functioî keù tï 'definition1'¬ thå '^4§ functioî keù tï 'definition2'¬ thå '^3§ functioî keù tï 'definition3'¬ anä theî displaù thå functioî keù table® Repetitivå commandó maù bå entereä aó well: A>KS -m "B:first" -5 "^QS^KB^X^KK^QC^KV^QV" -m "A:second" Thió commanä wilì savå thå currenô functioî keyó iî thå filå 'first§ oî drivå 'B'¬ changå thå '^5§ functioî keù tï '^QS^KB^X^KK^QC^KV^QV'¬ and save the new function key table as file 'second' on drive 'A'. Page 10