;

                 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