CP/M/CPM_CDROM.iso/jsage/znode3/uploads/z3help43.lbr/EDZCM.HZP/EDZCM.HLP

Text File | 1993-06-07 | 11.3 KB | 235 lines

;
                          
                       
                          
  ---  E D Z C M  ---  
                          
                       
                                Version 1.0

                        A Screen-oriented Editor for
                     NZCOM ZCM System Descriptor Files


                       I --> 
 Installation          
                       O --> 
 Overview              
                       S --> 
 Syntax                
                       E --> 
 Editing               
                       R --> 
 Recalculation         
                       W --> 
 Writing to a File     
                       A --> 
 Ampro Systems         
                       M --> 
 MKZCM Standard System 
:I

Installation

EDZC═ run≤ unde≥ ZPCR│ anΣ require≤ aε extendeΣ VLIB4D½ Z3CAP«  Thσ ì
distributioε versioε oµ EDZC═ i≤ supplieΣ witΦ ß Z3EN╓ addres≤ oµ 0000H¼ ì
read∙ fo≥ usσ iε ZCPR33½ environments«  ZCPR3░ user≤ shoulΣ instal∞ EDZC═ ì
usinτ thei≥ regula≥ installatioε methods«
:O

Overviewì

EDZC═ i≤ ß screen-orienteΣ NZCO═ ZC═ systeφ descripto≥ filσ editor«  I⌠ i≤ ì
morσ flexiblσ thaε MKZC═ and¼ withiε ß fe≈ limitations¼ allow≤ yo⌡ t∩ placσ ì
you≥ systeφ element≤ whereve≥ yo⌡ wan⌠ them¼ eveε iε above-CBIO╙ location≤ ì
sucΦ a≤ standarΣ AMPR╧ ZCPR│ buffe≥ locations«  NZCO═ systeφ element≤ arσ ì
displayeΣ iε sorteΣ orde≥ baseΣ oε address¼ witΦ thσ highes⌠ addresse≤ ì
appearinτ first.  Thσ effectivσ system TP┴ i≤ als∩ displayed.

EDZC═ caε producσ ß ZC═ filσ froφ aε editeΣ ZC═ filσ o≥ directl∙ froφ thσ ì
extendeΣ environment«  I⌠ caε producσ ß systeφ tha⌠ exactl∙ reflect≤ you≥ ì
specificatioε oµ systeφ elemen⌠ location≤ anΣ sizes¼ allowinτ yo⌡ t∩ creatσ ì
ß systeφ witΦ non-standarΣ gap≤ fo≥ variou≤ purposes«  Whilσ mos⌠ NZCO═ ì
user≤ wil∞ bσ quitσ happ∙ usinτ MKZCM¼ EDZC═ provide≤ ß morσ flexiblσ ì
systeφ editinτ too∞ fo≥ thosσ user≤ witΦ specia∞ system≤ o≥ requirements.

Iε thσ basiπ editinτ mode¼ thσ EDZC═ displa∙ wil∞ reflec⌠ thσ exac⌠ elemen⌠ ì
addresse≤ anΣ size≤ tha⌠ arσ specified«  I⌠ doe≤ n∩ checkinτ t∩ makσ surσ ì
element≤ don'⌠ overla≡ o≥ arσ correctl∙ sized«  Oε exi⌠ froφ thσ edi⌠ mode¼ ì
i⌠ wil∞ resor⌠ thσ systeφ element≤ baseΣ oε thσ currentl∙ specifieΣ ì
addresse≤ anΣ redispla∙ theφ iε sorteΣ order«

