COMPRESS | NOCOMPRESS

Category

Object code control

Pragma equivalent

None.

Purpose

Suppresses the generation of function names in the function control block, thereby reducing the size of your application's load module.

Syntax

Read syntax diagramSkip visual syntax diagram
   .-NOCOMPRESS-.   
>>-+-COMPRESS---+----------------------------------------------><

Defaults

NOCOMPRESS

Usage

Function names are used by the dump service to provide you with meaningful diagnostic information when your program encounters a fatal program error. They are also used by tools such as Debug Tool and the Performance Analyzer. Without these function names, the reports generated by these services and tools may not be complete.

If COMPRESS and TEST or DEBUG are in effect at the same time, the compiler issues a warning message and ignores the COMPRESS option.

IPA effects

The IPA compile step generates information for the IPA link step. COMPRESS also affects the regular object module if you request one by specifying the IPA(OBJECT) option.

If you specify the COMPRESS option for the IPA link step, it uses the value of the option that you specify. The IPA link step Prolog listing section will display the value of the option that you specify.

If you do not specify COMPRESS option in the IPA link step, the setting from the IPA compile step will be used.

The IPA link step merges and optimizes your application code, and then divides it into sections for code generation. Each of these sections is a partition. The IPA link step uses information from the IPA compile step to determine if a subprogram can be placed in a particular partition. Only compatible subprograms are included in a given partition. Compatible subprograms have the same COMPRESS setting.

The COMPRESS setting for a partition is set to the specification of the first subprogram that is placed in the partition. Subprograms that follow are placed in partitions that have the same COMPRESS setting. A NOCOMPRESS mode subprogram is placed in a NOCOMPRESS partition, and a COMPRESS mode subprogram is placed in a COMPRESS partition.

The option value that you specified for each IPA object file on the IPA compile step appears in the IPA link step Compiler Options Map listing section.

The Partition Map sections of the IPA link step listing and the object module END information section display the value of the COMPRESS option.

Predefined macros

None.

Related information

For more information on related compiler options, see: