Using BYE with NZCO� (c)
                                     or
                       The New Taming of an Old Shrew
                               by Lee McEwen
                            Socrates Z-Node #32
                       The Computer Journal, Issue 42
                         Reproduced with permission
                          of author and publisher

  Socrates� m� rcpm� wen� o� lin� las� December�  Evidently� thi� wa� mor� o� �
a� �even� tha� i� seeme� a� th� time�  Why�  � ha� jus� bough� NZCO� th� �wee� �
before� �withou� �an� �previou� �� �Syste� �experience� �an� �gettin� �BY� �t� �
peacefull� �coexis� �wit� �NZCO� wa� suppose� t� b� hard�  T� �b� �fair� �min� �
wasn'� �th� firs� rcp� t� ru� unde� NZCOM�  Bo� Dea� converte� Drexe� Hil� �t� �
NZCO� sometim� th� previou� summer� an� � a� sur� ther� wer� others�  Bu� �th� �
difference� �I'� �told� wa� tha� � tota� neophyt� manage� t� �stumbl� �i� �th� �
righ� combination� t� mak� thing� work�  Thi� seeme� t� interes� Ja� Sage� wh� �
surel� i� mor� accustome� t� dealin� wit� peopl� wh� ca� wal� an� che� gu� �a� �
th� sam� time�  H� aske� m� t� tel� yo� ho� � di� it.

  Befor� w� start� � shoul� mentio� on� thing�  I� i� tru� tha� yo� can'� ru� �
NZCO� �unde� BYE�  BY� i� a� RS� an� protect� itsel� fro� �bein� �overwritten�  �
NZCO� i� � ver� powerfu� loade� tha� ca� reconfigur� th� memor� map�  I� look� �
fo� �suc� �program� a� BY� an� refuse� t� ru� whe� the� exist�  Bu� �w� �don'� �
nee� �t� ru� NZCO� whil� BY� i� running�  W� ru� i� before� w� ru� BYE� an� �w� �
chang� �system� wit� EN� file� rathe� tha� ZCM� usin� JetLDR�  Ou� �onl� �rea� �
restrictio� i� tha� w� canno� chang� th� memor� ma� whil� BY� i� active.

  I� �thi� �article� w� wil� se� u� � Xero� 16/� DE�-I� wit� � �1� �me� �har� �
