home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CP/M
/
CPM_CDROM.iso
/
mbug
/
mbug060.arc
/
CPM#005.LBR
/
MKWAIT20.DOC
< prev
next >
Wrap
Text File
|
1979-12-31
|
12KB
|
315 lines
MKWAIT (MaKe WAIT) Version 2.0
For Osborne EXECUTIVE only.
Copyright (C) Peter C. Cole July, 1985 Duncanville, TX
All commercial rights reserved.
Released for free distribution. Not to be sold.
MKWAI╘ wil∞ creatσ o≥ edi⌠ ß "Wai⌠ Filσ" oε thσ disδ drivσ oµ you≥ ì
choice« ┴ "Wai⌠ Fileó i≤ ß filσ tha⌠ has these features:
ááááá1.áááI⌠ caε senΣ ß messagσ t∩ thσ screeε anΣ theε wait unti∞ ì
ááááááááááyo⌡ pusΦ ß button« Thσ messagσ i≤ alway≤ precedeΣ b∙ ß ì
ááááááááááflashinτ "REA─ NOTE:". Thσ compute≥ wil∞ bee≡ t∩ aler⌠ ì
ááááááááááyou.
ááááá2.áááI⌠ caε tes⌠ u≡ thσ screeε fo≥ ß messagσ linσ tha⌠ wa≤ ì
áááááááááápu⌠ oε thσ screeε durinτ thσ runninτ oµ a previou≤ ì
ááááááááááprogram« Iµ thσ messagσ linσ i≤ correc⌠ theε n∩ wai⌠ ì
ááááááááááwil∞ occur« If¼ however¼ thσ messagσ linσ i≤ no⌠ ì
áááááááááácorrec⌠ theε ß messagσ i≤ giveε anΣ thσ "Wai⌠ Fileó ì
ááááááááááwil∞ wait.
ááááá3.áááI⌠ wil∞ allo≈ yo⌡ t∩ terminatσ an∙ remaininτ CP/═ ì
ááááááááááand/o≥ SUBMI╘ commands.
Thesσ "Wai⌠ Filesó caε bσ inserteΣ int∩ ß CP/═ o≥ SUBMI╘ commanΣ ì
strinτ t∩ hel≡ yo⌡ contro∞ thσ sequence« Somσ suggesteΣ use≤ oµ ì
"Wai⌠ Filesó are:
ááááá1.áááT∩ tel∞ yo⌡ wheε ß disδ changσ i≤ required« I⌠ caε bσ ì
ááááááááááuseΣ t∩ tel∞ yo⌡ wha⌠ typσ oµ disδ t∩ changσ t∩ anΣ ì
ááááááááááwhicΦ drivσ t∩ pu⌠ thσ disδ into.
2.áááIµ yo⌡ usσ ß prograφ likσ SKEY╙ froφ INOV┴ iε Dallas¼ ì
ááááááááááT° theε anothe≥ usσ oµ "Wai⌠ Filesó migh⌠ bσ t∩ tel∞ ì
ááááááááááyo⌡ t∩ changσ onσ o≥ morσ specia∞ functioε ke∙ ì
áááááááááádefination≤ and what to change them to.ì
ááááá3.áááAllo≈s terminatioε oµ thσ res⌠ oµ thσ commanΣ strinτ ì
ááááááááááwheε ß prograφ iε thσ commanΣ strinτ indicate≤ aε erro≥ ì
ááááááááááoε thσ screen.
.paè1. HOW TO RUN "MKWAIT"
1.1 MKWAIT i≤ ruε b∙ typinτ iε it≤ namσ usinτ norma∞ CP/═ ì
ááááááformat«
1.2áááMKWAIT doe≤ no⌠ usσ any commanΣ tails«ì
1.3áááTo exit from MKWAIT push ^C or X from the Main Menu.
2.ááááTHE MAIN MENU OF "MKWAIT"
2.1áááWheε MKWAIT i≤ firs⌠ started¼ ß fe≈ word≤ describinτ MKWAIT ì
ááááááarσ displayeΣ oε thσ screen« Thesσ word≤ arσ removeΣ anΣ ì
ááááááwil∞ no⌠ reappea≥ afte≥ thσ firs⌠ use≥ actioε selectioε i≤ ì
áááááámade.
2.2áááUser action selections are:
áááááá1. Read a disk drive for an existing "Wait File".
áááááá2. Create a new message.
áááááá3. Change to a different file name.
ááááá 4. Create or change "Check Line Above" data.
áááááá5. Edit the "active message".
áááááá6. Create a new "Wait File" on a disk drive of your choice.
áááááá7. Exit MKWAIT.
2.3áááThσ "activσ message" i≤ displayeΣ a⌠ thσ bottoφ oµ thσ ì
ááááááMaiε Menu« Therσ i≤ n∩ "activσ message" wheε MKWAIT i≤ ì
ááááááfirst started.
.paè3.ááááREADING A DISK DRIVE FOR AN EXISTING "WAIT FILE"
3.1áááPusΦ A¼ B¼ etc« froφ thσ Maiε Men⌡ t∩ reaΣ thσ selecteΣ ì
áááááádisδ drivσ fo≥ aε existinτ "Wai⌠ File"« Remembe≥ t∩ usσ thσ ì
áááááácorrect file name.
3.2áááIµ ß "Wait Fileó exist≤ oε thσ disδ anΣ i⌠ wa≤ createΣ ì
ááááááb∙ MKWAI╘ theε it≤ messagσ anΣ "Checδ Linσ Aboveó datß wil∞ ì
áááááábσ displayeΣ fo≥ reference«
3.3 Thσ filσ caε bσ accepteΣ anΣ overwritσ thσ existinτ "activσ ì
áááááádataó o≥ thσ filσ caε bσ ignoreΣ anΣ thσ use≥ caε returε t∩ ì
ááááááthσ Maiε Men⌡ withou⌠ overwritinτ thσ existinτ "activσ ì
áááááádata".
4.ááááHOW TO CREATE A MESSAGE
4.1áááPushinτ "1ó froφ thσ Maiε Men⌡ wil∞ allo≈ yo⌡ t∩ creatσ ß ì
ááááááne≈ message«
4.2áááPushinτ A¼ B¼ etc« froφ thσ Maiε Men⌡ wil∞ reaΣ iε a ì
áááááámessagσ froφ aε existinτ "Wai⌠ File"« Thσ "Checδ Linσ ì
ááááááAbove" data will tag along with the message.
4.3 ááPushinτ <RETURN╛ wil∞ allo≈ yo⌡ t∩ edi⌠ thσ "activσ ì
áááááámessage".
4.4 ááMessage≤ caε bσ u≡ t∩ 255 character≤ long« Thi≤ wil∞ givσ ì
ááááááthreσ 8░ characte≥ line≤ plu≤ 15 character≤ oε thσ 4tΦ ì
ááááááline.
5. "CHECK LINE ABOVE" OPERATIONS
5.1áááPusΦ "3ó froφ thσ maiε men⌡ t∩ ente≥ int∩ "Checδ Linσ ì
ááááááAboveó operations« "Checδ Linσ Aboveó allo≈s "Wai⌠ Filesó t∩ ì
ááááááactuall∙ looδ ß predetermineΣ numbe≥ oµ line≤ u≡ thσ screeε ì
ááááááfo≥ ß standarΣ messagσ lef⌠ b∙ thσ previou≤ program« Iµ ì
áááááátha⌠ messagσ i≤ founΣ theε thσ "Wai⌠ Fileó wil∞ no⌠ wait« ì
ááááááIµ thσ messagσ i≤ no⌠ founΣ theε thσ "Wai⌠ Fileó wil∞ givσ ì
ááááááß messagσ oµ it≤ owε anΣ theε wai⌠ unti∞ yo⌡ decidσ wha⌠ t∩ ì
áááááádo. This feature can be "disabled" or "activated".
5.2áááIµ thσ "Checδ Linσ Aboveó i≤ "disabledó wheε "3ó i≤ pusheΣ ì
áááááátheε thσ onl∙ option≤ yo⌡ wil∞ havσ arσ t∩ "activateó i⌠ o≥ ì
ááááááreturε t∩ thσ Maiε Menu.
.paè5.3áááIµ thσ "Checδ Linσ Aboveó i≤ "activatedó wheε "3ó i≤ pusheΣ ì
áááááátheε yo⌡ havσ severa∞ options« The∙ are:
áááááá1.ááReturn to the Main Menu.
áááááá2.ááDisable "Check Line Above".
áááááá3.ááEdit the "Check Line Above" message.
áááááá4.ááSet the number of lines to look up.
5.4áááThσ numbe≥ oµ line≤ t∩ looδ u≡ i≤ referenceΣ froφ thσ CP/═ ì
áááááá"Wai⌠ Fileó commanΣ line« Fo≥ example:
XXX╪ (Thi≤ i≤ thσ messagσ lef⌠ b∙ thσ previou≤ program)
A>WAIT (This is the CP/M "Wait File" command line)
ááXXX╪ i≤ ▓ line≤ u≡ froφ thσ commanΣ line« Yo⌡ caε selec⌠ ì
ááááááfroφ ░ t∩ ╣ lines« Yo⌡ caε selec⌠ u≡ t∩ 1╡ line≤ u≡ iµ yo⌡ ì
áááááákno≈ thi≤ littlσ trick« Thσ fou≥ leas⌠ significan⌠ bit≤ oµ ì
ááááááthσ ASCI╔ codσ arσ useΣ t∩ ente≥ thσ number« Fo≥ examplσ ì
áááááápusΦ J,K,L,M,╬ anΣ ╧ fo≥ 10,11,12,13,14¼ anΣ 15.
5.5áááYo⌡ caε looδ fo≥ u≡ t∩ 3▒ characters« Remembe≥ tha⌠ thσ ì
ááááááfirs⌠ characte≥ i≤ alway≤ iε thσ fa≥ lef⌠ columε oµ thσ ì
ááááááscreen« Iµ therσ arσ blank≤ therσ theε the∙ mus⌠ bσ par⌠ oµ ì
ááááááthe message line to be looked for.
áááááá
6.ááááON BOARD LINE EDITOR
6.1áááThσ oε boarΣ linσ edito≥ i≤ useΣ t∩ edi⌠ thσ "activσ ì
áááááámessage" and the "Check Line Above" message.
6.2áááThσ oε boarΣ linσ edito≥ wil∞ allo≈ mos⌠ CP/═ anΣ WordSta≥ ì
ááááááeditinτ commands« ┴ men⌡ oµ editinτ command≤ i≤ provideΣ oε ì
ááááááthe screen.
6.3áááMKWAI╘ use≤ 0Φ insteaΣ oµ "$ó fo≥ thσ "outpu⌠ delimiteró ì
áááááá(enΣ flaτ oµ screeε messages)« Thi≤ mean≤ tha⌠ "$ó caε bσ ì
ááááááentereΣ int∩ thσ message.
6.4áááThσ editeΣ messagσ caε bσ saveΣ and replace the "active" ì
áááááámessage b∙ pushinτ <RETURN>« ì
6.5áááThσ editeΣ messagσ caε bσ discarded¼ iµ desired¼ b∙ pushinτ ì
áááááá<ESC>.
6.6áááThσ onboarΣ edito≥ wil∞ no⌠ allo≈ nonprintablσ character≤ ì
ááááááto bσ entereΣ int∩ thσ message.
.paè7. CHANGE TO A DIFFERENT FILE NAME
7.1 The default file name that MKWAIT can create is WAIT.
7.2áááT∩ changσ t∩ ß differen⌠ filσ namσ pusΦ "2ó froφ thσ Maiε ì
ááááááMenu.
7.3 áá┴ maximuφ oµ ╕ character≤ wil∞ bσ allowed« Lowe≥ casσ wil∞ ì
áááááábσ converteΣ t∩ uppe≥ case« Follo≈ CP/═ Plu≤ rule≤ fo≥ ì
áááááácreatinτ filσ names« Somσ character≤ sucΦ a≤ ║ anΣ « canno⌠ ì
áááááábσ useΣ iε thσ ╕ characte≥ filσ name« MKWAI╘ will allo≈ yo⌡ ì
áááááát∩ ente≥ thesσ character≤ bu⌠ the∙ wil∞ causσ yo⌡ problem≤ ì
áááááálate≥ wheε thσ filσ i≤ actuall∙ createΣ oε ß disk.
7.4áááThσ filσ typσ oµ .CO═ i≤ assumeΣ fo≥ al∞ filσ name≤ ì
ááááááselected.
8.ááááWRITE THE ACTIVE MESSAGE TO DISK
8.1áááPusΦ "Wó t∩ writσ thσ "activσ message" t∩ ß disδ drivσ ì
ááááááto be selected.
8.2áááMKWAIT will allow a message of no characters if desired.
8.3áááIµ thσ "Wai⌠ Fileó alread∙ exist≤ oε thσ disδ theε MKWAI╘ ì
ááááááwil∞ questioε iµ i⌠ i≤ t∩ bσ overwritten« MKWAI╘ caε ì
ááááááoverwritσ ß read/onl∙ "Wai⌠ Fileó iµ needed«
.paè9.ááááADDITIONAL NOTES
9.1 ááT∩ creatσ CP/═ "commanΣ stringsó witΦ "Wai⌠ Files"iε them¼ ì
áááááátheε usσ somethinτ likσ MAKES╘ b∙ your≤ truely¼ o≥ setu≡ ß ì
ááááááspecia∞ functioε key¼ o≥ jus⌠ typσ iε ß commanΣ strinτ ì
ááááááafte≥ thσ systeφ prompt« "Wai⌠ Filesó caε als∩ bσ useΣ iε ì
ááááááSUBMI╘ file≤ iµ desired« Pushinτ thσ <ESC╛ ke∙ whilσ ì
ááááááwaitinτ iε ß "Wai⌠ Fileó wil∞ terminatσ al∞ remaininτ ì
áááááácommand≤ includinτ thosσ iε SUBMI╘ file≤ (includinτ al∞ ì
áááááácommand≤ oµ stackeΣ SUBMI╘ files).
9.2áááYo⌡ don'⌠ always neeΣ "Wai⌠ Filesó t∩ inser⌠ message≤ ì
ááááááiεto you≥ commanΣ string« Yo⌡ caε inser⌠ message≤ directl∙ ì
ááááááint∩ you≥ commanΣ strinτ b∙ usinτ thσ semicolon« Fo≥ ì
ááááááexample:
ááááááDIR A:!;LOAD DISK INTO DRIVE B:
ááááááKee≡ iε minΣ tha⌠ thσ abovσ examplσ wil∞ no⌠ allo≈ yo⌡ t∩ ì
ááááááfreezσ thσ strinτ iε progres≤ (tha⌠ is¼ wai⌠ unti∞ ß ke∙ i≤ ì
áááááápushed⌐.
10.ááááSOME PROBLEMS
10.1ááWheε thσ oε boarΣ linσ edito≥ become≤ ful∞ anΣ yo⌡ tr∙ t∩ ì
ááááááadΣ onσ morσ characte≥ theε thσ "belló wil∞ sound« Yo⌡ ma∙ ì
áááááánoticσ tha⌠ wheε thσ "belló sounds¼ tha⌠ thσ fa≥ lef⌠ ì
áááááácharacte≥ oε thσ screeε wil∞ flash« Thi≤ i≤ becausσ thσ ì
ááááááBIO╙ activate≤ thσ CP/═ curso≥ whilσ thσ bel∞ i≤ goinτ ofµ ì
ááááááeveε thougΦ thσ oε boarΣ edito≥ turneΣ i⌠ ofµ s∩ i⌠ coulΣ ì
ááááááusσ it≤ owε cursor«
10.2ááYo⌡ canno⌠ ente≥ carriagσ return/linσ feeΣ code≤ int∩ thσ ì
áááááámessages« Instead¼ yo⌡ mus⌠ usσ thσ featurσ tha⌠ line≤ wil∞ ì
ááááááautomaticall∙ g∩ t∩ thσ nex⌠ linσ afte≥ displayinτ 8░ ì
áááááácharacter≤ oε thσ screen« Iε orde≥ no⌠ t∩ spli⌠ word≤ iε ì
ááááááthσ wronτ placσ yo⌡ ma∙ wan⌠ t∩ adΣ space≤ t∩ enΣ ß linσ iε ì
ááááááthσ righ⌠ place.
10.3ááThσ featurσ t∩ terminatσ al∞ remaininτ command≤ i≤ baseΣ oε ì
ááááááundocumenteΣ information« Therσ i≤ thσ possibilit∙ tha⌠ ì
ááááááDigita∞ ResearcΦ and/o≥ Osbornσ coulΣ changσ thσ locatioε ì
ááááááoµ datß needeΣ fo≥ commanΣ terminations« Thereforσ, thi≤ ì
ááááááfeaturσ ma∙ no⌠ worδ oε futurσ release≤ oµ SUBMI╘ o≥ thσ ì
ááááááOsborne Executive«
10.4ááA≤ alway≤ yo⌡ shoulΣ bacδ u≡ importan⌠ file≤ iε casσ oµ ì
ááááááproblems« Thi≤ i≤ no⌠ onl∙ gooΣ advicσ fo≥ wheε yo⌡ usσ ì
áááááá"Wai⌠ Files"¼ bu⌠ i⌠ i≤ gooΣ advicσ a⌠ al∞ time≤ anΣ wheε ì
ááááááusinτ al∞ programs.
.paè11.áááFO╥ CP/═ PLU╙ HACKER╙ ONLY
11.1ááCP/═ Plu≤ i≤ great« CP/═ Plu≤ i≤ wonderful« CP/═ Plu≤ ha≤ ì
ááááááit≤ owε strangσ quirks« Fo≥ example¼ ho≈ i⌠ handle≤ ì
áááááácommanΣ string≤ i≤ no⌠ al∞ straigh⌠ forward.
11.2ááIµ yo⌡ werσ t∩ typσ iε afte≥ thσ CP/═ promp⌠ ß commanΣ ì
áááááástring¼ yo⌡ coulΣ ente≥ u≡ t∩ 22╖ characters« Wh∙ 22╖ ì
áááááácharacters┐ Wh∩ knows.
11.3ááYo⌡ caε ente≥ ß commanΣ strinτ oµ u≡ t∩ 12╢ character≤ ì
ááááááusinτ Bdo≤ Functioε 4╖ (Chaiε t∩ Program)« Thi≤ i≤ becausσ ì
áááááái⌠ use≤ thσ defaul⌠ DM┴ whicΦ i≤ 12╕ byte≤ long« Als∩ thσ ì
áááááácommanΣ strinτ mus⌠ enΣ witΦ ß nul∞ bytσ 00h« S∩ yo⌡ migh⌠ ì
ááááááasδ wh∙ 12╢ characters╗ wh∙ no⌠ 127┐ You≥ gues≤ i≤ a≤ gooΣ ì
ááááááa≤ mine.
11.4ááCommanΣ tail≤ arσ loadeΣ int∩ thσ defaul⌠ DM┴ a⌠ addres≤ ì
áááááá80h« Thσ firs⌠ bytσ i≤ thσ numbe≥ oµ byte≤ iε thσ commanΣ ì
áááááátail« Thσ seconΣ bytσ i≤ alway≤ ß blanδ (20h)« Thσ bytσ ì
ááááááfollowinτ thσ las⌠ bytσ oµ thσ commanΣ tai∞ i≤ 00Φ unles≤ ì
áááááái⌠ occur≤ a⌠ 100Φ o≥ abovσ iε whicΦ casσ i⌠ anΣ al∞ oµ thσ ì
áááááátail data loaded past 100h i≤ lost«
11.5ááS∩ ho≈ wa≤ ╔ ablσ t∩ terminatσ commanΣ lines« ╔ mus⌠ admi⌠ ì
á áááái⌠ wa≤ lucδ anΣ ß lo⌠ oµ trial and error«
ááááááFirs⌠ yo⌡ mus⌠ terminatσ an∙ anΣ al∞ SUBMI╘ RSX's« Iµ yo⌡ ì
áááááásenΣ 81Φ a≤ thσ RS╪ Functioε Numbe≥ oµ Bdo≤ Functioε 6░ ì
ááááááunti∞ i⌠ return≤ thσ Erro≥ Codσ oµ FFΦ theε thi≤ wil∞ ì
ááááááterminatσ al∞ SUBMI╘ RSX's« I⌠ ma∙ requirσ man∙ 81Φ code≤ ì
ááááááiµ SUBMI╘ file≤ arσ stacked.
ááááááNex⌠ yo⌡ mus⌠ terminatσ an∙ CP/═ commanΣ RS╪ (therσ wil∞ ì
ááááááonl∙ bσ onσ iµ therσ i≤ any)« Iµ yo⌡ checδ thσ datß a⌠ aε ì
ááááááoffse⌠ oµ 16Φ iε thσ SC┬ (usσ Bdo≤ Functioε 49⌐ i⌠ wil∞ ì
áááááátel∞ yo⌡ thσ HigΦ addres≤ oµ thσ commanΣ RSX« Iµ i⌠ i≤ 00Φ ì
áááááátheε therσ i≤ n∩ commanΣ RSX« WitΦ thσ HigΦ addres≤ knowε ì
ááááááanΣ addinτ thσ Lo≈ addres≤ oµ 0EΦ theε thσ commanΣ RS╪ caε ì
áááááábσ "removedó b∙ settinτ it≤ "removσ flagó t∩ FFh« Nex⌠ yo⌡ ì
áááááámus⌠ se⌠ thσ addres≤ pointe≥ oµ thσ commanΣ RS╪ t∩ 0000h« ì
ááááááThi≤ i≤ locateΣ a⌠ thσ offse⌠ oµ 15Φ iε thσ SCB.
Pete≥ C« Cole
Man∙ thank≤ t∩ Joe∞ Guerrß anΣ Martiε Murr∙ fo≥ sharinτ thei≥ ì
excitemen⌠ oµ thσ interna∞ workinτ oµ thσ Executivσ witΦ me« The∙ ì
havσ knowingl∙ o≥ unknowingl∙ giveε mσ man∙ oµ m∙ idea≤ fo≥ thi≤ ì
project.