Chapter Contents

Previous

Next
Using the Debugger in a Cross-Development Environment

Introduction

The SAS/C Debugger enables you to debug programs in a cross-development environment. To debug a load module that was compiled with the SAS/C or C++ cross-platform compiler, you run the program with the =debug run-time option, just like any other SAS/C or C++ load module.

The debugger provides access to information from several different types of files that may be resident on either the UNIX or Windows host or the target mainframe, including

In a cross-development environment, the files that are used by the debugger, with the exception of the load module file, may reside on the host workstation. In order for the debugger to access files that reside on the workstation, a distributed file system must establish a client/server relationship between the target mainframe and the host workstation. The Network File System (NFS) is the distributed file system that is used in the SAS/C cross-development environment. For more information, see Installing and Administering the NFS Client. Using NFS and running on the mainframe under OS/390 or CMS, the debugger has direct access to the source, include, and debugger files that reside on the host workstation.

If the debugger's default file-searching mechanism does not meet your needs, you can change or augment the search mechanism with the debugger's set search command. The set search command is used to specify filename templates. Filename templates are used to specify the identity and location of the source, include, or debugger files that are associated with the load module that is being debugged. Multiple filename templates can be defined for each type of file. As a result, the debugger can search for a file by more than one name or in multiple locations. Each template is saved in a search list, and each search list is associated with a specific type of file.

Filename templates are character strings that are similar to the patterns in a printf statement. Each filename template may contain conversion specifiers and characters. A conversion specifier is a character or a string that is preceded by a percent character. The conversion specifier is either replaced by its associated string or specifies the format of the conversion specifier that follows it. The resulting string is used as the name of the file to be opened. If a file with the resulting name cannot be opened, the next filename template in the search list is processed until either a file is opened or there are no more filename templates in the search list for that type of file.

This powerful technique enables you to direct the debugger to files that have moved or even changed names or file systems. This chapter explains how to use the set search and set cache commands in order to define filename templates and to establish search lists.

Debugging in a Cross-Development Environment illustrates the relationship between the files that are used by the SAS/C Debugger in a cross-development environment.

Debugging in a Cross-Development Environment

[IMAGE]


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.