ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/CPM/UTILS/ARC-LBR/NULU15.WS

Text File | 2000-06-30 | 65KB | 1,348 lines

                            NULU.DOC
                   Documentatioε fo≥ NULU.COM
                         a≤ oµ 11/01/85
                           Versioε 1.5

NULU.CO═ anΣ NULU.DO├ arσ botΦ Copyrigh⌠ 198┤ anΣ 1985¼ b∙ Martiε ì
Murray¼á P.O«á Bo°á 35972¼á Dallas¼á T╪  75235«á BotΦ ma∙ bσ useΣ ì
freel∙á fo≥á non-commercia∞ purposes¼á bu⌠ neithe≥ ma∙á bσá sold¼ ì
includeΣ iε ß packagσ fo≥ sale¼á o≥ useΣ a≤ aε incentivσ t∩á buy¼ ì
b∙áá an∙á person¼áá organizatioεá o≥á corporatioεá withou⌠á prio≥ ì
arrangemen⌠áá witΦáá thσáá copyrigh⌠áá holder¼áá Martiεáá Murray«  ì
Furthermore¼ Martiε Murra∙ wil∞ bea≥ n∩ responsibilit∙ fo≥ losse≤ ì
resultinτá froφá thσá usσá o≥á inabilit∙á t∩á usσá thi≤á program«  ì
NULU.CO═á ma∙ no⌠ bσ distributeΣ withou⌠ NULU.DOC¼á no≥á ma∙á thσ ì
copyrigh⌠á message≤ bσ removeΣ froφ eithe≥ filσ no≥ causeΣ t∩ no⌠ ì
bσ displayed.


                        ACKNOWLEDGEMENTS

Thi≤á prograφá woulΣ no⌠ havσ beeε possiblσ werσ i⌠ no⌠á fo≥á thσ ì
elegan⌠ worδ oµ Gar∙ P« NovosielskΘ anΣ thosσ other≤ workinτ witΦ ì
thσ L╒ librar∙ structure.

