home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / SALIAS16.LBR / ALIAS.HZP / ALIAS.HLP
Encoding:
Text File  |  1990-09-05  |  5.1 KB  |  167 lines
  1. ;
  2.  
  3.                             ALIA╙ 1.5
  4.  
  5.                     The ZCPR3 ALIAS Facility
  6.  
  7.                       A - The ALIAS Command
  8.  
  9.                        E - ALIAS Examples
  10.  
  11.                  S - Summary of ALIAS Variables
  12.  
  13. :A
  14.  
  15. Command:  ALIAS
  16.  
  17.                  Syntax:é  ALIA╙ [[dir:]cmndname]
  18.  
  19. Function:
  20.  
  21.      Thσ ALIA╙ facilit∙ i≤ thσ scrip⌠ expansioε utilit∙ oµ ZCPR3«  ì
  22. Aε áAlia≤ ái≤ áß áCO═ filσ createΣ b∙ áthσ áALIA╙ áprograφ áwhicΦ ì
  23. contain≤ áonσ áo≥ morσ command≤ (separateΣ b∙ semicolons⌐ át∩ ábσ ì
  24. placeΣ áiε thσ CommanΣ Linσ Buffer«  Wheε thσ Alia≤ ái≤ áinvoked¼ ì
  25. parameter≤ áfroφ thσ commanΣ linσ arσ implanteΣ int∩ áthσ áscrip⌠ ì
  26. containeΣ withiε thσ Alias¼ anΣ thσ resultinτ ne≈ commanΣ linσ i≤ ì
  27. placeΣ int∩ thσ CommanΣ Linσ Buffe≥ anΣ executed.
  28.  
  29.  
  30. Options:
  31.      None
  32.  
  33. Comments:
  34.  
  35.      ZCPR│ áMUS╘ ábσ implementeΣ witΦ aε áExterna∞ áCommanΣ áLinσ ì
  36. Buffe≥ iε orde≥ fo≥ ALIA╙ t∩ work.
  37.  
  38.      Thσ áscrip⌠ oµ thσ interna∞ commanΣ linσ support≤ áparamete≥ ì
  39. passinτ áiε ß manne≥ simila≥ t∩ ZE╪ anΣ SUB«  Thσ ávariable≤ á$n¼ ì
  40. wherσ á░ á<╜ áε á<╜ 9¼ ma∙ bσ placeΣ int∩ áthσ áscript¼ áanΣ áthσ ì
  41. correspondinτ áparameter≤ wil∞ bσ substituteΣ fo≥ áthσ áindicateΣ ì
  42. variables«  Thσ variablσ $░ i≤ thσ namσ oµ thσ Alia≤ itself«  Thσ ì
  43. variablσ $¬ i≤ thσ entirσ tai∞ oµ thσ commanΣ line.
  44.  
  45.  
  46.      Ne≈ ávariables¼ $─ anΣ $U¼ arσ available«  $─ áexpand≤ áint∩ ì
  47. thσ lette≥ oµ thσ disδ whicΦ wa≤ loggeΣ iε a⌠ thσ timσ thσ áAlia≤ ì
  48. wa≤ áexpandeΣ (thσ homσ disk)¼ anΣ $╒ expand≤ int∩ ß ánumbe≥ á(iε ì
  49. ASCI╔ áchars⌐ representinτ thσ use≥ areß whicΦ wa≤ loggeΣ áiε áa⌠ ì
  50. thσ timσ thσ Alia≤ wa≤ expandeΣ (thσ homσ user).
  51.  
  52.      Thσ áZCPR│ Systeφ filσ name≤ arσ availablσ t∩ thσ áAlia≤ áa≤ ì
  53. thσ ávariable≤ á$Fε fo≥ NAME.TYP¼ $Nε fo≥ NAM┼ anΣ $Tε áfo≥ áTYP¼ ì
  54. wherσ á░ <╜ ε <╜ 4«  $F░ refer≤ t∩ thσ prototypσ SH.VA╥ áfilenamσ ì
  55. whilσ $F▒ refer≤ t∩ NAME.TY╨ oµ Systeφ Filσ 1¼ $N▒ refer≤ t∩ NAM┼ ì
  56. oµ Systeφ Filσ 1¼ etc«  Notσ tha⌠ thσ SETFIL┼ commanΣ i≤ useΣ át∩ ì
  57. definσ thσ content≤ oµ thσ Systeφ filσ names.
  58.  
  59.      '$$º áexpand≤ int∩ ß singlσ '$'«  Iε fact¼ an∙ áunrecognizeΣ ì
  60. variablσ afte≥ ß '$º wil∞ expanΣ t∩ itself«  
  61.  
  62.  
  63.      ┴ áne≈ áALIA╙ ávariablσ i≤ introduceΣ a⌠ áVersioε á1.5¼ áthσ ì
  64. Pointer« á I⌠ áwil∞ áreturε áthσ content≤ áoµ áan∙ áknowε ámemor∙ ì
  65. locatioε (plu≤ aε optiona∞ offset)«  I⌠ take≤ thσ forφ..
  66.               $.ADDR[+OFF][[.OFF[+OFF]][.OFF[+OFF]]
  67.  
  68.      Fo≥ example¼ oε m∙ NZCO═ system..
  69.  
  70. $.▒            (0001H⌐        D50│      Bio≤ Warφ boo⌠ entry      
  71. $.1-│          (0001H⌐        D50░      Beginninτ oµ Bios
  72. $.╢            (0006H⌐        C70╢      BDO╙ entry
  73.  
  74. $.10╣          (0109H⌐        E78░      Z3EN╓ address
  75. $.109.2▓       (Z3ENV+22H⌐    E88░      Z3MS╟ buffe≥ address
  76. $.109.22+╢     Z3MSG+╢        E88╢      Prograφ Erro≥ Flag
  77. $.109.1╕       (Z3ENV+18H⌐    E90░      Z3C╠ address
  78. $.109.18.░     (Z3CL⌐         E9x°      NXTCH╥ pointer
  79.  
  80.  
  81.                  Summary of Alias Variables
  82.  
  83.      $0  - Name of Alias
  84.      $n  - Parameter from Command Line (1 <= n <= 9)
  85.  
  86.      $*  - Tail of Command Line (everything after the verb)
  87.  
  88.      $D  - Curren⌠ Drivσ Letter
  89.      $U  - Curren⌠ Use≥ Number
  90.  
  91.      $F░ ¡ Prototypσ SH.VA╥ Shel∞ Variablσ File
  92.      $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
  93.      $Nn - FILENAME of System File n
  94.      $Tε ¡ TY╨ oµ Systeφ Filσ n
  95.  
  96.      $.add≥ ¡ Ne≈ Pointe≥ variable
  97.  
  98.      $$  - The character '$'
  99.  
  100.  
  101.  
  102.  
  103. Error Messages:é  (onl∙ one)
  104.  
  105.      "Ovfló ámean≤ átha⌠ áeithe≥ ß particula≥ ácommanΣ átai∞ áha≤ ì
  106. expandeΣ ábeyonΣ á12╢ character≤ anΣ woulΣ overflo≈ TBUF╞ áiµ ái⌠ ì
  107. werσ áruε áo≥ áthσ áexpandeΣ commanΣ álines¼ ácombineΣ áwitΦ áthσ ì
  108. remainde≥ oµ thσ content≤ oµ thσ commanΣ linσ buffer¼ i≤ to∩ lonτ ì
  109. t∩ fi⌠ iε thσ commanΣ linσ buffer.
  110.  
  111. :S
  112.  
  113.                  Summary of Alias Variables
  114.  
  115.      $0  - Name of Alias
  116.      $n  - Parameter from Command Line (1 <= n <= 9)
  117.  
  118.      $*  - Tail of Command Line (everything after the verb)
  119.  
  120.      $D  - Home Disk
  121.      $U  - Home User
  122.  
  123.      $F░ ¡ SH.VA╥ prototypσ Shel∞ Variablσ filename
  124.      $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
  125.      $Nn - FILENAME of System File n
  126.      $Tε ¡ TY╨ oµ Systeφ Filσ n
  127.  
  128.      $.add≥ ¡ Ne≈ Pointe≥ variable
  129.  
  130.      $$  - The character '$'
  131.  
  132. :E
  133.  
  134.                     Examples of Aliases
  135.  
  136. Case 1:
  137.  
  138.      Thσ use≥ i≤ constantl∙ issuinτ thσ followinτ command≤ iε thσ ì
  139. orde≥ indicated:
  140.  
  141.           ASM myfile.BBZ
  142.           LOAD myfile
  143.  
  144.      He can generalize it with the following Alias script:
  145.  
  146.           ASM $1.BBZ;LOAD $1
  147.  
  148.      If this Alias is named MYASM.COM, then typing
  149.  
  150. "MYASM test" will be equivalent to "ASM test.BBZ;LOAD test"
  151.  
  152. Case 2:
  153.  
  154.      Samσ a≤ Casσ ▒ excep⌠ t∩ thσ Curren⌠ Drive¼ no⌠ ánecessaril∙ ì
  155. drivσ B:
  156.  
  157.           AS═ $1.$D$DZ;LOA─ $1
  158.  
  159. Casσ 3:
  160.  
  161.      Imaginσ áyo⌡ havσ changeΣ disk≤ iε thσ drivσ ├ anΣ yo⌡ áwan⌠ ì
  162. t∩ displa∙ it≤ director∙ anΣ spacσ available«  Yo⌡ woulΣ normall∙ ì
  163. executσ ^├ t∩ warφ boot¼ theε maybσ XDI╥ C║ fo≥ thσ display« á Aε ì
  164. alia≤ caε reducσ thi≤ t∩ ß singlσ characte≥ command¼ X.
  165.  
  166.           JUM╨ 0;XDI╥ C:
  167.