-qlist

Purpose

Produces a compiler listing file that includes an object listing.

When -qlist is in effect, a listing file is generated with a .lst suffix for each source file named on the command line.

Syntax


        .-nolist--------------------.   
>>- -q--+-list--+-----------------+-+--------------------------><
                |    .-nooffset-. |     
                '-=--+-offset---+-'

@PROCESS:

@PROCESS LIST[([NO]OFFSET)] | NOLIST

Defaults

-qnolist

Parameters

offset | nooffset

When -qlist=offset is in effect, the listing will show the offset from the start of the procedure rather than the offset from the start of code generation. This suboption allows any program reading the .lst file to add the value of the PDEF and the line in question, and come up with the same value whether offset or nooffset is specified.

The offset suboption is relevant only if there are multiple procedures in a compilation unit. For example, this may occur if nested procedures are used in a program.

Specifying -qlist with no suboption is equivalent to -qlist=nooffset.

Usage

You can use the object listing to help understand the performance characteristics of the generated code and to diagnose execution problems.

If you specify -qipa and want to generate the IPA listing file, use the -qipa=list=filename suboption to get an alternative listing.

The -qnoprint compiler option overrides this option.