EDZC═ als∩ ha≤ ß powerfu∞ 'Recalculationº commanΣ tha⌠ ma∙ bσ useΣ t∩ ì
recalculatσ thσ systeφ elemen⌠ addresse≤ beginninτ witΦ thσ star⌠ oµ thσ ì
CBIO╙ anΣ workinτ down«  Element≤ locateΣ abovσ thσ CBIO╙ wil∞ no⌠ bσ ì
affected║  EDZC═ assume≤ tha⌠ yo⌡ alread∙ kno≈ wha⌠ you'rσ doinτ wheε yo⌡ ì
placσ element≤ abovσ thσ CBIOS«  Seσ thσ sectioε oε 'Recalculationº fo≥ ì
morσ information.

EDZC═ caε savσ thσ currentl∙ displayeΣ systeφ configuratioε a≤ ß 'ZCMº ì
file«  Thσ inpu⌠ filenamσ i≤ thσ defaul⌠ outpu⌠ filename¼ bu⌠ yo⌡ wil∞ bσ ì
askeΣ iµ yo⌡ wisΦ t∩ specif∙ anothe≥ filenamσ beforσ thσ filσ i≤ written«  ì
Thσ outpu⌠ filσ wil∞ automaticall∙ overwritσ an∙ existinτ filσ oµ thσ samσ ì
name«  Unlikσ MKZCM¼ EDZC═ does not produce an '.ENVº file.
:R

Recalculation

EDZC═ allow≤ yo⌡ t∩ recalculatσ thσ elemen⌠ addresse≤ oµ thσ currentl∙ ì
displayeΣ system¼ beginning witΦ thσ CBIO╙ anΣ workinτ down«  EDZC═ ì
calculate≤ thσ startinτ addres≤ oµ eacΦ systeφ elemen⌠ baseΣ oε it≤ sizσ ì
anΣ oε thσ starting addres≤ oµ thσ elemen⌠ locateΣ jus⌠ abovσ it«

Wheε recalculatinτ ß system¼ EDZC═ fixe≤ severa∞ parameters«  Thσ star⌠ oµ ì
thσ Use≥ Memor∙ Areß i≤ fixeΣ t∩ jus⌠ belo≈ thσ CBIOS«  Thσ locatioε oµ thσ ì
DO╙ i≤ fixeΣ t∩ jus⌠ belo≈ thσ NZCO═ BIO╙ anΣ thσ locatioε oµ thσ CC╨ i≤ ì
fixeΣ t∩ jus⌠ belo≈ thσ DOS«  Whilσ thσ addresse≤ oµ thesσ element≤ arσ ì
displayed¼ yo⌡ can'⌠ directl∙ edi⌠ them«