drive� whic� w� hav� configure� wit� thre� logica� drive� (A� throug� C:� �fo� �
th� �har� driv� an� on� flopp� a� driv� D:�  Her� i� � lis� o� step� �t� �tak� �
whic� w� wil� discus� i� turn:

           Get NZCOM running first.
             RCP vs. Transient commands.
             Become familiar with ZCM files and how to edit them.
             Make your named directory files.
           Patch WHL.COM and NZCOM.COM
           Get BYE running next.
             Watch out! There some traps here.
             Z3BASE.LIB
   +-+-+-> Tweak it.
   | | |     Use MKZCM, NZCOM.COM and JETLDR.
   | | |     Current public DU:'s will reflect in the new .ZCM files.
   | | +-< Check SHOW, PATH and PUBLIC, and the BYE.PRN file.
   | |     Get your BBS software up and running.
   | +---< Make your aliases.
   |         My usual ones.
   |       Choose your transient commands carefully
   |         What stays on A0:
   |         What must be moved to A15:
   +-----< Check the system on line. �              Watch for security.


GET NZCOM RUNNING FIRST.

  Wh� �NZCO� �first�  I� i� you� operatin� system�  Imagin� tryin� t� �ru� �� �
progra� �withou� �havin� �CP/� installe� o� you� computer� � BY� �i� �� �nast� �
progra� �i� �tha� �i� hook� itsel� ver� deepl� int� th� �system� � Gettin� �i� �
runnin� unde� th� wron� syste� i� � wast� o� time.

  W� wan� t� ge� th� memor� configuratio� o� NZCO� tha� yo� wil� us� wit� th� �
BB� �going� � I� yo� nee� � certai� size� TP� fo� you� BBS� yo� hav� �t� �mak� �
roo� �fo� �i� �her� sinc� w� can'� chang� th� memor� ma� late� �whil� �BY� �i�  �
running�  Plac� MKZCM� SHOW� PATH� an� PUBLI� an� you� favorit� edito� o� A0:�  �
Ru� MKZC� t� creat� you� 'o� lin� system'�  W� wil� b� makin� severa� version� �
o� th� system� bu� the� mus� al� hav� th� sam� memor� map.

  W� �wil� �b� �settin� u� thre� systems�  Th� firs� i� th� on� �w� �wil� �b� �
lettin� �th� �caller� use�  I� wil� hav� significan� restriction� se� �o� �it� �
The� w� wil� se� u� � syste� fo� th� syso� whic� wil� allo� yo� t� d� anythin� �
yo� �lik� �o� you� computer� bu� wil� loc� ou� th� flopp� dis� drive� �Wh� �d� �
that� � Wha� �i� yo� cal� i� remotel� an� ente� � comman� suc� �a� �'FF� �tha� �
accesse� �th� floppy� bu� yo� forgo� t� leav� � dis� i� th� drive� You'� �han� �
th� system�  Finally� we'l� mak� on� las� syste� th� sam� a� th� sysop's� �bu� �
i� �wil� �le� yo� a� th� floppy�  � foun� i� easie� t� se� u� �th� �restricte� �
syste� �firs� an� the� afte� tha� i� runnin� properly� g� bac� an� se� u� �th� �
syso� systems.

  � �installe� �a� NZCO� syste� withou� an� RCP�  A� � implie� �i� �th� �lea� �
paragraph� �m� �assembl� programmin� experienc� i� les� tha� �minimal� � A� �� �
result� �� trus� transien� command� muc� mor� tha� � d� anythin� permanen� �i� �
th� �operatin� �syste� itself�  I� � comman� doesn'� behav� a� � �expected� �� �
replac� it� o� ge� i� ou� o� harm'� way�  Th� boo� say� tha� IOP'� ar� � topi� �
fo� �advance� �users�  Well� tha� di� that�  � dumpe� the� a� �well� � � �the� �
increase� th� numbe� o� name� directorie� allowed�  An� wit� that� � save� �m� �
ne� system�  Us� th� nam� 'USER� t� sav� thi� configuration.

  MKZC� wil� sav� tw� files� eac� o� whic� describe� th� configuratio� you'v�  �
jus� �done� � USER.ZC� �i� o� particula� interes� t� u� a� �i� �describe� �th�  �
targe� �syste� i� � tex� fil� whic� yo� ca� easil� edit�  Let'� d� �tha� �now�   �
Pa� �particula� attentio� t� MAXDRV� MAXUSR� QUIET� Z3WHL� DRVEC� PUBDRV� �an�  �
PUBUSR�  Loa� u� you� edito� an� brin� u� USER.ZC� i� no�-
document mode:

 EA06 CBIOS    0080 ENVTYP    E8F4 EXPATH    0005 EXPATHS   0000 RCP
 0000 RCPS     0000 IOP       0000 IOPS      E200 FCP       0005 FCPS
 E480 Z3NDIR   0023 Z3NDIRS   E900 Z3CL      00CB Z3CLS     E780 Z3ENV
 0002 Z3ENVS   E700 SHSTK     0004 SHSTKS    0020 SHSIZE    E880 Z3MSG
 E8D0 EXTFCB   E9D0 EXTSTK  ->0000 QUIET   ->E8FF Z3WHL     0004 SPEED
->0010 MAXDRV ->001F MAXUSR    0001 DUOK      0000 CRT       0000 PRT
 0050 COLS     0018 ROWS      0016 LINS    ->FFFF DRVEC     0000 SPAR1
 0050 PCOL     0042 PROW      003A PLIN      0001 FORM      0000 SPAR2 �  0000 SPAR3    0000 SPAR4     0000 SPAR5     CB00 CCP       0010 CCPS
 D300 DOS      001C DOSS      E100 BIO     ->0001 PUBDRV  ->0080 PUBUSR

  Thi� �almos� describe� � Xero� 16/� DE�-I� computer� bu� i� i� wron� �abou� �
th� drive� w� have�  Notic� tha� MAXDR� i� 0010� an� DRVE� i� FFFF�  Thes� tw� �
value� sa� tha� w� hav� 1� contiguou� drive� o� th� computer�  Thi� i� no� th� �
case� � Thi� syste� ha� fou� drives� bu� w� ar� buildin� � syste� �fo� �publi� �
use� �an� �w� won'� b� lettin� th� caller� a� ou� flopp� drive� � W� �nee� �t� �
chang� MAXDR� t� 0003�

  That'� eas� enough�  Bu� wha� o� thi� DRVEC�  I� i� � bi� ma� o� th� �vali� �
drives� whic� let� NZCO� ski� ove� an� driv� tha� i� no� present�  Yo� ca� us� �
th� followin� char� t� determin� th� valu� t� giv� DRVEC�  Pu� � on� ove� �an� �
driv� tha� yo� hav� o� th� system�  Ad� u� th� value� fo� eac� line� an� writ� �
the� dow� i� hexadecima� t� th� right�

                Weight Factor:
              8    4    2    1

              0    0    0    0    =    0---
              P    O    N    M

              0    0    0    0    =    -0--
              L    K    J    I

              0    0    0    0    =    --0-
              H    G    F    E

              0    1    1    1    =    ---7
              D    C    B    A
                                       0007

Change DRVEC to 0007.

  W� �als� wan� t� limi� th� highes� use� are� w� wil� le� th� �caller� �hav� �
acces� �to�  Al� th� sensitiv� command� suc� a� ER� wil� b� u� high� � � �hav� �
min� se� a� 7�  Chang� MAXUS� t� 0007.

  Th� QUIE� fla� tell� th� syste� i� i� shoul� repor� wha� i� i� doin� t� th� �
user� � W� �wan� �thi� fo� ourselves� bu� no� fo� ou� callers� � Par� �o� �ou� �
securit� i� tha� w� wil� b� usin� aliase� t� loa� i� module� whic� w� wil� �b� �
givin� secre� names�  I� th� quie� fla� i� off� th� name� wil� b� reporte� �a� �
the� load�  S� se� QUIE� t� 0001.

  Tak� �not� �o� th� valu� yo� hav� fo� Z3WHL�  Yo� wil� wan� thi� �late� �o� �
whe�  w� ge� t� BY� an� sav� thi� file.

  Bu� �didn'� w� forge� PUBDR� an� PUBUSR�  Thes� refe� t� th� �publi� �driv� �
an� �use� �area� tha� ZRDO� wil� recognize� an� ar� � bi� o� � �bear� � O� �m� �
system� �� �hav� A8� se� a� � publi� DU� wher� � pu� WordStar� � Obviousl� �w� �
don'� �wan� caller� usin� that�  Bu� ever� tim� � edite� th� USER.ZC� fil� �t� �
sa� �ther� wer� n� publi� DU's� th� nex� tim� � loade� th� system� �they'� �b� ��back� � Th� tric� her� i� t� us� th� PUBLI� utilit� t� cance� an� publi� �DU'� �
befor� yo� loa� you� ne� system�  D� tha� now.

   No� �ente� 'NZCO� A0:USER.ZCM� t� loa� thi� system�  B� sur� �yo� �includ� �
th� prefi� A0:�   Ru� SHO� t� se� i� w� hav� th� value� w� wan� fo� th� drive� �
an� use� areas�  You'l� se� thi� o� scree� 3�  Everythin� OK�  I� not� the� g� �
bac� t� you� edito� an� chang� USER.ZC� a� needed.

  Ru� �PAT� t� se� i� th� QUIE� fla� i� correct�  I� won'� tel� yo� �anythin� �
i� �th� QUIE� fla� i� on�  I� i� tell� yo� wha� you� pat� is� the� �th� �QUIE� �
fla� i� off�  That'� no� good�  Again� loa� you� editor� an� fi� QUIET.

  I� �you'v� change� anything� reloa� wit� NZCO� an� chec� �everythin� �agai� �
wit� �SHO� an� PATH�  Kee� editing� reloading� an� checkin� unti� yo� hav� �i� �
th� wa� yo� wan� it.

  No� �chec� �fo� PUBLI� DU's�  Yo� shoul� hav� none�  I� yo� �d� �hav� �any� �
clea� the� now.

  Ru� �MKZC� �on� mor� time�  Don'� chang� anything� jus� sav� i� �unde� �th� �
sam� �name� � Wh� d� that�  Remembe� tha� MKZC� create� tw� �files� � Th� �on� �
we'v� bee� workin� wit� ha� th� extensio� o� 'ZCM'�  I� yo� noticed� th� othe� �
fil� �MKZC� save� ha� th� extensio� o� 'ENV'�  Thi� i� wha� we'v� �bee� �afte� �
al� thi� tim� becaus� JetLD� ca� handl� thi� fil� jus� fine.

  Chec� �an� rechec� tha� th� syste� i� se� a� you'� wan� fo� ope� use� �Whe� �
yo� ar� happ� wit� th� users� system� w� wil� g� o� t� mak� th� syso� �system�  �
Brin� u� MKZC� again� bu� thi� tim� sav� th� resul� unde� � nam� tha� onl� yo� �
wil� �know� � Fo� ou� discussion� w� wil� cal� i� SYSOP�  Let'� g� �bac� �wit� �
you� edito� an� giv� yo� som� acces� o� you� ow� computer!

  Chang� MAXUS� t� th� maximu� use� are� yo� have�  Thi� i� usuall� 15� �Pul� �
tha� �DRVE� �char� ou� again�  Chec� of� al� th� drive� yo� �nee� �acces� �to�  �
except� �fo� �flopp� disks�  The� se� QUIE� t� 0000�  Bu� watc� out� �Don'� �d� �
anythin� tha� change� th� siz� o� th� system�  Sav� th� results.

  Ente� 'NZCO� A0:SYSOP.ZCM� t� loa� thi� system�  Again� i� i� importan� �t� �
ente� th� A0:�  Ru� SHO� an� PATH�  I� i� se� a� yo� want�  I� not� edi� agai� �
an� reload.

  No� �se� �an� publi� DU'� yo� want�  Afte� you'v� thoroughl� �verifie� �th� �
settings� ru� MKZC� t� creat� a� EN� o� thi� system�  Finally� creat� on� mor� �
system� bu� thi� tim� includ� th� floppies�  Giv� thi� anothe� secre� name.

  Wha� �hav� w� done�  We'v� create� thre� environmen� file� tha� w� ca� �us� �
o�-lin� t� chang� � caller'� access�  W� don'� nee� th� ZC� file� an� �longer� �
s� �yo� ca� eras� them�  Us� STA� o� DF� t� se� al� th� EN� file� t� �$SY� �s� �
tha� user� wil� no� b� abl� t� se� the� wit� th� DI� command.

  Th� �las� �thin� t� d� befor� w� mov� o� i� t� creat� th� �name� �director� �
files�  � us� th� sam� name� a� th� environmen� files�  Th� bi� poin� her� �i� �
tha� eve� i� � DU� i� ou� o� rang� o� th� environment� i� i� ha� � nam� an� n� ��password� � calle� ca� mov� there�  Yo� ca� giv� password� t� directories� bu� �
i� �i� simple� jus� t� no� declar� the� i� th� firs� plac� i� yo� �don'� �wan� �
peopl� goin� there.

  [Not� �b� Ja� Sage� � tak� � differen� approac� an� mak� extensiv� �us� �o� �
name� directorie� wit� passwords�  I� fact� th� name� directorie� o� m� syste� �
ar� th� sam� fo� user� an� sysops�  Al� � d� t� mak� th� syso� system� i� tur� �
o� �th� whee� byte� sinc� whe� thi� i� on� password� ar� ignored� an� on� �ha� �
fre� acces� t� al� th� syso� directories.]


PATC� WHL.CO� AN� NZCOM.COM

  Befor� �w� g� to� muc� further� yo� nee� t� mak� tw� patches�  Mak� �backu� �
copie� �o� �NZCOM.COM�  I� yo� dumpe� th� RC� a� � did� yo� nee� �� �transien� �
calle� �WHL32.CO� �t� manipulat� you� whee� byte� an� w� wil� �patc� �thi� �a� �
well�  I� yo� ar� usin� th� RCP� you� syste� passwor� i� i� there�  Bi� �poin� �
her� i� t� d� thi� afte� you'v� mad� bac�-u� copie� o� whateve� yo� ar� �goin� �
t� patch�  Ca� yo� sa� 'oops'?

  Us� �D� �(dis� utility)� ZPATCH� o� whateve� yo� ar� comfortabl� �wit� �an� �
cal� i� NZCOM.COM�  Searc� fo� NZCPM�  Thi� wil� b� i� th� FC� sectio� o� �th� �
program� � Chang� i� t� somethin� else�  You� restriction� ar� tha� �yo� �mus� �
mak� thi� eigh� character� o� less� tha� yo� mus� pa� i� ou� t� exactl� �eigh� �
character� �wit� spaces� an� tha� yo� mus� us� capita� letters�  Wha� yo� �pu� �
her� mus� b� � secret.

  Now� �wh� di� w� d� this�  NZCO� wil� mak� � fil� calle� NZCPM.CO� �o� �th� �
dis� i� ther� isn'� alread� one�  Th� purpos� o� thi� fil� i� t� allo� yo� �t� �
dum� th� NZCO� syste� an� g� int� straigh� CP/M�  I� � use� doe� thi� o� line� �
h� �wil� effectivel� tur� you� BB� off�  H� can'� hur� anything� a� BY� �won'� �
b� �abl� t� tal� t� th� syste� an� longer� bu� i� won'� rese� whe� h� �finall� �
drop� carrier� either�  You'l� b� crashe� unti� yo� reboot.

  S� �w� �gav� NZCP� � secre� name�  Dro� ou� o� NZCO� an� �reloa� �it� � Th� �
syste� wil� writ� NZCPM.CO� unde� th� nam� yo� jus� gav� it�  Eras� NZCPM.COM� �
an� us� STA� t� mak� it� replacemen� � $SY� fil� s� tha� n� on� bu� yo� �know� �
it� name.

  [Not� �b� �Ja� �Sage� � Again� � ca� sugges� �a� �alternativ� �an� �simple� �
approach�  Leav� NZCOM.CO� a� i� is�  Ru� i� t� creat� th� fil� NZCPM.COM� an� �
the� �cop� �tha� fil� t� � secur� area�  The� us� SALIA� t� �creat� �a� �alia� �
calle� �NZCP� tha� ha� th� scrip� command� "I� WH;DIR:NZCPM;FI"� wher� DI� �i� �
th� �director� wher� yo� pu� th� rea� NZCPM.COM�  Th� presenc� o� �thi� �alia� �
wil� �inhibi� �NZCO� �fro� creatin� � ne� NZCP� file� an� th� �alia� �wil� �d� �
somethin� �onl� i� syso� mod� (whe� th� whee� byt� i� on)�  I� th� whee� �byt� �
i� off� th� comman� wil� d� nothing�  I� th� whee� i� on� the� th� rea� �NZCP� �
comman� wil� b� invoked.]

  Th� �othe� patc� w� hav� t� mak� i� th� whee� password�  I� yo� dumpe� �th� �
RC� �a� � suggested� the� yo� wil� b� usin� WHL32.COM�  Patc� that� �Otherwis� �
yo� �patc� �NZRCP.ZR� i� NZCOM.LBR�  Loo� fo� eithe� SYSTE� �o� �PASSWORD� � � ��forge� �wha� i� say� i� th� distributio� copy�  Chang� i� t� �somethin� �else�  �
Again� you� restriction� ar� eigh� characters� padde� wit� spaces� i� �capita� �
letters� � [Not� �adde� b� Ja� Sage�  Thi� patc� yo� absolutel� mus� �do� �yo� �
mus� �no� �leav� �� �whee�-settin� comman� o� �th� �syste� �wit� �a� �unsecur� �
password� � Th� whee� passwor� i� no� determine� b� th� syste� bu� i� se� �fo� �
eac� �WHEE� progra� (e.g.� WHL3� o� th� RC� WH� command)�  Yo� shoul� b� �abl� �
t� �fin� �th� �passwor� usin� � patchin� utilit� an� chang� �i� �t� �somethin� �
secret�  B� sur� t� tes� i� befor� puttin� you� syste� o� th� air.]


GE� BY� RUNNIN� NEXT

  No� come� som� rea� fun�  Gettin� BY� runnin� fo� th� firs� tim� i� �almos� �
guarantee� t� tak� fiv� year� of� you� lif� an� i� mor� tha� w� ca� tackl� �i� �
on� article�  � sugges� yo� wor� closel� wit� � �-Nod� syso� fo� assistanc� a� �
yo� �go�  Bu� her� i� th� plan� ge� BY� runnin� an� wa� yo� ca� a� first� �an� �
the� �g� bac� t� twea� it�  � woul� sugges� yo� renam� DI� t� th� nam� o� �th� �
BB� �yo� �pla� t� ru� s� tha� i� wil� b� th� progra� ru� whe� �yo� �tes� �BYE�  �
Thi� �eliminate� an� problem� yo� ma� hav� wit� you� BB� syste� a� �yo� �debu� �
BY� itself.

  BY� i� � necessar� evil�  I� hasn'� bee� give� � ful� rewrit� i� abou� fiv� �
years� an� it� ag� i� showing�  Th� bigges� proble� i� tha� i� trie� t� b� al� �
thing� fo� al� systems�  Al� � wan� fro� BY� i� mode� redirection� � fe� extr� �
BDO� �call� t� handl� situation� tha� woul� onl� happe� unde� � remot� �syste� �
(suc� �a� tim� o� lin� an� carrie� test)� an� mayb� � fe� nea� �functio� �key� �
lik� �"Who'� �o� �line?"� � Wha� � don'� w
an� i� doin� �i� �messin� �wit� �th� �
environment� � W� hav� a� operatin� syste� t� d� tha� fo� �us� �Unfortunately� �
BY� insists� an� i� usuall� messe� thing� up�  On� o� thes� day� w� wil� �hav� �
� �BY� �mad� �fo� �today'� systems�  Unti� then� w� hav� �t� �wor� �wit� �thi� �
monster�  [Not� adde� b� Ja� Sage�  Se� m� colum� i� TC� #4� fo� � �discussio� �
o� �wha� �BY� �does�  � secon� Lee'� comment� abou� BY� an� �th� �nee� �fo� �� �
replacemen� tha� i� appropriat� fo� �-Systems.]

  � �us� QBYE� a� i� i� th� simples� t� se� up�  QBY� i� base� o� NUBY� �1.0� �
b� �To� �Brady� � To� �an� �Ir� Hof� ha� �worke� �togethe� �fo� �mos� �o� �th� �
developmen� o� BY� bu� parte� compan� jus� a� th� las� generatio� cam� out� �� �
woul� expec� whateve� finding� � hav� wit� QBY� yo� wil� hav� wit� BY� 5.10.

  � notice� som� ver� od� happening� a� th� O� leve� an� suspecte� � conflic� �
betwee� BY� an� NZCOM�  Ther� wer� tw� symptoms� th� utilitie� tha� chec� �th� �
DRVE� �seeme� �t� b� prett� solid� bu� thos� tha� checke� MAXDR� �wer� �flaky�  �
Fo� �example� F� (Fin� File� woul� no� repor� an� file� foun� o� �th� �highes� �
drive�  I� � se� th� syste� t� syso� acces� whil� � use� wa� o� line� i� acte� �
strangel� onc� � woul� rese� bac� t� norma� access�  Th� onl� solutio� wa� �t� �
allo� th� calle� t� hav� whee� privilege� fo� th� duratio� o� th� call.

  Finally� �� �pulle� SHO� dow� whil� � calle� wa� o� lin� t� �se� �wha� �wa� �
goin� �on� � I� �seem� �tha� BY� wa� resettin� th� �MAXDR� �an� �MAXUS� �byte� �
erroneously�  O� col� boot� i� wa� givin� MAXDR� on� les� driv� tha� �allowed� �
an� MAXUS� on� more�  Mor� importantly� onc� an� ne� environment� wer� loaded� �
i� pu� invali� dat� int� thes� bytes. �
  Thoug� �� �ha� �tol� BY� no� t� monito� th� maximu� DU� �settings� �i� �wa� �
insistin� �o� doin� jus� that�  Worse� i� wasn'� doin� i� right�  Se� �Fig� �� �
fo� �th� CC� setting� i� th� BY� configuratio� fil� a� use� o� �Socrates� � B� �
awar� �tha� �AL� �syste� securit� wit� thes� setting� i� no� �th� �purvie� �o� �
NZCOM� � BY� wil� no� monito� anythin� fo� you�  Carefull� tes� �you� �variou� �
environmen� setting� remotel� befor� leavin� th� syste� fo� publi� calls� �Yo� �
shoul� �loo� throug� th� PR� fil� t� mak� sur� th� prope� addresse� ar� �bein� �
assigned� sinc� th� addresse� wil� diffe� fro� syste� t� system.

  Yo� �wil� notic� referenc� t� a� includ� fil� name� Z3BASE.LIB� � Yo� �wil� �
hav� �t� �generat� �suc� �� fil� wit� definition� �fo� �th� �modul� �addresse� �
reference� i� BYE�  Fig� � show� th� Z3BASE.LI� tha� � use�  Yo� hav� t� �edi� �
thi� �wit� �you� memor� configuratio� befor� yo� assembl� BYE�  Note� �i� �th� �
fil� wil� explain.

  S� �no� �yo� hav� BY� running�  G� o�-lin� an� us� SHO� t� �mak� �sur� �th� �
syste� �ha� �staye� th� wa� yo� wan� i� to�  Us� JetLD� t� �loa� �th� �variou� �
environment� w� mad� u� befor� an� us� SHO� t� verif� tha� MAXDRV� MAXUSR� an� �
DRVE� �hav� �staye� �correct�  Then� tur� you� WH� o� an� of� �whil� �yo� �tr� �
whee�-dependen� �command� suc� a� ERA�  Th� syste� shoul� �respon� �correctly�  �
I� �yo� �hav� problems� yo� nee� t� edi� eithe� you� Z3BAS� o� BY� �agai� �an� �
reassemble.

  Onc� yo� hav� gotte� thi� far� yo� ar� read� t� instal� you� BB� �software�  �
� �us� QBB� fo� � coupl� o� reasons�  I� hold� message� fro� �differen� �area� �
completel� �apart� �an� i� i� distribute� wit� ful� sourc� code� � I� �doesn'� �
hur� �tha� QBB� i� almos� � sna� t� install�  Wha� i� take� a� � �negativ� �b� �
many� tha� i� i� writte� i� compile� BASIC� i� � plu� i� m� mind�  Wha� doe� � �
BB� progra� do�  Basically� i� i� � tex� fil� reade� tha� ha� t� b� capabl� o� �
findin� �message� �quickly�  Othe� tha� that� an� th� messag� �editor� �� �BB� �
progra� reall� isn'� tha� involved�  � wil� pu� QBB� u� agains� PBB� an� HBBS� �
bot� writte� i� 100� machin� code� i� � spee� tes� an� da� o� th� week�  Also� �
modifyin� hig� leve� languag� program� i� usuall� easier�  Bu� wha� yo� �chos� �
i� u� t� you.


MAK� U� YOU� ALIASES

  A� � sai� earlier� par� o� you� syste� securit� i� tha� th� name� yo� �giv�  �
you� �environmen� file� mus� b� � secret�  Th� onl� wa� t� invok� the� wit� �� �
calle� �o� lin� i� t� blan� ou� th� mode� outpu� wit� BYE'� ES�-B� o� t� �loa� �
the� �throug� a� alias�  � us� th� alia� method�  I� yo� haven'� picke� u� �o� �
i� b� now� � don'� trus� BY� farthe� tha� � ca� thro� it....

  Her� �ar� � coupl� o� exampl� aliase� � have�  B� th� way� don'� pu� �thes� �
int� �you� ALIAS.CM� file�  I'v� see� variou� version� o� TYP� tha� le� �user� �
typ� ou� � $SY� file� an� tha� woul� blo� th� secret!

Thi� i� th� alia� t� loa� th� norma� (secure� system�  I� i� name� NZUSER:

       A0:NZUSER    --> ldr a0:user.env �                       ldr a0:user.ndr
                        whl <wheel password> /s
                        path a0 $$$$ a0
                        whl r
                        echo system load done

Now the alias to load the sysop system:

       A0:NZSYSOP   --> if ~wh
                          whl /s
                        fi
                        if wh
                          ldr a0:sysop.ndr
                          ldr a0:sysop.env
                          path a0 $$$$ a15 A0
                          echo sysop system loaded
                        else
                          echo access denied
                        fi

Thi� �alia� �give� th� use� � chanc� t� se� th� whee� i� cas� i� i� �off� �bu� �
wil� abor� i� h� can'� ge� i� set.

  Tw� �questions� � First� wh� d� w� loa� th� SYSOP.ND� befor� �w� �loa� �th� �
SYSOP.ENV� � Remembe� �th� QUIE� flag�  I� w� reverse� th� order� �th� �syste� �
woul� repor� th� nam� o� ou� ND� fil� t� th� user�  Second� wh� d� w� loa� th� �
extende� pat� afte� w� loa� th� environment�  Becaus� i� w� didn't� A15� woul� �
b� a� invali� DU:� an� th� syste� woul� refus� t� allo� � pat� t� it.

  Th� alia� t� loa� th� flopp� syste� i� th� sam� a� th� syso� alias� �excep� �
i� load� th� flopp� environment.

  Th� las� o� wha� � fee� ar� th� essentia� aliase� i� calle� BYE�  Wh� woul� �
� �d� �that� � Again� � don'� trus� th� rea� BY� �t� �handl� �syste� �securit� �
properly� s� � hav� thi� alia� rese� th� environmen� throug� th� NZUSE� befor� �
callin� th� rea� BYE�  O� course� renam� you� rea� BY� t� somethin� else� �an� �
mak� i� � $SY� file:

       A0:BYE       --> echo one moment please.
                        nzuser
                        echo thank you for calling.
                        echo please call again.
                        realbye $*


CHOOSE YOUR TRANSIENTS

  Yo� ar� ver� clos� t� goin� o� line�  Mov� MKZCM� SHOW� STAT� you� �editor� �
an� �anythin� els� tha� allow� someon� t� foo� wit� th� syste� u� t� �� �safe� �
hig� use� area�  Mos� o� u� us� A15� fo� this�  Se� al� th� EN� an� ND� �file� �
t� �$SY� status� a� wel� a� al� NZCO� file� an� librarie� an� th� �aliase� �w� �
mad� up�  No� onl� doe� thi� kee� peopl� fro� tryin� thing� the� shouldn't� i� ��als� keep� the� fro� downloadin� them�  Wha� goo� doe� i� d� t� g� throug� al� �
thi� t� hav� someon� downloa� you� NZCOM.LB� wit� it� patche� whee� password?

  Tim� �t� choos� you� transien� commands�  Yo� wil� nee� somethin� fo� �fil� �
transfers�  � us� ZMD15� an� RZMP16�  Somethin� t� typ� ou� tex� files�  � us� �
ZLT12� � Somethin� t� loc� int� LB� an� AR� files�  � hav� LUX77B� �LUSH� �an� �
ZLUX26� non� o� whic� � a� reall� happ� with�  Gott� wor� wit� AR� files� lik� �
i� o� not� s� tha� mean� yo� nee� UNARC16�  Don'� forge� LDIR� an� i� �today'� �
world� ZIPDIR�  Doe� tha� abou� d� it?


LET'S GO SEE THE WORLD

  I� �you'v� gotte� thi� far� you'r� read� t� star� takin� calls�  � �sugges� �
yo� �star� b� callin� i� yourself�  Thras� it� bas� it� tr� t� brea� �it� � I� �
yo� �can't� �the� �i� �i� tim� t� tel� � fe� �friends� � Giv� �the� �th� �sam� �
assignment� � Hav� the� d� anythin� the� ca� t� cras� th� system�  I� �someon� �
ca� d� it� eventuall� the� will� an� i� migh� a� wel� b� now� don� b� � frien� �
wh� �wil� �tel� �yo� �ho� �i� happened� � Leav� �th� �syste� �privat� �amongs� �
yourselve� �fo� � coupl� o� weeks�  I� i� stil� work� a� i� shoul� afte� �thi� �
time� g� public�  W� wil� al� welcom� � ne� RCP/M.

Welcom� t� th� club� sysop!


-----------------------------------------------------------------------------

; ++ CCP Options ++
;
ZCPR2   EQU     no              ; Yes, if running ZCPR/ZCMD/NZCPR (1 or 2)
;
; NOTE: Requires MAC.COM to assemble if ZCPR3 is set YES.
;
ZCPR3   EQU     yes             ; Yes, if running ZCPR3
;
        IF     ZCPR3
       MACLIB  Z3BASE          ; Requires MAC to assemble
        ENDIF
;
; NZCPR/ZCMD/ZCPR all use bytes (at 3DH/3EH/3FH) to store the maximum
; drive, wheel status, and maximum user area.  QBBS pokes these values
; in QBYE which in turn maintains them in low memory bytes.
;
USEZCPR EQU     yes             ; (QBBS = NO, except w/NZCOM. Then, YES)
;                               ;
CHEKDU  EQU     no              ; Yes, if QBYE will monitor MAXDRIV/USER.
                               ;   If using ZCPR/ZCMD/NZCPR, set this NO,
                               ;   since they already do it (saves a lot of
                               ;   code, too).  In either case, QBYE will
                               ;   have the correct values in MAXDRIV/USER.

;Set this equate to your system's ENV address: �NZENV   EQU     0E780h          ; Required for use with NZCOM
                               ; this value will vary on each computer.
                               ; use SHOW to see where your ENV is.
WHEEL   EQU     NZENV+17Fh      ; Location of ZCPR's wheel flag
MAXDRIV EQU     NZENV+02Ch      ; ZCPR location of MAXDRIV byte
MAXUSER EQU     NZENV+02Dh      ; ZCPR location of MAXUSR byte
;

MAXDRV  EQU     'J'             ; Highest drive supported
                               ; NZCOM:  Put this to highest + 1 on system
                               ; and let the OS control access.
MAXUSR  EQU     15              ; Highest user area
                               ; NZCOM:  Put this to highest on system and
                               ; let the OS control access.
;
; In all cases, set SYSDRV/USR, since the ^B function gives you these
; d/u areas when used to toggle off the user temporarily.
;
;NZCOM:  Set SYSDRV to one more than you really want.

SYSDRV  EQU     'J'             ;#Highest local drive supported
SYSUSR  EQU     15              ;#Highest local user area (0-15)
;
                        -------------------------

Figure 1.  This is a section of the BYE configuration file showing the�
proper settings to use on an NZCOM system.

-----------------------------------------------------------------------------

;Z3BASE.LIB
;
;Last edited: 10 July 89, Lee McEwen
;
;Currently configured for use with:
;  Ampro LB, 64 MB / NZCOM
;  Maximum memory size for use on bbs under bye
;
false   equ     0
true    equ     not false
off     equ     0
on      equ     not off

base    equ     0

;The following values are taken from screen 1 of SHOW:

z3cl    EQU     0DD00H                  ;mcl, multiple command line
z3cls   EQU     203                     ; length of mcl in bytes
expath  EQU     0DCF4H                  ;path
expaths EQU     5                       ; number of path elements
shstk   EQU     0DB00H                  ;shl, shell �shstks  EQU     4                       ; number of shell entries
shsize  EQU     32                      ; size of each shell entry
z3env   EQU     0DB80H                  ;env, z-system environment
z3envs  EQU     2                       ; size of env in records
z3msg   EQU     0DC80H                  ;msg, system message buffer
z3msgs  EQU     80                      ; size of msg in records
z3whl   EQU     0DCFFH                  ;whl, location of wheel byte
z3whls  EQU     1                       ; size of whl in bytes

                        -------------------------

Figure 2.  The part of the file Z3BASE.LIB needed for the assembly of BYE.

-----------------------------------------------------------------------------

About the author and his system:

  Le� �McEwe� i� � managemen� analys� livin� i� centra� Ne� Jersey� � H� �ha� �
bee� �runnin� publi� bulleti� board� sinc� 198� bu� onl� establishe� �� �CP/�-�
base� �syste� �a� th� beginnin� o� 1989�  Withi� thre� �months� �Socrate� �ha� �
gaine� ��-Nod� status�  Le� dedicate� Socrate� t� learning� whethe� i� b� �th� �
�-Syste� o� hig� leve� languages�  Ther� i� � messag� bas� devote� t� th� �ne� �
'C� �programmer� � I� �addition� �Socrate� �i� �th� �centra� �sit� �fo� ��QBB� �
development.

  Socrate� ca� b� calle� a� (201� 75�-9067� a� u� t� 240� bps�  I� run� o� a� �
Ampr� Littl� Boar� wit� � 6� me� drive�  Le� run� o� Cok� an� potat� chips.

=============================================================================

[This article was originally published in issue 42 of The Computer Journal,
P.O. Box 12, South Plainfield, NJ 07080-0012 and is reproduced with the
permission of the author and the publisher. Further reproduction for non-
commercial purposes is authorized. This copyright notice must be retained.
(c) Copyright 1990, 1991 Socrates Press and respective authors]