System Debug Reference Manual (32650-90888)

76 Chapter4
System Debug Command Specifications :-Exit
ALIAS
Several predefined aliases (command abbreviations) are automatically generated, and are
classified as
predefined aliases. Refer to the ALIASLIST and ALIASINIT commands.
Parameters
name The name of the alias (the new name to be used in place of another). Alias
names are restricted to 16 characters.
command The command name to be used when the alias name is encountered. This
can be any command or macro name. The command name is restricted to
32 characters.
Examples
$nmdebug > printtableentrylength 6
$200
$nmdebug > alias tbl printtableentrylength
$nmdebug > tbl 6
$200
The above example assumes that a macro called printtableentrylength has been
defined, and a typical macro invocation is displayed. Since the macro name is long, and
difficult to enter, an alias named TBL is defined. The shorter alias name can now be used in
place of the longer macro name.
$nmdebug > alias loop foreach
$nmdebug > loop j '1 2 3' {wl j}
$1
$2
$3
Create an alias named LOOP that is the same as the FOREACH command.
$nmdat > macro concealexit { wl "type EXIT to exit."}
$nmdat > alias e concealexit
A command is hidden by this new alias. (warning #71)
$nmdat > e
type EXIT to exit.
In this example, the single character command e (for EXIT) is protected by an alias, that
conceals (hides) the original command. Note that a warning message is generated
whenever a command name is concealed by an alias definition.
$nmdat > alias one two
$nmdat > alias two three
$nmdat > alias three one
$nmdat > one
Circular ALIAS error. Recursive ALIAS definition(s). (error
#2445)
It is legal for an alias (for example, one in the example above) to refer to another alias (two
in the example above), so long as the chain of aliases does not wrap back onto itself.
Recursive aliases are detected, and an error is generated.