Options

–o outputfile

The global listing is written to the file outputfile. If outputfile contains a directory path section, the file is written into it, otherwise into the current directory. The listing is output to stdout by default. If the -o option is used, the output codeset (ASCII or EBCDIC) is determined by the destination system codeset. However, BS2000 print control characters are always generated.

–V

The version and a copyright message are output to stderr.

-N listing1[,listing2...]

The listing generator writes the listings requested with this option either to stdout or into the file specified with the -o outputfile option.
The following can be specified for listing:

option or lo (options listing)

prepro or lp (preprocessor listing)

source_error or ls (source/error listing)

data_allocation_map or lm (map listing)

cross_reference or lx (cross-reference listing)

object or la (object listing)

project or lP (project listing, only useful for C++ programs)

summary or lS (statistics listing)

ALL

If ALL is specified, all listings are generated.

In order to generate a listing, the corresponding information must be requested during the compile (see -Ncif in section "Options for outputting listings and CIF information"). If a listing is requested but the information is not available, an error is generated.

-N output [,layout][,[lpp][,cpl]]

The layout of the global listing can be influenced with this option.

Four specifications are possible for layout:

normal or for_normal_print (default)
The default for the page length is 64 lines and for the line width 132 characters.

rotation or for_rotation_print
Defines the page length as 84 lines and the line width as 120 characters.

A page length of from 11 to 255 lines can be defined with lpp.

A line width of from 120 to 255 characters can be defined with cpl.

Note

Since the output file is prepared for printing under POSIX, there are up to 3 control characters at the beginning of some lines in the file. In addition, every line is terminated with the printer control character for a carriage return. If the output file is printed out, then the line length is cpl–1.

-N title,text

This operand can be used to specify if an additional line is to appear in the header of the listing and the text that is to be entered in it. In contrast to pragmas, which only apply to source and preprocessor listings, the -N title option applies to all compiler listings. In order to ensure that the desired text is transferred correctly, it is advisable to enter it within quotes ("text"). In the case of source and preprocessor listings, TITLE and PAGE pragmas (if any) override the -N title specification. See also the section on “Pragmas to control the layout of listings” in the C/C++ User Guide [4].

-N map_structlevel,n

See compiler option -N map_structlevel,n in section "Options for outputting listings and CIF information".

-N xref,xrefopt1[,xrefopt2...]

This option can be used to control which sections are included in the cross-reference listing requested with the -N cross_reference option. If the -N xref option is not specified, the cross-reference listing contains a list of the variables, functions and labels (equivalent to -N xref,v,f,l).
The cross-reference listing always contains a FILETABLE section with the names of all files, libraries and members that the compiler used as sources.

If the -N xref option is specified, the cross-reference listing contains the FILETABLE section and only the sections requested with the xrefopt argument. The following can be specified for xrefopt:

p	List of the names in #include and #define directives processed by the preprocessor.
y	List of the user-defined types (typedefs, structure, union, classes and counter types)
v	List of variables
f	List of functions
l	List of labels
t	List of templates (only with C++ compilations)
o=str	The order in which the separate sections are listed in the cross-reference listing. str is a string of 6 characters maximum ( letters for the listings shown above). The default is the order shown above (i.e. o=pyvflt). If the order specified with o=str does not include all letters for the listings requested with -N xref, the omitted letters are implicitly appended to the end of str in the default order shown above.

-K arg1[,arg2...]

General input rules for the -K option can be found on "Calling syntax and general rules.
The following entries are possible as arg arguments to control the listing output:

include_user
include_all
include_none

These options control whether and which header files are mapped to the source program, preprocessor and cross-reference listing.

-K include_user is the default and causes only the user header files to be mapped.

If -K include_all is specified, all header files, i.e. the standard and the user header files, are mapped.

No header files are mapped if -K include_none is specified.

A mapping of header files is only possible when the information is contained in the CIF file (see the compiler option -K cif_include_user).

pragmas_interpreted
pragmas_ignored

These arguments control whether #pragma directives are evaluated to control the t layout of the listing (see also the section “Pragmas to control the layout of listings” in the C/C++ User Guide [4]).
-K pragmas_interpreted is the default.