Processing Programs › Compiling a Program › Using the COMPILE Command › Issuing a COMPILE Command in CICS

Issuing a COMPILE Command in CICS

A compile initiated in CICS can produce a compilation listing directed to the output library or to a system or network printer. The default destination for output from an online compilation is the output library, where you can browse the output before you print it. Since online compilation of large applications (those with many report or panel definitions or a large procedure) could tie up much of the available resources, consider submitting compilations in batch with the compilation listing directed to the output library. For more information, see Batch Compilation.

One of the following messages informs you when compilation ends:

COMPILATION SUCCESSFUL
COMPILATION UNSUCCESSFUL, PROGRAM HAS ERRORS
COMPILE HAS FAILED

If the compilation was successful, the compilation produces a form of the program ready for execution, known as the object program, and a compilation listing. At this point, the program can run. For more information, see the Executing a Program.

If the compilation is unsuccessful, you can display either the compilation errors listing, including the errors listed at the end, or the procedure definition, with highlighted errors as an optional feature. Keep in mind, however, that there could be errors in any component of an application program, not just in the procedure. It is also possible to view both the compilation listing and the procedure definition by using a split screen. For more information on displaying output and splitting the screen, see the Working in the Environment Guide.

Example

To compile program DEMO1, enter:

COMPILE DEMO1

Assume that the compilation was unsuccessful and the message indicating that the program has errors appears. You can display the output and edit the corresponding section of the procedure definition by entering the following CA Ideal commands:

SPLIT
1 EDIT PROGRAM DEMO1 PROCEDURE
2 DISPLAY OUTPUT DEMO1

Then scroll to the errors given at the bottom of the compilation listing.

In the second region of the screen, the errors noted in the compilation listing are shown, while in the first region, the corresponding procedure statements are shown. Splitting the screen this way lets you proceed with:

1 EDIT *
.
.
.
1 COMPILE *
1 RUN *