Chapter Contents |
Previous |
Next |
SAS/C Cross-Platform Compiler and C++ Development System User's Guide, Release 6.50 |
The SAS/C Debugger's
set
command provides two subcommands:
set search
and
set cache
. The
set search
command is used to specify a search list consisting of one or more filename templates. Each filename template specifies a location used by the debugger to search for source, include, or debugger
files associated with the load module being debugged. The debugger traverses the search list, looking for the file specified by each filename
template.
The
set cache
command is used in cross-development environments that support a distributed file system, primarily to improve the debuggers performance when accessing debugger files. The benefit is especially
noticeable when debugger files are large. This command uses a filename template to specify the primary location to save and search for debugger files. In a typical cross-debugging session, this
location would
be on the mainframe.
Note: Frequently, file access problems are caused by an improper mount to the remote file system. If you encounter difficulty with either the
set search
or the
set cache
subcommands, refer to Accessing Remote File Systems
.
Locating the Debugger File |
set cache
command.
set search debug
command.
path:
.
The debugger first checks to see if a cache location has been specified. The
set cache
command uses a filename template to specify a location for the debugger file. For example, the following form of the
set cache
command could be used to specify a cache location in the CMS file system:
'SET CACHE DEBUG = "%sname dbg370"'
set search debug = "//ddn:DBGLIB(%sname)"
Note: You can create an empty debug search list
with a
set search debug
command of the form:
set search debug = ""
.
On CMS systems, no default templates are defined for the debug search list, so you will probably want to define one or more templates. The following form of
the
set search
command can be used to specify a new search list for the debugger file:
'SET SEARCH DEBUG = "cms: %sname db *"'
Finally, the debugger will attempt to open a file with the name the compiler used when it created the file and the SAS/C
filename style prefix
path:
.
Locating Source Files |
set search source
command.
path:
.
set search source = "//ddn:DBGSRC(%sname)"
If a file is not found using one of the templates in the source search list the debugger attempts to open the file by the name the compiler used for the file. Finally, the
debugger will attempt to open a file with the name the compiler used when it created the file, prefixed by the SAS/C filename style prefix
path:
.
The source search list is not checked for source files that have been altered by a
#line
preprocessor statement that specified a filename. Instead, the separate
altsource
search list is used. See file-tag Values
for more information on
altsource
.
You can use the following forms of the
set search
command to specify a new source search list to be used to locate these files:
set search source = "template1" "template2"... set search altsource = "template1" "template2"...
Locating include Files |
set search systeminclude
command or the
set search userinclude
command.
path:
.
You can use the following forms of the
set search
command to specify a new search list to be used to locate these files:
set search systeminclude = "template1" "template2"... set search userinclude = "template1" "template2"...
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 1998 by SAS Institute Inc., Cary, NC, USA. All rights reserved.