ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/CPM/BDOS/NOVADOSI.LBR/NOVADOS.WZ/NOVADOS.WS

Text File | 2000-06-30 | 48KB | 1,131 lines

.op
.po 8
.mb 8
.mt 3
.hm 2
.fm 2
.pl 66






             N O V A D O S ááD O C U M E N T A T I O N
             =========================================


                         R e l e a s e   H











NovaDO╙á  i≤á  aεá  enhanceΣ CP/═ compatiblσ Disδá Operatinτá Systeφ ì
whicΦ take≤ advantagσ oµ thσ feature≤ oµ thσ Z8░ microprocessor«  I⌠ ì
provide≤á ßá  numbe≥ oµ  feature≤  ove≥  anΣ abovσ thσá Digita∞á Reì
searcΦá BDOS¼á man∙ oµ whicΦ arσ user-selectablσ a⌠á assembl∙á time. ì
I⌠á  i≤  simila≥  iε  man∙  respect≤  t∩ ZRDOS¼á  ß widel∙ availablσ ì
commercia∞ CP/═ DOS¼ anΣ caε bσ madσ t∩ emulatσ ZRDO╙ quitσ closely« ì
Mos⌠ ┌ systeφ utilitie≤ whicΦ requirσ ZRDO╙ wil∞ als∩ operatσá unde≥ ì
NovaDOS«á  NovaDO╙á support≤ man∙ ZRDO╙ feature≤ includinτ thσ call≤ ì
t∩á Ge⌠ anΣ Se⌠ Warφ Boo⌠  Trap¼á  Returε  DM┴  Addres≤  anΣá returε ì
ZRDO╙á versioεá number«á  Additiona∞ feature≤ includσ ßá DO╙á searcΦ ì
path¼ ▓ kind≤ oµ publiπ files¼ archivσ bi⌠ support¼ improveΣ manageì
men⌠á oµ flopp∙ drive≤ anΣ mucΦ more«á  Thσ softwarσ interfacσá preì
serve≤á al∞ Z8░ register≤ no⌠ involveΣ iε returninτ datß t∩á callinτ ì
applications.









                          Lindsay Haisley
                     14206 Spreading Oaks Drive
                         Leander, TX  78641
                           [phone]
                     [phone] (Z-node 77)
.paè
NovaDOS - A replacement for CP/M 2.2 BDOSì
Release H. á03/14/89

NovaDO╙ i≤ aε updatσ oµ SUPRBDOS¼ formerl∙ P2DOS« Thσ presen⌠ incarì
natioε a≤ NovaDO╙ i≤ thσ responsibilit∙ of:

Lindsay Haisleyì
14206 Spreading Oaksì
Leander, TX á78641ì
[phone] (vox)ì
[phone] (Z-node 77)

Please notify Lindsay of any bugs or problems with NovaDOS.

SUPRBDOS was updated from P2DOS by

Benjamin Hoì
626 Emerson St.ì
Evanston, IL á60201


COPYRIGHT NOTICEì
----------------

