;

                  The ZCPR3 ALIAS Facility

                   A - 
The ALIAS Command

                     E - 
ALIAS Examples

               S - 
Summary of ALIAS Variables

:A


Command:  ALIAS 1.1


Syntax:

     ALIAS          <-- Define New Command
or
     ALIAS dir:ufn  <-- Redefine Old Command


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å �
Buffer in order for ALIAS to 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å �
command line.


     Twï  additionaì 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ä �
(the home user).

     Thå  ZCPR³ Systeí filå nameó arå availablå tï thå Aliaó �
aó thå variableó $Fî anä $Nn¬ wherå ± <½ î <½ 4®  $F± referó �
tï FILENAME.TYÐ oæ Systeí Filå 1¬  $N± referó tï FILENAMÅ oæ �
Systeí Filå 2¬  etc®   Notå thaô thå SETFILÅ commanä ió useä �
to define the contents of the System file names.

     '$$' expands into a single '$'.


                 
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

     $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
     $Nn - FILENAME of System File n

     $$  - The character '$'



Selected Error Messages:

     "Ovfl¢ meanó thaô thå expandeä commanä  line¬  combineä �
witè  thå  remaindeò  oæ thå contentó oæ  thå  commanä  linå �
buffer, is too long to fit in the command line buffer.


Examples of Use:

     ALIAS
          -- define Alias

     ALIAS alias
          -- display script of "alias.COM" and edit

: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

     $Fn - FILENAME.TYP of System File n (1 <= n <= 4)
     $Nn - FILENAME of System File n

     $$  - The character '$'

:E

                    
Examples of Aliases

Case 1:

     Thå  useò ió constantlù issuinç thå followinç  commandó �
in the order 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:

     Thå  useò haó twï printeró oî hió system®   Hå ió usinç �
redirectablå I/Ï aó implementeä undeò ZCPR3¬  anä hå haó twï �
versionó oæ Worä Staò (trademark¬  Micropro© - onå foò  eacè �
printer®   Hå  caî creatå aî Aliaó containinç thå  followinç �
script:

       Script              Meaning

       IÆ NEC=$²           Checë tï seå iæ 2nä parí ió NEC
            DEV L NEC      If so, assign LST to NEC
            WSN $1            and run NEC version of WS
       ELSE                If not ...
            DEV L TTY         assign LST to TTY
            WST $1            and run TTY version of WS
       FI

     If the Alias was named WSTAR, then:

     "WSTAR myfile.txt"

would be equivalent to

     DEV L TTY;WST myfile.txt

and

     "WSTAR myfile.txt NEC"

would be equivalent to

     DEV L NEC;WSN myfile.txt