Identifies the source directory search lists and search methods
currently in effect.
Format
SHOW SOURCE
1 – Qualifiers
1.1 /DISPLAY
Identifies the search list used when the debugger displays source
code.
1.2 /EDIT
Identifies the search list to be used during execution of the
debugger's EDIT command.
2 – Description
The SET SOURCE/MODULE=module-name command establishes a source
directory search list for a particular module. The SET SOURCE
command establishes a source directory search list for all
modules not explicitly mentioned in a SET SOURCE/MODULE=module-
name command. When you have used those commands, SHOW SOURCE
identifies the source directory search list associated with each
search category.
If a source directory search list has not been established by
using the SET SOURCE or SET SOURCE/MODULE=module-name command,
the SHOW SOURCE command indicates that no directory search list
is currently in effect. In this case, the debugger expects each
source file to be in the same directory that it was in at compile
time (the debugger also checks that the version number and the
creation date and time of a source file match the information in
the debugger's symbol table).
The /EDIT qualifier is needed when the files used for the display
of source code are different from the files to be edited by using
the EDIT command. This is the case with Ada programs. For Ada
programs, the SHOW SOURCE command identifies the search list of
files used for source display (the copied source files in Ada
program libraries); the SHOW SOURCE/EDIT command identifies the
search list for the source files you edit when using the EDIT
command.
For information specific to Ada programs, see the
Language_Support Ada help topic.
Related commands:
(SET,CANCEL) SOURCE
3 – Examples
1.DBG> SHOW SOURCE
no directory search list in effect,
match the latest source file version
DBG> SET SOURCE [PROJA],[PROJB],DISK:[PETER.PROJC]
DBG> SHOW SOURCE
source directory search list for all modules,
match the latest source file version:
[PROJA]
[PROJB]
DISK:[PETER.PROJC]
DBG>
In this example, the SET SOURCE command directs the debugger to
search the directories [PROJA],[PROJB], and DISK:[PETER.PROJC].
By default, the debugger searches for the latest version of
source files.
2.DBG> SET SOURCE/MODULE=CTEST/EXACT [], DISK$2:[PROJD]
DBG> SHOW SOURCE
source directory search list for CTEST,
match the exact source file version:
[]
DISK$2:[PROJD]
source directory search list for all other modules,
match the latest source file version:
[PROJA]
[PROJB]
DISK:[PETER.PROJC]
DBG>
In this example, the SET SOURCE command directs the debugger
to search the current default directory ([]) and directory
DISK$2:[PROJD] for source files to use with the module CTEST.
The /EXACT qualifier specifies that the search will locate
the exact version of the CTEST source files found in the debug
symbol table.