Thσ sizσ oµ thσ NZCO═ BIO╙ i≤ adjusted¼ iµ required¼ t∩ kee≡ it≤ startinτ ì
addres≤ anΣ thosσ oµ thσ DO╙ anΣ CC╨ oε pagσ boundarie≤ (xx00H)«  Thi≤ caε ì
causσ thσ NZCO═ BIO╙ sizσ t∩ gro≈ iε somσ case≤ iµ yo⌡ arσ addinτ anΣ ì
removinτ element≤ witΦ size≤ tha⌠ arσ aε odΣ numbe≥ oµ records«  I⌠ pay≤ t∩ ì
alway≤ checδ thσ sizσ oµ thσ NZCO═ BIO╙ afte≥ recalculatioε t∩ makσ surσ i⌠ ì
i≤ stil∞ thσ sizσ yo⌡ wisΦ (usuall∙ ▓ records⌐ o≥ n∩ morσ thaε onσ recorΣ ì
greater«  If it's grown, redi⌠ thσ sizσ anΣ recalculatσ thσ system.

Recalculatioε make≤ i⌠ eas∙ fo≥ yo⌡ t∩ usσ thσ edi⌠ modσ t∩ forcσ ß desireΣ ì
systeφ elemen⌠ orde≥ withou⌠ usinτ ß calculator«  Ente≥ 'dummyº elemen⌠ ì
addresse≤ that¼ fo≥ example¼ fi⌠ aε elemen⌠ betweeε tw∩ othe≥ elements«  ì
Thesσ dumm∙ addresse≤ ma∙ diffe≥ froφ eacΦ othe≥ b∙ an∙ convienien⌠ numbe≥ ì
oµ bytes¼ eveε one«  Thσ purposσ i≤ jus⌠ t∩ pu⌠ theφ iε thσ prope≥ orde≥ ì
rather than set actual starting addresses.

Oε returε t∩ thσ maiε menu¼ thσ systeφ element≤ wil∞ bσ displayeΣ iε thσ ì
ne≈ order«  Wheε yo⌡ havσ thσ element≤ iε thσ desireΣ order¼ thσ actua∞ ì
systeφ elemen⌠ addresse≤ ma∙ bσ obtaineΣ usinτ thσ Recalculatioε command.
:W

Writing to a File

Thσ 'Wº commanΣ allow≤ yo⌡ t∩ writσ ß ZC═ filσ froφ thσ displayeΣ systeφ ì
data«  Thσ defaul⌠ outpu⌠ filenamσ i≤ thσ inpu⌠ filenamσ oε thσ inpu⌠ ì
filenamσ director∙ or¼ wheε displayinτ thσ environment¼ Z3ENV.ZCM«  EDZC═ ì
ask≤ yo⌡ t∩ specif∙ aε outpu⌠ filenamσ anΣ display≤ thσ curren⌠ defaul⌠ ì
filename¼ whicΦ yo⌡ caε selec⌠ b∙ enterinτ RETURN«  Otherwisσ yo⌡ caε ì
selec⌠ ß ne≈ dir:filename«  N∩ wildcard≤ arσ permitteΣ iε outpu⌠ filenamσ ì
specifications«

Wheε writinτ aε outpu⌠ file¼ EDZC═ automaticall∙ overwrite≤ an∙ existinτ ì
file of the same name.

Unlike MKZCM, EDZCM does not produce an '.ENV' file.
:S

Syntaxì

The command line synta° is:

     EDZCM [[dir:]zcmfile[.ZCM]]

Yo⌡ ma∙ specif∙ aε inpu⌠ filenamσ iµ desired«  Iµ n∩ filetypσ i≤ specified¼ ì
'.ZCMº i≤ assumed«  Wildcard≤ arσ permitted«  EDZC═ wil∞ displa∙ thσ firs⌠ ì
filσ founΣ tha⌠ matche≤ thσ wildcarΣ filename«  Iµ n∩ inpu⌠ filσ i≤ ì
specified¼ EDZC═ wil∞ displa∙ thσ curren⌠ systeφ configuratioε datß ì
containeΣ iε thσ ZCPR│ environment.

EDZC═ doe≤ ß simplσ checδ oµ thσ inpu⌠ filσ content≤ t∩ tr∙ t∩ avoiΣ ì
problem≤ wheε thσ wronτ typσ oµ filσ i≤ accidentall∙ loaded«  Iµ i⌠ doe≤ ì
no⌠ finΣ thσ strinτ 'CBIOSº startinτ a⌠ bytσ ╡ iε thσ inpu⌠ file¼ i⌠ wil∞ ì
abor⌠ witΦ ß 'Filσ Errorº message.
:E

Editing

EDZC═ use≤ thσ WordSta≥ diamonΣ curso≥ movemen⌠ command≤ or thσ ZCPR│ ì
arro≈ ke∙ character≤ t∩ contro∞ curso≥ movement«  Thσ curso≥ movemen⌠ ì
command≤ are:

                                    ^E
                                ^A ^S ^D ^F
                                    ^X

     ^E     - Move up one element
è     ^A     - Move left one field (if at left field, move up one element)
     ^S     - Move left one character
     ^D     - Move right one character
     ^F/RET - Move right one field (if at right field, move down one element)
     ^X     - Move down one element

     ^T/^Y  - Erase from cursor to end of field with space fill

EDZC═ allow≤ yo⌡ t∩ edi⌠ al∞ field≤ tha⌠ arσ displayeΣ iε standou⌠ video«  ì
Sincσ thσ Use≥ Memor∙ Area¼ fo≥ example¼ i≤ fixeΣ iε relativσ locatioε t∩ ì
jus⌠ belo≈ thσ star⌠ oµ thσ CBIOS¼ i⌠ i≤ displayeΣ iε norma∞ vide∩ anΣ it≤ ì
actua∞ addres≤ i≤ calculateΣ b∙ EDZC═ wheε thσ Recalculatioε commanΣ i≤ ì
executed«  Thσ DO╙ anΣ CC╨ addresse≤ arσ als∩ calculateΣ b∙ EDZC═ t∩ ì
enforcσ thei≥ relationshi≡ witΦ thσ NZBIO╙ anΣ witΦ eacΦ other«

Whilσ thσ CBIO╙ sizσ i≤ no⌠ ß par⌠ oµ thσ ZC═ file¼ fo≥ informationa∞ ì
purpose≤ EDZC═ calculate≤ aε assumeΣ CBIO╙ sizσ baseΣ oε thσ locatioε oµ ì
thσ CBIO╙ iε thσ systeφ anΣ display≤ i⌠ iε norma∞ video.


Address Editing

Al∞ address field≤ arσ editeΣ iε hex«  ┴ ^╘ o≥ ^┘ entereΣ a⌠ thσ firs⌠ ì
character of a field will clear the field to spaces.

Wheε makinτ extensivσ changes¼ yo⌡ ma∙ finΣ i⌠ easie≥ t∩ makσ onl∙ ß fe≈ ì
change≤ a⌠ ß time¼ exi⌠ thσ edi⌠ modσ t∩ redispla∙ thσ newl∙ sorteΣ system¼ ì
vie≈ thσ results¼ anΣ returε t∩ thσ edi⌠ modσ t∩ makσ an∙ morσ desireΣ ì
changes.

Size Editing

Al∞ sizσ field≤ arσ editeΣ iε decimal«  EDZC═ consider≤ ß spacσ t∩ bσ aε ì
acceptablσ decima∞ leadinτ o≥ terminatinτ character«  Sizσ unit≤ arσ ì
displayeΣ afte≥ thσ sizσ fields¼ anΣ thσ actua∞ tota∞ he° elemen⌠ sizσ i≤ ì
displayeΣ iε thσ righ⌠ hanΣ fielΣ fo≥ reference«  ┴ ^╘ o≥ ^┘ entereΣ a⌠ an∙ ì
characte≥ iε ß fielΣ wil∞ clea≥ thσ res⌠ oµ thσ fielΣ t∩ spaces«


Exiting the Edit Mode

Yo⌡ ma∙ exi⌠ thσ edi⌠ modσ anΣ returε t∩ thσ maiε men⌡ usinτ thσ command≤ ì
^╫ anΣ ES├ o≥ b∙ movinτ thσ curso≥ pas⌠ thσ to≡ o≥ bottoφ oµ thσ display«  ì
Al∞ change≤ wil∞ bσ saved¼ thσ element≤ wil∞ bσ resorteΣ iε editeΣ addres≤ ì
orde≥ anΣ thσ screeε displa∙ wil∞ bσ refreshed«

Yo⌡ ma∙ exi⌠ froφ thσ edi⌠ modσ directl∙ t∩ thσ operatinτ systeφ usinτ thσ ì
command ^Q.  The edited system will not be saved.

Wheε yo⌡ exi⌠ thσ edi⌠ mode¼ EDZC═ wil∞ accep⌠ withou⌠ questioε al∞ you≥ ì
editeΣ addresses«  I⌠ wil∞ resor⌠ thσ systeφ element≤ b∙ addres≤ anΣ ì
redispla∙ them«  Whilσ thσ ne≈ elemen⌠ orde≥ wil∞ bσ correc⌠ a≤ displayed¼ ì
n∩ recalculatioε wil∞ automaticall∙ bσ performeΣ oε exi⌠ froφ thσ edi⌠ ì
mode«  Thi≤ allow≤ yo⌡ t∩ creatσ non-standarΣ gap≤ betweeε systeφ element≤ ì
iµ yo⌡ wish«  I⌠ als∩  allow≤ yo⌡ t∩ ente≥ simplσ 'dummyº addresse≤ t∩ ì
forcσ thσ element≤ int∩ thσ prope≥ orde≥ prio≥ t∩ usinτ thσ 'Rº commanΣ t∩ ì
calculatσ thσ actua∞ addresses«  Seσ thσ sectioε oε 'Recalculationº fo≥ ì
morσ information.
:A

Ampro Systems

Unles≤ you≥ Ampr∩ basσ systeφ need≤ t∩ havσ ever∙ bi⌠ oµ TP┴ space¼ wh∙ usσ ì
ß CP/═ basσ systeφ anΣ givσ u≡ al∞ thosσ wonderfu∞ ZCPR│ amenitie≤ you'vσ ì
comσ t∩ lovσ anΣ expect┐  Yo⌡ caε no≈ usσ EDZC═ t∩ creatσ aε NZCO═ systeφ ì
tha⌠ use≤ thσ standarΣ Ampr∩ ZCPR│ buffer≤ alread∙ locateΣ abovσ thσ Ampr∩ ì
CBIOS«  Thi≤ allow≤ yo⌡ t∩ usσ ß standarΣ Ampr∩ ZCPR│ systeφ a≤ you≥ basσ ì
systeφ withou⌠ reducinτ you≥ TP┴ b∙ thσ 300╚ byte≤ oµ existinτ above-CBIO╙ ì
ZCPR│ buffe≥ space«  ì

Thσ samplσ file¼ AMPRO.ZCM¼ i≤ aε examplσ oµ aε actua∞ Ampro NZCO═ systeφ ì
tha⌠ ha≤ thσ prope≥ above-CBIO╙ Ampr∩ ZCPR│ buffe≥ location≤ anΣ sizes«  ì
Notσ tha⌠ thσ Whee∞ bytσ anΣ thσ PatΦ havσ beeε relocateΣ froφ pagσ ░ t∩ ì
addresse≤ iε thσ above-CBIO╙ ZCPR│ buffer≤ tha⌠ havσ alway≤ beeε reserveΣ ì
fo≥ them«

Edi⌠ thσ CBIO╙ address¼ iµ necessary¼ t∩ tha⌠ oµ you≥ owε Ampr∩ system«  Iµ ì
yo⌡ reducσ thσ CBIO╙ address¼ makσ surσ yo⌡ als∩ reducσ thσ addresse≤ oµ ì
everythinτ belo≈ thσ CBIO╙ b∙ thσ samσ amoun⌠ s∩ thing≤ don'⌠ ge⌠ ou⌠ oµ ì
order«  Edi⌠ thσ desireΣ NZCO═ elemen⌠ addresse≤ and/o≥ size≤ t∩ creatσ ß ì
ne≈ Ampr∩ NZCO═ ZC═ systeφ file.
:M

MKZCM Standard System

MKZC═ create≤ system≤ witΦ the following standard fixeΣ order:ì

          Custom BIOS                   CBIOS
          User Memory Area              UMA
          External Stack                EXTSTK
          Multiple Command Line         Z3CL
          Wheel Byte                    Z3WHL
          External Path                 EXPATH
          External FCB                  EXTFCB
          Message Buffer                Z3MSG
          Environment Descriptor        Z3ENV
          Shell Stack                   SHSTK
          Named Directory               Z3NDIR
          Flow Control Package          FCP
          Resident Command Package      RCP
          Input/Output Package          IOP
          NZCOM BIOS                    BIO
          Disk Operating System         DOS
          Command Processor             CCP