Additionally¼ ╔ woulΣ likσ t∩ thanδ thσ peoplσ wh∩ havσ supporteΣ ì
thσ developmen⌠ oµ NUL╒ iε ß variet∙ oµ ways¼ froφ suggestion≤ t∩ ì
financia∞áá contributions«áá  Al∞áá comment≤áá (good¼áá baΣáá anΣ ì
disastrous⌐ arσ welcome«á  Specia∞ thank≤ t∩ KeitΦ W« Antclifµ oµ ì
Mead¼á Washingtoε fo≥ hi≤ developmen⌠ oµ NULUTERM.ASM¼á ß patche≥ ì
overlay¼á anΣ t∩ Roε Fowle≥ oµ Nightow∞ Softwarσ fo≥ hi≤ graciou≤ ì
permissioε t∩ includσ MLOAD23.CO═ iε thσ NUL╒ releasσ library.

Honor≤á fo≥á Couragσ g∩ t∩ Denni≤ Recla¼á Norφ Gregory¼á anΣá Jiφ ì
Swit·á fo≥ havinτ thσ gut≤ t∩ "risδ everythingó b∙á testinτá NUL╒ ì
anΣ offerinτ suggestion≤ anΣ pointinτ ou⌠ bugs.


                          INTRODUCTION

NUL╒ i≤ ß completσ replacemen⌠ fo≥ L╒ anΣ LSWEEP«  Weighinτ iε a⌠ ì
15k¼ i⌠ include≤ al∞ feature≤ oµ botΦ program≤ anΣ theε some«  I⌠ ì
features:

    Tw∩ operatioε mode≤ witΦ ß ful∞ men⌡ fo≥ each
        L╒ stylσ CR├ suppor⌠ anΣ verification
    Viewinτá anΣá printinτá oµ membe≥ file≤ anΣá disδá files¼ ì
               unsqueezinτ wheε necessary
    Extractioεá oµá membe≥ file≤ witΦ aε optioε t∩á unsqueezσ ì
               wherσ appropriate
    Bigge≥ libraries¼á u≡ t∩ 80░ member≤ o≥ morσ dependinτ oε        ì
               availablσ memory
    Automatiπ membe≥ sorting¼á al∞ member≤ kep⌠ sorteΣ a⌠ al∞ ì
               times
    Faster reorganization
    Enhanced error handlingèááááááááSwapped disk handling
        Automatic self-verification
    Access to deleted members
        Access to read/only libraries
        Wildcard library processing
    Optional read/only patch
        CP/M Plus support
    General compatibility with LU and NSWEEP syntax
    Numerous user patches


            DIFFERENCES BETWEEN NULU 1.5 AND NULU 1.1

NUL╒á 1.╡ incorporate≤ severa∞ significan⌠ changes¼á no⌠ leas⌠ oµ ì
whicΦ arσ thσ buτ fixes«  Versioε 1.▒ haΣ severa∞ bugs¼ includinτ ì
occasiona∞ imprope≥ extractioε oµ largσ files¼á anΣ clobberinτ oµ ì
byte≤ iε director∙ entr∙ membe≥ names«á  Al∞ knowε bug≤ havσ beeε ì
addresseΣ a≤ oµ thσ ne≈ release«  (Actually¼ thσ extractioε "bugó ì
wa≤á duσá t∩á onσá oµá thσá bug≤á iεá CP/═á tha⌠á effec⌠á unusua∞ ì
combination≤ oµ direc⌠ anΣ sequential filσ access«á  Iµ yo⌡ watcΦ ì
carefully¼ yo⌡ wil∞ seσ BDO╙ re-allocatσ useΣ block≤ oµ thσ disk¼ ì
iε descendinτ order¼ n∩ less!)

Iµá yo⌡á attemp⌠á t∩á makσá change≤ t∩ ßá librar∙á filσá tha⌠á i≤ ì
logically read/only, NULU will display the message:

     Library is READ-ONLY.  Modify anyway? (y/n)

anΣ wil∞ wai⌠ fo≥ yo⌡ t∩ sa∙ ye≤ o≥ no«á  Iµ yo⌡ sa∙ no¼ theε thσ ì
operatioε yo⌡ werσ attemptinτ wil∞ bσ cancelled«  Iµ yo⌡ sa∙ yes¼ ì
yo⌡ wil∞ bσ ablσ t∩ makσ change≤ anΣ wheε yo⌡ closσ thσá library¼ ì
the file will be read/only once again.

Therσ havσ beeε other¼á morσ visiblσ changes«  Thσ disδ interfacσ ì
ha≤á beeεá expandeΣ s∩ tha⌠ severa∞ command≤ tha⌠ useΣá t∩á appl∙ ì
onl∙á t∩ librar∙ membe≥ files¼á caε no≈ als∩ worδ oε disδá files«  ì
Thesσ command≤ include¼á -D¼á -P¼ -╓ anΣ ß ne≈ command¼ -S¼ whicΦ ì
perform≤á ßá limiteΣ strinτ search«á  Fo≥ example¼á t∩á deletσá ß ì
library member the command is still:

     -d filespec

but you can also delete disk files with:

     -d du:filespec

wherσá thσá drive/use≥á combinatioε inform≤á NUL╒á tha⌠á yo⌡á arσ ì
talkinτ abou⌠ disδ file≤ insteaΣ oµ librar∙ members«á  (Notσ tha⌠ ì
thσá -┌ commanΣ ha≤ beeε re-assigned.⌐ Thi≤ synta° applie≤ t∩ thσ ì
othe≥ command≤ listeΣ above¼ a≤ well.

Additionally¼á ╔ havσ madσ aε effor⌠ t∩ brinτ NUL╒ 1.╡ furthe≥ iε ì
linσáá witΦá L╒á synta°á anΣá operation¼áá especiall∙á LU310.COM«  ì
Therefore¼á iε additioε t∩ othe≥ changes¼ thσ use≥ wil∞ finΣ tha⌠ ì
thσá -═ commanΣ fo≥ thσ NUL╒ CommanΣ Men⌡ ha≤ beeε changeΣ t∩á -╚ ìèfo≥ Help.


                              NULU

T∩ thσ bes⌠ oµ m∙ knowledge¼á NUL╒ wil∞ ruε oε an∙ systeφ runninτ ì
CP/═ 2.° o≥ higher¼á howeve≥ i⌠ ha≤ onl∙ beeε testeΣ b∙ mσ oε thσ ì
Osbornσ ▒ anΣ thσ Osbornσ Executivσ computers«á  I⌠ i≤ writteε iε ì
808░ compatible¼ Z8░ assembly language.

┴á completσá discussioε oµ thσ naturσ anΣ advantage≤á oµá librar∙ ì
file≤ i≤ beyonΣ thσ scopσ oµ m∙ endurance¼á howeve≥ ß shor⌠ reca≡ ì
i≤ iε order.

┴á librar∙á filσ i≤ ß singlσ CP/═ filσ whicΦ maintain≤ ▒ o≥á morσ ì
smalle≥á file≤á a≤ it≤ members«á  EacΦ filσ i≤ writteεá int∩á thσ ì
librar∙ anΣ recordeΣ iε thσ librar∙ directory«á  Afte≥á that¼á i⌠ ì
ma∙ bσ accesseΣ fo≥ viewing¼á printing¼á o≥ execution¼á o≥ ma∙ bσ ì
extracteΣá froφ thσ librar∙ t∩ assumσ thσ statu≤ oµ ß stand-alonσ ì
filσ oncσ again.

Thσ reason≤ fo≥ doinτ thi≤ arσ many«á  Fo≥ one¼á unde≥ CP/═á eacΦ ì
filσá occupie≤ ß minimuφ amoun⌠ oµ disδ space«á  Thi≤ amoun⌠á caε ì
rangσá froφ 1δ t∩ 16k¼á dependinτ oε thσ system«á  Eveε thougΦá ß ì
filσá ma∙á onl∙á bσ ▒ bytσ iε length¼á i⌠ wil∞ stil∞á occup∙á thσ ì
minimuφá requireΣá amount╗á thσá res⌠ oµá thσá spacσá i≤á wasted«  ì
Puttinτá thesσ file≤ iε ß librar∙ minimize≤ thσ possiblσ wastσ t∩ ì
12╖ bytes.

EacΦ filσ als∩ occupie≤ ß director∙ entry«á  Oε mos⌠ flopp∙á disδ ì
systems¼á thσ maximuφ numbe≥ oµ filσ entrie≤ pe≥ disδ i≤ 64«á  B∙ ì
includinτá ßá filσá iε ß librar∙ thσ director∙ spacσ i⌠á useΣá t∩ ì
occup∙ i≤ freeΣ fo≥ anothe≥ file.

Additionally¼á usinτá librar∙á file≤ caε simplif∙ thσ proces≤á oµ ì
categorizatioεá b∙á subsuminτ severa∞ file≤ oµ simila≥á type≤á o≥ ì
subject≤ int∩ onσ file.

However¼á therσ arσ als∩ danger≤ associateΣ witΦ usinτ libraries«  ì
Thσ maiε onσ i≤ tha⌠ iµ ß librar∙ filσ i≤ los⌠ o≥ damaged¼ al∞ oµ ì
thσ membe≥ file≤ arσ los⌠ a≤ well«á  Thσ solutioε t∩ thi≤ probleφ ì
caεá bσá summeΣá u≡ iε onσá word║á BACKUP«á NUL╒á probabl∙á isn'⌠ ì
perfect¼ anΣ wσ al∞ kno≈ tha⌠ disδ system≤ aren't¼ s∩ backu≡ you≥ ì
importan⌠á libraries¼á please«á ╔á don'⌠á wan⌠ t∩á hea≥á an∙á saΣ ì
stories.

Almos⌠á a≤á importan⌠á a≤á backinτ u≡ librarie≤á i≤á thσá usσá oµ ì
discretioε wheε decidinτ wha⌠ t∩ pu⌠ int∩ them«á  Let'≤ facσá it¼ ì
iµá ß filσ i≤ iε ß librar∙ i⌠ i≤ no⌠ a≤ eas∙ t∩ ge⌠ to«á  Iµá yo⌡ ì
neeΣ t∩ ge⌠ t∩ ß filσ ever∙ 1╡ minutes¼á i⌠ probabl∙ shouldn'⌠ bσ ì
iε ß librar∙ excep⌠ a≤ ß backu≡ measure.


                  A╬ ASID┼ CONCERNIN╟ FILESPECS
èWheεá specifyinτá ßá filespec¼á wildcard≤á ma∙á bσá useΣá freely¼ ì
however¼á unlikσá mos⌠ programs¼á NUL╒ doesn'⌠ insis⌠ tha⌠ ßá ".ó ì
separatσá thσá filenamσá froφ thσá filetype«á  Fo≥á example¼á thσ ì
filespeπá "**óá mean≤ thσ samσ thinτ a≤ "*.*ó t∩á NULU«á  Oεá thσ ì
othe≥ hand¼á thσ filespeπ "FRED.TXTó shoulΣ bσ typeΣ iε jus⌠ likσ ì
that«á  "FREDTXTó woulΣ makσ NUL╒ thinδ tha⌠ n∩ filetypσ haΣ beeε ì
specified«á  Thσ rulσ i≤ simple║ usσ ß do⌠ an∙ timσ yo⌡ like¼ bu⌠ ì
i⌠ i≤ onl∙ strictl∙ necessar∙ wheε i⌠ i≤ needeΣ fo≥ clarity.

Wheεá specifyinτá ßá drivσ and/o≥ use≥ areß thσá synta°á i≤á ver∙ ì
liberal«áá  "A15:**óá mean≤á thσá samσá a≤á "15/A:*.*"¼á a≤á doe≤ ì
"1A5:**"«á  Thσá coloε i≤ absolutel∙ necessary«á  Iµ ßá differen⌠ ì
use≥ areß i≤ desireΣ fo≥ thσ defaul⌠ drive¼á thσ drivσá specifie≥ ì
ma∙á bσá omitted¼á a≤ iε "15:**"¼á jus⌠ a≤ thσ use≥ areßá ma∙á bσ ì
omitteΣ a≤ iε "A:**".

Iµá ßá drive/use≥á specificatioεá i≤ made¼á bu⌠á n∩á filespeπá i≤ ì
indicated¼ ß filespeπ oµ ????????.??┐ i≤ generated«  Thereforσ t∩ ì
indicatσ thσ defaul⌠ drive¼á curren⌠ use≥ area¼ anΣ ß filespeπ oµ ì
????????.???¼ jus⌠ typσ ß coloε b∙ itselµ (e.g.¼ ":"⌐ !


                         NULU OPERATION

Wheεá NUL╒ loads¼á i⌠ automaticall∙ verifie≤ it≤ owεá CRC«á  Thi≤ ì
proces≤á cause≤ ß 2.╡ seconΣ dela∙ oε m∙ 4mh· machine«á  However¼ ì
becausσ oµ thσ safet∙ tha⌠ thi≤ featurσ affords¼á ╔ hopσ tha⌠ yo⌡ ì
wil∞ finΣ i⌠ t∩ bσ ß reassurinτ pause«á  Notσ tha⌠ thσ CR├ i≤ no⌠ ì
affected by normal user patches.

NUL╒á ma∙ bσ invokeΣ witΦ o≥ withou⌠ ß commanΣ tail«á  ┴á commanΣ ì
tai∞ caε consis⌠ oµ an∙ combinatioε oµ valiΣ NUL╒ operator≤ u≡ t∩ ì
12╕á character≤á (thσ limi⌠ imposeΣ b∙ thσá CCP«á  Oncσá NUL╒á i≤ ì
running¼ commanΣ line≤ caε bσ a≤ lonτ a≤ 25┤ characters.)

A≤á iε LU¼á al∞ NUL╒ command≤ arσ precedeΣ b∙ ß dash«á  Thi≤ i≤ ß ì
cop∙ oµ thσ men⌡ fo≥ thσ commanΣ modσ oµ operation:

          -A Add members            -B Brief toggle
          -C Close the library      -D Delete members/files
          -E Extract members        -F Filesweep mode
          -G Get filespec           -H Help
          -K Krunch library         -L List members
          -N Rename members         -O Open a library
          -P Print members/files    -Q Unsqueeze members
          -R Replace members        -S String search
          -T Replace/Add members    -U Drive/User change
          -V View members/files     -W Wildcard open
          -X Exit NULU              -Y Disk directory
          -< Redirect input         -> Redirect output

Command≤á ma∙á bσ strunτ together¼á eacΦ terminateΣ b∙á ßá space«  ì
The∙ arσ processeΣ lef⌠ t∩ right«á  Al∞ character≤ arσá converteΣ ì
t∩ uppe≥ case.
èThσá defaul⌠ drive/use≥ areß arσ displayeΣ alonτ witΦ thσ namσ oµ ì
thσá curren⌠ commanΣ modσ eacΦ timσ thσ consolσ i≤á prompteΣá fo≥ ì
input.

Thσá command≤á wil∞á bσ explaineΣ iε orde≥á oµá thei≥á appearancσ ì
above«áá  Al∞áá item≤á iεá [squarσá brackets▌á indicatσá optiona∞ ì
parameters«á Thσá worΣá "filenameó refer≤ t∩ aε unambiguou≤á filσ ì
specification¼á whilσ thσ terφ "filespecó refer≤ t∩ ß potentiall∙ ì
ambiguou≤á filσ specification«á  Filespeπ parameter≤ encloseΣá iε ì
(parenthesis⌐ indicatσ reference≤ t∩ deleteΣ membe≥ files«  Threσ ì
dot≤ ("..."⌐ afte≥ ß paramete≥ indicatσ infinitσ repetition.

Durinτ thσ executioε oµ mos⌠ command≤ whicΦ receivσ aεá ambiguou≤ ì
filespeπá a≤á ßá parameter¼á enterinτ ß ^├ a⌠á thσá consolσá wil∞ ì
interrupt the current process.


                            COMMANDS

-AáááááááADD MEMBERS
áááááááááSyntax: -a filespec[ filespec...]

áááááááááUsσá thi≤ commanΣ t∩ adΣ file≤ froφ disδ t∩ thσá curren⌠ ì
ááááááááálibrary«á  NUL╒ wil∞ makσ ß serie≤ oµ passe≤ througΦ thσ ì
ááááááááádirectory¼á addinτá file≤ a≤ i⌠ goes¼á unti∞ thσ lis⌠ oµ ì
ááááááááámatchinτá file≤ i≤ exhausted«á  Iµ ßá matchinτá filenamσ ì
áááááááááalread∙á exist≤ a≤ aε activσ membe≥ iε thσ library¼á it≤ ì
ááááááááánamσ wil∞ bσ displayeΣ anΣ thσ filσ wil∞ no⌠ bσ added.

áááááááááIεá al∞ filσ additioε anΣ replacemen⌠ operations¼á iµá ß ì
ááááááááádeleteΣá entr∙á oµ identica∞ sizσ caε bσá located¼á tha⌠ ì
ááááááááádisδ spacσ anΣ director∙ entr∙ wil∞ bσ useΣ rathe≥á thaε ì
áááááááááallocatinτá ne≈ spacσ fo≥ thσ file«á  Thi≤ mean≤ tha⌠ i⌠ ì
áááááááááwil∞á bσá necessar∙ t∩ reclaiφ wasteΣá disδá spacσá les≤ ì
áááááááááoften.

áááááááááAn LU style CRC will be generated for each file added.

-BáááááááBRIEF TOGGLE
áááááááááSyntax: -b

áááááááááThi≤ toggle≤ thσ promptinτ mode«  Thσ releasσ versioε oµ ì
áááááááááNUL╒ i≤ setu≡ t∩ prin⌠ thσ ful∞ namσ oµ thσ curren⌠ modσ ì
áááááááááfo≥á ß prompt¼á a≤ iε "-Add members A0:>"«á  Iµ BRIE╞ i≤ ì
áááááááááturneΣ oε thσ use≥ wil∞ simpl∙ seσ "-┴ A0:>"«á  NUL╒ ma∙ ì
ááááááááábσá permanentl∙ patcheΣ t∩ defaul⌠ t∩ BRIE╞ O╬á o≥á OFF«  ì
áááááááááSeσ NUL╒ MODIFICATION.

-CáááááááCLOSE THE LIBRARY
áááááááááSyntax: -c

áááááááááThi≤á commanΣá close≤ thσ curren⌠ library¼á writinτá it≤ ì
ááááááááádirector∙á t∩ disδ iµ an∙ change≤ havσ beeε madσ t∩á thσ ì
ááááááááádirectory«á  Thσá librar∙á director∙á i≤á NEVE╥á writteε ì
áááááááááexcep⌠ wheε thσ librar∙ i≤ closed¼á s∩ bσ surσ t∩ d∩ it«  ìèáááááááááIµá yo⌡ forge⌠ t∩ d∩ s∩ anΣ removσ thσ disk¼á NUL╒á wil∞ ì
ááááááááápromp⌠á yo⌡á fo≥á thσ disδ agaiεá anΣá wil∞á attemp⌠á t∩ ì
ááááááááárecover.

áááááááááSomσá othe≥ operation≤ tha⌠ causσ thσ curren⌠ librar∙ t∩ ì
ááááááááábσ closeΣ are:
ááááááááá      -k, -o, -w, -x

-DáááááááDELETE MEMBERS/FILES
áááááááááSyntax: -d filespec[ filespec (filespec)...]
         Syntax: -d du:filespec[ du:filespec...]

áááááááááIµ thσ drive/use≥ specificatioε i≤ included¼á thσ DELETE ì
áááááááááfunctioεá wil∞á appl∙á t∩ file≤ oεá disk¼á otherwisσá i⌠ ì
áááááááááapplies to library member files.

áááááááááMembe≥á file≤ matchinτ thσ giveε filespeπ wil∞ bσá giveε ì
ááááááááádeleteΣ statu≤ iε thσ librar∙ directory¼ excep⌠ wheε thσ ì
áááááááááfilespeπá i≤á encloseΣ iεá parenthesis«á  Iεá tha⌠á casσ ì
ááááááááámatchinτá deleteΣá member≤ wil∞ bσ giveε activσá status«  ì
áááááááááTha⌠ is¼á the∙ wil∞ bσ undeleted«á  Iµ thσ filenamσ oµ ß ì
ááááááááámatchinτ deleteΣ membe≥ filσ alread∙ exist≤ a≤ aε activσ ì
ááááááááámember¼ thσ filenamσ wil∞ bσ displayeΣ anΣ thσ filσ wil∞ ì
áááááááááno⌠ bσ undeleted.

áááááááááIµá thσá membe≥ filσ beinτ deleteΣ ha≤ ßá sizσá oµá zer∩ ì
ááááááááásectors¼á it≤á entr∙á wil∞ bσ entirel∙ REMOVE─ froφá thσ ì
ááááááááálibrary directory, thereby creating a new, free entry.

-EáááááááEXTRACT MEMBERS
áááááááááSyntax: -e filespec[=newfilespec filespec du:filespec...]

áááááááááUsσá thi≤ commanΣ t∩ extrac⌠ activσá membe≥á files«á  Iµ ì
áááááááááextractioε t∩ thσ curren⌠ drive/use≥ areß i≤ desired¼ n∩ ì
áááááááááfurthe≥ synta° i≤ necessary«  T∩ indicatσ anothe≥ drive¼ ì
áááááááááhowever¼á ß destinatioε drive/use≥ areß ma∙ bσá includeΣ ì
áááááááááin the source filespec.  Example:

ááááááááá-e a5:**

áááááááááwoulΣá extrac⌠ al∞ activσ member≤ t∩ drivσ A¼á use≥ areß ì
ááááááááá5«á  File≤á ma∙á bσá renameΣ a≤ wel∞á a≤á redirecteΣá b∙ ì
áááááááááindicatinτá ß filespeπ alonτ with¼á o≥ iεá placσá of¼á ß ì
ááááááááádrivσá use≥á specificatioεá followinτá aεá equal≤á sign«  ì
áááááááááExamples:

ááááááááá1.  -e *asm=*bak
ááááááááá2.  -e *asm=5:*txt
ááááááááá3.  -e fred.txt=sam.txt jane.inf=c8:girls.dbf

áááááááááThσ example≤ woulΣ producσ thσ followinτ results:

ááááááááá1«  Extrac⌠ al∞ file≤ witΦ ß typσ oµ .AS═ t∩ thσ defaul⌠ ì
ááááááááádrive/use≥ renaminτ theφ witΦ thσ filetypσ oµ .BAK.
ááááááááá2«  Extrac⌠ al∞ file≤ oµ typσ .AS═ t∩ use≥ areß ╡ oµ thσ ìèááááááááádefaul⌠ drive¼ renaminτ eacΦ witΦ thσ .TXT filetype.
ááááááááá3«á  Extrac⌠á thσá membe≥ filσ FRED.TX╘ t∩á thσá defaul⌠ ì
ááááááááádrive/use≥á unde≥ thσ namσ oµ SAM.TXT¼á anΣ extrac⌠á thσ ì
ááááááááámembe≥ filσ JANE.IN╞ t∩ use≥ areß ╕ oµ drivσ C║ witΦ thσ ì
áááááááááfilenamσ GIRLS.DBF.

áááááááááThσá tw∩á redirectioεá rule≤ t∩ remembe≥ are║á 1⌐á iµá ß ì
ááááááááádestinatioεá filespeπ i≤ entereΣ i⌠ canno⌠ bσá an∙á les≤ ì
áááááááááambiguou≤ thaε thσ sourcσ filespec¼ i.e.¼ "*asm=*bakó i≤ ì
ááááááááávaliΣ whilσ "**=*bakó i≤ no⌠ valid╗á anΣ 2⌐ an∙ filespeπ ì
áááááááááfollowinτá aεá equal≤á sigε take≤á precedencσá ove≥á an∙ ì
ááááááááádrive/use≥á specificatioε iε thσ sourcσ filespec¼á i.e.¼ ì
ááááááááá"-σá 6:*asm=*bakó woulΣ extrac⌠ al∞ membe≥ file≤ t∩á thσ ì
ááááááááácurren⌠ drive/user¼á renaminτ them¼ anΣ woulΣ ignorσ thσ ì
ááááááááá"6:" specification.

áááááááááDurinτá extraction¼á ß CR├ i≤ generateΣ fo≥á eacΦá file«  ì
áááááááááAfte≥á thσ destinatioε filσ ha≤ beeε closed¼á thσ CR├ s∩ ì
ááááááááágenerateΣ i≤ compareΣ t∩ thσ CR├ fo≥ tha⌠ librar∙ membe≥ ì
ááááááááátha⌠ wa≤ storeΣ iε thσ librar∙ directory¼á iµ tha⌠ valuσ ì
áááááááááwa≤á non-zero«á  Iµ thσ result≤ arσá no⌠á identical¼á aε ì
áááááááááerro≥á messagσ wil∞ bσ displayeΣ beforσ thσ nex⌠á membe≥ ì
áááááááááfilσá o≥á filespeπá wil∞ bσá processed«á  Thσá erroneou≤ ì
ááááááááádestinatioεá filσ wil∞ no⌠ bσ deleteΣ froφ disδ b∙á NUL╒ ì
áááááááááa≤ ß resul⌠ oµ thi≤ error.

-FáááááááFILESWEEP MODE
áááááááááSyntax: -f

áááááááááThi≤ commanΣ place≤ NUL╒ iε it≤ seconΣ operationa∞ mode║ ì
áááááááááthσá fileswee≡á mode«á  Thi≤á allow≤ thσá use≥á t∩á movσ ì
áááááááááthrougΦ thσ director∙ oµ activσ membe≥ file≤ a≤ iµá the∙ ì
áááááááááwerσá individua∞ file≤ beinτ examineΣ b∙ ß prograφá likσ ì
áááááááááNSWEEP«áá  Thσá fileswee≡á mode'≤á commanΣá lis⌠á i≤á a≤ ì
áááááááááfollows:

áááááááááA Next member              B Previous member
áááááááááC Close library            D Delete member
áááááááááE Extract member           F Find member
áááááááááL Log new drive/user       M Mass operations
áááááááááO Open new library         P Print member
áááááááááQ Unsqueeze member         R Rename member
áááááááááT Tag member               U Untag member
áááááááááV View member              W Wildcard rename
áááááááááX Exit NULU                Y Disk directory
áááááááááZ NULU command mode        ? Help!

áááááááááBecausσ oµ thσ extremσ similarit∙ betweeε thesσ command≤ ì
áááááááááanΣá thσ command≤ oµ NULU'≤ commanΣ mode¼á onl∙ ßá shor⌠ ì
ááááááááádescriptioεá oµá eacΦ commanΣ wil∞ bσá giveε.

ááááááááá┴  --  Advancσ t∩ nex⌠ member
ááááááááá       (spacebar¼á cr¼á o≥á lµá wil∞á producσá thσá samσ ì
ááááááááááááááááresult)
ááááááááá┬  --  Bacδ u≡ t∩ previou≤ memberèááááááááá├  --  Closσ thσ curren⌠ library
ááááááááá─  --  Deletσ curren⌠ membe≥ file
ááááááááá┼áá--  Extrac⌠ácurren⌠ámembe≥áfilσ
ááááááááá       (promp⌠ allow≤ redirection)
áááááááááF  --  Find first member matching input filespec
ááááááááá╠  --  Change drive/user defaults
ááááááááá       (return≤ filσ pointe≥ t∩ thσ to≡ oµ thσ filσ lis⌠ ì
ááááááááá       and untags all member files)
áááááááááM  --  Mass operations on all tagged files
ááááááááá       (allow≤ááá Deletion¼áááá Extraction¼ááá Printing¼ ì
ááááááááááááááááUnsqueezing¼ or Viewing)
áááááááááO  --  Open new library (closes the current library)
ááááááááá╨  --  Dump≤ thσ curren⌠ membe≥ filσ t∩ LST║
ááááááááááááááá (unsqueeze≤ iµ needed)
ááááááááá╤á --  Extrac⌠á curren⌠á membe≥á file¼áá unsqueezinτá iµ
áááááááááááááááánecessar∙ (promp⌠ allow≤ redirection)
áááááááááR  --  Rename current member file
áááááááááT  --  Tag current member
ááááááááá╒  --  Untag current member
ááááááááá╓  --  Vie≈ curren⌠ membe≥ filσ (unsqueeze≤ iµ needed)
ááááááááá╫á --  WildcarΣá renamσ (prompt≤ fo≥áoldnamσá& newname)
áááááááááX  --  Exit NULU (closes all files)
áááááááááY  --  Get disk directory for default drive/user
ááááááááá       (return≤ filσ pointe≥ t∩ thσ to≡ oµ thσ filσ lis⌠ ì
ááááááááá       and untags all member files)
ááááááááá┌á --  Returεá t∩ NUL╒ commanΣá modσ
ááááááááá       (curren⌠álibrar∙ remain≤ open)
ááááááááá?  --  Print the filesweep mode menu

áááááááááIf¼á wheεá thσá fileswee≡ modσ i≤ entered¼á o≥á afte≥á ß ì
ááááááááálibrar∙á ha≤á beeεá closed¼áá therσá i≤á no⌠á ßá librar∙ ì
ááááááááácurrentl∙ open¼ thσ fileswee≡ modσ wil∞ promp⌠ with:

áááááááááNo library open.

áááááááááand will accept only the following commands:

áááááááááL,O,X,Y,Z,?

áááááááááLikewise¼á iµ ß librar∙ i≤ opeε bu⌠ onl∙ ha≤ ß director∙ ì
áááááááááwitΦ n∩ othe≥ activσ members¼ thσ message

áááááááááNo member files.

áááááááááwil∞ bσ printeΣ anΣ onl∙ thσ command≤ listeΣ above wil∞ ì
ááááááááábe accepted.

áááááááááDurinτ fileswee≡ operation¼á eacΦ filσ wil∞ bσ listeΣ iε ì
áááááááááthσá orde≥ iε whicΦ i⌠ i≤ founΣ iε thσ directory¼á alonτ ì
áááááááááwitΦ thσ sizσ iε ╦ tha⌠ thσ filσ woulΣ occup∙ iµ i⌠ werσ ì
áááááááááextracteΣ t∩ thσ defaul⌠ drive.

áááááááááIµá thσ fileswee≡ modσ i≤ terminateΣ b∙ ß returε t∩á thσ ì
áááááááááNUL╒á commanΣá mode¼á an∙ command≤ tha⌠ followeΣ thσá -╞ ì
ááááááááácommanΣá oεá thσá previou≤ NUL╒á commanΣá linσá wil∞á bσ ìèáááááááááexecuted.

-GáááááááGET FILESPEC
áááááááááSyntax: -g filespec

áááááááááNUL╒á wil∞ searcΦ fo≥ thσ filespeπ indicated«á  Iµ i⌠ i≤ ì
áááááááááfound¼á processinτá continues«á  Iµá not¼á thσá use≥á i≤ ì
áááááááááprompteΣá t∩ inser⌠ thσ disδ containinτá tha⌠á filespec«  ì
áááááááááThσá drivσ i≤ theε rese⌠ anΣ searcΦ again«á  Thσ prograφ ì
áááááááááwil∞á promp⌠á foreve≥á unti∞á i⌠á receive≤á thσáá prope≥ ì
áááááááááfilespeπá o≥á unti∞á ß ^├ i≤ entered¼á forcinτá NUL╒á t∩ ì
ááááááááácontinuσ withou⌠ thσ filespeπ beinτ found.

áááááááááThi≤á commanΣ caε bσ usefu∞ wheε attemptinτá t∩á contro∞ ì
áááááááááNUL╒á througΦá ß submi⌠ utilit∙ likσá DRI'≤á SUBMIT.COM«  ì
áááááááááFor example, one might type:

ááááááááánulu -o a:asm -g b5:-work.005 -e b10: -g a0:-5.005 -x

áááááááááAfte≥ loading¼á NUL╒ woulΣ opeε ß librar∙ calleΣ ASM.LB╥ ì
áááááááááoεá drivσ A║á iε thσ curren⌠ use≥ area«á  Nex⌠ i⌠á woulΣ ì
ááááááááásearcΦá use≥ areß ╡ oµ drivσ B║á fo≥ filespeπá -WORK.00╡ ì
áááááááááunti∞á i⌠á wa≤á found«á  Theε al∞á activσá membe≥á file≤ ì
áááááááááwoulΣá bσá extracteΣá t∩á use≥á areßá 1░á oµá drivσá B:«  ì
áááááááááFinally¼ NUL╒ woulΣ searcΦ use≥ areß ░ oµ drivσ A║ fo≥ ß ì
áááááááááfilespeπá calleΣá -5.00╡ unti∞ found«á Theεá NUL╒á woulΣ ì
áááááááááterminate«á Noticσ herσ tha⌠ thσ ASM.LB╥ didn'⌠ havσá t∩ ì
ááááááááábσá closeΣá beforσá thσ searcΦ fo≥á thσá fina∞á filespeπ ì
ááááááááábecausσáá n∩á changσá haΣá beeεá madσá t∩á thσáá librar∙ ì
ááááááááádirectory«á  Iµá ß changσ haΣ beeε made¼á afte≥ thσá ne≈ ì
áááááááááfilespeπ haΣ beeε loaded¼á NUL╒ woulΣ havσ demandeΣá thσ ì
ááááááááádisδ witΦ ASM.LB╥ bacδ s∩ i⌠ coulΣ updatσ thσ directory«  ì
áááááááááThereforσáá thσá GE╘á operatioεá woulΣá bσáá effectivel∙ ì
ááááááááánegated.ì

-HáááááááHELP
áááááááááSyntax: -h

áááááááááPrint the command mode menu.

-KáááááááKRUNCH LIBRARY
áááááááááSyntax: -k[ <number of entries to allow]

áááááááááEveεá thougΦ al∞ member≤ arσ kep⌠ iε alphabetica∞á orde≥ ì
áááááááááa⌠ al∞ times¼ wheε ß membe≥ i≤ deleteΣ thσ disδ spacσ i⌠ ì
áááááááááoccupie≤á i≤ no⌠ releaseΣ t∩ thσ operatinτ systeφá unti∞ ì
áááááááááthσ KRUNC╚ commanΣ i≤ executed«á  KRUNC╚ consist≤ oµ thσ ì
áááááááááfollowing steps:

ááááááááá1«á   Iµá ß filσ oµ thσ samσ namσ a≤ thσ librar∙ alread∙ ì
áááááááááexist≤á iε thσ defaul⌠ drive/use≥ areß AN─á THEá LIBRARY ì
áááááááááFIL┼á ORIGINATE╙ FRO═ ┴ DIFFEREN╘ DRIVE/USER¼á ß messagσ ì
áááááááááindicatinτá tha⌠ thσ filσ exist≤ wil∞ bσá displayeΣá anΣ ì
áááááááááthσ KRUNC╚ commanΣ wil∞ bσ skipped«  Yo⌡ mus⌠ deletσ thσ ì
áááááááááoffendinτá filσá o≥á changσ drive/use≥ areßá beforσá thσ ìèáááááááááKRUNCH can be effected.
ááááááááá2«   Thσ librar∙ i≤ closed.
ááááááááá3«á  ┴ ne≈ librar∙ calleΣ WORK-LBR.$$ñ i≤ openeΣ iεá thσ ì
ááááááááádefaul⌠á drive/use≥á areßá anΣ thσ use≥ i≤á prompteΣá t∩ ì
áááááááááinpu⌠ thσ numbe≥ oµ file≤ tha⌠ thσ ne≈ librar∙ shoulΣ bσ ì
áááááááááablσ t∩ contain«á  Iµ thσ use≥ want≤ jus⌠ enougΦ entrie≤ ì
ááááááááát∩ contaiε thσ currentl∙ activσ members¼ thσ numbe≥ ▒ o≥ ì
áááááááááan∙á numbe≥ les≤ thaε o≥ equa∞ t∩ thσ curren⌠ numbe≥á oµ ì
áááááááááactivσá entrie≤á ma∙á bσá entered«áá  Iµá thσáá optiona∞ ì
áááááááááparamete≥á listeΣ abovσ i≤ entered¼á i⌠ wil∞ bσ useΣá a≤ ì
áááááááááthσá numbe≥á oµá entries«á  (Thσ KRUNC╚ proces≤á ma∙á bσ ì
áááááááááaborteΣá herσ b∙ typinτ RETUR╬ o≥ 0«á  Pleasσ notσá tha⌠ ì
áááááááááthσá librar∙á director∙á count≤ a≤á aεá entr∙á anΣá wil∞ ì
áááááááááautomaticall∙ bσ accounteΣ fo≥ b∙ NULU.)
ááááááááá4«á   Oncσá WORK-LBR.$$ñ i≤ opened¼á thσá activσá membe≥ ì
áááááááááfile≤á froφá thσ origina∞ librar∙ wil∞ bσ copieΣ onσá b∙ ì
áááááááááonσá int∩á thσá ne≈ library«á Thσ cop∙á routinσá use≤á ß ì
ááááááááárecursivσá proces≤ t∩ cop∙ a≤ man∙ file≤ a⌠ onσ timσá a≤ ì
ááááááááápossible«á ┴ CR├ i≤ calculateΣ fo≥ eacΦ membe≥ a≤ i⌠á i≤ ì
ááááááááácopied«á  Iµ thi≤ numbe≥ doe≤ no⌠ matcΦ thσ CR├ recordeΣ ì
áááááááááiε thσ origina∞ librar∙ directory¼ thσ message:

áááááááááCRC ERROR-Continue? (y/n)

áááááááááwil∞ appea≥ afte≥ thσ filenamσ iε question«á ┴ repl∙á oµ ì
ááááááááá"Nóá wil∞á resul⌠ iε thσ worδ librar∙ beinτ deleteΣá anΣ ì
áááááááááthσá origina∞ librar∙ beinτá re-opened«á  Otherwisσá thσ ì
ááááááááánewl∙á generateΣ CR├ fo≥ thσ filσ wil∞ bσ storeΣ iεá thσ ì
ááááááááádirectory of the new library.
ááááááááá5«á  Thσá olΣá librar∙ i≤ deleteΣá anΣá WORK-LBR.$$ñá i≤ ì
ááááááááárenameΣ witΦ thσ olΣ librar∙ name.

áááááááááExamples:
ááááááááá1.  -k
ááááááááá2.  -k <1
ááááááááá3.  -u b5: -k <63
ááááááááá4.  -u b5: -k <1 -u a0: -k <63

áááááááááThe above examples would produce the following results:

ááááááááá1«á  Thσá librar∙á woulΣá bσá KRUNCHeΣá t∩á thσá defaul⌠ ì
ááááááááádrive/use≥á area«á  Thσ use≥ woulΣ bσ prompteΣ t∩á inpu⌠ ì
áááááááááthe number of entries to allow.
ááááááááá2«á  Thσá librar∙á woulΣá bσá KRUNCHeΣá t∩á thσá defaul⌠ ì
ááááááááádrive/use≥á areß witΦ jus⌠ enougΦ entrie≤ t∩ contaiε al∞ ì
ááááááááácurrently active member files.
ááááááááá3«á  Thσ defaul⌠ drive/use≥ areß woulΣ bσ changeΣ t∩ B5║ ì
ááááááááábeforσá thσá KRUNC╚ begins«á  Theε thσ librar∙ woulΣá bσ ì
áááááááááKRUNCHed¼ allowinτ 6│ entries.
ááááááááá4«á  Thσ defaul⌠ drive/use≥ areß woulΣ bσ changeΣ t∩ B5║ ì
ááááááááábeforσá thσá KRUNC╚ begins«á Thσ KRUNC╚ woulΣá commence¼ ì
áááááááááallowinτá onl∙á enougΦá entrie≤ t∩á contaiεá al∞á activσ ì
ááááááááámembers«á  Thσ drive/use≥ areß woulΣ bσ changeΣ t∩á A0:« ì
áááááááááTheεá thσ librar∙ woulΣ bσ KRUNCHeΣ again¼á allowinτá 6│ ì
áááááááááentries.è
-LáááááááLIST MEMBERS
áááááááááSyntax: -l[ filespec]
áááááááááSyntax: -l[ (filespec)]

áááááááááUsσá thi≤á commanΣ t∩ lis⌠ thσ content≤ oµá thσá librar∙ ì
ááááááááádirectory«á  EacΦá membe≥ filenamσ wil∞ printeΣ followeΣ ì
áááááááááb∙á thσ startinτ relativσ secto≥ numbe≥ iεá thσá librar∙ ì
áááááááááfile¼á thσ sizσ oµ thσ membe≥ iε sectors¼á thσ sizσ iε ╦ ì
ááááááááátha⌠ thσ filσ woulΣ occup∙ iµ i⌠ werσ t∩ bσ extracteΣ t∩ ì
áááááááááthσá defaul⌠ drive/use≥ area¼á anΣ thσ CR├ fo≥ thσ file«  ì
áááááááááFinally¼á ß reca≡ oµ thσ sizσ oµ al∞ membe≥ file≤ listeΣ ì
ááááááááái≤ printed¼ alonτ witΦ thσ numbe≥ oµ sector≤ occupieΣ b∙ ì
ááááááááádeleteΣ files.

áááááááááThσá parameter≤ listeΣ abovσ caε bσ useΣ t∩ contro∞á thσ ì
áááááááááselection of files for display.  Examples:

ááááááááá1.  -l
ááááááááá2.  -l **
ááááááááá3.  -l (**)
ááááááááá4.  -l *asm
ááááááááá5.  -l (fred.txt)

áááááááááThe above examples would produce the following results:

ááááááááá1.  All active member files listed.
ááááááááá2.  All active member files listed.
ááááááááá3.  All deleted member files listed.
ááááááááá4«á Al∞á activσá membe≥ file≤  matchinτ thσ filespeπá oµ ì
ááááááááá????????.ASM listed.
ááááááááá5«á  Al∞á deleteΣ membe≥ file≤ calleΣá FRED.TX╘á listed«  ì
ááááááááá(Notσá tha⌠ i≤ I╙ possiblσ t∩ havσ morσ thaε onσ deleteΣ ì
áááááááááfile with the same name.)

-NáááááááRENAME MEMBERS
áááááááááSyntax: -n oldfilespec=newfilespec[...]
áááááááááSyntax: -n (oldfilespec)=newfilespec[...]

áááááááááThi≤á commanΣ i≤ useΣ t∩ renamσ activσ o≥ deleteΣ membe≥ ì
áááááááááfiles«áá  Wildcard≤áá arσá full∙á supported¼áá bu⌠áá thσ ì
ááááááááánewfilespeπáá caεáá bσá n∩á les≤á ambiguou≤áá thaεáá thσ ì
áááááááááoldfilespec«áá  DeleteΣáá member≤á ma∙á bσá renameΣáá b∙ ì
áááááááááenclosinτáá thσáá oldfilespeπáá ONL┘áá iεáá parenthesis«  ì
áááááááááExamples:

ááááááááá1.  -n *asm=*bak
ááááááááá2.  -n (fred.txt)=sam.txt
ááááááááá3.  -n **=**

áááááááááThe above examples would produce the following results:

ááááááááá1«áá  Al∞áá activσáá member≤áá matchinτáá thσáá filespeπ ì
ááááááááá????????.ASM would be renamed with a filetype of .BAK.
ááááááááá2«á  Thσ firs⌠ deleteΣ membe≥ filσ calleΣ FRED.TX╘ woulΣ ìèááááááááábσ renameΣ t∩ SAM.TXT«á  Al∞ othe≥ member≤ matchinτ tha⌠ ì
áááááááááfilespeπ woulΣ bσ listeΣ alonτ witΦ ß messagσ indicatinτ ì
áááááááááthat they could not be renamed.
ááááááááá3«  Al∞ activσ membe≥ file≤ woulΣ bσ listed¼ eacΦ witΦ ß ì
ááááááááámessagσá indicatinτá tha⌠á the∙á coulΣá no⌠á bσá renameΣ ì
ááááááááábecause the name already exists.


-OáááááááOPEN A LIBRARY
áááááááááSyntax: -o filename[ <number of entries to allow]

áááááááááWitΦáá thσá exceptioεá oµá thσá fileswee≡á Opeεá Librar∙ ì
ááááááááácommand¼á thi≤á i≤ thσ onl∙ methoΣ t∩ opeε o≥á creatσá ß ì
ááááááááálibrary«á  NUL╒á wil∞ searcΦ fo≥ thσ filenamσ indicated«  ì
áááááááááIµ i⌠ i≤ found¼á i⌠ wil∞ bσ openeΣ anΣ ß messagσ wil∞ bσ ì
ááááááááádisplayeΣá indicatinτá thσá sizσ oµá thσá Datßá Transfe≥ ì
áááááááááBuffer«á  Thi≤á i≤ thσ numbe≥ oµ sector≤ iε memor∙á tha⌠ ì
áááááááááNUL╒ wil∞ havσ t∩ usσ iε extracting¼á addinτ o≥á copyinτ ì
ááááááááámembe≥ files.

áááááááááIµ thσ filσ i≤ no⌠ found¼á thσ use≥ wil∞ bσ prompteΣ fo≥ ì
áááááááááthσá numbe≥ oµ entrie≤ t∩ allo≈ iε thσ ne≈ library«á  Iµ ì
áááááááááthσ optiona∞ paramete≥ abovσ i≤ passed¼á thσ numbe≥ wil∞ ì
ááááááááábσ useΣ t∩ determinσ thσ director∙ sizσ oµ thσá library«  ì
áááááááááAl∞á directorie≤ caε contaiε somσ multiplσ oµ ┤ entries«  ì
áááááááááAl∞á number≤á inpu⌠ wil∞ bσ roundeΣ u≡á t∩á thσá neares⌠ ì
ááááááááámultiplσá oµá 4«á  Remembe≥á tha⌠ thσá director∙á itselµ ì
ááááááááácount≤á a≤á onσ entr∙ anΣ tha⌠ NUL╒á wil∞á automaticall∙ ì
ááááááááámakσ spacσ fo≥ it.

áááááááááThe filename passed must be unambiguous.

áááááááááNOTE ON DIRECTORY SIZE:
áááááááááDependinτ oε availablσ memory¼ librarie≤ witΦ a≤ man∙ a≤ ì
ááááááááá80░á entrie≤ (theoretically⌐ caε bσ opened«á  Bu⌠á watcΦ ì
áááááááááthσ Datß Buffe≥ Sizeíá  Iµ i⌠ i≤ les≤ thaε ╣ sector≤ yo⌡ ì
áááááááááwil∞ no⌠ bσ ablσ t∩ unsqueezσ an∙ files« WitΦ ß use≥ TP┴ ì
áááááááááoµ 58k¼á ╔ havσ beeε ablσ t∩ opeε librarie≤ witΦ n∩ morσ ì
áááááááááthaεá 58┤ tota∞ member≤ anΣ stil∞ bσ lef⌠ witΦ ßá buffe≥ ì
áááááááááoµá ╣á sectors«á  (Seσá -╝ commanΣ anΣá ho≈á i⌠á affect≤ ì
ááááááááálibrar∙ memory.)

-PáááááááPRINT MEMBERS/FILES
áááááááááSyntax: -p filespec[ filespec (filespec)...]
áááááááááSyntax: -p du:filespec[ du:filespec...]

áááááááááIµ thσ drive/use≥ specificatioε i≤ included¼á thσá PRIN╘ ì
áááááááááfunctioεá wil∞á appl∙á t∩ file≤ oεá disk¼á otherwisσá i⌠ ì
áááááááááapplie≤ t∩ librar∙ membe≥ files.

áááááááááWitΦ thi≤ command¼á thσ asciΘ content≤ oµ file≤ matchinτ ì
áááááááááthσá filespec≤ giveε wil∞ bσ dumpeΣ t∩ thσ lis⌠á device«  ì
áááááááááIµá thσá filσá i≤á squeezed¼á NUL╒á wil∞á unsqueezσá it«  ì
áááááááááDeleteΣá librar∙ member≤ ma∙ bσ listeΣ b∙ enclosinτá thσ ì
áááááááááappropriatσ filespeπ iε parenthesis.è
-QáááááááUNSQUEEZE MEMBERS
áááááááááSyntax: -q filespec[=newfilespec filespec...]

áááááááááThi≤ commanΣ i≤ identica∞ iε operatioε anΣ synta° t∩ thσ ì
áááááááááEXTRAC╘ command¼ excep⌠ tha⌠ iµ thσ matchinτ member≤ arσ ì
ááááááááásqueezed, they will be unsqueezed.

-RáááááááREPLACE MEMBERS
áááááááááSyntax: -r filespec[ filespec...]

áááááááááThi≤ commanΣ i≤ identica∞ iε operatioε anΣ synta° t∩ thσ ì
áááááááááAD─ command¼ excep⌠ tha⌠ matchinτ file≤ wil∞ bσ addeΣ t∩ ì
áááááááááthσá librar∙ ONL┘ iµ the∙ alread∙ exis⌠ iε thσá library«  ì
áááááááááThey will be deleted, then the new files will be added.

-S       STRING SEARCH
áááááááááSyntax: -s filespec "string to search for"
áááááááááSyntax: -s du:filespec "string to search for"

áááááááááIµ thσ drive/use≥ specificatioε i≤ included¼á thσ SEARC╚ ì
áááááááááfunctioεá wil∞á appl∙á t∩ file≤ oεá disk¼á otherwisσá i⌠ ì
áááááááááapplie≤ t∩ librar∙ membe≥ files.

áááááááááThi≤á provide≤ ß wa∙ t∩ d∩ ß SIMPL┼ searcΦ fo≥á ßá giveε ì
ááááááááástrinτ amonτ ß grou≡ oµ files«  Iµ thσ "strinτ t∩ searcΦ ì
áááááááááforó i≤ founΣ yo⌡ wil∞ bσ notified«á  Al∞ file≤ searcheΣ ì
áááááááááarσ listed«á  Thσ individua∞ linσ oε whicΦ thσ iteφá wa≤ ì
ááááááááámatcheΣá i≤ no⌠ displayeΣ becausσ thσ matcΦ i≤ no⌠á madσ ì
áááááááááoε ß linσ basis«á  Tha⌠ is¼ yo⌡ ma∙ searcΦ .CO═ file≤ o≥ ì
ááááááááásqueezeΣá .OV╥á file≤ jus⌠ a≤ easil∙ a≤á searchinτá tex⌠ ì
áááááááááfiles«  However¼ thσ implementatioε i≤ admittedl∙ rathe≥ ì
áááááááááweaδ a⌠ thi≤ poin⌠ a≤ thing≤ likσ contro∞ character≤ anΣ ì
ááááááááátab≤á arσá rippeΣá ou⌠ oµ thσ commanΣá linσá beforσá thσ ì
ááááááááásearcΦá functioεá eveε see≤ thσ command«á  Enjo∙ i⌠á anΣ ì
áááááááááI'll improve it later.

-TáááááááREPLACE/ADD MEMBERS
áááááááááSyntax: -t

áááááááááThi≤ commanΣ i≤ ß combinatioε oµ thσ AD─ anΣ thσ REPLAC┼ ì
ááááááááácommands«á  Iµá thσá file≤ d∩ no⌠ exis⌠ iε thσá library¼ ì
áááááááááthe∙á wil∞ bσ added«á  Iµ the∙ d∩ exist¼á the∙á wil∞á bσ ì
áááááááááreplaced.

-UáááááááDRIVE/USER CHANGE
áááááááááSyntax: -u new drive/user

áááááááááUsσá thi≤ commanΣ t∩ changσ thσ defaul⌠ drive/use≥ area«  ì
áááááááááA colon (":") must follow the drive/user spec.  Example:

ááááááááá-u a5:

áááááááááwould switch the default drive/user area to A5:.
è-VáááááááVIEW MEMBERS/FILES
áááááááááSyntax: -v filespec[ filespec (filespec)...]
áááááááááSyntax: -v du:filespec[ du:filespec...]

áááááááááIµá thσ drive/use≥ specificatioε i≤ included¼á thσá VIE╫ ì
áááááááááfunctioεá wil∞á appl∙á t∩ file≤ oεá disk¼á otherwisσá i⌠ ì
áááááááááapplie≤ t∩ librar∙ membe≥ files.

áááááááááThi≤á commanΣ wil∞ lis⌠ thσ asciΘ content≤ oµ al∞á file≤ ì
ááááááááámatchinτá thσá giveεá filespeπ t∩á thσá consolσá device«  ì
áááááááááDeleteΣá librar∙á member≤ ma∙ bσ indicateΣ b∙á enclosinτ ì
áááááááááthσ filespeπ iε parenthesis«  Iµ thσ file≤ arσ squeezed¼ ì
áááááááááthe∙ wil∞ bσ unsqueezed«  A⌠ eacΦ page¼ NUL╒ wil∞ accep⌠ ì
áááááááááonσ  oµ thσ followinτ commands:

ááááááááá1.  ^X to skip to the next matching file
ááááááááá2.  ^C to abort further listing
ááááááááá3.  L to list one line
ááááááááá4.  CR, space, or LF to list another full page

áááááááááA⌠á thσá enΣá oµ eacΦ filσá thσá messagσ

ááááááááá "Pres≤ RETURNó

áááááááááwil∞á bσá displayeΣ anΣ NUL╒ wil∞ wai⌠ fo≥á ßá keystrokσ ì
ááááááááábeforσ movinτ t∩ thσ nex⌠ matchinτ file.

-W       WILDCARD OPEN
áááááááááSyntax: -w filespec commands to process

áááááááááFor advanced users only.

áááááááááThi≤á caε bσ onσ oµ thσ mos⌠ powerful¼á anΣ possibl∙ thσ ì
ááááááááámos⌠á dangerous¼á oµ al∞ NUL╒ commands«á  I⌠ allow≤á thσ ì
áááááááááuse≥á t∩ specif∙ ß grou≡ oµ librarie≤ oε whicΦ t∩ le⌠á ß ì
áááááááááse⌠ oµ command≤ operate«  ┴ simplσ example:

ááááááááá-w a5:*lbr -l

áááááááááwoulΣ opeε al∞ file≤ founΣ oε drivσ ┴ iε use≥ areß ╡á a≤ ì
ááááááááálibrarie≤á anΣá lis⌠ thσ content≤ oµ each«á  Thi≤á woulΣ ì
áááááááááhappeεá iε sequencσ fo≥ al∞ matchinτ file≤ iε thσá orde≥ ì
áááááááááiεá whicΦ the∙ werσ founΣ iε thσ directory«á  Notσá tha⌠ ì
áááááááááthi≤á commanΣá ha≤á thσ samσ effec⌠ a≤á thσá -╧á commanΣ ì
áááááááááexcep⌠ tha⌠ i⌠ processe≤ wildcarΣ librar∙ filespec≤á anΣ ì
ááááááááátha⌠á thσá user'≤á contro∞ ove≥ eacΦ librar∙á openeΣá i≤ ì
ááááááááálimiteΣ t∩ thσ singlσ linσ tha⌠ invoke≤ thσ -╫á command«  ì
áááááááááTha⌠á is¼á al∞ command≤ applyinτ t∩ eacΦ librar∙á openeΣ ì
ááááááááámus⌠ bσ contained oε thσ onσ commanΣ line.

áááááááááThσá adven⌠á oµ thi≤ commanΣ i≤ thσ reasoε tha⌠á certaiε ì
ááááááááácommand≤á tha⌠ useΣ t∩ bσ restricteΣ t∩ NC╞á redirectioε ì
áááááááááfile≤ arσ no≈ availablσ a⌠ thσ commanΣ level«  Takσ thi≤ ì
áááááááááexample:
èááááááááá-w *lbr -k <5 -p ** -l -' "hit enter for next file " -:

áááááááááTha⌠á commanΣá woulΣá resul⌠ iε thσ followinτá fo≥á eacΦ ì
ááááááááámatching file:
ááááááááá1)  The library would be KRUNCHed to 5 members.
ááááááááá2)  All member files would be sent to LST:.
ááááááááá3)  The library directory would be listed.
ááááááááá4⌐á Thσ prompt¼á "PRES╙ ENTE╥ FO╥ NEX╘ FIL┼ óá woulΣá bσ ì
ááááááááádisplayeΣ t∩ CON:
ááááááááá5⌐á NUL╒ woulΣ wai⌠ fo≥ thσ use≥ t∩ pres≤ RETUR╬á beforσ ì
ááááááááápassinτ contro∞ bacδ t∩ -╫ whicΦ woulΣ theε d∩ thσá samσ ì
áááááááááthing for the next library.

áááááááááUsσ ß lo⌠ oµ cautioε wheε usinτ thi≤ command«  I⌠ i≤ ne≈ ì
áááááááááeveε t∩ me¼á bu⌠ ╔ havσ founΣ i⌠ t∩ bσ EXTREMEL┘ useful«  ì
áááááááááI really like this one:

ááááááááá-w *lbr -f

áááááááááwhicΦá allow≤á mσ t∩ looδ a⌠ ß lo⌠ oµ librarie≤á througΦ ì
áááááááááfilesweep without having to know their names.

áááááááááI have tried something like this:

ááááááááá-w *lbr -< command.ncf

ááááááááábu⌠ witΦ ver∙ disappointinτ results«á  I⌠ doesn'⌠á work«  ì
ááááááááá╔á wil∞ worδ oε tha⌠ fo≥ nex⌠ time¼á iµ therσ i≤ ßá nex⌠ ì
ááááááááátime.

-XáááááááEXIT NULU
áááááááááSyntax: -x

áááááááááThi≤á commanΣ wil∞ se⌠ ß flaτ indicatinτ tha⌠á wheεá thσ ì
ááááááááácurren⌠á NUL╒á commanΣ linσ i≤á exhausted¼á NUL╒á shoulΣ ì
áááááááááterminate«  Bu⌠ thσ commanΣ i≤ actuall∙ ß toggle«  Iµ i⌠ ì
ááááááááái≤á entereΣá twicσá oε ß linσ thσ effec⌠ oµá thσá seconΣ ì
áááááááááissuancσá wil∞á bσ t∩ negatσ thσ first«á  Notσ tha⌠á thσ ì
ááááááááásuppor⌠áá fo≥áá commanΣá chaininτá ha≤áá beeεáá removed«  ì
áááááááááExamples:

ááááááááá1.  -x
ááááááááá2.  -x -x

áááááááááThe above examples would produce the following results:

ááááááááá1«á Thσá terminatioεá flaτá wil∞ bσ se⌠á anΣá NUL╒á wil∞ ì
áááááááááterminate when the current command line is exhausted.
ááááááááá2«á  Thσ terminatioε flaτ i≤ se⌠ anΣ theεá reset«á  NUL╒ ì
ááááááááádoe≤ no⌠ terminate.

-YáááááááDISK DIRECTORY
áááááááááSyntax: -y[ filespec]

áááááááááThi≤á commanΣá wil∞ prin⌠ aε unsorteΣ director∙á oµá thσ ìèááááááááádisδá indicateΣ b∙ thσ paramete≥ passed¼á o≥ ßá completσ ì
ááááááááádirector∙ iµ nonσ i≤ passed«  Thσ scopσ oµ thσ director∙ ì
áááááááááma∙á bσ limiteΣ b∙ indicatinτ thσ appropriatσá ambiguou≤ ì
áááááááááfilespec«  Iµ thσ diφ o≥ reversσ vide∩ string≤ havσ beeε ì
ááááááááádefined¼á NUL╒ wil∞ usσ tha⌠ characteristiπ t∩á indicatσ ì
ááááááááátha⌠á certaiεá filσá attributσá bit≤á arσá se⌠á iεá eacΦ ì
áááááááááfilename.

-ZáááááááZAP DISK FILES
áááááááááSyntax: -z filespec

áááááááááUsσá thi≤á commanΣá t∩á deletσ disδá file≤á whilσá stil∞ ì
ááááááááárunninτ NULU«  EacΦ filσ matchinτ thσ ambiguou≤ filespeπ ì
ááááááááágiveεá wil∞á bσ listeΣ anΣ deleted«á  Librarie≤á caεá bσ ì
ááááááááádeleteΣ jus⌠ a≤ easil∙ a≤ an∙ othe≥ typσ oµ file¼á s∩ bσ ì
ááááááááácareful«á  Thσá onl∙á protectioεá affordeΣ i≤á tha⌠á thσ ì
ááááááááálibrary currently open, if any, will never be deleted.

-<áááááááREDIRECT INPUT
áááááááááSyntax: -< filename

áááááááááThi≤á commanΣá wil∞á causσ NUL╒á t∩á opeεá thσá filenamσ ì
áááááááááindicateΣá anΣ begiε acceptinτ command≤ froφ i⌠á insteaΣ ì
áááááááááoµá receivinτ theφ froφ thσ console«á  Thi≤ typσ oµ filσ ì
áááááááááis¼á iε effect¼ ß NUL╒ CommanΣ File«   Thσ filetypσ wil∞ ì
ááááááááádefaul⌠ t∩ ".NCFó iµ n∩ filetypσ i≤ specified« Synta° oµ ì
áááááááááthσ command≤ iε thi≤ filσ i≤ compatible iε ever∙ wa∙á t∩ ì
áááááááááthσá synta°á useΣ iε norma∞ NUL╒á operation«á Additiona∞ ì
áááááááááfunction≤ havσ beeε addeΣ t∩ facilitatσ thσá developmen⌠ ì
áááááááááoµá NC╞á files«á EacΦ commanΣ linσ iε thσ filσá mus⌠á bσ ì
áááááááááterminateΣá b∙ ß CR,LF¼á anΣ wil∞ bσ converteΣ t∩á uppe≥ ì
ááááááááácasσá anΣ echoeΣ t∩ thσ consolσ beforσá processing«á Thσ ì
ááááááááálas⌠ linσ iε thσ filσ shoulΣ enΣ witΦ a⌠ leas⌠ tw∩ CR,L╞ ì
ááááááááácombinations«áá Afte≥áá al∞áá NC╞á command≤á havσáá beeε ì
áááááááááprocessed¼á contro∞ wil∞ bσ returneΣ t∩ thσ console« An∙ ì
ááááááááácommand≤ appearinτ afte≥ ß "-<ó commanΣ wil∞ bσ ignored.

áááááááááIµ anothe≥ "-<ó commanΣ i≤ encountereΣ iε thσ file¼á thσ ì
ááááááááácurren⌠á commanΣ filσ wil∞ bσ suspendeΣ anΣ thσ ne≈ filσ ì
áááááááááopened«á  Wheεá thσ command≤ iε tha⌠ ne≈ filσ  havσá al∞ ì
ááááááááábeeε processed¼á contro∞ wil∞ "returnó t∩ thσ filσá tha⌠ ì
ááááááááá"calledó thσ ne≈ file«  Thi≤ nestinτ caε continuσ t∩ thσ ì
áááááááááleve∞á alloweΣá b∙á thσá numbe≥á oµá inpu⌠á file≤á patcΦ ì
ááááááááádescribeΣá iεá NUL╒á MODIFICATION«áá  (I⌠á caεá actuall∙ ì
ááááááááácontinuσá t∩ ß mucΦ deepe≥ leve∞ iµ n∩ librar∙ i≤á open¼ ì
ááááááááábut what's the point?  Hmmm... maybe a tutorial...)

áááááááááThe filename passed must be unambiguous.

áááááááááOµá thσá followinτ commands¼á thesσ arσ valiΣ onl∙á wheε ì
áááááááááreceiveΣ froφ aε NC╞ file║á -j¼á -z¼ -"«  Thσ other≤ ma∙ ì
ááááááááábσá useΣá a⌠á an∙ timσ bu⌠ arσá includeΣá herσá anΣá arσ ì
áááááááááomitteΣá froφá thσá men⌡ becausσ oµá thei≥á programmatiπ ì
ááááááááánature.
è-----------------------------------------------------------------
-JáááááááJUMP TO LINE
áááááááááSyntax: -j line number

áááááááááUsσá thi≤á commanΣ t∩ havσ NUL╒á star⌠á readinτá commanΣ ì
áááááááááline≤á froφá thσá curren⌠ NC╞ filσ a⌠á thσá linσá numbe≥ ì
áááááááááindicated«  Thσ example:

ááááááááá-j 1

áááááááááwoulΣ causσ NUL╒ t∩ star⌠ readinτ line≤ froφ thσ curren⌠ ì
áááááááááNC╞á filσá beginninτá a⌠á linσá numbe≥á 1«á ForwarΣá anΣ ì
ááááááááábackwarΣá reference≤ arσ allowed«á  ┴ referencσ t∩á linσ ì
ááááááááánumbe≥á ░á wil∞á bσ ignored«á  An∙á reference≤á t∩á non-ì
áááááááááexisten⌠ linσ number≤ wil∞ causσ thσ curren⌠ NC╞ filσ t∩ ì
áááááááááterminate¼á thereb∙á returninτá t∩ thσ nex⌠á highe≥á NC╞ ì
ááááááááálevel¼ o≥ t∩ thσ commanΣ modσ iµ thi≤ i≤ thσ highes⌠ NC╞ ì
ááááááááálevel.

áááááááááNotσ tha⌠ iµ yo⌡ adΣ o≥ deletσ an∙ line≤ iε aε NC╞ file¼ ì
ááááááááátha⌠á wil∞ completel∙ fou∞ u≡ an∙ jum≡ command≤ iεá tha⌠ ì
áááááááááfile.  That's a bug, not a feature.

-ZáááááááTOGGLE CONSOLE
áááááááááSyntax: -z

áááááááááThi≤á command toggle≤ al∞ outpu⌠ t∩ thσ consolσá device«  ì
áááááááááTha⌠á is¼á iµ thi≤ commanΣ i≤ issueΣ once¼á al∞á consolσ ì
áááááááááoutpu⌠ i≤ shu⌠ down¼á witΦ thσ exceptioε oµ thσá specia∞ ì
ááááááááácommand≤á listeΣá below«á  Issuσ i⌠ again¼á anΣá consolσ ì
áááááááááoutput will be re-enabled.

-'áááááááPRINT TEXT
áááááááááSyntax: -' "text to print"

áááááááááUsσ thi≤ commanΣ t∩ prin⌠ tex⌠ t∩ thσ console¼ n∩ matte≥ ì
áááááááááwha⌠ thσ conditioε oµ thσ consolσ outpu⌠ toggle« Tex⌠ t∩ ì
ááááááááábσá printeΣá mus⌠ bσ encloseΣ iεá quotes«á  Thσá openinτ ì
áááááááááquotσá MUS╘á bσ present¼á bu⌠ thσ closinτ quotσ i≤á onl∙ ì
ááááááááánecessary to delimit any following commands.

-"áááááááPROMPT AND CHAIN TO PREVIOUS MODE
áááááááááSyntax: -mode to chain to -" "prompt" -failure mode

áááááááááM∙á methoΣ oµ synta° diagramminτ fall≤ utterl∙ shor⌠á oµ ì
ááááááááádescribinτ thi≤ command¼ ╔ know«  Let'≤ takσ i⌠ onσ ste≡ ì
áááááááááa⌠á ß time«á  Thi≤ commanΣ allow≤ thσ NUL╒ programme≥ t∩ ì
áááááááááspecif∙ thσ modσ t∩ whicΦ hσ wishe≤ t∩ pas≤ ß parameter¼ ì
ááááááááápromp⌠ thσ use≥ fo≥ tha⌠ parameter¼á anΣ t∩ als∩ specif∙ ì
áááááááááaction≤ t∩ bσ takeε iµ n∩ responsσ i≤ receiveΣ froφá thσ ì
áááááááááuser.  Now for an example...

ááááááááá-y *lbr -o -" "open which library? " -j 65535

áááááááááThe following result would be produced:èááááááááá1«á ┴ director∙ listinτ oµ al∞ file≤ witΦ ß typσ oµ .LB╥ ì
áááááááááwoulΣá bσá listeΣ t∩ thσ consolσ devicσ iµá thσá consolσ ì
áááááááááwere toggled on.
ááááááááá2«  Thσ OPE╬ LIBRAR┘ modσ woulΣ bσ transparentl∙ entereΣ ì
ááááááááájust long enough for NULU to take note of it.
ááááááááá3.  The console would be prompted with the message:

ááááááááá(CR, LF)
áááááááááOPEN WHICH LIBRARY?

áááááááááanΣ NUL╒ woulΣ wai⌠ fo≥ thσ use≥ t∩ ente≥ ß linσ oµ tex⌠ ì
áááááááááNO╘ EXCEEDIN╟ thσ lengtΦ oµ thσ prompt(!)«á  Iµ thσ use≥ ì
áááááááááentereΣ anΣ RETUR╬ b∙ itselµ o≥ ß nul∞ line¼á thσ promp⌠ ì
áááááááááwoulΣ reappea≥ oε thσ nex⌠ line«á  Iµ thσ use≥ entereΣ ß ì
ááááááááávaliΣ line¼á thσ firs⌠ worΣ oε tha⌠ linσ (delimiteΣ b∙ ß ì
áááááááááspace¼á tab¼á etc.⌐á woulΣ bσ passeΣ t∩ thσ OPE╬ LIBRAR┘ ì
ááááááááámodσ anΣ thσ balancσ oµ thσ linσ woulΣ bσ ignored«á  If¼ ì
áááááááááoε thσ othe≥ hand¼á thσ use≥ entereΣ aε ESCAP┼á followeΣ ì
áááááááááb∙á ßá RETUR╬ (1bh¼á 0dh⌐ thσ command≤ afte≥ thσá promp⌠ ì
áááááááááwoulΣá bσ executeΣ anΣ contro∞ woulΣ bσ passeΣá t∩á linσ ì
ááááááááánumbe≥ 65535¼ almos⌠ surel∙ ß non-existen⌠ line¼ thereb∙ ì
áááááááááterminating the current NCF file.

áááááááááSomσá command≤ whicΦ normall∙ accep⌠á parameter≤á canno⌠ ì
áááááááááreceivσá parameter≤á froφá thi≤ modσá becausσá the∙á arσ ì
ááááááááádecodeΣ differently«  Thesσ include:

ááááááááá-:, -;, -l, -n, -x, -y, ->

-:áááááááWAIT FOR RETURN
áááááááááSyntax: -: -failure mode

áááááááááThi≤á commanΣá wil∞á forcσ NUL╒ t∩ wai⌠ fo≥á thσá RETUR╬ ì
ááááááááá(0dh⌐ characte≥ t∩ bσ inpu⌠ t∩ thσ consolσ device«  Iµ ß ì
áááááááááRETUR╬ i≤ received¼ thσ balancσ oµ thσ commanΣ linσ wil∞ ì
ááááááááábσ ignored«á  Iµ ß ^├ i≤ entered¼ thσ remaininτ command≤ ì
áááááááááon the line will be executed.

-;áááááááCOMMENT
áááááááááSyntax: -; comment about this kludge of a JCL

áááááááááThi≤á commanΣá wil∞á causσá NUL╒á t∩á ignorσá al∞áá tex⌠ ì
áááááááááappearinτ afte≥ thσ commanΣ oε thσ samσ physica∞ commanΣ ì
áááááááááline.
-----------------------------------------------------------------

->áááááááREDIRECT OUTPUT
áááááááááSyntax: -> filename
áááááááááSyntax: ->

áááááááááWitΦ thσ firs⌠ forφ oµ thi≤ command¼ NUL╒ outpu⌠ wil∞ bσ ì
ááááááááásen⌠ t∩ thσ filenamσ indicated«á Thσ defaul⌠ filetypσ oµ ì
ááááááááá".NOFó  wil∞ bσ useΣ iµ n∩ filetypσ i≤ specified« Iµ thσ ì
áááááááááfilσ alread∙ exists¼á i⌠ wil∞ bσ deleted«á  Al∞á specia∞ ì
ááááááááácharacter≤ tha⌠ thσ use≥ ma∙ havσ patcheΣ int∩ NUL╒ (seσ ìèááááááááábelow¼á NUL╒á MODIFICATION⌐ wil∞ bσ sen⌠ t∩ thσ filσá a≤ ì
áááááááááwell¼ witΦ thσ exceptioε oµ thσ EO╞ character¼ 2╢ (1ah)«  ì
áááááááááThσá onl∙á outpu⌠ no⌠ echoeΣ t∩ thσ filσ wil∞ bσá outpu⌠ ì
ááááááááácauseΣá b∙ viewinτ o≥ printinτ ß membe≥ file«á  Eveεá iµ ì
áááááááááthσá consolσá ha≤ beeε turneΣ ofµ b∙ aεá NC╞á file¼á al∞ ì
áááááááááconsolσ outpu⌠ wil∞ continuσ t∩ bσ sen⌠ t∩ thi≤ file.

áááááááááThe filename passed must be unambiguous.

áááááááááUnde≥á thσá seconΣá forφ oµ thi≤á command¼á thσá curren⌠ ì
áááááááááoutpu⌠ file¼ iµ an∙ wil∞ bσ closed«  Wheε NUL╒ i≤ causeΣ ì
ááááááááát∩á terminate¼á thσ curren⌠ outpu⌠ filσ i≤ closeΣá alonτ ì
áááááááááwith the current library, if any.


                         ERROR HANDLING

NUL╒ shoulΣ neve≥ crasΦ t∩ CP/═ anymore«á  Wheε NUL╒ sign≤ on¼ i⌠ ì
redirect≤á thσá warφ boo⌠ BIO╙ vector¼á thereb∙á preventinτá NUL╒ ì
terminatioεá duσ t∩ BDO╙ errors«á  Unde≥ CP/═ Plus¼á i⌠ goe≤ eveε ì
further¼á shuttinτ dowε thσ consolσ erro≥ messages¼ handlinτ theφ ì
internally«áá  Therefore¼áá iµá NUL╒á attempt≤á t∩á perforφá somσ ì
operatioεá oεá ßá drivσá wherσ n∩á disδá i≤á mounted¼á onσá coulΣ ì
reasonabl∙á expec⌠ (oε ß 2.▓ system⌐ fo≥ thσ BIO╙ t∩á issuσá somσ ì
erro≥á message«á  Thσ use≥ theε hit≤ RETUR╬ o≥ ^├ anΣ NUL╒ shoulΣ ì
recover«á  I⌠ ma∙ thinδ tha⌠ thσ disδ wa≤ full¼ wheε therσ reall∙ ì
wasn'⌠á onσá therσ a⌠ all¼á bu⌠ i⌠ shoulΣ stil∞ takσá thσá prope≥ ì
course of action needed to recover.


                         ERROR MESSAGES

Most NULU error messages are of the form:

ERROR XX: Explanation

wherσá "XXóá i≤ somσ numbe≥ froφ ░ t∩ 25╡ anΣ "Explanationó i≤á ß ì
cluσ a≤ t∩ thσ naturσ oµ thσ error«  EacΦ erro≥ messagσ i≤ listeΣ ì
below¼á alonτá witΦ aε explanation«á  Suggestion≤ abou⌠á way≤á t∩ ì
handlσ thσ error are given where appropriate.

ERROR 1: reading unwritten data
Problem:ááááááá┴á secto≥á requireΣ t∩ gaiε acces≤ t∩á ßá filσá i≤ ì
áááááááááááááááindicated by CP/M to be unwritten.
Solution:ááááááThσá librar∙á director∙á o≥á perhap≤á thσá librar∙ ì
áááááááááááááááitselµ ha≤ becomσ trasheΣ a⌠ somσ point«  Deletinτ ì
áááááááááááááááthσá entr∙á anΣ KRUNCHinτ wil∞ probabl∙ rende≥á i⌠ ì
áááááááááááááááharmless¼á bu⌠á thσá safes⌠ coursσ t∩ takσá i≤á t∩ ì
áááááááááááááááobtaiε ß fresΦ cop∙ oµ thσ library.

ERROR 2: disk full
Problem:       Thσá librar∙ disδ becamσ ful∞ durinτ filσ additioε ì
áááááááááááááááo≥á KRUNCHinτá o≥á thσá destinatioεá disδá oµáá aε ì
áááááááááááááááextractioε commanΣ becamσ full.
Solution:ááááááIµá thσá erro≥á occurreΣá durinτá KRUNCHing¼á NUL╒ ìèáááááááááááááááshoulΣ havσ recovereΣ b∙ itself¼ reopeninτ thσ olΣ ì
ááááááááááááááálibrary«á  Iµ i⌠ diΣ no⌠ recover¼ theε yo⌡ removeΣ ì
áááááááááááááááthσá origina∞ disδ beforσ thσ KRUNC╚ wa≤á completσ ì
áááááááááááááááo≥ ß seriou≤ reaΣ erro≥ occurred.

áááááááááááááááIµá thσ erro≥ occur≤ durinτ filσ additioεá t∩á thσ ì
ááááááááááááááálibrary¼á operatioε shoulΣ no⌠ bσ impaired¼ bu⌠ n∩ ì
áááááááááááááááfile≤á tha⌠ requireΣ additiona∞ disδ spacσ caεá bσ ì
áááááááááááááááaddeΣá t∩á thσá librar∙ unti∞ somσ disδá spacσá i≤ ì
ááááááááááááááácleared«á  Notσ tha⌠ deleteΣ entrie≤ caε stil∞á bσ ì
áááááááááááááááoverwritteεá b∙ incominτ file≤ a≤ lonτ a≤ thσ filσ ì
ááááááááááááááásize≤á match«á  Thσ incominτ filσ tha⌠ causeΣá thσ ì
áááááááááááááááerro≥ wil∞ bσ recordeΣ iε thσ librar∙ director∙ a≤ ì
áááááááááááááááß deleteΣ entry«á Iµ thσ erro≥ occur≤ a≤ ßá resul⌠ ì
áááááááááááááááoµá attemptinτ t∩ replacσ ß member¼á thσá origina∞ ì
ááááááááááááááálibrar∙á membe≥ shoulΣ bσ unharmeΣ anΣ lef⌠ a≤á aε ì
áááááááááááááááactivσ member.

áááááááááááááááIµá thσá erro≥á occur≤ durinτ filσá extractioεá o≥ ì
áááááááááááááááunsqueezinτáá thσá destinatioεá filσá i≤áá deleteΣ ì
ááááááááááááááábecausσ i⌠ i≤ aε incompletσ file«á  Extractioε caε ì
ááááááááááááááácontinue as before.

ERROR 4: reading unwritten data
               Seσá ERRO╥ 1«á  Thi≤ i≤ thσ samσ excep⌠ tha⌠á BDO╙ ì
               mentioned that an entire extent was missing.

ERROR 5: can't make file
Problem:áááááááAεá attemp⌠á wa≤ madσ t∩ creatσ ß filσ oεá ßá disδ ì
áááááááááááááááwith no free directory entries.

ERROR 10: media changed
Problem:á      Yo⌡á pulleΣá thσ diskettσ ou⌠ iε thσ middlσá oµá ß ì
ááááááááááááááácrucial operation.
Solution║á     Don'⌠á d∩ that«á  I⌠ i≤ probabl∙ aε unrecoverablσ ì
               error.
ERROR 11: disk i/o error
Problem:       Yo⌡á arσ probabl∙ runninτ unde≥ CP/═ Plu≤á iµá yo⌡ ì
áááááááááááááááge⌠á thi≤á message«á  I⌠ mean≤ tha⌠ thσá operatinτ ì
ááááááááááááááásysteφ detecteΣ ß physica∞ probleφ witΦ you≥á disδ ì
áááááááááááááááand the read or write failed.
Solution:ááááááTr∙ i⌠ again«á  ╔ havσ recovereΣ froφ thi≤ typσ oµ ì
áááááááááááááááerror by persistence.

ERROR 12: disk r/o
Problem:       You≥ operatinτ systeφ probabl∙ discovereΣ tha⌠ yo⌡ ì
áááááááááááááááhave a write-protect tab on your diskette.
Solution:ááááááRemove it.

ERROR 14: bad drive
Problem:áááááááAεá invaliΣ drivσ fo≥ you≥ systeφ wa≤ choseεá (seσ ì
ááááááááááááááábelow¼á NUL╒ MODIFICATION⌐ o≥ ß lette≥ highe≥ thaε ì
ááááááááááááááá"P" was indicated.
Solution:ááááááChoose another drive or re-patch NULU.
èERROR 17: password error
Problem:       Yo⌡á trieΣá t∩ acces≤ ß filσ fo≥ whicΦ ßá passworΣ ì
áááááááááááááááwa≤á required«á  NUL╒ doe≤ no⌠ suppor⌠á acces≤á t∩ ì
ááááááááááááááásuch files.

ERROR 18: file exists
Problem:       Yo⌡á attempteΣá t∩ KRUNC╚ ß librar∙ froφ onσá use≥ ì
áááááááááááááááareß int∩ ß differen⌠ onσ iε whicΦ ß filσ witΦ thσ ì
ááááááááááááááásame name already resided.

ERROR 19: ambiguity error
Problem:á      Thi≤ mean≤ tha⌠ yo⌡ entereΣ aε ambiguou≤á filespeπ ì
áááááááááááááááwherσá aεá unambiguou≤ filenamσ wa≤á required¼á o≥ ì
ááááááááááááááátha⌠ thσ destinatioε filespeπ iε aε extractioεá o≥ ì
áááááááááááááááunsqueezσá commanΣá wa≤á les≤ ambiguou≤á thaεá thσ ì
ááááááááááááááásourcσá filespec«á Seσá -┼á  EXTRAC╘á MEMBER╙á fo≥ ì
ááááááááááááááácomplete details.

ERROR 70: file table full
Problem:       Yo⌡ attempteΣ t∩ opeε onσ morσ NC╞ filσ thaεá you≥ ì
ááááááááááááááánesting patch supported.  See NULU MODIFICATION.

ERROR 74: checksum error
Problem:áááááááDurinτá thσá unsqueezinτ oµ ß file¼á thσá interna∞ ì
áááááááááááááááchecksuφá generateΣá diΣ no⌠á matcΦá thσá explici⌠ ì
áááááááááááááááchecksuφá stateΣá iε thσ file'≤á squeezσá decodinτ ì
ááááááááááááááátable.
Solution:ááááááGe⌠ ß ne≈ cop∙ oµ thσ membe≥ file«  Your≤ ha≤ beeε ì
ááááááááááááááátrashed somehow.

ERROR 75: CRC error
Problem:áááááááWheε eacΦ membe≥ filσ i≤ addeΣ t∩ ß library¼ ß CR├ ì
ááááááááááááááái≤á createΣá fo≥á i⌠á anΣ storeΣá iεá thσá librar∙ ì
ááááááááááááááádirectory«á  If¼á upoε extractioε o≥á unsqueezing¼ ì
áááááááááááááááthσá CR├ generateΣ a⌠ THA╘ timσ doe≤ no⌠ matcΦ thσ ì
áááááááááááááááorigina∞ CR├ iε thσ directory¼ tha⌠ mean≤ tha⌠ thσ ì
ááááááááááááááásector≤á whereiε tha⌠ librar∙ entr∙á reside≤á havσ ì
ááááááááááááááábecomσ corrupted«  Therσ i≤ aε outsidσ chancσ tha⌠ ì
áááááááááááááááthσá CR├ entr∙ iε thσ librar∙ director∙ ha≤ becomσ ì
ááááááááááááááádamageΣá instead¼á howeve≥á tha⌠á conditioεá woulΣ ì
áááááááááááááááprobably also generate ERROR 107.

ERROR 77: not enough memory
Problem:áááááááAεá attemp⌠á wa≤á madσ t∩ opeε ßá librar∙á witΦá ß ì
ááááááááááááááádirector∙á to∩á largσá t∩ bσá accounteΣá fo≥á witΦ ì
áááááááááááááááavailable memory.
Solution:ááááááOpeεá thσ librar∙ oε ß compute≥ witΦ ß large≥á TP┴ ì
áááááááááááááááanΣá reorganizσá i⌠á s∩ i⌠ caε bσ handleΣá b∙á thσ ì
ááááááááááááááásmaller system.

ERROR 78: user cancel
Problem:áááááááN∩ problem«á  NUL╒ i≤ simply lettinτ thσ use≥ kno≈ ì
áááááááááááááááwh∙áá aεá operatioεá ha≤á beeεá cancelled«áá  Mos⌠ ì
áááááááááááááááoperation≤á whicΦ worδ oε ambiguou≤ filespec≤á ma∙ ì
ááááááááááááááábσá interrupteΣá b∙á enterinτ ßá ^├á durinτá thei≥ ìèáááááááááááááááoperation«á (Yo⌡á ma∙ havσ t∩ holΣ thσ ke∙ dowεá ß ì
áááááááááááááááwhile.⌐áá  Thσáá KRUNC╚á operatioεáá ma∙áá bσáá s∩ ì
áááááááááááááááinterrupted as well.

ERRORá83: bad syntax
Problem:áááááááImprope≥ synta° wa≤ used t∩ attemp⌠ somσ operation.

ERROR 85: file not found
Problem:áááááááThσá filespeπ indicateΣ fo≥ somσá operatioεá coulΣ ì
ááááááááááááááánot be located.

ERROR 86: incompatible cp/m version
Problem:áááááááAεá attemp⌠ wa≤ madσ t∩ ruε NUL╒ oε ß systeφá witΦ ì
áááááááááááááááa CP/═ versioε numbe≥ oµ les≤ thaε 2.0.

ERROR 100: bad library directory
Problem:áááááááThσá filσá specifieΣá coulΣ no⌠á bσá openeΣá a≤á ß ì
ááááááááááááááálibrar∙á file«ì
Solution:ááááááThσá director∙ coulΣ bσ bad¼á bu⌠ mos⌠ likel∙á thσ ì
áááááááááááááááfilσá simpl∙ isn'⌠ ß library«á  Checδ i⌠ ou⌠á witΦ ì
ááááááááááááááásome disk editor like SPZ or EDFILE.

ERROR 107: library directory CRC error
Problem:áááááááThσá CR├á tha⌠ wa≤ calculateΣ anΣ storeΣá fo≥á thσ ì
ááááááááááááááádirector∙á thσ las⌠ timσ thσ librar∙ wa≤á modifieΣ ì
ááááááááááááááádoe≤ no⌠ matcΦ thσ director∙ CR├ calculateΣ a≤ thσ ì
ááááááááááááááálibrary is opened this time.
Solution:ááááááWitΦ mos⌠ libraries¼ thi≤ erro≥ wil∞ bσ valid«  Iε ì
ááááááááááááááátha⌠ case¼ thσ onl∙ remed∙ i≤ t∩ obtaiε ß ne≈ cop∙ ì
áááááááááááááááoµ thσ library«  However¼ therσ arσ somσ librarie≤ ì
ááááááááááááááátha⌠á werσ createΣ witΦ LU¼á anΣ theε modifieΣ bu⌠ ì
áááááááááááááááneve≥ KRUNCHE─ b∙ NUL╒ 1.0«á  Iε tha⌠ case¼á i⌠ i≤ ì
ááááááááááááááálikel∙á tha⌠ thσ old¼á origina∞ CR├ storeΣ iεá thσ ì
ááááááááááááááálibrar∙á director∙á woulΣá stil∞á bσá there¼á eveε ì
áááááááááááááááthougΦ i⌠ i≤ wa∙ ou⌠ oµ date«á  M∙ suggestioεá is¼ ì
áááááááááááááááwheεá yo⌡á firs⌠ ge⌠ NUL╒ 1.5¼á g∩ througΦ al∞á oµ ì
áááááááááááááááyou≥á .LB╥á files¼á iµá yo⌡ werσá usinτá NUL╒á 1.░ ì
ááááááááááááááápreviously¼á anΣ KRUNC╚ them«á  Thi≤ wa∙ yo⌡á wil∞ ì
ááááááááááááááákno≈ late≥ oε tha⌠ thσ CRC≤ storeΣ iε eacΦ librar∙ ì
áááááááááááááááshoulΣ al∞ bσ accurate.

ERROR 116: squeeze decode table error
Problem:ááááááá┴á filσ ha≤ ß squeezσ decodinτ table¼á bu⌠ a⌠ somσ ì
ááááááááááááááápoin⌠ thσ tablσ i≤ trasheΣ o≥ perhap≤ i≤á missing« ì
Solution:ááááááNonσ really╗á ge⌠ ß ne≈ cop∙ oµ thσ file«  Iµ you≥ ì
áááááááááááááááDatß Buffe≥ Sizσ ha≤ falleε belo≈ ╣ sectors¼á theε ì
áááááááááááááááthσá reasoε migh⌠ bσ tha⌠ thσ entirσ decodσá tablσ ì
ááááááááááááááácould not be read into memory.

ERROR XX: undefined
Problem:áááááááUnknown.
Solution:ááááááWritσáá dowεá al∞á informatioεá presenteΣá oεá thσ ì
áááááááááááááááterminal«á  Thσ numbe≥ followinτ thσ worΣ ERRO╥ i≤ ì
áááááááááááááááespeciall∙ important«á Ge⌠ thσ informatioε t∩á me«  ì
áááááááááááááááMail it or call and I will try to help.è

The most serious, non-recoverable error is:

     NULU CRC error

whicΦá caε occu≥ wheε NUL╒ 1.╡ i≤ firs⌠ loaded«á  Thi≤ mean≤ tha⌠ ì
NUL╒ faileΣ t∩ matcΦ it≤ owε CRC«á  Yo⌡ neeΣ t∩ ge⌠ ß fresΦ copy«  ì
Or perhaps you have tried some patch not described below...?


                        NULU MODIFICATION

Patche≤ arσ listeΣ iε thσ orde≥ iε whicΦ the∙ appea≥ iε NULU.COM«  ì
EacΦá patcΦá i≤á explaineΣá anΣ thσá defaul⌠á value≤á arσá listeΣ ì
immediatel∙á nex⌠á t∩á thσá patcΦá address«á  Al∞á addresse≤á arσ ì
absolutσ hexadecimal.

Patch     Default             Explanation
00163h      50h               Numbe≥á oµá character≤á eacΦáá ful∞ ì
áááááááááááááááááááááááááááááávide∩áá linσá caεáá contain«áá  No⌠ ì
áááááááááááááááááááááááááááááánecessaril∙á thσ samσ a≤ thσ numbe≥ ì
ááááááááááááááááááááááááááááááyou can see.
00164h      50h               Numbe≥á oµ character≤ visiblσ oεá ß ì
ááááááááááááááááááááááááááááááline at any one time.
00167há     07h               Thi≤á bytσ indicate≤ thσ numbe≥á oµ ì
ááááááááááááááááááááááááááááááfile≤á tha⌠ NUL╒ caε havσá opeεá a⌠ ì
ááááááááááááááááááááááááááááááan∙á onσ time«á  Thσ basσ numbe≥ i≤ ì
áááááááááááááááááááááááááááááá┤ anΣ shoulΣ neve≥ fal∞ belo≈ that«  ì
ááááááááááááááááááááááááááááááThσ valuσ oµ │ ha≤ beeε addeΣ t∩ i⌠ ì
áááááááááááááááááááááááááááááát∩á allo≈á │ leve∞ nestinτá oµá NC╞ ì
ááááááááááááááááááááááááááááááfiles«áá  Iµáá thσá NC╞á valuσáá i≤ ì
ááááááááááááááááááááááááááááááincreaseΣ o≥á decreased¼á identica∞ ì
ááááááááááááááááááááááááááááááchange≤á shoulΣá bσá madσá t∩á thi≤ ì
áááááááááááááááááááááááááááááábyte.  (See Patch at 00220h.)
00168h   0010h                Thi≤áá obscurσá worΣá control≤á thσ ì
áááááááááááááááááááááááááááááánumbe≥á oµ relocatablσá task≤á tha⌠ ì
áááááááááááááááááááááááááááááácaεáá bσá controlleΣá b∙á thσá NUL╒ ì
áááááááááááááááááááááááááááááámemor∙áááá managemen⌠áááá routines«  ì
ááááááááááááááááááááááááááááááBecausσ eacΦ filσ i≤ ßá relocatablσ ì
áááááááááááááááááááááááááááááátask¼á thσá samσ modification≤á fo≥ ì
ááááááááááááááááááááááááááááááthσ previou≤ bytσ appl∙ here«á  Thσ ì
áááááááááááááááááááááááááááááábasσá valuσá oµ thi≤ worΣ i≤á 000dΦ ì
ááááááááááááááááááááááááááááááanΣá shoulΣ neve≥ fal∞á belo≈á tha⌠ ì
áááááááááááááááááááááááááááááápoint.  (See Patch at 00220h.)
0016ah     10há ááááááááááááááNumbe≥á oµá contiguousl∙áá numbereΣ ì
áááááááááááááááááááááááááááááádisδ drive≤ iε you≥ system«  Iµ yo⌡ ì
ááááááááááááááááááááááááááááááhavσ drive≤ ┴ anΣ B¼ se⌠ thi≤ valuσ ì
áááááááááááááááááááááááááááááát∩á 2«á  I⌠á wil∞ preven⌠ yo⌡á froφ ì
ááááááááááááááááááááááááááááááaccessing an invalid drive.
0016bhá    10h                Numbe≥á oµá contiguou≤á use≥á area≤ ì
áááááááááááááááááááááááááááááátha⌠áá NUL╒á wil∞á bσá alloweΣáá t∩ ì
ááááááááááááááááááááááááááááááaccess«á  Unde≥á norma∞á CP/═á 2.2¼ ì
ááááááááááááááááááááááááááááááTurbo-Do≤á o≥á ßá ZCP╥á system¼áá ╔ ì
ááááááááááááááááááááááááááááááunderstanΣ tha⌠ thi≤ numbe≥ caεá bσ ìèááááááááááááááááááááááááááááááa≤ higΦ a≤ 20h«á  Fo≥ CP/═ Plu≤á o≥ ì
áááááááááááááááááááááááááááááámos⌠á system≤á tha⌠á usσá time/datσ ì
áááááááááááááááááááááááááááááástampinτá thi≤á numbe≥á shoulΣá no⌠ ì
ááááááááááááááááááááááááááááááexceeΣ 10h.
0019ch    0005h               Thi≤á i≤á thσ addres≤ oµá thσá BDO╙ ì
áááááááááááááááááááááááááááááávector«  Al∞ operatinτ systeφ call≤ ì
áááááááááááááááááááááááááááááág∩á througΦ thi≤ address«á  Iµá yo⌡ ì
ááááááááááááááááááááááááááááááhavσ somσ weird¼á non-standarΣ CP/═ ì
ááááááááááááááááááááááááááááááimplementatioεá yo⌡ caε patcΦá thi≤ ì
ááááááááááááááááááááááááááááááto try to make NULU work with it.
0021ch      00háááááááááááááááSe⌠á t∩á ß non-zer∩ valuσá t∩á makσ ì
ááááááááááááááááááááááááááááááNUL╒ READ/ONLY«á  N∩ operator≤ wil∞ ì
áááááááááááááááááááááááááááááábσá executeΣ tha⌠ coulΣ changσá thσ ì
áááááááááááááááááááááááááááááálibrar∙ o≥ disδ directorie≤ iεá an∙ ì
ááááááááááááááááááááááááááááááway.
0021dh      00háááááááááááááááLU.CO═áá wa≤áá se⌠áá u≡áá t∩áá exi⌠ ì
ááááááááááááááááááááááááááááááautomaticall∙ iµ ß commanΣ tai∞ wa≤ ì
ááááááááááááááááááááááááááááááuseΣ wheε L╒ wa≤ invoked«  WitΦ thσ ì
ááááááááááááááááááááááááááááááreleasσá versioε oµ NULU¼á i⌠ take≤ ì
ááááááááááááááááááááááááááááááthσ -╪ commanΣ t∩ exit«á  Se⌠á thi≤ ì
áááááááááááááááááááááááááááááábytσ t∩ ß 01Φ t∩ ge⌠ i⌠ t∩ ac⌠ likσ ì
ááááááááááááááááááááááááááááááL╒á iε thi≤ respect«á  Tha⌠ is¼á i⌠ ì
ááááááááááááááááááááááááááááááwil∞áá automaticall∙áá exi⌠áá afte≥ ì
ááááááááááááááááááááááááááááááexecutinτ thσ passeΣ commanΣá tail¼ ì
ááááááááááááááááááááááááááááááiµ onσ wa≤ present.
0021eh      01háááááááááááááááSe⌠á t∩á ß 00Φ t∩ star⌠á NUL╒á witΦ ì
ááááááááááááááááááááááááááááááBRIE╞á modσá O╬ (lonτ message≤á no⌠ ì
ááááááááááááááááááááááááááááááprinted).
0021fh      01h               Se⌠á t∩ zer∩ t∩ preven⌠ user≤á froφ ì
áááááááááááááááááááááááááááááábeinτá ablσá t∩á ESC,RE╘á froφá thσ ì
ááááááááááááááááááááááááááááááPROMP╘á AN─ CHAI╬ T╧ PREVIOU╙á MOD┼ ì
ááááááááááááááááááááááááááááááprompt≤ iε NC╞ files«á (Bσ surσá t∩ ì
ááááááááááááááááááááááááááááááals∩á changσá thσ value≤ a⌠á 00167Φ ì
ááááááááááááááááááááááááááááááand 00168h.)
00220h      03h               Thi≤á bytσá indicate≤á thσá nestinτ ì
ááááááááááááááááááááááááááááááleve∞á alloweΣá fo≥ NC╞á files«á  ╔ ì
ááááááááááááááááááááááááááááááhavσá n∩ ideß wha⌠ thσ uppe≥á limi⌠ ì
ááááááááááááááááááááááááááááááis¼á bu⌠á watcΦá tha⌠á Datßá Buffe≥ ì
ááááááááááááááááááááááááááááááSize!
00221h      '-Y *LBR -O',0 áááStartinτ herσ arσ 3╣ byte≤ iε whicΦ ì
ááááááááááááááááááááááááááááááan∙á valiΣá NUL╒ operator≤á ma∙á bσ ì
áááááááááááááááááááááááááááááástored«ááá  Thi≤áá linσáá wil∞áá bσ ì
ááááááááááááááááááááááááááááááautomaticall∙ executeΣ wheε NUL╒ i≤ ì
ááááááááááááááááááááááááááááááloaded¼áá eveεá beforσá an∙áá othe≥ ì
ááááááááááááááááááááááááááááááparameter≤á passeΣá oε thσá commanΣ ì
ááááááááááááááááááááááááááááááline«  Thi≤ migh⌠ bσ useΣ t∩ creatσ ì
ááááááááááááááááááááááááááááááßá versioεá oµá NUL╒á that¼áá afte≥ ì
ááááááááááááááááááááááááááááááloading¼ááá set≤áá thσáá drive/use≥ ì
áááááááááááááááááááááááááááááádefault≤ t∩ B0:¼á print≤ thσá menu¼ ì
ááááááááááááááááááááááááááááááscan≤á thσ drivσ fo≥ librar∙ files¼ ì
áááááááááááááááááááááááááááááátheεá switche≤ t∩ thσ opeεá librar∙ ì
áááááááááááááááááááááááááááááámode«  Tha⌠ commanΣ linσ woulΣ looδ ì
áááááááááááááááááááááááááááááálikσ this:

áááááááááááááááááááááááááááááá-U B: -H -Y *LBR -Oè
ááááááááááááááááááááááááááááááNoticσ tha⌠ al∞ character≤ iεá thi≤ ì
áááááááááááááááááááááááááááááálinσá MUS╘á bσá UPPE╥á CASE«áá  Thσ ì
ááááááááááááááááááááááááááááááentirσ linσ MUS╘ bσ terminateΣ b∙ ß ì
áááááááááááááááááááááááááááááánul∞á byte«áá  Onl∙á 3╣á byte≤á arσ ì
ááááááááááááááááááááááááááááááavailablσá fo≥á text...no⌠á ßá bytσ ì
áááááááááááááááááááááááááááááámore«á  Thσá 40tΦá bytσ i≤ fo≥á thσ ì
áááááááááááááááááááááááááááááánull terminator.
0026fh      3ch               Thi≤á i≤á thσ numbe≥ oµ line≤á tha⌠ ì
ááááááááááááááááááááááááááááááNUL╒ wil∞ prin⌠ oε eacΦ pagσ durinτ ì
áááááááááááááááááááááááááááááámembe≥ filσ printing«á  Changσ thi≤ ì
áááááááááááááááááááááááááááááávaluσá iε accordancσ witΦ thσá linσ ì
ááááááááááááááááááááááááááááááprinte≥á patcΦá below«á  Se⌠ i⌠á t∩ ì
áááááááááááááááááááááááááááááázer∩á t∩á havσá NUL╒á ignorσáá linσ ì
áááááááááááááááááááááááááááááácounts altogether.

Startinτ a⌠ 0024cΦ arσ 5 datß area≤ useΣ t∩ definσ string≤ needeΣ ì
t∩ contro∞ thσ consolσ attributes«  EacΦ strinτ i≤ precedeΣ b∙ an ì
identificatioεá bytσá anΣ ß bytσ indicatinτá it≤á activσá length«  ì
Theε ╡ byte≤ arσ availablσ fo≥ thσ actua∞ definition«á  Thereforσ ì
ßá tota∞á oµ ╖ byte≤ i≤ consumeΣ fo≥á eacΦá vide∩á control«á  Thσ ì
attribute≤ are¼ iε order:
     DIM or REVERSE VIDEO ONáá (DIM is preferred)
     DIM or REVERSE VIDEO OFF
     UNDERLINING ON
     UNDERLINING OFF
     CLEAR SCREEN

Each control becomes active as soon as it is patched in.

Likewise¼á therσá i≤ onσ strinτ defineΣ fo≥ thσ LST║á devicσ tha⌠ ì
wil∞ bσ issueΣ immediatel∙ beforσ printinτ ß file«á  I⌠ begin≤ a⌠ ì
00271Φ anΣ ha≤ thσ samσ forma⌠ a≤ thσ string≤ above.



                           FINAL NOTES

Pleasσá repor⌠ an∙ bug≤ o≥ problem≤ t∩ Martiεá Murray¼á P.O«á Bo° ì
35972¼á Dallas¼á T°  7523╡ o≥ cal∞ (214⌐ 351-6117¼á EVENING╙á AN─ ì
WEEKEND╙ ONLY«  Pleasσ specif∙ thσ versioε oµ NUL╒ witΦ whicΦ yo⌡ ì
arσá working«ì

A≤ always¼á donation≤ wil∞ bσ gratefull∙ accepted«  I⌠ tooδ ß lo⌠ ì
oµá worδ t∩ producσ NUL╒ anΣ iµ yo⌡ enjo∙ i⌠ anΣ i⌠ benefit≤ you¼ ì
don'⌠ hesitatσ t∩ sho≈ you≥ appreciatioε witΦ ß checkíá  Note║  ╔ ì
n∩ longe≥ worδ fo≥ SYSTE═ SOLUTIONS¼á s∩ please¼á n∩ check≤á madσ ì
ou⌠á t∩á them«á  ╔ aφ no≈ workinτ fo≥ INOVA¼á ßá compan∙á foundeΣ ì
specificall∙á t∩ suppor⌠ 8-bi⌠ computer≤ runninτ CP/M«á  Looδ fo≥ ì
ne≈á anΣá excitinτá retai∞á product≤á froφá tha⌠á source«áá  (Thσ ì
preceedinτ ha≤ beeε aε officia∞ plug.)