DOCUMENTATION FILE
                             FOR AKA

============================================================================

AKA.ASM version 1.3 by Michael Conley and Larry Davis is released to the
                    public domain 6/02/86.  Questions or comments should
                    be left on the Charlatan's Cabin BBS (213) 656-4192.

The name AKA is taken from the expression "ALSO KNOWN AS" ... because this
program can "be" several other programs!  

This is a simple aliasing program for use with ZCMD or ZCPRx which allows
execution of a sequence of commands from a single file.  It depends upon
multiple command execution being enabled in your CCP.  If any of the programs
ends with a warmboot, subsequent commands will not be executed.  Its key
advantage is that NO SUBMIT FILE IS CREATED, and thus the commands themselves
are never seen by the user, and execution time is much faster.

============================================================================
EXAMPLE: 
========

Run AKA.  It asks for a command line.  You type:

	A0:;DIR *.BAK;ERA *.BAK;STAT A:

The program responds with instructions to type SAVE 4 newname.COM, 
so you type:

	SAVE 4 CLEANUP.COM

When you run CLEANUP, it logs you into A0:, performs a DIRECTORY of all
files named *.BAK and then erases them, then runs STAT.

CHANGING COMMANDS:
==================

You don't need the original AKA to create a new file.  Using our example
from before, you could use the CLEANUP program by simply adding a 'C' to
the command line:

	CLEANUP C

This would make the program behave exactly like the "virgin" AKA program,
asking for a new command line, and then instructing you to use the CP/M
SAVE command.  You could then write over cleanup, or create a new file
depending upon the filename chosen.

Because of the hazards of leaving such an option available on a public system,
the SECURE equate may be changed to TRUE to defeat cloning by copies other 
than the original AKA.

INSTALLATION:
=============

You probably will not need to reassemble the source code, which is provided
in the AKA library.  There are 3 exceptions:

	1)  You have an odd-length CCP (not 2k)  This would make the
	    automatic CCP locator produce an incorrect result.
	    In this case, enter the location of your CCP base in the
   	    appropriate equate.  Make sure you use the correct equate
	    to specify the internal buffer.   There are adequate notes
	    to guide you.

	2)  You are using an external command buffer.  This requires
	    setting the EXCBUF equate TRUE and manually inserting the
	    address of your external buffer at the appropriate equate.
	    Refer to notes in the program to locate these equates.

	3)  You are using an AKA cloned program on a public system, and
	    wish to disable the CHANGE feature.   Locate the SECURE equate
	    and set it to TRUE to disable this feature.  AKA will work
	    normally, but once a command is inserted into the clone, it
	    will ignore the 'C' switch on the command line.  See above.

Once the source code is edited, use ASM or MAC to build the program and
LOAD or MLOAD to make the .COM file.

THE GOTCHAS:
============

These are things that must be considered when using AKA:


1.  Your CCP must be capable of executing multiple commands from its
    internal or external buffer.  Unlike some other programs, AKA will 
    correctly initialize the NXTCHR pointer in the CCP so that the entire 
    command string will execute.

2.  WARMBOOT blues:  If any program in your string of commands exits
    via a warmboot, the rest of the command string will be wiped out
    and will not execute.

HISTORY:
========

version 1.3 adds conditional assembly for external command line buffer,
            and adds 'C' option for revising ANY copy of the program.
	     Special thanks to Russ Pencin of the Dallas Connection RCP/M
	     for his help and suggestions for this version.
							06/03/86 [MAC]
version 1.2 adds an input function to get the command line
							05/26/86  Larry Davis
version 1.1 adds automatic calculation of CCP address and buffer length
							05/19/86 [MAC]
version 1.0 initial release of AKA
							05/12/86 [MAC]