_______ / / /______/ ____ / / \ / /___/ version 3.39 /______/ \/ /____ 10/21/85 / The BYE communications program Authors note: BYE is in the public domain. I have Copyrighted this manual in anticipation of it being purloined by pseudo-BYE spinoffs. I am allowing this manual to be distributed under the following circumstances: 1) I i onl to be distribute wit BY versio software. 2 I ma no b sol o distribute commercially without my express written permission. Thos ar th onl restriction a placin o on this manual. I regret having to do this in the first place, but I'm not going to have my effort get trashed with BYE spinoffs. -- pst 7/25/85 P.S. I'd like to make it clear, I am NOT the author of BYE, BYE is a collaboration by about 60+ people. Historical note: BYE was originally hacked together by: Dave Hardy, Keith Petersen, Howard Moulton (I think), Bruce Ratoff, and Ben Bronson. At that time it supported only PMMI and HAYES MM100 S100 modems. We've come a long way, but if it wasn't for these guys, BYE would never have been written. The original single author's name has been lost due to careless editing over the years, Sorry. Legalities: CP/M is a registered trademark of Digital Research  T A B L E O F C O N T E N T S  What is BYE?...................................................1 What do I use BYE for?......................................1 What are other uses for BYE other than running a BBS?.......1 BYE instalation................................................1 Setting up control equates..................................1 Installing your serial port driver..........................1 Installing your intelligent modem driver....................2 Installing your clock reader................................2 Appendix A - new BDOS functions................................3 32 *BYE EXISTANCE TEST*...................................3 61 Get raw modem input status (modem only)................3 62 Get raw modem output status (modem only)...............3 63 Send 8 bit character to modem (no waiting).............3 64 Get 8 bit character from modem (no waiting)............3 65 Get carrier status.....................................3 66 Get local console input status.........................3 67 Get 7 bit character from local console.................4 68 Send 7 bit character to local console..................4 69 Set/Get maximum drive allowed on system................4 70 Set/Get maximum user area allowed on system............4 71 Set/Get timeout # of minutes...........................4 72 Set/Get number of nulls................................4 73 Set/Get upper-case only flag...........................4 74 Set/Get line feed-masking..............................4 75 Set/Get RBBS WRTLOC flag...............................4 76 Set/Get hardlog active flag............................4 77 Set/Get modem block-out flag...........................5 78 Set/Get console bell enable............................5 79 Return address of RTC buffer...........................5 80 Return address of LASTCALR buffer (for whokey).........5 81 Set maximum time allowed on system (if RTC is present).6 82 Set initial login time.................................6 83 Print "Time on system nn minutes." message.............6 Appendix B - Description of BYE equates........................7 CCPL - ccp length...........................................7 LOCMD - start of BYE BDOS calls.............................7 IMODEM - intelligent modem present..........................7 B3IM - Hayes compatible modem............................7 MDMRNG - Modem needs ring signal............................7 HS2400/HS1200/HS300 - modem's highest speed.................8 ECHO - does Hayes compatible modem echo.....................8 CALBAK - use intelligent-call-back system...................8 ANCHOR - modem is an Anchor Modem...........................8 NODTR - modem cannot handle DTR line........................9 NOATA - modem cannot handle ATA command.....................9 OXGATE, MBBS, MINICK, METAL, RBBSCK.........................9 IOVAL - MiniCBBS I/O Byte value..........................9 RTC - have RTC reader installed.............................9 TIMEON - monitor time on system.........................10 TOSWB - print TOS on warmboot........................10 MAXMIN - maximum time allowed on system..............10 RSPEED - restrict slow speed modems.....................10 HOUR1/HOUR2 - hours of prime time....................10 OKSPD - slowest non-restricted modem speed...........10 BCD2BIN / BIN2BCD - clock reader needs these............11 HARDLOG - keep a log of all input on printer...............11 PRINTER - printer online...................................11 COMFILE - execute a program at answer time.................11 COMDRV/COMUSR - where program exists....................12 EXFILE - run a program on emergency exit...................12 EXDRV/EXUSR - area where program exists.................12 NO25TH - we don't have 25th line...........................12 NEEDLC - need to read lastcaller file...................13 LCDRV/LCUSR - area where lastcaller file exists......13 WELFILE - print a welcome file.............................13 WELDRV/WELUSR - area where welcome file exists..........13 CLRSCR - clear screen betwen calls.........................14 CLRB4 - clear before userlog summary....................14 CLRCH1..6 - clear screen sequence.......................14 MNULLS - number of times to ask for nulls..................14 PRGRSS - print progress messages...........................15 PRNTGB - print "Goodbye" message...........................15 PWRQD - password required..................................15 TOVALUE - idle timeout value...............................15 WBRTN - warm boot routine..................................15 CLOSS - carrier loss time..................................16 CTRLC - map ^C.............................................16 DOWNMIN - time 'til system down............................16 LOSER - bad computer.......................................16 MHZ - processor clock speed................................17 ATTNCH - function key attention character..................17 BLNKKEY - blank out key.................................17 SYSDKEY - system going down key.........................17 TWITKEY - twit-killer key...............................17 MSGKEY - message from Sysop key.........................18 BELLKEY - toggle quiet mode key.........................18 TIMEKEY - display time on system........................18 WHOKEY - display who's on system........................18 ULTIME - give user unlimited time on system.............18 ZSCREEN - zap screen key................................19 ZCPR2 - using ZCPR2 or similar.............................19 ZCPR3 - using ZCPR3........................................19 USEZCPR - CCP controls maxdrive/user....................19 MAXDRIV/WHEEL/MAXUSER - location of bytes...............19 MAXDRV/MAXUSR/SYSDRV/SYSUSR - initial values.........20 CHGPATH - change command search path....................20 EXTPATH - location of path...........................20 MSPEED - baud rate pointer.................................20 WBCALL/WMSTRT - loser equates..............................21 Bye Documentation v3.38 What is BYE? BYŠ i progra tha relocate underneat th CC o you CP/ 2. system I parallel mode I/ t th BIO consol I/ jumps I als monitor th syste fo breache i securit an loss of carrier. What do I use BYE for? T ru BB unde CP/M o RCP/ (Remot CP/M system An applicatio progra tha run unde norma CP/ syste wil run BYE, and will allow you to use that program over the phone. What are other uses for BYE other than running a BBS? Man peopl jus us BY o thei hom o wor compute s tha the ca cal i t i ove th phone Thi let the us editor o wor processor o data-bas program fro th comfor of their own home. BYE instalation To install BYE on your computer you must: 1) Set up the control equates at the beginning of BYE. 2) Install your modem driver insert using the "Yank a file in" command under your favorite editor. (WS=^KR, WM=Y) 3 Optionall instal a intelligen mode programmer insert in BYE. 4) Optionally install a real-time-clock reader insert into BYE. Setting up control equates BYŠ i distribute fo minimum-system Tha is everythin tha ca b turne of I off Yo wil hav t chang severa equate i BY t ge BY t ru o you syste wit th feature that YOU want. BYE is infinitely customizeable. Fo documentatio o individua contro equates pleas se Appendix B. Installing your serial port driver W ar no P clones Ever CP/ syste i individual hav CompuPr Interfacer- fo seria board M frien ma hav a Osborn O computer M Interfacer- drive obviousl won' ru his Osborne O1, or another friend's Kaypro. What do we do? Well ove th thre year sinc ɠ release BYEII man modem/seria por driver hav bee writen W no suppor ten of computers. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 I yo hav on o th computer tha w suppor (Se th BY inser list the you'r fine Jus inser tha drive int th mai BYŠ cod a th appropriat poin (loo fo "+++ t fin tha point) I w don' currentl suppor you the ge togethe al o th informatio o you computer' seria I/O and either: 1) write your own driver or 2) call me and I'll write one for you Writin driver i NO a eas task n matte ho muc w trie t mak i so I' sorry bu i yo don' kno 808 assembl language you're going to be lost. Installing your intelligent modem driver BYŠ support th Haye compatibl modem internally I ha super-sophisticate wa o answerin th phon an detectin bau rates if you have one of these types of modems: Hayes: Smartmodem300, Smartmodem1200, Smartmodem2400 Robotics: Password, AD212, Courrier 2400 Prometheus: ProModem 1200 Anchor: Signalman Mark XII Vadic: Maxwell 2400 Ther ma b othe compatible tha w support bu ɠ don' recall them at this time. I yo hav a intelligen mode tha i NO "Haye Compatible the yo mus instal a intelligen mode driver A exampl o thi i th popula Cermete Infomat 212 an I19 modems Ther i drive whic wil progra thes modem t answer Just insert the code in the intelligent modem driver area. Installing your clock reader Righ now BY support severa differen real-time-cloc board (o computers) Again jus inser you RT routin int th prope plac i BY an se th RT equate appropriately I yo don' hav RTC the mak sur tha th RT equat i se to NO. I yo hav RT bu n cloc reade insert the giv m cal and we can write one. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 Appendix A - new BDOS functions Her i lis o "BDO functions tha BY wil support T thos o yo wh kno wha RS is thi i exactl wha BY i pretendin t be. Comman number ar passe i registe C an entr dat i passe i registe DE an exi dat i passe i H̠ o dependin upo the function. 32 *BYE EXISTANCE TEST* Also this is the CP/M set/get user area command. This will test if BYE is there, IF and ONLY IF register E = 241 (decimal). Entry: E = 0-31 set user area (CP/M std) E = 255 get user area (CP/M std) E = 241 test if BYE exists. Exit: if E=241 & BYE exists A=77 (decimal) if E=241 & no BYE A=something else (unknown) if E<>241 see CP/M manual 61 Get raw modem input status (modem only) Entry: nil Exit: if not ready: A=0 & zero flag set if ready: A=255 & zero flag cleared 62 Get raw modem output status (modem only) Entry: nil Exit: if not ready: A=0 & zero flag set if ready: A=255 & zero flag cleared 63 Send 8 bit character to modem (no waiting) Call modem output status first, or you may overrun the modem. Entry: E= 8 bit character Exit: nil 64 Get 8 bit character from modem (no waiting) Call modem input status first, or you may input garbage. Entry: nil Exit: A= 8 bit character 65 Get carrier status Entry: nil Exit: if carrier present: A=255 & zero flag cleared if no carrier: A=0 & zero flag set 66 Get local console input status Entry: nil Exit: if not ready: A=0 & zero flag set if ready: A=255 & zero flag cleared This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 67 Get 7 bit character from local console (loop until key struck) Entry: nil Exit: A= character 68 Send 7 bit character to local console (loop until console ready) Entry: E= character to send Exit: nil 69 Set/Get maximum drive allowed on system Entry: E= drive (0=A:, 1=B:, etc) if E=255 then return current setting Exit: if E=255 then A= current maximum drive 70 Set/Get maximum user area allowed on system Entry: E= user area (0=0, 1=1, etc) if E=255 then return current setting Exit: if E=255 then A= current maximum user area 71 Set/Get timeout # of minutes Entry: E= number of minutes (between 0 and 254) if E=255 then return current setting Exit: if E=255 then A= current setting 72 Set/Get number of nulls (after carriage return) Entry: E= nulls (between 0 and 9 only! (or 255)) if E=255 then return current setting Exit: if E=255 then A= current number of nulls 73 Set/Get upper-case only flag Entry: if upper case only: E=32 if upper/lower case: E=0 if read current setting: E=255 Exit: if E=255 then A= current setting 74 Set/Get line feed-masking Entry: if ok to send line feeds: E=0 if not ok: E=1 if read current setting: E=255 Exit: if E=255 then A= current setting 75 Set/Get RBBS WRTLOC flag Entry: if normal operation: E=0 if nohangup active: E=1 if read current setting: E=255 Exit: if E=255 then A= current setting 76 Set/Get hardlog active flag (will do nothing if HARDLOG=NO) Entry: if disable hardlog: E=0 if enable hardlog: E=1 if read current setting: E=255 Exit: if E=255 then A= current setting This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 77 Set/Get modem block-out flag Entry: if modem I/O ok: E=0 if modem squelched: E=1 if read current setting: E=255 Exit: if E=255 then A= current setting 78 Set/Get console bell enable Entry: if quiet console: E=0 if bell-ringing ok: E=1 if read current setting: E=255 Exit: if E=255 then A= current setting 79 Return address of RTC buffer Entry: nil Exit: HL = address of RTC buffer A = time on system Format: byte hours BCD read only byte minutes BCD read only byte seconds BCD read only byte century BCD read only byte year BCD read only byte month BCD read only byte day BCD read only byte time online binary read only byte binary reserved byte current hour binary read only byte current minute binary read only byte login hour binary read/write byte login minute binary read/write Note: If you don't have the clock reader installed, the first byte of the buffer will be 099 HEX. This way application programs can sense NO clock. 80 Return address of LASTCALR buffer (for whokey) Entry: nil Exit: HL = address of buffer Th buffe ha roo fo 7 asci characters whic wil b displaye o warmboo (i desired) Applicatio program coul loo int thi buffe fo information however som system ma no suppor th buffe becaus BY i s LARGE. Note I th firs byt o th LASTCAL buffe i space th buffe ha no bee programe th BB o b BYE I th firs byt o th LASTCAL buffe i null the th buffe shoul no b rea fro o writte to as it doesn't exist. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 81 Set maximum time allowed on system (if RTC is present) Entry: E= number of minutes allowed (1..255) if E=255 then return current setting if E=0 then unlimited time allowed on system Exit: if E=255 then A= current maximum time on system 82 Set initial login time Entry: D = hours (0..23) E = minutes (0..59) Exit: nil 83 Print "Time on system nn minutes." message. Entry: nil Exit: nil This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 Appendix B - Description of BYE equates The following list is in order of appearance in the source code: CCPL - ccp length Default: 8 - (2k) Related: none Thi i th numbe o page (25 bytes= page tha you CC take up Fo mos users i shoul remai se t 8 Fo Appl user with Microsoft CP/M v2.23, it should be set to 9. LOCMD - start of BYE BDOS calls Default: 61 Related: HICMD Thi equat i wher ou ne BDOӠ call start Thi numbe shoul no b change unde norma circumstances Currentl w hav 2 ne command added I w ad more we'l hav t chang HICMD Th curren setting ar compatibl wit CP/ 2.2 CP/ 3.0 MP/ 1.0 an MP/ II. IMODEM - intelligent modem present Default: NO - no, we're using dumb modem Related: B3IM I yo ar usin Haye compatibl modem o AN٠ kin o programabl modem yo wil wan t se thi equat t YES I yo hav Haye compatibl modem yo wil als wan t se th B3I͠ equat description I yo don' hav Haye compatibl modem bu i i intelligen (e.g Cermete I212a) the yo shoul inser you intelligen mode drive i th prope place. B3IM - Hayes compatible modem Default: NO - no, not compatible Related: ECHO, ANCHOR, NODTR, NOATA I yo hav Haye compatibl modem se thi equat t YE s tha i wil b programe b ou super-intelligen mode handler Se als relate equates. MDMRNG - Modem needs ring signal Defalut: NO - no ring signal required Related: IMODEM, B3IM Certai modem suc as Haye MM100 Haye MM][ PMMI an Novatio Appleca nee t kno i rin i present I thi equat i YES the BY wil cal MDRIN t detec ring an MDANS t tel th mode t answe th phone Mak sur IMODE and B3IM are NO. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 HS2400/HS1200/HS300 - modem's highest speed Default: all = NO - uninitialized, must be changed Related: none Yo shoul onl hav on o thes thre equate set Thes equate defin th highes spee you mode i capabl o running I yo hav a 300 baud modem: set HS300 = YES, set HS1200, HS2400 = NO 1200 baud modem: set HS1200 = YES, set HS300, HS2400 = NO 2400 baud modem: set HS2400 = YES, set HS300, HS1200 = NO ECHO - does Hayes compatible modem echo Default: NO - no, it doesn't don't echo Related: B3IM I B3I͠ i se t yes thi equat tell i you mode echo character o no whe it' i comman mode Thi equat shoul b se t N fo th U Robotic Passwor an th Ancho modems Thi equat shoul b se t YE fo th Hayes ProModem Vadi Maxwell an U Robotic Courrie modems. CALBAK - use intelligent-call-back system Default: NO - no, standard answer Related: B3IM, NOATA I B3I i se t yes an NOAT i se t no the thi equat wil allo yo t us you compute o norma "household telephone. This is accomplished as such: Normal voice callers will just dial the number, and the system will ignore their call. Household members should be informed to always let the phone ring at least 2 times before picking it up. Modem users will dial the number, let it ring once, hangup, and then dial the same number again. Upon the second dial, the computer will answer the phone. ANCHOR - modem is an Anchor Modem Default: NO - nope Related: B3IM I B3I i se t yes thi equat shoul b se t YE i yo hav Signalma Mar XII I not se i t NO. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 NODTR - modem cannot handle DTR line Default: NO - we can handle it Related: B3IM Th Ancho Mar XI canno hang-u b droppin th DTҠ line Also som computer (lik th Kaypro canno contro thei DT line I yo hav eithe o thes situation (an ar runnin wit B3IM) the se thi equat t YES. NOATA - modem cannot handle ATA command Default: NO - we can handle it Related: B3IM I B3I i se t yes thi equat shoul b se t YE i yo hav a olde U Robotic Passwor o 212A o S10 tha wil no execut th AT command. [You can contact Robotics for new ROMS to fix this bug]. OXGATE, MBBS, MINICK, METAL, RBBSCK Default: all = NO - none of these BBS programs Related: none I yo ar runnin eithe OxGate MBBS MiniCBBS Metal o RBBS the se th appropriat equat t YES an se th res t NO. IOVAL - MiniCBBS I/O Byte value Default: 0 - everything = TTY: Related: MINICK Thi i onl use i MINIC i YES Thi i th initia valu fo th I/ Byte. RTC - have RTC reader installed Default: NO - nope Related: TIMEON, RSPEED, BCD2BIN, BIN2BCD I yo hav real-time-clock the inser you cloc reade cod i th apropriat spo i BY an se thi equat t YES. Note: some clock overlays may need to use our utility routines "convert BCD to binary" and "convert binary to BCD." This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 TIMEON - monitor time on system Default: NO - nope Related: RTC, TOWSB, MAXMIN I RT i yes the thi wil kee trac o user' tim o th system I wil automagicall boo hi of afte MAXMI minutes I MAXMI get se t zer o th WHEE byt get poke wit 255 th use ha unlimited time on the system. TOSWB - print TOS on warmboot Default: NO - nope Related: RTC, TIMEON I RT an TIMEO ar yes the thi wil prin th tim tha user' bee o th syste o ever war boot Thi functio i disable when the WHEEL byte is poked with 255. MAXMIN - maximum time allowed on system Default: 60 - one hour Related: RTC, TIMEON I RT an TIMEO ar yes the thi i th defaul "maximu tim o system tha get poke i whe w answe th phone BB ma pok th valu dow i th RT buffe t dynamicall chang thi value. RSPEED - restrict slow speed modems Default: NO - nope Related: RTC, HOUR1, HOUR2, OKSPD I RT i yes BY ca restric slo spee modem durrin "prime- time hours T d this se RSPEE t YES. HOUR1/HOUR2 - hours of prime time Default: 19 / 23 - 7pm to 11pm local time Related: RTC, RSPEED, OKSPD If RTC & RSPEED are yes, this sets the hours of prime time (24 hour time). OKSPD - slowest non-restricted modem speed Default: 5 - 1200 baud Related: RTC, RSPEED, HOUR1, HOUR2 Thi valu i th slowes bau rat allowe o th syste durrin prim tim i RT RSPEE ar se t YES. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 BCD2BIN / BIN2BCD - clock reader needs these Default: NO - we don't need this code Related: RTC BYŠ ha tw subroutines calle "BCDBIN an "BINBCD whic conver binar t BC o bac again I you cloc routin need eithe converter the se th appropriat equat t true Thes module wil onl b installe i RT i als se t yes. HARDLOG - keep a log of all input on printer Default: NO - no, don't waste paper Related: none I thi equat i se t YES the al use inpu (everythin th gu o th mode types wil b sen t th printer Thi i usefu i som boz i crashin you syste becaus yo ca se exactl wha h typed Yo ca disabl thi (i thi equeat i se t yes b usin th BYERSؠ cal t enable/disabl th hardlog It' automagicall re-enable ever tim th syste answer th phone. PRINTER - printer online Default: NO - no printer online Related: none I yo wan t leav you printe online the se thi equat t YES Man BBӠ program lik t sen erro message t th printer s sugges tha yo kee thi equat t YES otherwis yo won' kno ther wa problem I thi equat i se t NO al character tha wer suppose t g t th printe ar instea sen t th modem. COMFILE - execute a program at answer time Default: NO - no, just drop to CP/M Related: COMDRV, COMUSR, ...and BBS types... I yo ar runnin BB yo definitel wan thi on se t YES Thi wa BY wil execut you BB program I i i se t NO the BYŠ wil jus dro int CP/M I on o th BBӠ typ equate (se above wa set the thi wil tel BY wha .CO fil t loo fo (eg "OXENTR.COM v "RBBS.COM") Th COMDRV/COMUS equate tel exactl wher t loo fo thi file. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 COMDRV/COMUSR - where program exists Default: A: 14 - on A14: Related: COMFILE I COMFILŠ i yes the thes tw equate tel wher th .CO fil i located Mos BB system hav followe th "pseudo- standard tha se abou year ag o lookin t A14: bu your ma wan A15 o A0 o somethin eve stranger. EXFILE - run a program on emergency exit Default: NO - no don't do anything Related: EXDRV / EXUSR I thi equat i se to YES the BY wil ru .CO fil upo unexpecte los o carrier BY wil NO ru thi .CO fil i someon exit you BB wit th "G comman o i someon type "BYE fro CP/M Th usefulnes o thi equat i yo ca hav somethin updat you BB log t sa ho lon th curren use wa o th system Righ no EXFIL i rathe flake becaus it' bee neglected I' lik t ge everythin workin again s i anyone is now using EXFILE I'd like to hear from you. EXDRV/EXUSR - area where program exists Default: A: 14 - A14: Related: EXFILE I EXFIL i true the thi tell BY exactl wher thi fil i located Se COMDRV/COMUS fo mor info. NO25TH - we don't have 25th line Default: NO - no, and we don't want a fake one... Related: NEEDLC / LCDRV / LCUSR / ATTNCH / WHOKEY Thi shoul onl b se t YE if (1 yo hav BBӠ tha store th caller' nam (an othe info i fil tha i calle "LASTCALR.xxx wher "xxx i anything (2 Yo hav BB tha poke th LCDAT buffe automatically Th advantag o thi i tha o ever war boot th syste wil displa (o you loca consol only th guy' name. If you are not running a BBS, set this equate to NO. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 NEEDLC - need to read lastcaller file Default: NO - no Related: NO25TH / LCDRV / LCUSR I yo hav NO25T se t true the thi equat come int play Som BBSs notabl OxGat an MBBS wil automaticall pok th user' nam int th LCDAT buffe i BYE Thi make th extensiv cod neede t rea th lastcalle fil unnecessary Therefore w ca remov th cod (an mak BY smaller) I yo ar runnin BB tha doesn' automaticall pok th user' nam int th buffer the yo shoul se thi equat t YES O th firs warm-boo int CP/ th lastcalle fil wil b rea an store i the LCDATA buffer. LCDRV/LCUSR - area where lastcaller file exists Default: A: 14 - A14: Related: NO25TH / NEEDLC I NO25T an NEEDL ar se t true the thi i wher BY wil loo fo th lastcalle file I it' no there BY wil CRAS an BURN Therefor onl se thi NO25T stuf i yo hav BBS. WELFILE - print a welcome file Default: NO - no Related: WELDRV / WELUSR Thi equat wil includ cod i BY t prin nic littl welcom tex fil whe BY answer th phone I yo ar runnin BBS yo probabl wan thi se t NO becaus it' jus includin extr cod that' no used (You BB print it ow welcom file. WELDRV/WELUSR - area where welcome file exists Default: A / 14 - on A14: Related: WELFILE I WELFIL i se t yes the thes tw equate tel BY wher th welcom fil is. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 CLRSCR - clear screen betwen calls Equate: CLRSCR - clear screen between calls Default: NO - no Related: CLRB4 / CLRCH1..6 Ther ar tw reason wh yo migh wan t clea th scree betwee calls 1 Yo lik thing t b nea an tid whe th syste i idleing 2 You CR doesn' automagicall tur off s you tub get etche (ich!) I yo ar # (lik me) the yo shoul se CLRSC t ye an CLRB t no I yo ar #2 the yo shoul se CLRSC t yes an CLRB t no I CLRSC i se t NO the BY won' clea th scree betwee calls. CLRB4 - clear before userlog summary Default: NO - no Related: CLRSCR I CLRSC i se t yes the yo hav tw option t clea th screen I yo se CLRB t YES the BY wil clea th scree an prin vita statistic o th scree whil it' waitin fo th nex call. I yo se CLRB t NO the BY wil prin th statistic (whic ge zappe immediatel because... an the clea th screen Thi i fo guy tha hav tube tha coul ge th phospho etche i BYŠ jus sa ther fo hour displayin th sam garbage. CLRCH1..6 - clear screen sequence Default: 1BH, '*' - * - televideo / soroc default Related: CLRSCR Thes si equate se th clea scree sequence An unuse byte shoul b se t zer (a yo ca se i th sourc code) byte allo comple ANS typ clea scree sequences. MNULLS - number of times to ask for nulls Default: 6 - 6 times Related: OXGATE Thi equat onl ha effec i th OXGAT equat i se t NO (OxGat doesn' as th "Ho man null d yo have? question Th use i give "MNULLS trie a answerin thi question I h doesn' answe i i "MNULLS tries BY print satyrica messag an hang up. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 PRGRSS - print progress messages Default: YES - yes Related: just about everything Thi genera equat i rea winner Th syste wil prin progres message o th loca consol (includin displayin las calle an ho lon h wa o (i TIMEON/NO25T ar set)) Thes helpfu message ca reall sav you bun whe you'r debuggin BYE I' sugges alway leavin i on. PRNTGB - print "Goodbye" message Default: YES - yes Related: none Thi simpl say t prin th "Goodbye cal again... message Som peopl apparentl don' lik th message bu mos o u wil wan i se t YE s th remot calle know tha w reall di sign-off. PWRQD - password required Default: NO - no Related: none Normall yo wan thi se t NO Thi i onl fo fe guy tha ru BY o thei hom compute an don' hav BBS I thi equat i se t YES the BY wil as fo passwor befor i let yo d anythin else Th defaul passwor i "DDT" Th passwor i store nea th en o th cod i yo wan t chang it. TOVALUE - idle timeout value Default: 5 - 5 minutes Related: none Thi i th numbe o minute tha th gu ca g of an ge cu o coffe withou BY hangin u o him BY i constantl checkin t se ho lon it' bee sinc th gu las hi key I it' greate tha TOVALU minutes the it'l bum hi off Thi variabl i dynamicall changeabl usin BYERSؠ calls TOVALU ma rang fro t 255. WBRTN - warm boot routine Default: NO - no Related: none Thi wil le yo mak BY d functio ever tim yo d war boot Fo mos peopl i shoul b NO bu ther ar fe wh wante thi capablilty. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 CLOSS - carrier loss time Default: 1 - one second Related: none Thi i th numbe o second t wai befor hangin u th mode i w los carrier Mos modem automagicall han u afte secon anyway bu this is to make sure. CTRLC - map ^C Default: 'K'-'@' - ^K Related: none ^à seem t upse som BB programs s thi wil ma ^ t ^ (o whatever whe byt 0000 i se t anythin othe tha 0C3h. This is a bit technical, if you want to skip it, fine. Byt 0000 i normall 0C3 whic i JM instruction W lik t chang i t CAL instructio (0CDh) whic affect nothin a fa a CP/ goes bu doe ma ^ t a alternat character Also i progra exit t CP/ whe byt 0000 i CAL instruction the BY wil sa "Goodbye... -- thi i ho mos BBS' tel by it' o t hangu whe using their "G" function. DOWNMIN - time 'til system down Default: 2 - 2 minutes Related: RTC, TIMEON Th Syso ha loca functio ke (currentl "O" whic wil prin "Syste goin dow i minutes... T tel remot use tha h shoul g away Well i RT an TIMEO ar true w don' hav t trus hi watch Th syste wil automaticall han u o hi i h hasn' logge ou i DOWNMI minutes Note thi i invali durin XMODE transfers. LOSER - bad computer Default: NO - nope, we do things right Related: WMSTRT / WBCALL Som computers namel th Superbrai an th Serri SBC-10 ar reall dumb The overwrit th BIO jum tabl ever tim th d war boot (Naught naughty... Thi screw BYŠ royally I you compute doe thi the se LOSE t YE an modif th tw relate equate (se below) This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 MHZ - processor clock speed Default: 4 - 4 MHz Related: none This is the speed of your CPU. It may be anywhere from 1 to 8. ATTNCH - function key attention character Default: '^'-'@' - ^^ (RS aka "") Related: BLNKKEY etc... Thi i th attentio characte neede t us "functio key unde BYE Earlie version o BYŠ ha jus use contro character a functio keys Thi wa obnoxiou becaus ever tim yo type fo example ^N BY woul hangup Anyon eve us WordStar Now functio key ar don b typin th attentio characte followe b letter. BLNKKEY - blank out key Default: 'B' - B Related: ATTNCH I yo typ "B the al I/Ϡ t th mode wil b temporaril discarded Thi wa yo ca ente passwords o wor a 960 bau withou havin som gu o th othe en se wha you'r doing. SYSDKEY - system going down key Default: 'O' - O Related: ATTNCH, TIMEON, RTC, DOWNMIN I yo typ O th syste print "Syste goin dow i minutes... DOWNMI set th numbe o minutes I TIMEOΠ an RT ar als YES the th syste wil automagicall bum hi of i h stay o longe than DOWNMIN minutes. TWITKEY - twit-killer key Default: 'N' - N Related: ATTNCH I som boz i typin fou language o he' jus to stupi fo words o yo wan t pla Zor REALL bad.. the typ "N an th mode wil dro carrie o th guy. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 MSGKEY - message from Sysop key Default: 'Q' - Q Related: ATTNCH Thi equat wil print "Messag fro Sysop an pu yo int loca loo wher bot o yo ca se wha yo type bu h can' typ back Thi i usefu whe th gu i i th middl o somethin an yo wan t sa somethin lik "I' goin t b playin wit th powe cord here s don' b alarme i th syste hang up...jus cal back. BY wil remai i thi local-onl cha loo unti th Syso type ^C...s REMEMBEҠ t typ ^C! BELLKEY - toggle quiet mode key Default: 'G' - G Related: ATTNCH BYŠ ha ne featur whic allow yo t bloc ou th BEL characte fro bein sen t th loca terminal Thi wa yo don ge "beep..beep a AM CHAT4 an som BBS' cha program wil loo t se i th consol bel i disabled an i so jus sa "Hey...th Sysop' no arround." TIMEKEY - display time on system Default: 'T' - T Related: ATTNCH I th Syso want t kno ho lon som user' bee o th system al h ha t d i typ "T an BY wil tel him. WHOKEY - display who's on system Default: 'W' - W Related: ATTNCH, NO25TH I NO25TȠ i se t YES the thi wil displa who' o th syste i yo typ "W" I NO25T i no se t YES i wil d nothing. ULTIME - give user unlimited time on system Default: 'U' - U Related: ATTNCH, TIMEON, RTC I TIMEON an RT ar set user' ar normall allowe onl certai amoun o tim o th system I th Syso type o th loca console th use onlin wil b grante sta o execution. The user gets unlimited time on the system. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 ZSCREE - za scree key Default: 'Z' - Z Related: ATTNCH I yo wan t clea th loca CR whe waitin fo cal o whe someone' online jus typ "Z an th loca CR wil b cleared. ZCPR2 - using ZCPR2 or similar Default: NO - nope Related: USEZCPR, MAXDRIV, MAXUSER, WHEEL, MAXDRV, MAXUSR, SYSDRV, SYSUSR If you are running: ZCPR version 1.1 through 1.6 any of these CCP NZCPR version 1.0 through 2.01 replacements ZCMD only one version set ZCPR2 to YES. ZCMD2 only one version ZCPR2 only one version ZCPR3 - using ZCPR3 Default: NO - nope Related: USEZCPR, MAXDRIV, MAXUSER, WHEEL, MAXDRV, MAXUSR, SYSDRV, SYSUSR I yo ar runnin wit ZCPR o ZCMD3 the se thi equat t YES Thi wil clea th TCA are an initializ som specia ZCPR stuff Yo wil nee MA o M8 t assembl BY i thi equat i YES. USEZCPR - CCP controls maxdrive/user Default: NO - no, BYE does! Related: MAXDRIV, MAXUSER, ZCPR2 Normall yo wan BY t tel ZCP wha th maximu driv an use are are Mos BB program tal t BYE no ZCPR Som program ar backward though I you progra poke th lowmemor byte (use b ZCPR) instea o th byte i BYE the yo shoul se USEZCP t YES (Yo shoul probabl chang you BB t us BYERS calls whic woul b th bes solution). MAXDRIV/WHEEL/MAXUSER - location of bytes Default: 003DH 003EH 003FH Related: USEZCPR, MAXDRV, MAXUSR, SYSDRV, SYSUSR Thes byte ar th standar location use by ..all. o th ZCPR (excep fo ZCPR3 fo storin th superuse ("wheel" byte an th maximu drive/maximu use are bytes Don' chang thes unles yo kno wha you'r doing. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 MAXDRV/MAXUSR/SYSDRV/SYSUSR - initial values Default: D, 9, F, 15 Related: USEZCPR, ZCPR2 Whe BY answer th phone i set th maximu driv an maximu use area t MAXDR an MAXUSR Thi allow yo t restric caller t certai drive an use areas Whe BY abort (^ exi t CP/ b Sysop) i set th maximu driv an maximu use area t SYSDR an SYSUSR whic o cours shoul b se t giv th loca Syso ful access. CHGPATH - change command search path Default: NO - no Related: EXTPATH, ZCPR2, ZCPR3, REMPAT, SYSPAT I yo ar running ZCPR2 ZCMD2 ZCPR3 o ZCMD3 yo probabl wan thi equat se t YES Thi allow yo t restric th comman searc pat whe runnin remotely Upo ^ loca abort th pat get change bac t th ful acces path Fo example o m system wan loca user t b abl t ru .CO͠ file fro $$ an A0 only However hav m persona program (lik MAC DDT etc u i A15: s m comman path whe exi BY get se t $$ A0 A15: I yo don' understan wha just said, read the ZCPR2 or ZCPR3 manual(s). Th remot user' pat i locate a th en o BY a th labl "REMPATH. Th Sysop' pat i locate a th en o BY a th labl "SYSPATH." EXTPATH - location of path Default: 0040H - ZCPR2 default Related: CHGPATH Thi i wher ZCPR an ZCPR friend expec th comman searc pat t be Don' chang thi unles yo kno wha you'r doing. MSPEED - baud rate pointer Equate: MSPEED - baud rate pointer Default: 003CH - universal default location Related: BPxxxx BYŠ store th curren spee tha calle i runnin dow her a MSPEED Man program loo thi byt u t se ho fas th gu i running Normall yo d no wan t chang thi equate. The BPxxxx equates should NOT be changed. This manual Copyright (c) 1985 by Paul Traina Bye Documentation v3.38 WBCALL/WMSTRT - loser equates Default: 0E260H 0E566H - you'll have to change these Related: LOSER Thes equate onl wor i LOSE i se t YES I you compute i lose (se above) the yo mus fin warmboo cal t HIG i th BIOS thi cal i the patche b BYE Th for o th cal is: WBCALL CALL WMSTRT Thi i prett technical bu i yo hav loser yo ca wor wit it. This manual Copyright (c) 1985 by Paul Traina