Creates a synonym or alias for an illegal or undesirable name.
The restrictions on the characters that can be used for symbols within an assembler source file are defined in "Constructing Symbols". The symbol cannot contain any blanks or special characters, and cannot begin with a digit.
For any external symbol that must contain special characters, the .rename pseudo-op provides a way to do so.
The .rename pseudo-op changes the Name parameter to the StringConstant value for all external references at the end of assembly. Internal references to the local assembly are made to Name. The externally visible Name is StringConstant. The .rename pseudo-op is useful in referencing symbol names that are otherwise illegal in the assembler syntax.
|Name||Represents a symbol. To be externally visible, the Name parameter must appear in an .extern or .globl statement.|
|StringConstant||Represents the value to which the Name parameter is changed at end of assembly.|
The following example illustrates the use of the .rename pseudo-op:
.csect mst_sect[RW] .globl mst_sect[RW] OK_chars: .globl OK_chars .long OK_chars .rename OK_chars,"$_SPECIAL_$_char" .rename mst_sect[RW],"MST_sect_renamed"
The .extern pseudo-op, .globl pseudo-op.