;
                                    BA.COM                                    

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              10k (78)   BD98  2.4                                 Z3COM2

  1- Usage  2- Notes  3- Examples of Use  4- Help File  5- BA.HLP             


  
   BA is an alias-building utility which runs on Z80-based  ZRDOS or 'vanilla'
CP/M.  See BA.HLP for details on usage.
:1

Syntax:

   BA<cr>     
      -- Scriptfile name is  requested from  console.   The skeleton  alias is
         read from DUMMY.COM.  The new alias is written to scriptfile.COM.

   BA scriptfile /options<cr>
      -- Commmands are  read  from scriptfile.CMD.  The skeleton alias is read 
         from scriptfile.COM or  DUMMY.COM.   The  new  alias  is  written  to 
         scriptfile.COM.

   BA scriptfile oldalias /options<cr>
      -- Commmands are  read from scriptfile.CMD.   The skeleton alias is read 
         from oldalias.COM.  The new alias is written to scriptfile.COM.

   BA //<cr> 
      -- Display on-line help.



   For all call formats, the scriptfile will be supplied a type of CMD and the
aliasfile will will be supplied a type of COM as needed.  


   Options:   F - Display flow control, resume on any character.
              Z - Enable additional program messages.
:2

BA Notes:        
         
   a. Features: 
      o Accepts Named Directory file names  if ZCPR3 is present.   (Of course,
           the resultant alias will not run on CP/M!)
      o Quick help display lists all the call formats.
      o Restartable; BA can be re-executed with the system GO command.
      o The CP/M file format of spaces packed into tabs handled correctly.
      o The default alias script file type is "CMD;" the user may supply
           another.
      o Ambiguous script names accepted; update all aliases at one run.
      o The alias script may be one or several commands per line.
      o Script lines with semicolon in column one are retained as comments.
      o Both the old and new aliases are displayed for reference.
      o The CRC of the new alias is displayed for reference.
      o The size of the alias is displayed in two forms -
           how many characters are from the source file;
           how many characters would result if all $-fields are fully
           expanded.



BA Notes (cont'd):

      o Warning message is displayed if the alias will overflow the CLB.
      o Caution message is displayed if the $-field expansion may overflow
           the CLB.
      o The alias script is available to be put into the documentation or,
           in menu systems, to be put into screens for online reference.

   b. Vs 2.4 allows you to make and modify aliases with your own editor.   Any 
      editor that makes  a standard (non-DOC) ASCII text  file can be  used to 
      manage your aliases.
:3


Examples of Use:

   a. EDIT A15:$1.CMD;BA A15:$1

      -- an alias to update an alias. 
:4

                                    BA.COM

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              10k (80)   D15D  2.4                                 Z3HLP4
==============================================================================

   Z-System help file on use of BA.COM vs 2.4.
:5 :ba