DBG$HELP.HLB  —  DEBUG  SET  SOURCE  Description, Continued...
    Specifying the Directory Search Method

    When you issue a SET SOURCE command, be aware that one of the
    two qualifiers -/LATEST or /EXACT-will always be active. These
    qualifiers affect the debugger search method. The /LATEST
    qualifier directs the debugger to search for the version last
    created (the highest-numbered version in your directory). The
    /EXACT qualifier directs the debugger to search for the version
    last compiled (the version recorded in the debugger symbol table
    created at compile time). For example, a SET SOURCE/LATEST
    command might search for SORT.FOR;3 while a SET SOURCE/EXACT
    command might search for SORT.FOR;1.

    If the debugger locates this version using the directory search
    list, it checks that the creation or revision date and time,
    file size, record format, and file organization are the same as
    the original compile-time source file. If these characteristics
    match, the debugger concludes that the original source file has
    been located in its new directory.

    If the debugger cannot locate this version using the directory
    search list, it identifies the file that has the closest revision
    date and time (if such a file exists in that directory) and
    issues a NOTORIGSRC message ("original version of source file
    not found") when first displaying the source code.

    Specifying the /EDIT Qualifier

    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 (SET, SHOW, CANCEL) SOURCE commands affect
    the search of files used for source display (the "copied"
    source files in Ada program libraries); the (SET,SHOW,CANCEL)
    SOURCE/EDIT commands affect the search of the source files you
    edit when using the EDIT command. If you use /MODULE with /EDIT,
    the effect of /EDIT is further qualified by /MODULE.

    For information specific to Ada programs, see the
    Language_Support Ada help topic.

    Specifying the /ORIGINAL Qualifier

    Before you can use the /ORIGINAL qualifier in a SET SOURCE
    command, the Correlation Facility (a separate layered product)
    must be installed on your system. Refer to Correlation Facility
    documentation for information on creating a correlation library
    before debugging.

    Then, invoke the kept debugger and issue the SET SOURCE/ORIGINAL
    command as follows:

    $   DEBUG/KEEP
    DBG> SET SOURCE/ORIGINAL
    DBG> RUN filename.EXE

    After issuing these commands, you can debug STDL source code in
    the same way you debug any other supported language program.

    Related commands:

       (SHOW,CANCEL) SOURCE
Close Help