NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

82 Chapter 5. Debugging a SAF Application
Referring to the Log Information
SAF subroutines contain a logging feature that may be turned on or off by an
environment variable. For setting this feature, see "Environment variable setup for
SAF subroutine" in Chapter 4. Since it is the log information of SAF subroutines, it is
not a program trace, but it provides a record of the SAF subroutine calls made by the
program. The log file record format is as follows:
Process ID thread ID year-month-day hour:minute:second severity message
A concrete example of the configuration is given below.
0000000188 0000000187 1999-02-02 11:48:07 02 COB-06310: COBW3: The specified
conversion name has already been set. The conversion information that has already
been set is validated.
0000000188 0000000181 1999-02-02 11:48:10 01 COB-04470: COBW3: The conversion
information specified could not be changed because it has not been set.
To collect trace information from an application, itself, use the TRACE function of
COBOL. For details of the TRACE function, see "NetCOBOL Debugging Guide."
For details of the log output by SAF Director, see " SAF Director Reference" in
Chapter 4.
Checking Execution Using the Interactive Debugger
The debug the Web application generated in the COBOL, by using the debugger, use
the method of starting the debugger from the program to be debugged.
The Web application can be remotely debugged from the client which starts a WWW
browser by using a remote debugger. Please refer to “NetCOBOL Debugging Guide”
for the usage of a remote debugger.
The following must be noted when debugging an application by using the interactive
debugger because NES reads all Web applications into the same memory space.
•
•
If a Web application operates incorrectly, not only the application being
debugged but also other Web applications loaded at the same time and NES
itself may fail. We recommend using the interactive debugger only when other
Web applications are not in use. If this is successful, then you can check
operations when other Web applications are active.
The debugger debugs not only the Web application being tested, but also other
Web applications and NES itself. If the debugger terminates, other Web
applications and NES will also terminate and it will be necessary to restart NES.