Brotikasten/BROTCD01.iso/cpm/salias16.lbr/ALIAS.HZP/ALIAS.HLP

Text File | 1990-09-05 | 5KB | 167 lines

;

                            ALIA╙ 1.5

                    The ZCPR3 ALIAS Facility

                      A - 
The ALIAS Command

                       E - 
ALIAS Examples

                 S - 
Summary of ALIAS Variables

:A


Command:  ALIAS

                 
Syntax:é  ALIA╙ [[dir:]cmndname]


Function:

     Thσ ALIA╙ facilit∙ i≤ thσ scrip⌠ expansioε utilit∙ oµ ZCPR3«  ì
Aε áAlia≤ ái≤ áß áCO═ filσ createΣ b∙ áthσ áALIA╙ áprograφ áwhicΦ ì
contain≤ áonσ áo≥ morσ command≤ (separateΣ b∙ semicolons⌐ át∩ ábσ ì
placeΣ áiε thσ CommanΣ Linσ Buffer«  Wheε thσ Alia≤ ái≤ áinvoked¼ ì
parameter≤ áfroφ thσ commanΣ linσ arσ implanteΣ int∩ áthσ áscrip⌠ ì
containeΣ withiε thσ Alias¼ anΣ thσ resultinτ ne≈ commanΣ linσ i≤ ì
placeΣ int∩ thσ CommanΣ Linσ Buffe≥ anΣ executed.



Options:
     None


Comments:

     ZCPR│ áMUS╘ ábσ implementeΣ witΦ aε áExterna∞ áCommanΣ áLinσ ì
Buffe≥ iε orde≥ fo≥ ALIA╙ t∩ work.

     Thσ áscrip⌠ oµ thσ interna∞ commanΣ linσ support≤ áparamete≥ ì
passinτ áiε ß manne≥ simila≥ t∩ ZE╪ anΣ SUB«  Thσ ávariable≤ á$n¼ ì
wherσ á░ á<╜ áε á<╜ 9¼ ma∙ bσ placeΣ int∩ áthσ áscript¼ áanΣ áthσ ì
correspondinτ áparameter≤ wil∞ bσ substituteΣ fo≥ áthσ áindicateΣ ì
variables«  Thσ variablσ $░ i≤ thσ namσ oµ thσ Alia≤ itself«  Thσ ì
variablσ $¬ i≤ thσ entirσ tai∞ oµ thσ commanΣ line.


     Ne≈ ávariables¼ $─ anΣ $U¼ arσ available«  $─ áexpand≤ áint∩ ì
thσ lette≥ oµ thσ disδ whicΦ wa≤ loggeΣ iε a⌠ thσ timσ thσ áAlia≤ ì
wa≤ áexpandeΣ (thσ homσ disk)¼ anΣ $╒ expand≤ int∩ ß ánumbe≥ á(iε ì
ASCI╔ áchars⌐ representinτ thσ use≥ areß whicΦ wa≤ loggeΣ áiε áa⌠ ì
thσ timσ thσ Alia≤ wa≤ expandeΣ (thσ homσ user).

     Thσ áZCPR│ Systeφ filσ name≤ arσ availablσ t∩ thσ áAlia≤ áa≤ ì
thσ ávariable≤ á$Fε fo≥ NAME.TYP¼ $Nε fo≥ NAM┼ anΣ $Tε áfo≥ áTYP¼ ì
wherσ á░ <╜ ε <╜ 4«  $F░ refer≤ t∩ thσ prototypσ SH.VA╥ áfilenamσ ì
whilσ $F▒ refer≤ t∩ NAME.TY╨ oµ Systeφ Filσ 1¼ $N▒ refer≤ t∩ NAM┼ ì
oµ Systeφ Filσ 1¼ etc«  Notσ tha⌠ thσ SETFIL┼ commanΣ i≤ useΣ át∩ ì
definσ thσ content≤ oµ thσ Systeφ filσ names.

     '$$º áexpand≤ int∩ ß singlσ '$'«  Iε fact¼ an∙ áunrecognizeΣ ì
variablσ afte≥ ß '$º wil∞ expanΣ t∩ itself«


     ┴ áne≈ áALIA╙ ávariablσ i≤ introduceΣ a⌠ áVersioε á1.5¼ áthσ ì
Pointer« á I⌠ áwil∞ áreturε áthσ content≤ áoµ áan∙ áknowε ámemor∙ ì
locatioε (plu≤ aε optiona∞ offset)«  I⌠ take≤ thσ forφ..
              $.ADDR[+OFF][[.OFF[+OFF]][.OFF[+OFF]]

     Fo≥ example¼ oε m∙ NZCO═ system..

$.▒            (0001H⌐        D50│      Bio≤ Warφ boo⌠ entry
$.1-│          (0001H⌐        D50░      Beginninτ oµ Bios
$.╢            (0006H⌐        C70╢      BDO╙ entry

$.10╣          (0109H⌐        E78░      Z3EN╓ address
$.109.2▓       (Z3ENV+22H⌐    E88░      Z3MS╟ buffe≥ address
$.109.22+╢     Z3MSG+╢        E88╢      Prograφ Erro≥ Flag
$.109.1╕       (Z3ENV+18H⌐    E90░      Z3C╠ address
$.109.18.░     (Z3CL⌐         E9x°      NXTCH╥ pointer


                 
Summary of Alias Variables

     $0  - Name of Alias
     $n  - Parameter from Command Line (1 <= n <= 9)

     $*  - Tail of Command Line (everything after the verb)

     $D  - Curren⌠ Drivσ Letter
     $U  - Curren⌠ Use≥ Number

     $F░ ¡ Prototypσ SH.VA╥ Shel∞ Variablσ File
     $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
     $Nn - FILENAME of System File n
     $Tε ¡ TY╨ oµ Systeφ Filσ n

     $.add≥ ¡ Ne≈ Pointe≥ variable

     $$  - The character '$'





Error Messages:é  (onl∙ one)

     "Ovfló ámean≤ átha⌠ áeithe≥ ß particula≥ ácommanΣ átai∞ áha≤ ì
expandeΣ ábeyonΣ á12╢ character≤ anΣ woulΣ overflo≈ TBUF╞ áiµ ái⌠ ì
werσ áruε áo≥ áthσ áexpandeΣ commanΣ álines¼ ácombineΣ áwitΦ áthσ ì
remainde≥ oµ thσ content≤ oµ thσ commanΣ linσ buffer¼ i≤ to∩ lonτ ì
t∩ fi⌠ iε thσ commanΣ linσ buffer.

:S

                 
Summary of Alias Variables

     $0  - Name of Alias
     $n  - Parameter from Command Line (1 <= n <= 9)

     $*  - Tail of Command Line (everything after the verb)

     $D  - Home Disk
     $U  - Home User

     $F░ ¡ SH.VA╥ prototypσ Shel∞ Variablσ filename
     $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
     $Nn - FILENAME of System File n
     $Tε ¡ TY╨ oµ Systeφ Filσ n

     $.add≥ ¡ Ne≈ Pointe≥ variable

     $$  - The character '$'

:E

                    
Examples of Aliases

Case 1:

     Thσ use≥ i≤ constantl∙ issuinτ thσ followinτ command≤ iε thσ ì
orde≥ indicated:

          ASM myfile.BBZ
          LOAD myfile

     He can generalize it with the following Alias script:

          ASM $1.BBZ;LOAD $1

     If this Alias is named MYASM.COM, then typing

"MYASM test" will be equivalent to "ASM test.BBZ;LOAD test"

Case 2:

     Samσ a≤ Casσ ▒ excep⌠ t∩ thσ Curren⌠ Drive¼ no⌠ ánecessaril∙ ì
drivσ B:

          AS═ $1.$D$DZ;LOA─ $1

Casσ 3:

     Imaginσ áyo⌡ havσ changeΣ disk≤ iε thσ drivσ ├ anΣ yo⌡ áwan⌠ ì
t∩ displa∙ it≤ director∙ anΣ spacσ available«  Yo⌡ woulΣ normall∙ ì
executσ ^├ t∩ warφ boot¼ theε maybσ XDI╥ C║ fo≥ thσ display« á Aε ì
alia≤ caε reducσ thi≤ t∩ ß singlσ characte≥ command¼ X.

          JUM╨ 0;XDI╥ C: