Application Debugging Tools › Compile Debugging

Compile Debugging

Based on your site and session output settings and on your use of the DESTINATION clause with CA Ideal output commands, you can direct the output of an online or a batch compilation‑the compilation listing‑to either the output library (for browsing online) or to a system printer. You can also direct an online compilation to a network printer.

You can use several options of the COMPILE command or the equivalent COMPILE prompter to aid in compile debugging. The Programming Reference Guide has the complete syntax. Working in the Environment Guide describes the compilation listing.

Compilation options include the following:

IDE

• YES-Includes identification information, program resources and environment sections in the compilation listing.
• NO-Does not include it.

EXD

• YES-Includes external data (dataview definitions, panel definitions, report definitions, and copied SQLCAs) in the compilation listing.
• NO-Does not include it.

BOD

• YES-Includes the body of the program (working data, parameter data, and procedure definition) in the compilation listing.
• NO-Does not include it.

ADV

• YES-Includes advisory messages in the compilation listing.
• NO-Does not include it.

MEL

• YES-Marks error lines in the original procedure definition. If SET EDIT HIGHLIGHT ERRORS is in effect, they are highlighted. They can also be found using FIND/INCL ERROR. This does not see the compilation listing as do the other options.
• NO-Does not mark errors.

LSQL

• YES-Lists SQL generated from any FOR constructs.
• NO-Does not list generated SQL.

REF

• FULL-Generates a cross reference listing.
• SHORT-Suppresses symbol names that are defined but not referenced.
• NO-Does not generate a cross reference listing.

  Note: You can specify this option for any batch compiles. No cross-reference listing is generated in CICS.

PANEL

• FULL-Includes all panel components in the listing.
• SHORT-Includes only the Identification, Summary, and Facsimile.
• NO-Does not include any panel components in the compilation listing.

  Note: This only applies if EXD is YES.

Select all of these options if you are going to communicate with CA Ideal Technical Support. However, these options do incur some overhead. Use only those needed (for example, ADV and MEL) in a normal testing environment.

Example

COMPILE PGM 1 VER 2 IDE Y EXD Y BOD Y ADV Y MEL Y

To determine which options are on, use the DISPLAY SESSION COMPILE command. You can select any of the above options for a single compile, for a session, or for the site for the following:

• Each compile, using the COMPILE command.
• The current session, using SET COMPILE commands issued during the current session, or SET COMPILE commands executed in a CA Ideal data member.
• The site, using SET SITE commands.