Qualified Symbol Names

Resolve ambiguities on a symbol file reference

Syntax

[\][::program][:module.]symbol

Where

\	force symbol name lookup before keyword lookup
program	specifies the program name containing the symbol
module	specifies the module name containing the symbol
symbol	specifies any symbolic reference expression

Discussion

When SourcePoint looks up a name it uses the current program scope. If the symbol name is not found, it continues looking in containing scopes trying to find the symbol.  It’s possible there may be more than one instance of a symbol name.  This can occur when there is static data with the same name in two different modules.  It can also occur when multiple programs are loaded, and more than one program has the same symbol name.

The qualified symbol name syntax allows SourcePoint to references the correct symbol.

If you have a symbol name that conflicts with a SourcePoint keyword, preface the name with the ‘\’ character. This forces SourcePoint to assume the name is a program symbol rather than a keyword

Example 1

To display a structure ints found in the module csample:

Command Input:

:csample.ints

Result:

a: 1

b: 2

c: 3

Example 2

To display a structure ints found in the module csample in the program flat:

Command Input:

::flat:csample.ints

Result:

a: 1

b: 2

c: 3

Related Topics

 

Symbolic References