Thσá sourcσá codσ fo≥ NovaDO╙ i≤ copyrigh⌠ (c⌐ 198╡á b∙á Hermaεá Teε ì
Bruggσá oµá Thσ Netherlands«á I⌠ ma∙ bσ freel∙ copieΣ anΣá useΣá fo≥ ì
noncommercia∞á purposes«á An∙á commercia∞ usσ i≤á prohibiteΣá unles≤ ì
approveΣ iε writinτ b∙ thσ origina∞ author¼ H.A.J« Teε Brugge.


ALL RIGHTS RESERVED ááááááááH.A.J. Ten Brugge
                            Molenstraat 33
                            NL-7491 BD Delden
                            The Netherlands
                            Tel:..[phone]ì


NZCO═ i≤ ß registereΣ trademarδ oµ Alphß System≤ Corp.¼ 71▒ Chatsì
wortΦ Place¼ Saε Jose¼ C┴ 95128.

JetLDR i≤ ß registereΣ trademarδ oµ Plu*Perfec⌠ Systems¼ 41░ 23rΣ ì
St., Santa Monica, CA  90402

ZRDO╙ mentioneΣ hereiε i≤ copyrigh⌠ (C⌐ 1985¼ 198╢ B∙ Denni≤ L« ì
Wright.

Thank≤á t∩á Ja∙ Sagσ fo≥ bit≤ anΣ byte≤ oµá highe≥á education¼á Phi∞ ì
Newmaε fo≥ betß testinτ previou≤ releases¼á Pa⌠ Pricσ fo≥ betß testì
inτ thi≤ release¼á Bridge≥ Mitchel∞ fo≥ hi≤ elegan⌠ codσá relocatioε ì
algorithφá anΣá Jiφ Lil∞ fo≥ hi≤ finσ routine≤ t∩á displa∙á assembl∙ ì
stats.

.paè                 T A B L E   O F   C O N T E N T S
                 ---------------------------------


OVERVIEW OF FEATURES   . . . . . . . . . . . . . . . . . .    1

DISCUSSION OF FEATURES   . . . . . . . . . . . . . . . . .    3
     Public Files    . . . . . . . . . . . . . . . . . . .    3
áááááSearch Path     . . . . . . . . . . . . . . . . . . .    3
áááááArchived Files    . . . . . . . . . . . . . . . . . .    4
áááááConsole Checking  . . . . . . . . . . . . . . . . . .    5
áááááTime and Date Stamping  . . . . . . . . . . . . . . .    5
áááááHigh Bit Characters   . . . . . . . . . . . . . . . .    7
áááááPermanent Media Relogging   . . . . . . . . . . . . .    7
áááááChanged Disks   . . . . . . . . . . . . . . . . . . .    8
áááááUse of Z80 Registers  . . . . . . . . . . . . . . . .    8
     Disk Initialization   . . . . . . . . . . . . . . . .    9
áááááNovaDOS Flags   . . . . . . . . . . . . . . . . . . .   10

NOVADOS ERROR HANDLING   . . . . . . . . . . . . . . . . .   11

CONFIGURATION AND INSTALLATION   . . . . . . . . . . . . .   12

NOVADOS FUNCTIONS  . . . . . . . . . . . . . . . . . . . .   13
     Function  1:  Read Console Byte   . . . . . . . . . .   13
áááááFunction  2:  Write Console Byte  . . . . . . . . . .   13
áááááFunction  6:  Direct Console I/O  . . . . . . . . . .   13
áááááFunction  9:  Display $-Terminated STring   . . . . .   13
áááááFunction 10:  Read Console String   . . . . . . . . .   14
áááááFunction 11:  Read Console Status   . . . . . . . . .   14
áááááFunction 13:  Reset Disk System   . . . . . . . . . .   14
áááááFunction 15:  Open File   . . . . . . . . . . . . . .   15
áááááFunction 19:  Erase (Delete) File   . . . . . . . . .   15
áááááFunction 21:  Write Sequential  . . . . . . . . . . .   15
áááááFunction 34:  Write Random  . . . . . . . . . . . . .   15
áááááFunction 37:  Reset Drive   . . . . . . . . . . . . .   16
ááá  Function 38:  Relocate Code . . . . . . . . . . . . .   16
áááááFunction 39:  Return Fixed Media Vector . . . . . . .   16
áááááFunction 41:  Get/Set NovaDOS Flags   . . . . . . . .   17
áááááFunction 42:  Set Path Address  . . . . . . . . . . .   17
áááááFunction 47:  Return Current DMA Address  . . . . . .   17
áááááFunction 48:  Return ZRDOS Version Number   . . . . .   17
áááááFunction 50:  Set Warm Boot Trap  . . . . . . . . . .   17
áááááFunction 52:  Reset Warm Boot Trap  . . . . . . . . .   18
áááááFunction 200: Get Time  . . . . . . . . . . . . . . .   18
áááááFunction 201: Set Time  . . . . . . . . . . . . . . .   18

ASSEMBLY . . . . . . . . . . . . . . . . . . . . . . . . .   19
     Loadable REL Files  . . . . . . . . . . . . . . . . .   19
áááááPatching PUTSYS with a HEX File   . . . . . . . . . .   19

ADDITIONAL ASSEMBLY OPTIONS  . . . . . . . . . . . . . . .   20
     Binary Image Files  . . . . . . . . . . . . . . . . .   20
áááááSPR/PRL Files   . . . . . . . . . . . . . . . . . . .   21
.heNovaDOS  Features Overview                                   page #
.paè.foNovaDOS  User's Manual                                     Release H
.pn 1
AN OVERVIEW OF NOVADOS FEATURES:
================================

NovaDO╙á i≤ ß 100Ñ CP/═ 2.▓ compatiblσ replacemen⌠ fo≥á Digita∞á Reì
searcΦá BDOS«á I⌠ i≤ no⌠ protecteΣ b∙ Digita∞ Research'≤á copyright¼ ì
anΣá i≤á limiteΣ onl∙ b∙ thσ rathe≥ generou≤ publiπ domaiεá restricì
tion≤ iε thσ origina∞ copyrigh⌠ noticσ reproduceΣ above«á I⌠ ma∙á bσ ì
useΣá witΦá thσá standarΣ Digita∞ ResearcΦ CC╨ o≥ witΦá an∙á oµá thσ ì
ZCPR's«á Thσá followinτá feature≤ arσ improvement≤ oεá thσá standarΣ ì
Digita∞á ResearcΦá BDO╙á anΣ arσ discusseΣ full∙á iεá thσá followinτ ì
sections.

** áTw∩á kind≤á oµ Publiπ file≤ arσ supported¼á a≤ explaineΣ iεá thσ ì
áááápubliπ file≤ sectioε below.

** á┴á searcΦ patΦ i≤ availablσ whicΦ wil∞ acces≤ systeφ anΣá publiπ ì
ááááfile≤ iε directorie≤ othe≥ thaε thσ default« Thσ dospatΦ addres≤ ì
ááááma∙ bσ modifieΣ througΦ aε optiona∞ DO╙ Functioε 4▓ call.

** áThσ archivσ filσ attributσ bi⌠ (higΦ bi⌠ oµ thσ seconΣá filenamσ ì
ááááletter⌐á i≤ supported«á An∙ filσ writσ operatioε wil∞ rese⌠ thi≤ ì
áááábi⌠ oε al∞ filσ extent≤ oµ thσ affecteΣ file.

** áConsolσá Statu≤á ma∙ bσ checkeΣ afte≥ ever∙á 25╢á character≤á oµ ì
ááááoutput«á Thi≤á make≤ i⌠ possiblσ t∩ exi⌠ ß prograφ doinτ continì
ááááuou≤ screeε outpu⌠ usinτ ^╙ ^├ eveε thougΦ othe≥ character≤á arσ ì
ááááwaitinτ t∩ bσ processed

** áTimσá anΣá datσá stampinτ oµ file≤ i≤á supported¼á assuminτá thσ ì
áááádirector∙á ha≤ previousl∙ beeε se⌠ u≡ t∩ contaiε thσ stamp≤á anΣ ì
ááááthσ BIO╙ support≤ ß calendar/clock.

**  Tw∩á differen⌠á method≤á arσ provideΣá fo≥á sensinτá thσá changσ ì
áááábetweeεá singlσ anΣ doublσ sideΣ flopp∙ disk≤ oε computers whicΦ ì
áááásuppor⌠ botΦ formats«á  BotΦ method≤ takσ advantagσ oµ thσ user-ì
ááááconfigurablσ naturσ oµ NovaDO╙ t∩ gaiε direc⌠ acces≤ t∩ powerfu∞ ì
ááááBIO╙ features not usually available to the DOS.

** áAutomatiπ logoε oµ changeΣ disk≤ i≤ supported« ┴ changeΣ disδ i≤ ì
ááááreloggeΣ int∩ thσ systeφ rathe≥ thaε declareΣ R/O¼ a≤ witΦ CP/M« ì
ááááN∩ warφ boo⌠ i≤ required.

** áPermanen⌠á mediß (harΣ anΣ RA═ disks⌐ arσ supporteΣ b∙ ßá permaì
áááánen⌠á medißá vecto≥á anΣá ß fas⌠ disδá rese⌠á optioε.

** áAεá interna∞ flag≤ bytσ i≤ availablσ througΦ ß cal∞á t∩á NovaDO╙ ì
ááááFunctioε 41« Thesσ flag≤ contro∞ thσ 25╢ characte≥ delay¼ acces≤ ì
áááát∩á publiπá files¼á higΦ bi⌠ characte≥ I/╧ anΣ thσ relogginτá oµ ì
áááápermanen⌠ media.

** áErro≥ message≤ havσ beeε greatl∙ improveΣ anΣ includσ thσá fileì
ááááname≤á oµ file≤ involveΣ erro≥ conditions«á Optiona∞ overridσ oµ ì
ááááfilσ R/╧ erro≥ provided.
.paè** áThσ deletσ ke∙ work≤ likσ ß backspacσ unde≥ functioε 10«á Thσ ^╥ ì
áááá(redra≈á buffe≥á line⌐á commanΣ ha≤ beeε eliminateΣá t∩á providσ ì
ááááspace.

** áFunction≤á ma∙á bσ assembleΣ int∩ NovaDO╙á t∩á suppor⌠á softwarσ ì
áááádesigneΣ t∩ ruε unde≥ ZRDOS.

** áSuppor⌠á fo≥á higΦ bi⌠ characte≥ I/╧ i≤ ma∙ bσá enableΣá iεá thσ ì
ááááassembly«á Iµ included¼ thi≤ featurσ i≤ unde≥ thσ contro∞ oµ thσ ì
ááááflag≤ byte.

** áDisδ sizσ caε bσ a≤ largσ a≤ 6553╢ ¬ 16╦ ╜ ▒ ╟ byte.

** áFile size can be as large as 32 * 64 * 16K = 32 M byte.

.heNovaDOS  Features                                            page #
.paèDISCUSSION OF FEATURES:ì
=======================

Public files:ì
-------------

Publiπá file≤ arσ file≤ whicΦ appea≥ t∩ bσ independen⌠ oµ use≥á areß ì
anΣá ma∙á bσ accesseΣ b∙ aε Opeε Filσ reques⌠ t∩ an∙ use≥ numbe≥á oε ì
thσ disδ oε whicΦ the∙ reside«á NovaDO╙ support≤ tw∩ kind≤ oµ publiπ ì
files.

Type 1: áFiles whose names begin with "$" ($-Pub)

Type 2: áFile≤á whosσá name≤ havσ thσ attributσ bi⌠á oµá thσá seconΣì
    áááááfilenamσ characte≥ set.

Typσá ▒á $-PuΓ file≤ includσ thσ submi⌠ commanΣ filσá $$$.SU┬á whicΦ ì
shoulΣá bσ publiπ unde≥ ZCPR3│ anΣ 34«á Thesσ ZCPR'≤ reaΣ thi≤á filσ ì
froφ director∙ a0║á whilσ olde≥ CPR'≤ anΣ man∙ utilitie≤ whicΦ read¼ ì
writσá o≥á erasσ thσ $$$.SU┬ filσ expec⌠ t∩ finΣ i⌠ iεá thσá curren⌠ ì
use≥ areß oε thσ ┴ drivσ (A$:)«á Thσ $-PuΓ facilit∙ solve≤ thσ probì
leφá createΣá b∙ thi≤ difference«á $-PuΓ file≤ arσ R/╫á anΣá caεá bσ ì
eraseΣ froφ an∙ director∙ b∙ naminτ theφ unambiguousl∙ iε ß Functioε ì
1╣ call.

Typσá ▓á publiπ file≤ arσ defineΣ fo≥ NovaDO╙ b∙ settinτ thσá seconΣ ì
filenamσá attributσá bit«á Publiπ file≤ wil∞ bσ openeΣ anΣá reaΣá b∙ ì
NovaDO╙ jus⌠ a≤ iµ the∙ werσ iε thσ curren⌠ use≥ areß oε thσ defaul⌠ ì
disδá o≥ oε an∙ disδ iε thσ NovaDO╙ searcΦ path«á Publiπá file≤á arσ ì
normall∙á defineΣ a≤ reaΣ only¼á anΣ aε attemp⌠ t∩ writσ t∩ ß publiπ ì
filσ wil∞ producσ ß standarΣ NovaDO╙ erro≥ message.

Resettinτ bi⌠ ▓ oµ thσ interna∞ flag≤ (seσ thσ discussioε oµ NovaDO╙ ì
functioεá 38⌐á wil∞ turε ofµ thσ publiπ file≤á facility«á Thσá writσ ì
protec⌠á statu≤ oµ publiπ file≤ i≤ determineΣ b∙ bi⌠ ┤ oµ thσá flag≤ ì
bytes«á Settinτ thi≤ bi⌠ set≤ al∞ publiπ file≤ t∩ R/╧ anΣá resettinτ ì
i⌠á declare≤á theφ R/╫ unles≤ the∙ arσ additionall∙ taggeΣ witΦá thσ ì
ReaΣ Onl∙ attribute.

Thσá utilit∙ PUBLIC.CO═ i≤ provideΣ t∩ managσ thi≤ bi⌠á oεá selecteΣ ì
file≤á whilσ PFILE.CO═ i≤ provideΣ t∩ set/rese⌠ bit≤ ▓ anΣ ┤ oµá thσ ì
flag≤ bytσ withiε NovaDOS.


Search path:ì
------------

NovaDO╙ provide≤ aε optiona∞ searcΦ patΦ t∩ acces≤ file≤ no⌠ locateΣ ì
iεá thσ defaul⌠ directory«á Thσ searcΦ patΦ informatioε consist≤á oµ ì
bytσ pair≤ specifyinτ disδ anΣ use≥ areß fo≥ eacΦ dospatΦ element« ┴ ì
pointe≥á t∩ thσ searcΦ patΦ i≤ containeΣ a⌠ do≤ ½ 15h«á Settinτ thi≤ ì
pointe≥á t∩ ░ wil∞ disablσ thσ searcΦ patΦ altogether«á Thσá curren⌠ ì
director∙ i≤ no⌠ includeΣ iε thσ searcΦ patΦ unles≤ specifieΣ iε thσ ì
patΦ definition.
.paèNovaDO╙ wil∞ searcΦ fo≥ botΦ systeφ anΣ publiπ file≤ iε thσá curren⌠ ì
searcΦá path«áá Al∞á othe≥á file≤á wil∞á bσá ignored«áá Thσá utilit∙ ì
DOSPATH.CO═ i≤ provideΣ t∩ definσ anΣ quer∙ thσ NovaDO╙ searcΦ path« ì
I⌠ i≤ selµ documentinτ anΣ work≤ iε ß manne≥ quitσ simila≥ t∩ thσ Z│ ì
utilit∙á dospath.COM«á Notσ tha⌠ invokinτ DOSPAT╚ witΦ n∩á argument≤ ì
wil∞á cance∞ thσ NovaDO╙ searcΦ path¼á whilσ n∩ simila≥ functioεá i≤ ì
availablσ fo≥ thσ Z│ dospatΦ utility.

Thσá searcΦ patΦ consist≤ oµ ß serie≤ oµ bytσ pairs«á Thσ firs⌠ bytσ ì
oµá eacΦ patΦ elemen⌠ pai≥ i≤ aε ASCI╔ disδ lette≥ whilσ thσá seconΣ ì
bytσ oµ eacΦ dospatΦ elemen⌠ i≤ thσ use≥ areß iε binar∙ form« Use≥ ▒ ì
i≤ storeΣ a≤ 01h¼á use≥ ▓ a≤ 02Φ anΣ etc«á Thσ dospatΦ i≤ terminateΣ ì
b∙ ß binar∙ 0« I⌠ i≤ thσ responsibilit∙ oµ thσ colΣ boo⌠ t∩ initialì
izσá thσá DO╙ dospatΦ areß eithe≥ witΦ ß valiΣ DO╙ dospatΦá o≥á witΦ ì
zeros.

Thσá dospatΦá addres≤ i≤ harΣ codeΣ int∩ NovaDO╙ a⌠á assembl∙á time« ì
Functioε 42¼á iµ enableΣ iε assembly¼ ma∙ bσ useΣ t∩ quer∙ anΣ rese⌠ ì
thσá dospatΦ addres≤ a⌠ ruε time«á Seσ thσ discussioεá oµá function≤ ì
below.

Thσá NovaDO╙ searcΦ patΦ i≤ iε n∩ wa∙ exclusivσ of¼á o≥ iεá conflic⌠ ì
witΦá thσ ZCPR│ path«á I⌠ i≤ especiall∙ usefu∞ fo≥ non-ZCP╥ program≤ ì
sucΦá a≤ dBasσ anΣ WordSta≥ whicΦ requirσ acces≤ t∩á overla∙á files« ì
SucΦá overlay≤ ma∙ bσ kep⌠ a≤ systeφ file≤ iε ß director∙á specifieΣ ì
iεá thσá NovaDO╙ patΦ anΣ accesseΣ b∙ sucΦ program≤ froφ an∙á direcì
tory.

Thσá NovaDO╙ patΦ wil∞ takσ precedencσ ove≥ thσ ZCPR│ path¼á anΣá i⌠ ì
mus⌠á bσá remembereΣá tha⌠ EAC╚ elemen⌠ oµ thσ Z│á patΦá wil∞á causσ ì
NovaDO╙ t∩ d∩ ß dospatΦ search«á Thi≤ caε increasσ filσ acces≤á timσ ì
considerably« Iµ yo⌡ havσ thσ Z│ dospatΦ enabled¼ yo⌡ shoulΣ usσ thσ ì
NovaDO╙ patΦ sparingly.


Archived Files:ì
---------------

┴á filσá i≤á defineΣ a≤ archiveΣ iµ thσ attributσ bi⌠á oµá thσá las⌠ ì
characte≥á iε thσ filenamσ extensioε i≤ se⌠ iε it≤ director∙á entry« ì
Thi≤ bi⌠ i≤ customaril∙ se⌠ b∙ utilitie≤ whicΦ cop∙ file≤ fo≥ backu≡ ì
purpose≤ o≥ b∙ othe≥ program≤ capablσ oµ settinτ attribute≤ directl∙ ì
sucΦ a≤ thσ Z│ utilit∙ PROT.COM«á I⌠ i≤ useΣ t∩ indicatσ tha⌠ ß cop∙ ì
oµ thσ filσ iε it≤ presen⌠ forφ exist≤ somewherσ else¼á usuall∙ oε ß ì
backu≡á disk«á NovaDO╙ wil∞ rese⌠ thi≤ bi⌠ iε thσ director∙á entrie≤ ì
fo≥á al∞ extent≤ oµ ß filσ anytimσ thσ filσ i≤á copied¼á renameΣá o≥ ì
otherwisσá changeΣ iε ß manne≥ whicΦ woulΣ affec⌠ thσ accurac∙ oµá ß ì
backu≡ copy« Thi≤ applie≤ als∩ t∩ copie≤ madσ b∙ program≤ whicΦ cop∙ ì
filename≤á directl∙ froφ onσ FC┬ t∩ anothe≥ (sucΦ a≤ WordSta≥ o≥ an∙ ì
othe≥á prograφ whicΦ create≤ ß *.BA╦ file⌐ sincσ thσ archivσ bi⌠á i≤ ì
rese⌠ iε thσ origina∞ FC┬ a≤ sooε a≤ an∙ changσ t∩ thσ filσ i≤ made.

.paèConsole Checking:ì
-----------------

Iµá bi⌠ ▒ oµ thσ flag≤ bytσ i≤ set¼á theε thσ consolσ statu≤ wil∞ bσ ì
periodicall∙ checkeΣ durinτ Functioε ▓ o≥ Functioε ╣ consolσá outpu⌠ ì
anΣ an∙ pendinτ ^╙ wil∞ bσ identifieΣ fo≥ thσ purposσ oµ pausinτ thσ ì
output«á Seσá thσ discussioε unde≥ Functioε 4▒ oε settinτ anΣ resetì
tinτ thσ flag≤ byte.

Unde≥ Digita∞ ResearcΦ BDOS¼á thσ keyboarΣ wil∞ locδ u≡ iµ ß characì
te≥ othe≥ thaε ß ^╙ o≥ ^├ i≤ typeΣ durinτ continuou≤ screeεá output« ì
Oε occasion≤ wheε i⌠ i≤ necessar∙ t∩ exi⌠ ß prograφ witΦ ^╙ ^C¼ sucΦ ì
a≤á wheεá aε infinitσ loo≡ conditioε exists¼á aεá imprope≥á keyboarΣ ì
entr∙ wil∞ preven⌠ ß ^╙ froφ eve≥ beinτ recognized.

Iµá thσá Consolσ Clearinτ featurσ oµ NovaDO╙ i≤á enabled¼á theεá thσ ì
consolσ inpu⌠ devicσ i≤ automaticall∙ checkeΣ fo≥ ^╙ afte≥ ever∙ 25╢ ì
character≤á oµ consolσ output«á Durinτ intensivσ consolσá I/O¼á thi≤ ì
wil∞á resul⌠ iε ß somewha⌠ morσ erratiπ keyboarΣ operatioε thaεá onσ ì
woulΣá expec⌠á froφ standarΣ BDOS¼á howeve≥ thσ differencσá i≤á onl∙ ì
noticeablσ iε games¼á fligh⌠ simulators¼ animateΣ debugger≤ o≥ othe≥ ì
program≤á requirinτá precisσá timinτ oµ keyboarΣ input«á ┴á cal∞á t∩ ì
Functioε 4▒ caε bσ madσ t∩ disablσ thi≤ feature.

Sincσ thi≤ somewha⌠ comple° featurσ i≤ implementeΣ internall∙ withiε ì
thσá DO╙ consolσ statu≤ check¼á i⌠ ma∙ oε occasioε bσá desirablσá t∩ ì
bypas≤á thi≤ routinσ anΣ obtaiε thσ consolσ statu≤ directl∙ froφ thσ ì
BIOS«á NovaDO╙ provide≤ thσ abilit∙ t∩ d∩ thi≤ usinτ DO╙ functioε 6¼ ì
Direc⌠ consolσ i/o« Settinτ registe≥ σ t∩ 0feΦ wheε callinτ functioε ì
╢ wil∞ returε thσ consolσ statu≤ directl∙ froφ thσ BIOS.


Time and Date Stamping:ì
-----------------------

Timσ anΣ Datσ stampinτ arσ supported¼ assuminτ tha⌠ ß calendar/clocδ ì
devicσ i≤ availablσ viß BIO╙ call«á Thσ addres≤ oµ thi≤ routinσ mus⌠ ì
bσ specifieΣ a≤ aε offse⌠ int∩ thσ BIO╙ b∙ thσ TIMEOF╞ equatσ iε thσ ì
heade≥ librar∙ Ndoshdr.LIB«á Thσ director∙ mus⌠ havσ beeε previousl∙ ì
initializeΣá fo≥ standarΣ date/timσ stampinτ oµ file≤ iε whicΦá casσ ì
thσá timσá anΣá datσ arσ initializeΣ wheε ß filσá i≤á createΣá unde≥ ì
NovaDO╙á anΣ updateΣ eacΦ timσ ß filσ i≤ closed«á Thσ addres≤ oµ thσ ì
BIO╙ date/timσ routinσ i≤ storeΣ a⌠ NovaDO╙ ½ 17h.
.paèTw∩ functioε call≤ arσ provideΣ t∩ acces≤ thσ date/timσ information¼ ì
assuminτá date/timσ stampinτ oµ file≤ i≤ enableΣ a⌠á assembl∙á time« ì
Functioεá 20░á accept≤ aε addres≤ iε D┼ a⌠ whicΦ t∩ writσá date/timσ ì
informatioε iε thσ followinτ format:

 Date: ááádefs ááá2áááDate = 1 áááá(Sunday, 01 Jan 1978)
                      to
                      Date = 65535 (Sunday, 05 Jun 2157)

 Hour: ááádefs ááá1 ááHour in BCD
 Minute: ádefs ááá1 ááMinute in BCD
 Second: ádefs ááá1 ááSecond in BCD

Afte≥á returninτ t∩ thσ caller¼á thσ curren⌠ datσ anΣ timσá wil∞á bσ ì
storeΣ a⌠ thσ requesteΣ address.

Functioεá 20▒ wil∞ se⌠ thσ calendar/clocδ froφ ß simila≥ datß strucì
turσ addresseΣ oε entr∙ b∙ registe≥ pai≥ DE.

Thσ BIO╙ routinσ accesseΣ fo≥ date/timσ informatioε mus⌠ observσ thσ ì
followinτ protocol:

Entry parameters:

if getting time
 áááC á= 000h To get timeì
if setting time
 áááC á= 0ffh To set time
 áááHL = pointer to time table in above format

Exit parameters:

if getting time
 áááHL = pointer to time table in above formatì
if setting time
 ááánoneì

.paèHigh Bit Characters:ì
--------------------

HigΦ bi⌠ character≤ arσ standarΣ ASCI╔ character≤ witΦ thσ higΦá bi⌠ ì
(7⌐á set«á The∙á arσ ofteε referreΣ t∩ a≤ graphic≤ character≤á sincσ ì
the∙á arσ sometime≤ useΣ t∩ producσ graphic≤ oε printer≤á anΣá CRT'≤ ì
whicΦá otherwisσ displa∙ thσ standarΣ ASCI╔ characte≥ set«á StandarΣ ì
BDO╙á allow≤á higΦ bi⌠ character≤ t∩ bσ reaΣ froφ thσá inpu⌠á devicσ ì
witΦ thσ function≤ Consolσ Inpu⌠ anΣ Direc⌠ Consolσ I/╧ (#≤ ▒ anΣ 6⌐ ì
bu⌠ no⌠ witΦ Functioε 10¼á ReaΣ Consolσ Buffer«á Oε output¼ higΦ bi⌠ ì
character≤á iεá thσ datß streaφ arσ normall∙ sen⌠ b∙á al∞á function≤ ì
whicΦ senΣ character≤ t∩ thσ outpu⌠ device.

Iµ higΦ bi⌠ characte≥ contro∞ i≤ programmeΣ int∩ NovaDOS¼á theεá thσ ì
strippinτá oµ higΦ bit≤ froφ thσ datß streaφ i≤ altereΣ a≤ showεá iε ì
thσ followinτ tables.


yes = High bit strippedì
no á= High bit not stripped

                     Input ááá(Bit 2) áááááááOutput or echo (Bit 3)ì
Function áá     áááááNorm áááSet áááReset áááNorm áááSet áááResetì
-------- áááááá     á---------------------------------------------

Read Console Byte áááyes áá  yes áááyes ááá  yes ááá yes ááánoì
Write Console Byte áá--- ááá --- ááá--- ááá  yes ááá yes ááánoì
Direct Console I/O ááyes ááá yes áááyes ááá  yes ááá yes áááyesì
Display "$" String áá--- ááá --- ááá--- ááá  yes ááá yes ááánoì
Read Console String áno ááá  yes áááno á áá  yes ááá yes áááno

Man∙á computer≤ canno⌠ ente≥ higΦ bi⌠ character≤ froφ thσá keyboard« ì
Oεá sucΦá machines¼á thσ higΦ bi⌠ facilit∙ i≤ no⌠ needeΣ anΣ caεá bσ ì
eliminateΣ froφ thσ assembly.



Permanent Media Reloggingì
-------------------------

Unde≥ CP/M¼ ß functioε 1│ disδ rese⌠ wil∞ trea⌠ thσ entirσ systeφ a≤ ì
"newó anΣ loτ iε thσ ┴ drive¼á readinτ thσ disk'≤ director∙ t∩ builΣ ì
aεá allocatioεá vector«á Thi≤ take≤ time¼á anΣ iµ thσ ┴ drivσá i≤á ß ì
permanentl∙á installeΣ disδ sucΦ a≤ ß harΣ disδ o≥ ß raφ disδá therσ ì
i≤ n∩ neeΣ t∩ rebuilΣ thσ allocatioε vecto≥ eacΦ timσ ß functioεá 1│ ì
i≤á called«á Flag≤ bi⌠ ╡ control≤ thσ re-initializinτ oµ thσá systeφ ì
(A⌐ drive«á Iµ thσ flaτ bi⌠ i≤ reset¼ n∩ initializatioε wil∞ bσ perì
formed¼á whicΦá caεá dramaticall∙ reducσ thσ timσ requireΣ fo≥á warφ ì
boots.

Therσ i≤ ß tradeofµ fo≥ thi≤ feature« Iε thσ proces≤ oµ buildinτ thσ ì
allocatioε vecto≥ thσ DO╙ normall∙ check≤ fo≥ thσ presencσ oµá file≤ ì
whosσá name≤ begiε witΦ "$ó ("$$ó fo≥ NovaDOS⌐ anΣ return≤ A=0ffΦ iµ ì
sucΦá ß filσ i≤ found«á Thσ CC╨ ma∙ usσ thi≤ flaτ t∩á determinσá thσ ì
presencσá oµá ß $$$.SU┬ filσ fo≥ processinτ b∙ thσ submi⌠á facility¼ ìèanΣá neeΣ no⌠ perforφ anothe≥ searcΦ oµ thσ disδ director∙á t∩á disì
closσá thσá presencσá o≥ absencσ oµ thi≤ file«á Iµ flag≤ bytσá ╡á i≤ ì
reset¼á Functioε 1│ wil∞ alway≤ returε A=░ anΣ iµ thσ CC╨ i≤á expecì
tinτ thi≤ "submi⌠ clueó i⌠ wil∞ no⌠ engagσ thσ submi⌠ process« Sincσ ì
thσá submi⌠á proces≤ ha≤ largel∙ beeε replaceΣ b∙ ZE╪ oε ZCPR│á sysì
tems¼ thi≤ i≤ almos⌠ ß non-problem¼ howeve≥ dBasσ I╔ stil∞ relie≤ oε ì
thσá submi⌠ featurσ iε chaininτ t∩ othe≥ programs«á Iµ yo⌡á usσá thσ ì
"qui⌠ toó featurσ oµ dBase¼ yo⌡ wil∞ wan⌠ t∩ se⌠ flag≤ bi⌠ ╡ fo≥ thσ ì
duratioεá oµ thσ process«á Functioε 4▒ make≤ i⌠ eas∙ t∩ changσá thi≤ ì
featurσá "oε thσ fly"«á Thσ utilit∙ FBOO╘ i≤ provideΣ t∩á manipulatσ ì
thi≤ bit.


Changed Disks:
--------------

NovaDO╙á i≤á quitσ intelligen⌠ regardinτ changeΣá flopp∙á disks«á  ┴ ì
checksuφ tablσ i≤ maintaineΣ fo≥ eacΦ disδ director∙ anΣ i≤á checkeΣ ì
frequentl∙á witΦá variou≤á disδ operations«á  Iµ ß changeΣá disδá i≤ ì
sensed¼á NovaDO╙ wil∞ attemp⌠ t∩ recove≥ b∙ relogginτ thσ drivσá anΣ ì
attemptinτ t∩ proceeΣ witΦ whateve≥ operatioε i≤ iε progress«  CP/M¼ ì
b∙ contrast¼á simpl∙ declare≤ thσ offendeΣ drivσ t∩ bσ reaΣ onl∙ anΣ ì
wil∞ no⌠ writσ t∩ i⌠ unti∞ ß Functioε ░ o≥ Functioε 1│ disδ rese⌠ i≤ ì
performed«á  NovaDOS¼á a≤ wel∞ a≤ applications¼ CA╬ bσ confused¼ fo≥ ì
instance¼ b∙ swappinτ disk≤ whilσ file≤ arσ open¼ s∩ reasonablσ carσ ì
shoulΣ bσ exerciseΣ iε thi≤ regard«

A≤á ß companioε feature¼á NovaDOS¼á unlikσ CP/M¼á doesn'⌠ rese⌠á thσ ì
drivσ read/onl∙ bitma≡ witΦ ß Functioε 1│ call«  Oε system≤ whicΦ d∩ ì
no⌠ reloaΣ thσ DO╙ witΦ eacΦ warφ boot¼á thσ onl∙ wa∙ t∩ rese⌠ ß R/╧ ì
drivσ t∩ read/writσ i≤ viß ß Functioε 3╖ call«


Use of Z80 Registers:
---------------------

Unlikσ somσ othe≥ CP/═ DOS's¼á NovaDO╙ i≤ fairl∙ conscientiou≤ abou⌠ ì
preservinτ thσ Z8░ Registers«á Oε returε froφ al∞ call≤ thσ C¼ D┼ I╪ ì
anΣá I┘ register≤ arσ preserved«á Register≤ ┴ anΣ H╠ wil∞ bσ se⌠á t∩ ì
zer∩á iµ thσ calleΣ functioε doe≤ no⌠ returε value≤ iε thesσá regisì
ters« I⌠ shoulΣ bσ noted¼ however¼ tha⌠ softwarσ whicΦ i≤ writteε t∩ ì
takσá advantagσá oµ thi≤ featurσ ma∙ no⌠ ruεá properl∙á unde≥á othe≥ ì
DOS's.

I⌠ wa≤ anΣ i≤ generall∙ accepteΣ practicσ amonτ Z8░ compute≥ system≤ ì
designer≤ t∩ makσ operatinτ systeφ softwarσ preservσ thσ specia∞ Z8░ ì
register≤ IX¼ I┘ anΣ thσ alternatσ registe≥ se⌠ acros≤ systeφ calls« ì
Unfortunately¼á thi≤ ha≤ no⌠ alway≤ beeε donσ anΣ somσ BIOS'≤á alte≥ ì
thσ content≤ oµ onσ o≥ morσ oµ thesσ registers«   Knowε offender≤ iε ì
thi≤ areß arσ somσ Osbornes¼ Zorba¼ Epsoε QX10¼ Televide∩ TS803/T-1¼ ì
anΣá probabl∙ others«á  NovaDO╙ use≤ thσ I╪ registe≥ anΣ expect≤ thσ ì
content≤á thereoµ t∩ bσ retaineΣ acros≤ BIO╙á calls«á  BIOS'≤á whicΦ ì
alte≥ thi≤ registe≥ wil∞ causσ NovaDO╙ t∩ crash.

.paèDisk Initializationì
-------------------

Somσ systems¼á likσ thσ Kaypr∩ ┤ anΣ 10¼á arσ capablσ oµ readinτ anΣ ì
writinτ botΦ singlσ anΣ doublσ sideΣ flopp∙ disks«  Oε sucΦ systems¼ ì
thσá flopp∙á i≤ usuall∙ un-initializeΣ onl∙ oε ßá warφá boot¼á whicΦ ì
mean≤á tha⌠á application≤ sucΦ a≤ cataloginτ program≤á whicΦá handlσ ì
man∙á flopp∙á disk≤ iε thσ coursσ oµ ß ruε arσ unablσ t∩á reaΣá botΦ ì
format≤á iεá thσá samσ run«á  Furthe≥ problem≤ arσá introduceΣá witΦ ì
system≤á sucΦ a≤ NZ-CO═ whicΦ d∩ no⌠ allo≈ thσ generatioε oµ ßá truσ ì
warφá boot«á  Oεá sucΦ system≤ iε i≤ ofteε quitσá difficul⌠á t∩á un-ì
initializσ ß flopp∙ drivσ eveε witΦ ß Functioε ░ call«  Thi≤ i≤ truσ ì
eveεá fo≥ sucΦ advanceΣ DOS'≤ a≤ ZRDOS¼á al∞ oµ whicΦ arσ limiteΣ t∩ ì
makinτ standarΣ BIO╙ call≤ viß thσ BIO╙ jum≡ table«  Becausσ NovaDO╙ ì
i≤á use≥ configurable¼á i⌠ caε acces≤ thσ BIO╙ iε non-standarΣá way≤ ì
whicΦá allo≈ i⌠ t∩ turε ofµ thσ curren⌠ flopp∙ forma⌠ selectioεá anΣ ì
forcσá thσ redeterminatioε oµ thσ forma⌠ witΦ thσ nex⌠á disδá login« ì

Therσá arσá tw∩ way≤ oµ achievinτ this¼á botΦ oµ whicΦ involvσá somσ ì
knowledgσá oµá thσá working≤á oµ thσá systeφá BIOS«á  EacΦá ha≤á it≤ ì
advantages¼áá althougΦá thσá seconΣá methoΣá i≤á morσá precisσáá anΣ ì
preferable if it can be used.

1.  Thσá warφ boo⌠ routinσ iε BIO╙ usuall∙ contain≤ ß cal∞ t∩ ß disδ ì
ááááinitializatioεá subroutinσ whicΦ reset≤ al∞ thσá interna∞á flag≤ ì
ááááanΣá parameter≤á fo≥ thσ disδ system«á  Iµ thσ addres≤á oµá thi≤ ì
áááároutinσá caεá bσ determineΣ theε i⌠ caε bσ calleΣá eacΦá timσá ß ì
ááááfunctioεá 1│ (rese⌠ disδ system⌐ cal∞ i≤ made«á  Thi≤ methoΣ ha≤ ì
ááááthσ disadvantagσ tha⌠ i⌠ reset≤ thσ entirσ disδ system¼á anΣ caε ì
ááááthu≤á onl∙á bσ useΣ witΦ ß functioε 1│ cal∞ anΣ theεá onl∙á wheε ì
ááááful∞ relogginτ oµ permanen⌠ mediß drive≤ i≤ enableΣ (seσ NovaDO╙ ì
ááááflags)«á  Thσá advantagσ i≤ tha⌠ thσ disδ initializatioε cal∞ i≤ ì
áááágenerall∙ eas∙ t∩ finΣ (jus⌠ abou⌠ ever∙ systeφ ha≤ one⌐ anΣá iµ ì
ááááthσ sourcσ fo≥ thσ systeφ BIO╙ i≤ available¼ ß jum≡ t∩ thi≤ cal∞ ì
áááácaεá bσ placeΣ iε thσ basσ pagσ alonτ witΦ thσ warφ boo⌠á IOBYT┼ ì
ááááand DOS jump at system startup.

2.áá┴á singlσ bytσ iε thσ BIO╙ RO═ scratcΦ memor∙ areß usuall∙á conì
áááátrol≤á thσ determinatioε oµ flopp∙ format«á  Thσ bytσ i≤ ßá flaτ ì
ááááwhicΦá tell≤á thσá operatinτ systeφ whethe≥ o≥á no⌠á thσá flopp∙ ì
ááááforma⌠ i≤ known«  Oε system≤ witΦ tw∩ o≥ morσ floppie≤ therσ ma∙ ì
áááábσá morσ thaε onσ sucΦ flaτ byte«á  Resettinτ thi≤ bytσ o≥ byte≤ ì
áááái≤ ß ver∙ precisσ wa∙ oµ resettinτ thσ flopp∙ forma⌠ withou⌠ un-ì
ááááinitializinτá permanen⌠á medißá a≤á well«áá  Thσá rese⌠á caεá bσ ì
ááááperformeΣ wheε ß disδ i≤ loggeΣ iε rathe≥ thaε wheε i⌠ i≤ loggeΣ ì
ááááout¼á anΣá thσ systeφ become≤ morσ transparen⌠ t∩ flopp∙á forma⌠ ì
ááááchanges.

Instruction≤á anΣ suggestion≤ arσ provideΣ iε NDOSHDR.LI┬ fo≥ analyì
zinτ you≥ BIOS in order to implement either of these methods.


.paèNovaDOS Flags:ì
--------------

Onσá oµ thσ morσ powerfu∞ feature≤ oµ NovaDO╙ i≤ thσ flag≤ byte«á  ┴ ì
numbe≥ oµ ruε timσ features¼ a≤ discusseΣ below¼ arσ affecteΣ b∙ thσ ì
flag≤ byte«á  Unlikσ feature≤ includeΣ o≥ excludeΣ b∙ assembl∙á conì
figuratioεá options¼á thσá feature≤á affecteΣ b∙ thσá flag≤á ma∙á bσ ì
controlleΣá b∙á settinτ anΣ resettinτ individua∞ bit≤ iεá thσá flag≤ ì
byte«á  ┴á specia∞ DO╙ function¼á Functioε 41¼á i≤ availablσ t∩ botΦ ì
reaΣá anΣ writσ t∩ individua∞ bit≤ oµ thi≤ byte«á

Thσá flag≤á bytσá i≤ mos⌠ usefu∞ oε system≤ sucΦá a≤á NZ-CO═á which¼ ì
unlikσ CP/M¼á don'⌠ reloaΣ thσ DO╙ witΦ eacΦ warφ boo⌠ call«á  Thus¼ ì
thσ flag≤ retain their settings until the system is cold booted.


The NovaDOS flags byte is interpreted as follows:


         SET áááááá áááááááááááááááááááááRESET

Bit 0: ááBoth type 1 and type 2 áááááááááThe ápublic áfiles
         public files are recognized. áááfacility is disabled.



Bit 1: ááThe ability to poll the ááááááááNo checks for ^S are per-
         console input for ^S during ááááformed during extended
         output is enabled. áááááááááááááconsole output.


Bit 2: ááAllow high bit characters to áááHigh bits will be stripped
         be áentered áinto áthe con- ááááoff of all characters en-
         sole buffer if the high bit ááááentered into the console
         facility is enabled. ááááááááááábuffer.

BIT 3: ááHigh ábits áwill be passed áááááHigh bits will be stripped
         by all NovaDOS functions áááááááfrom all output characters
         which send characters to the áááexcept those output by
         CRT. áááááááááááááááááááááááááááFunction 6.

BIT 4: ááFiles with the public file áááááFiles with the public file
         attribute (second filename áááááattribute set are read/
         character high bit) are read    write.
         only.

BIT 5: ááThe A drive will be searched áááIf the A drive is a fixed
         and the allocation vector áááááádisk, the allocation vectorá
         rebuilt each time Function 13 ááwill not be rebuilt on
         i≤ called«                      Function 13 call, savinτ
                                         much time on warm boots.


.heNovaDOS  Error Handling                                      page #
.paèNOVADOS ERROR HANDLING:
=======================

NovaDO╙ provide≤ substantiall∙ morσ informatioε iε it≤ erro≥ report≤ ì
thaε doe≤ ZRDO╙ o≥ standarΣ CP/═ DOS« Thσ DO╙ functioε whicΦ encounì
tereΣ thσ error¼á thσ disδ anΣ thσ namσ oµ an∙ filσ involveΣ iεá thσ ì
erro≥á arσá displayed«á Enterinτá ES├á (o≥á thσá ke∙á designateΣá iε ì
NDOSHDR.LIB⌐á afte≥á aε filσ o≥ disδ reaΣ onl∙ erro≥á override≤á thσ ì
erro≥á anΣ treat≤ thσ filσ o≥ disδ a≤ R/W«á An∙ othe≥ ke∙ produce≤ ß ì
jum≡ ░ warφ boo⌠ unles≤ thσ warφ boo⌠ tra≡ i≤ set«á Iµ thσ warφ boo⌠ ì
tra≡ i≤ set¼ erro≥ message≤ anΣ erro≥ escapσ arσ disabled.


Error Code Returns:ì
-------------------

T∩á maintaiε compatibilit∙ witΦ ZRDO╙ inasmucΦ a≤ possible¼á NovaDO╙ ì
wil∞ returε erro≥ code≤ oε ß DO╙ generateΣ warφ boo⌠ eithe≥ witΦá o≥ ì
withou⌠á warφá boo⌠á trapping«á Iµ thσ warφ boo⌠ tra≡á i≤á set¼á thσ ì
callinτ prograφ caε makσ usσ a≤ i⌠ wil∞ oµ thσ erro≥ codes.

Errorì
Number ááááNovaDOS áááá       ááááZRDOS ááá      ááááááááCP/M

1 áááááá  áDisk Read Error áááááááDisk Read Error áááááááBad Sectorì
2 ááááááá  Drive Select Error áá áDrive Select Error  áááSelectì
3 ááááááá  Disk R/O Error á ááááááDisk R/O error á ááááááR/Oì
4 ááááááá  File R/O Error á ááááááFile R/O error áááá áááFile R/Oì
5 áááá  áááDisk Write error á   ááDisk Changed Error ááá -ì
6   ááááááá- ááá          ááááááááFile Wheel Protected áá-


.heNovaDOS  Installation                                        page #
.paèCONFIGURING AND INSTALLING NOVADOS:
===================================

AlthougΦá yo⌡ ma∙ ruε thσ pre-assembleΣ version≤ oµ NovaDO╙ provideΣ ì
witΦ thi≤ packagσ anΣ enjo∙ man∙ oµ it'≤ advanceΣ features¼ ful∞ usσ ì
oµá NovaDO╙ feature≤ require≤ re-assembl∙ oµ thσ sourcσá code«á  Al∞ ì
"finσ tuningó fo≥ advanceΣ feature≤ i≤ donσ iε thσ filσá NDOSHDR.LI┬ ì
whicΦ contain≤ extensivσ discussioε anΣ instruction≤ fo≥ settinτ thσ ì
assembl∙ value≤ anΣ equate≤ provideΣ therein«  NDOSHDR.LI┬ i≤ essenì
tiall∙ ß separatσ configuratioε manua∞ fo≥ NovaDOS¼á anΣ s∩á detail≤ ì
oµá thσ configuratioε proces≤ arσ no⌠ provideΣ here«á  NovaDO╙á wil∞ ì
assemblσá witΦá eithe≥á thσ finσ SL╥ assemble≥ Z80AS═ (o≥á it'≤á biτ ì
brothe≥á Z80ASM+⌐ o≥ witΦ Microsoft'≤ M8░ whicΦ i≤ slowe≥á bu⌠á morσ ì
readil∙á available«á  Thσá assembl∙ proces≤ i≤ covereΣ iεá thσá lastì
section«

ReaΣá througΦá NDOSHDR.LI┬ anΣ theε g∩ bacδ througΦ i⌠ anΣá se⌠á thσ ì
option≤ whicΦ sui⌠ you≥ need≤ anΣ you≥ system«á  Yo⌡ ma∙ assemblσ t∩ ì
eithe≥á ß RE╠ filσ fo≥ loadinτ witΦ NZ-CO═ o≥ JetLD╥ o≥ t∩ ßá binar∙ ì
imagσ witΦ phaseΣ codσ addresse≤ fo≥ usσ witΦ PUTSYS«á  Aε optioε i≤ ì
als∩á provideΣ t∩ assemblσ anΣ linδ t∩ ß PR╠ filσ fo≥ usσ witΦá codσ ì
o≥ utilitie≤ whicΦ caε handlσ thσ opportunitie≤ provideΣ b∙ ßá reloì
catioε bitmap«  Thσ filσ MAKENVDS.CO═ use≤ sucΦ ß filσ t∩ generatσ ß ì
cop∙ oµ NovaDO╙ tailoreΣ t∩ you≥ system«

.heNovaDOS  Functions                                           page #
.paèNOVADOS FUNCTIONS:ì
==================

Thσá followinτá discussioε oµ function≤ cover≤ onl∙á thosσá feature≤ ì
whicΦá diffe≥á iε somσ respec⌠ froφ thσ Digita∞ ResearcΦ BDO╙á funcì
tions«á An∙ gooΣ CP/═ referencσ manua∞ wil∞ givσ informatioε oεá thσ ì
detail≤ oµ thσ standarΣ BDO╙ functions.



Function 1: áRead Console Byteì
C = 01hì
------------------------------

áááIµ higΦ bi⌠ characte≥ contro∞ i≤ enabled¼ thσ echoinτ oµ higΦ bi⌠ ì
ááácharacter≤á t∩ thσ screeε witΦ Functioε ▒ i≤ unde≥ thσ contro∞ oµ ì
áááflag≤ bi⌠ 3.


Function 2: áWrite Console Byteì
C = 02hì
-------------------------------

áááAε automatiπ checδ i≤ madσ ever∙ 25╢ character≤ fo≥ thσá presencσ ì
áááoµá ^╙á a⌠ thσ consolσ input«á Thi≤ checδ wil∞ bypas≤á an∙á othe≥ ì
ááácharacte≥á waitinτ t∩ bσ processeΣ b∙ DO╙ consolσ inpu⌠ anΣ iµá ß ì
ááá^╙ ha≤ beeε typed¼ screeε outpu⌠ wil∞ bσ halted.

áááThi≤á featurσ  wil∞ resul⌠ iε ß sligh⌠ los≤ oµ keyboarΣá responsσ ì
áááspeeΣá durinτá time≤ oµ intensivσ screeεá output«á Thi≤á i≤á onl∙ ì
ááánoticeablσá witΦá program≤á sucΦ a≤ game≤ o≥á animateΣá debugger≤ ì
ááárequirinτá ver∙ precisσ timinτ oµ keyboarΣ entry«á Thσá characte≥ ì
ááácheckinτ featurσ ma∙ bσ disableΣ usinτ functioε 4▒ t∩ rese⌠ bi⌠ 1 ì
áááoµ thσ flag≤ byte.


Function 6: áDirect Console I/Oì
C = 06hì
-------------------------------

áááThi≤ function¼ iε additioε t∩ standarΣ I/╧ capabilities¼ provide≤ ì
áááthσá abilit∙á t∩ checδ consolσ statu≤ directl∙ viß ß cal∞ t∩á thσ ì
áááBIOS¼á bypassinτ thσ routine≤ associateΣ witΦ thσ inpu⌠á checkinτ ì
áááfeaturσá oµ Function≤ ▓ anΣ 11«á ┴ cal∞ t∩ thi≤ functioε witΦ ┼ ╜ ì
ááá0feΦ wil∞ returε ┴ ╜ ░ iµ n∩ characte≥ pendinτ anΣ ┴ ╜ 0ffΦ iµá ß ì
ááácharacte≥ i≤ pending.


Function 9: áDisplay "$"-Terminated Stringì
C = 09hì
------------------------------------------

áááNote≤ fo≥ Functioε ▓ appl∙ t∩ Functioε ╣ a≤ well.

.paèFunction 10: áRead Console Stringì
C = 0ahì
---------------------------------

áááThσá deletσ ke∙ behave≤ iε ß respectablσ fashion¼á i.e«á likσ thσ ì
ááábackspacσ key«á A≤ ß result¼á thσ ^╥ (rewritσ line⌐ featurσ i≤ n∩ ì
ááálonge≥ necessar∙ anΣ caε bσ eliminateΣ iε assembly¼á iµá desired« ì
áááIµá higΦá bi⌠ characte≥ contro∞ i≤ enabled¼á theε thσá inpu⌠á anΣ ì
áááechoinτ oµ higΦ bi⌠ character≤ i≤ unde≥ thσ contro∞ oµ flag≤ bit≤ ì
ááá▓ anΣ 3.


Function 11: áRead Console Statusì
C = 0bhì
---------------------------------

áááThi≤á functioεá i≤á invokeΣ b∙ Function≤ ▓ anΣ ╣ t∩ checδá fo≥á ß ì
ááápendinτ character« An∙ characte≥ othe≥ thaε ^╙ i≤ reaΣ anΣ storeΣ ì
áááinternall∙á fo≥ futurσ processing¼á anΣ ß cal∞ t∩á thi≤á functioε ì
áááwil∞á indicatσ tha⌠ ß characte≥ i≤ presen⌠ a⌠ thσ inpu⌠á console¼ ì
áááeveεá thougΦá thσá pendinτ characte≥ ha≤ alread∙á beeεá reaΣá anΣ ì
ááástored«á Fo≥ ß truσ cal∞ t∩ thσ BIO╙ statu≤ routine¼ usσ Functioε ì
ááá╢ witΦ ┼ ╜ 0feh.


Function 13: áReset Disk Systemì
C = 0dhì
-------------------------------

áááUnlikσá CP/M¼á NovaDO╙á doe≤ no⌠ necessaril∙ rese⌠ thσ ReaΣá Onl∙ ì
ááávecto≥ oε ß functioε 1│ call«á Thus¼ iµ thσ runloτ equatσ wa≤ se⌠ ì
áááfalsσ iε thσ heade≥ filσ a⌠ assembl∙ timσ ¼á ß disδ ma∙ bσá rese⌠ ì
ááát∩ R/╫ onl∙ b∙ ß cal∞ t∩ functioε 37.

áááIµá flag≤ bi⌠ ╡ i≤ reset¼á thσ allocatioε vecto≥ wil∞ no⌠ bσá reì
ááábuil⌠á fo≥á fixeΣ media«á Thi≤ wil∞ savσ ß grea⌠ dea∞ oµ timσá oε ì
áááwarφ boot≤ bu⌠ ma∙ causσ problem≤ witΦ othe≥ feature≤ a≤á discusì
áááseΣ iε thσ nex⌠ tw∩ paragraphs.

áááIµá Flag≤ bi⌠ ╡ i≤ set¼á Functioε 1│ return≤ ┴ ╜ 0ffΦ (thσ submi⌠ ì
áááflag⌐á iµá ß filσ oε thσ ┴ drivσ exist≤ whosσá namσá begin≤á witΦ ì
ááá"$$"«á Notσ that¼ unlikσ somσ othe≥ CP/═ DOS's¼ ß filσ whosσ namσ ì
ááástart≤ witΦ ß singlσ ñ characte≥ wil∞ no⌠ se⌠ thσ submi⌠ flag« $-ì
áááPuΓá filσ name≤ shoulΣ no⌠ begiε witΦ "$$ó iµ thσ submi⌠ flaτá i≤ ì
áááuseΣ b∙ thσ CP╥ t∩ establisΦ thσ presencσ oµ submi⌠ commanΣ file.

.paèFunction 14: áSelect Diskì
C = 0ehì
-------------------------

áááThσá Selec⌠á Disδ functioε contain≤ thσ cal∞ t∩ thσá BIO╙á RESDS╦ ì
ááároutinσ (iµ enabled⌐ whicΦ i≤ calleΣ prio≥ t∩ logginτ iε ß flopp∙ ì
ááádrive«á Thi≤ allow≤ botΦ singlσ anΣ doublσ sideΣ disk≤ t∩ bσ reaΣ ì
áááb∙ machine≤ whicΦ suppor⌠ botΦ formats« WitΦ NovaDO╙ releasσ H¼ ß ì
áááRESDS╦á cal∞ i≤ madσ no⌠ onl∙ b∙ thi≤ functioε wheε logginτ iεá ß ì
áááflopp∙ iε responsσ t∩ aε externa∞ call¼á bu⌠ als∩ b∙ an∙ functioε ì
áááwhicΦá sense≤á ß changeΣ disδ sincσ thσ las⌠ logiε oµ thσá flopp∙ ì
ááádrivσ anΣ call≤ thi≤ functioε internally.


Function 15: áOpen Fileì
C = 0fhì
-----------------------

áááThσ se⌠ oµ file≤ whicΦ arσ accessiblσ viß Functioε 1╡ i≤ extendeΣ ì
áááb∙á thσ usσ oµ thσ NovaDO╙ searcΦ patΦ anΣ b∙ thσ usσá oµá publiπ ì
áááfiles«á Seσá thσá sectioεá "Discussioε oµ Featuresó abovσá fo≥á ß ì
ááádetaileΣ explanatioε oµ thσ searcΦ patΦ anΣ publiπ files.

áááIµá ßá flopp∙ disδ ha≤ beeε changeΣ thσ las⌠ disδá rese⌠á NovaDO╙ ì
áááwil∞á simpl∙ rese⌠ thσ drivσ anΣ proceed«á ┴ changeΣá disδá unde≥ ì
áááCP/═ BDO╙ resulteΣ iε thσ disδ beinτ declareΣ reaΣ only.


Function 19: áErase (Delete) Fileì
C = 13hì
---------------------------------

áááI⌠á i≤á worth∙ oµ notσ tha⌠ eveε whilσ publiπ file≤ arσá madσá bσ ì
áááreaΣ onl∙ b∙ settinτ flag≤ bytσ 4¼á the∙ ma∙ bσ eraseΣ witΦ Funcì
ááátioε 19.


Function 21: áWrite Sequentialì
C = 15hì
------------------------------

áááNovaDO╙á wil∞ conside≥ al∞ publiπ file≤ t∩ bσ ReaΣ Onl∙ unles≤á ß ì
ááácal∞á t∩ Functioε 4▒ ha≤ altereΣ thi≤ condition«á An∙ attemp⌠á t∩ ì
áááwritσá t∩ sucΦ ß filσ wil∞ producσ ß standarΣ "Filσ i≤ R/Oóá mesì
ááásage.

áááWritinτá t∩ ß filσ wil∞ causσ thσ archivσ bi⌠ t∩ bσ rese⌠ iεá thσ ì
ááádirector∙ entr∙ fo≥ thσ filσ wheε i⌠ i≤ closed.


Function 34: Write Randomì
C = 21hì
--------------------------

áááSeσ note≤ fo≥ Functioε 21.
Function 37: áReset Driveì
C = 25hì
-------------------------

áááNovaDO╙á ma∙á bσ configureΣ oε assembl∙ t∩ emulatσ ZRDO╙á iεá thσ ì
áááexecutioε oµ thi≤ function« StandarΣ CP/═ DO╙ wil∞ rese⌠ thσ bit≤ ì
áááiεá thσ writσ protec⌠ vecto≥ fo≥ al∞ drive≤ whicΦ arσ no⌠ currenì
ááátl∙ loggeΣ in«á Iµ ZRDO╙ emulatioε i≤ enabled¼á onl∙ thosσ drive≤ ì
áááwhicΦá arσá specificall∙á loggeΣ ofµ arσ rese⌠á t∩á ßá Read/Writσ ì
ááácondition.


Function 38:  Relocate Code
C = 26h
---------------------------

   Thi≤á i≤á aε experimenta∞ functioε whicΦ a≤ ye⌠ ha≤á n∩á applicaì
ááátions«á  ┴ pointe≥ t∩ ß Relocatioε Contro∞ Blocδ i≤ passeΣ iε DE«ì
áááCodσá specifieΣá b∙ thσ blocδ i≤ relocateΣ anΣ addres≤á adjusted«ì
áááThσ forma⌠ fo≥ thσ RC┬ i≤ a≤ follows:

ááá       defw      oldloc         ; Old location of code
ááá       defw      newloc         ; New location of code
          defw      offset         ; Offset for address adjustment
ááá       defw      codesiz        ; Size of block to relocate
ááá       defw      bitmap         ; Pointer to relocation bitmap

áááAddresse≤á t∩á bσ adjusteΣ arσ referenceΣ b∙ thσ bitma≡á thσá se⌠ ì
ááábit≤á oµá whicΦ indicatσ thσ HIG╚ orde≥ bytσ oµ addresse≤á t∩á bσ ì
áááadjusted«  SucΦ ß bitma≡ i≤ produceΣ b∙ linker≤ generatinτ SP╥ o≥ ì
áááPR╠ files.

   Iµ thσ codσ i≤ operationa∞ iε onσ locatioε anΣ i≤ beinτ moveΣá t∩ ì
áááanothe≥á addres≤ a⌠ whicΦ i⌠ i≤ als∩ expecteΣ t∩ bσá operational¼ ì
ááátheεá offse⌠ ╜ newloπ - oldloc«á  I⌠á i≤á possible¼á however¼á t∩ ì
áááaddres≤ adjus⌠ codσ iε memor∙ withou⌠ movinτ it«á  Thus¼á iµ bitì
ááámap≤á exis⌠á fo≥ al∞ reference≤ t∩ eacΦ oµ severa∞ commoεá block≤ ì
áááwhicΦ thσ codσ mus⌠ access¼á theε thi≤ functioε ma∙ bσ calleΣ fo≥ ì
áááeacΦá bitma≡ witΦ thσ runtimσ addres≤ oµ thσ commoε blocδ iεá thσ ì
áááRC┬á offse⌠á word«á Thσ generatioε oµ multiplσá bitmap≤á oµá thi≤ ì
ááánaturσ ma∙ bσ beyonΣ thσ capabilitie≤ oµ existinτ linkers.


Function 39: Return Fixed Media Vector á(Optional)ì
C = 27hì
--------------------------------------

áááNovaDO╙ keep≤ ß recorΣ oµ thosσ mediß whicΦ arσ permanen⌠á withiε ì
áááthσ systeφ sucΦ a≤ harΣ disk≤ anΣ RA═ disk≤ (no⌠ floppies)«á Thi≤ ì
áááfunctioε return≤ ß bi⌠ ma≡ oµ sucΦ disk≤ iε ß manne≥ analogou≤ t∩ ì
áááFunctioε 2┤ (seσ an∙ gooΣ DO╙ reference)«á Thi≤ functioε i≤ adapì
áááteΣ froφ ZRDO╙ vs« 1.9.
.paèFunction 41: áGet/Set/Reset NovaDOS Flagsì
C = 29hì
-------------------------------------

áááOε entry¼á registe≥ ┼ contain≤ ß flaτ specificatioε bytσ iε whicΦ ì
áááthσá bit≤ correspondinτ t∩ thosσ flag≤ t∩ bσ altereΣ arσ set«á Iµ ì
ááábi⌠á ╖ i≤ set¼á thσ designateΣ flag≤ wil∞ bσ set¼á otherwisσá thσ ì
áááflag≤ wil∞ bσ reset«á Iµ E=░ oε entr∙ theε thσ curren⌠ flag≤ bytσ ì
áááwil∞ bσ returneΣ iε thσ ┴ register«


Function 42║ Se⌠ PatΦ Addres≤ (Optional⌐
├ ╜ 2aΦ
-----------------------------

áááIµ D┼ contain≤ ß non-zer∩ valuσ oε entry¼ thσ patΦ addres≤ i≤ se⌠ ì
ááát∩ tha⌠ value«á Iµ D┼ i≤ 0¼á thσ curren⌠ patΦ addres≤ i≤ returneΣ ì
áááiε HL.


Function 47: áReturn Current DMA Address á(Optional)ì
C = 2fhì
-----------------------------------------

áááThσá curren⌠á DM┴ addres≤ i≤ returneΣ iεá HL«á Thi≤á functioεá i≤ ì
ááánecessar∙ fo≥ ZRDO╙ emulation.


Function 48: áReturn ZRDOS Version Number á(Optional)ì
C = 30hì
-----------------------------------------
ì
ááá┴á numbe≥ oµ ZCP╥ Z-systeφ utilitie≤ requirσ ZRDO╙ anΣ wil∞ abor⌠ ì
áááwitΦá ßá messagσ t∩ tha⌠ effec⌠ iµ ß Functioε 4╕á cal∞á doe≤á no⌠ ì
áááreturεá ßá ZRDO╙ versioε number«á Thi≤ functioε return≤ ßá numbe≥ ì
ááácorrespondinτ t∩ ß valiΣ ZRDO╙ versioε number.


Function 50: áSet Warm Boot Trap á(Optional)ì
C = 32hì
--------------------------------

áááThi≤á functioεá replace≤ thσ interna∞ DO╙ warφ boo⌠ jum≡ witΦá aε ì
áááaddres≤ receiveΣ iε DE« Internall∙ generateΣ warφ boot≤ wil∞ theε ì
ááábσ diverteΣ t∩ thi≤ address« Thi≤ functioε i≤ necessar∙ fo≥ ZRDO╙ ì
áááemulation«á Erro≥ message≤ anΣ thσ erro≥ escapσ optioε arσá disaì
ááábleΣ wheε thσ warφ boo⌠ tra≡ i≤ set.

.paèFunction 52: áReset Warm Boot Trap á(Optional)ì
C = 34hì
----------------------------------

áááThi≤ functioε reset≤ thσ warφ boo⌠ jum≡ addres≤ t∩ 0000h«á Iµ thσ ì
áááwarφ boo⌠ tra≡ i≤ no⌠ set¼ thσ functioε iε null« Thi≤ functioε i≤ ì
ááánecessar∙ fo≥ ZRDO╙ emulation.


Function 200: áGet Time á(Optional)ì
C = C8hì
-----------------------

áááIµá date/timσ stampinτ i≤ enabled¼á thi≤ functioε wil∞ writσá thσ ì
ááácurren⌠ timσ t∩ thσ buffe≥ addres≤ passeΣ iε DE«á Seσ thσ sectioε ì
áááoε Timσ anΣ Datσ Stampinτ unde≥ "Discussioε oµ Features".


Function 201: áSet Time á(Optional)ì
C = C9hì
-----------------------

áááIµá date/timσá stampinτ i≤ enabled¼á thi≤ functioε wil∞ reaΣá thσ ì
ááácurren⌠á timσá froφ thσ buffe≥ addres≤ passeΣ iε D┼ anΣá se⌠á thσ ì
áááBIO╙ clock/calenda≥ accordingly« Seσ thσ sectioε oε Timσ anΣ Datσ ì
áááStampinτ unde≥ "Discussioε oµ Features".

.heNovaDOS  Assembly                                            page #
.paèASSEMBLY INSTRUCTIONS:
======================

Therσá arσá tw∩ genera∞ method≤ fo≥ gettinτ NovaDO╙ u≡ anΣá running«ì
EacΦá require≤ ß differen⌠ assembl∙ anΣ loadinτ proces≤ a≤á wel∞á a≤ ì
differen⌠á softwarσá anΣ setting≤ withiε NDOSHDR.LIB¼á a≤á discusseΣ ì
below«á  Thσ methoΣ whicΦ yo⌡ shoulΣ usσ depend≤ oε you≥ systeφá anΣ ì
thσ softwarσ tool≤ availablσ t∩ you«á  NovaDO╙ wil∞ assemblσ withou⌠ ì
modificatioεá witΦá eithe≥á SL╥ systemsº excellen⌠á Z80AS═á o≥á witΦ ì
Microsoft'≤á M80¼á whicΦ i≤ morσ readil∙ available«á  Thσ forme≥á i≤ ì
highl∙ recommenΣ fo≥ speeΣ anΣ versatility.


Method 1:  Loadable REL file
----------------------------

Iµ yo⌡ arσ usinτ thσ NZCOM/ZCPR3┤ packagσ froφ Alphß System≤ (highl∙ ì
recommended⌐á you≥ assembl∙ anΣ loadinτ proces≤ i≤ extremel∙ simple«

1.   Set cmnadr true in NDOSHDR.LIB

2.   If using Z80ASM, assemble to a REL file with

          > Z80ASM nvds/r

     If using M80, assemble to a REL file with

          > M80 nvds,=nvds.z80/z

3«á  I⌠á i≤á advisablσá t∩ renamσ thσ resultinτ RE╠á filσá witΦá thσ ì
     extensioε ZR╠ t∩ maintaiε consistenc∙ witΦ existinτ NZCO═ softì
áááááware.  You may load NovaDOS to memory with:

ááááá     > JETLDR nvds.zrl

áááááor   > NZCOM nvds.zrl


Method 2:  Patching PUTSYS.COM with a HEX file
----------------------------------------------

Iµá yo⌡á havσ Z80AS═ yo⌡ ma∙ assemblσ NovaDO╙ t∩ aε Inte∞á HE╪á filσ ì
whicΦ ma∙ bσ overlaiΣ ont∩ thσ DO╙ imagσ withiε PUTSYS.COM«  NovaDO╙ ì
ma∙á theεá bσ loadeΣ ont∩ thσ systeφ track≤ oµ an∙ disδá b∙á runninτ ì
PUTSYS«

1.á  Se⌠á hexgeε truσ iε NDOSHDR.LIB«á  Se⌠ EITHE╥ z33ad≥ o≥á intad≥ì
ááááátruσá dependinτ oε whethe≥ o≥ no⌠ yo⌡ arσ usinτ ZCPR3│ anΣ havσ ì
áááááZ3BASE.LI┬ available«  Iµ Z3BASE.LI┬ i≤ no⌠ available¼ yo⌡ mus⌠ ì
áááááse⌠ thσ DO╙ anΣ BIO╙ addres≤ equate≤ whicΦ follow.

2.   If using Z80ASM, assemble to a HEX file with:

          > Z80ASM nvds/h
.paèáááááIµá usinτá M80¼á producinτ thσ HE╪ filσ i≤ ß tw∩ ste≡á process«ì
áááááYo⌡ mus⌠ makσ ß notσ oµ thσ addres≤ putsdo≤ (usuall∙ 1180h⌐á iε ì
áááááNDOSHDR.LIB for use with L80.

áááááa.   Assemble to a REL file with:

ááááá     > M80 nvds,=nvds.z80/z

áááááb.   Link to a HEX file with:

ááááá     ╛áL8░á /p:1180,nvds,nvds/e/n/°      (usσ putsdos address)

3.   LoaΣá thσ HE╪ filσ ont∩ PUTSY╙ usinτ MLOA─ witΦ:

ááááá     > MLOAD newsys=putsys.com,nvds.hex

     Iµ yo⌡ don'⌠ havσ MLOAD¼á yo⌡ caε usσ DD╘ t∩ loaΣ NVDS.HE╪ int∩ ì
áááááPUTSYS.COM as follows:

ááááá     > DDT putsys.com

áááááMakσ ß notσ oµ thσ numbe≥ unde≥ NEXT«  A⌠ thσ DD╘ prompt¼ issuσ ì
áááááthe commands:

ááááá     - invds.hex
ááááá     - r
ááááá     - ^C           (exit DDT)

áááááImmediatel∙á issuσá thσá commanΣ "SAV┼á nεá newsys.com"¼á wherσ ì
ááááánεá i≤ thσ higΦ orde≥ bytσ (leftmos⌠ tw∩ digits⌐ oµ thσá numbe≥ ì
áááááunder NEXT, converted to decimal.

4.   Run PUTSYS to place NovaDOS onto your system tracks.


ADDITIONAL ASSEMBLY OPTIONS:
============================

Binary Image:
---------------

Yo⌡á ma∙ generatσ ß binar∙ imagσ oµ NovaDO╙ whicΦ may¼á likσ thσ HE╪ ì
file¼á bσá loadeΣ int∩ PUTSY╙ usinτ DDT¼á placeΣ iε memor∙á directl∙ ì
usinτá an∙á utilit∙ capablσ oµ doinτ s∩ o≥ patcheΣ iε an∙ onσá oµá ß ì
numbe≥á oµá way≤ ont∩ you≥ systeφ tracks«á Yo⌡ ma∙ obtaiεá ßá binar∙ ì
imagσá oµá generiπ NovaDO╙ directl∙ b∙ runninτ MAKENVD╙ o≥á yo⌡á ma∙ ì
generatσ ß custoφ versioε a≤ follows.

1.   Se⌠ intad≥ o≥ z33ad≥ true¼á dependinτ oε whethe≥ o≥ no⌠ yo⌡ arσ ì
áááááusing ZCPR33 and have Z3BASE.LIB available.  Set hexgen false.
.paè2.áááIf using Z80ASM, create a COM file with:

ááááá     > Z80ASM nvds

áááááIf using M80 and L80, a two step process is required

áááááa.   Generate a REL file with M80 with:

ááááá     > M80 nvds,=nvds.z80/z

áááááb.   Generate a COM file from the REL file with:

ááááá     > L80 /p:100,nvds,nvds/e/n

Thσá resultinτá CO═á filσ shoulΣ bσ renameΣ witΦ thσ exten⌠á BI╬á t∩ ì
preven⌠á i⌠ froφ beinτ accidentall∙ executed«á  Yo⌡ ma∙ loaΣ thσ BI╬ ì
filσ int∩ PUTSYS¼ iµ yo⌡ wish¼ usinτ DDT« Invokσ DD╘ a≤ beforσ with

ááááá     > DDT putsys.com

Makσ ß notσ oµ thσ numbe≥ oµ page≤ loadeΣ (thσ higΦ orde≥ tw∩ digit≤ ì
oµ thσ fou≥ digi⌠ figurσ unde≥ NEXT¼á converteΣ t∩ decimal)«á  Issuσ ì
thσ followinτ command≤ t∩ DDT.

ááááá     - invds.bin
ááááá     - r1180        (use the offset in PUTSYS of the DOS image)
ááááá     - ^C           (exit DDT)

Immediatel∙á issuσá thσ commanΣ "SAV┼ nε newsys"¼á wherσ nεá i≤á thσ ì
numbe≥ oµ page≤ oµ putsy≤ loadeΣ b∙ DDT.


SPR/PRL Files:
--------------

SP╥ anΣ PR╠ file≤ arσ no⌠ iε commoε use¼á bu⌠ arσ usefu∞ iε applicaì
tion≤ requirinτ ß relocatablσ binar∙ imagσ oµ executablσ code«á  Thσ ì
filσá MAKENVDS.CO═ use≤ ß PR╠ imagσ oµ NovaDO╙ whicΦ caε bσ useΣá t∩ ì
generatσá ß BI╬ filσ fo≥ usσ a⌠ an∙ poin⌠ iε memory«á  PR╠á anΣá SP╥ ì
file≤á contaiεá ß relocatioε bitma≡ followinτ thσ activσ codσá whicΦ ì
specifie≤á byte≤á t∩ bσ addres≤ adjusted«á  T∩ generatσ ßá RE╠á filσ ì
compatiblσ witΦ thσ generatioε oµ SP╥ anΣ PR╠ file≤ se⌠ relad≥á truσ ì
iεá NDOSHDR.LI┬á anΣ assemblσ t∩ ß RE╠ filσ usinτá eithe≥á supporteΣ ì
assembler«á  Generatioε oµ thσ SP╥ o≥ PR╠ filσ require≤ SL╥ Systemsº ì
SLRNK½á (thσ Cadillaπ oµ Z8░ linkers⌐ o≥ LIN╦ froφ Digita∞ Research«ì
Thσ usσ oµ SPR/PR╠ file≤ i≤ beyonΣ thσ scopσ oµ thi≤ manual«