## ALP Programming Guide and Reference

[prev][next][parent][TOC]

### Message Coordinates

Message coordinates (if present) appear as the first field within a message , and have one of two forms:

[Path]Filename(LLLL:CCCC):

[Path]Filename(LLLL,Macroname(LLLL,CCCC)):

Coordinates are displayed as part of a message if ALP is parsing an input stream and the event which caused the message to be diplayed is directly related to a specific location in the input. The coordinates show the user exactly where to look if action is required. The fact the ALP is parsing an input stream does not mean that coordinates will appear in a message; some messages may occur during parsing that are not a reference to the input stream.

Filename

This is the name of the file containing the input token which caused the message to be generated. If this is the root source file whose name was passed on the assembler command line, the file name will be displayed exactly as specified by the user. If this is an INCLUDE file, it will be displayed exactly as specified in the INCLUDE directive, and the path name where the file was searched for and found (if any) will be prepended to the beginning. ALP does not query the operating system in an attempt to derive the full path name of a partially qualified file.

Macroname

If the assembler is currently parsing tokens within a macro expansion, the name of the macro currently being expanded will appear in the coordinates.

Line Number (LLLL)

The first number in parentheses is the line number within the source file where the referenced token is located; this refers to the outer-most point of invocation if a macro name is also given in the message coordinates. A line number value appearing within parentheses following a macro name refers to the innermost point of expansion (since macro expansions may be nested) and references the original definition of the macro.

Column Number (CCCC)

The second number in parentheses is the column number of the first character of the referenced token within the source file or macro definition.