OS/2 Professional/OS2PRO194.ISO/os2/patches/cset50/help/dde4cset.hlp

OS/2 Help File | 1992-05-12 | 41.9 KB | 1,309 lines

ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ

References in this help to IBM products, programs, or services do not imply
that IBM intends to make these available in all countries in which IBM
operates.

Any reference to an IBM licensed program in this help is not intended to state
or imply that only IBM's licensed program may be used. Any functionally
equivalent product, program, or service that does not infringe any of IBM's
intellectual property rights may be used instead of the IBM product, program,
or service.

Evaluation and verification of operation in conjunction with other products,
except those expressly designated by IBM, is the user's responsibility.

IBM may have patents or pending patent applications covering subject matter in
this help. The furnishing of this help does not give you any license to these
patents.

The following terms, denoted by an asterisk (*) in this help, are trademarks of
the IBM Corporation in the United States and/or other countries:

 C/2
 C Set/2
 IBM
 OS/2
 Operating System/2
 Presentation Manager
 WorkFrame/2.

 This help contains examples of data and reports used in daily business
 operations. To illustrate them as completely as possible, the examples include
 the names of individuals, companies, brands, and products. All of these names
 are fictitious and any similarity to the names and addresses used by an actual
 business enterprise is entirely coincidental.


ΓòÉΓòÉΓòÉ 2. IBM C Set/2* Options ΓòÉΓòÉΓòÉ

Use this window to select which set of compiler options you want to change.
Select one of the following sets of options:

 o File management options
 o Listing options
 o Debug and diagnostic options
 o Source code options
 o Object code control options
 o Preprocessor options
 o Other options

 A window appears which displays the options that are available to use for
 compilation. In most cases, options are selected for you in each window. The
 selected options indicate the default compiler options. If you want to change
 an option you click on that option.


ΓòÉΓòÉΓòÉ 2.1. File management options ΓòÉΓòÉΓòÉ

Select File management options to specify under what conditions the compiler is
run, what files are used by the compiler, and what files are produced by the
compiler.


ΓòÉΓòÉΓòÉ 2.2. Listing Options ΓòÉΓòÉΓòÉ

Select Listing options to control the type of information in the source listing
and the appearance of the file.


ΓòÉΓòÉΓòÉ 2.3. Debug and diagnostic options ΓòÉΓòÉΓòÉ

Select Debug and diagnostic options to set debug and diagnostic options. The
information generated by C Set/2* compiler is provided to help you diagnose
problems in your code. Do not use the debugging information as a programming
interface.


ΓòÉΓòÉΓòÉ 2.4. Source code options ΓòÉΓòÉΓòÉ

Select Source code options to control how the C Set/2* compiler interprets your
source file.

Using these options you set the language standard, the type conversion rule,
the alignment and/or packing of data items within unions and structures.


ΓòÉΓòÉΓòÉ 2.5. Object code control options ΓòÉΓòÉΓòÉ

Select Object code control options to specify the executable environment, the
library linkage, the library selection, the type of file you want to create,
the target processor, whether you want to optimize the object code, the
linkage, the tiled memory model, the floating point method, or whether to
generate object code that runs at ring 0.


ΓòÉΓòÉΓòÉ 2.6. Preprocessor options ΓòÉΓòÉΓòÉ

Select Preprocessor options to specify whether you want to run only the
preprocessor, redirect the preprocessor output, remove all macros, or remove or
define specific macros.


ΓòÉΓòÉΓòÉ 2.7. Other options ΓòÉΓòÉΓòÉ

Select Other options to specify whether you want to compile but not link the
program, set the default char type for unspecified char declarations, set the
significant length for external names, specify a version string, or pass
parameters to the linker.


ΓòÉΓòÉΓòÉ 2.8. Save with project ΓòÉΓòÉΓòÉ

Select Save with project to save the compiler options that you have selected in
all the windows. The selections are saved with the project which was active
when the IBM C Set/2 Options was opened.


ΓòÉΓòÉΓòÉ 3. File Management Options ΓòÉΓòÉΓòÉ

Use this window to specify File management options. These options allow you to
specify under what conditions the compiler is run, what files are used by the
compiler, and what files are produced by the compiler.


ΓòÉΓòÉΓòÉ 3.1. Perform syntax check only ΓòÉΓòÉΓòÉ

Select Perform syntax check only to syntax check the file. An executable file
(.EXE) is not produced. The only output files that are produced when you
specify this option are the listing (.LST) files.

Selecting this item is equivalent to specifying the /Fc+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.2. Store internal work files on disk ΓòÉΓòÉΓòÉ

Select Store internal work files on disk to store internal work files on the
hard drive. If you do not select this option, the work files are stored in
shared memory.

Selecting this item is equivalent to specifying the /Fd+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.3. Ignore environment include paths ΓòÉΓòÉΓòÉ

Select Ignore environment include paths to ignore the paths specified in the
INCLUDE environment variable.

Selecting this item is equivalent to specifying the /Xi+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.4. Ignore command line include paths ΓòÉΓòÉΓòÉ

Select Ignore command line include paths to ignore the include paths specified
on the command line.

Selecting this item is equivalent to specifying the /Xc+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.5. Listing ΓòÉΓòÉΓòÉ

Select Listing to create a listing file from the source file. This listing will
include information from the compiler. This listing is not intended to be used
as a programming interface.

Unless you specify an output name for the listing in the Listing field, the
listing created will have the same file name as the source file and a file
extension of .LST.

Selecting this item is equivalent to specifying the /L+ option, or the /Fl+
option on the icc command line.


ΓòÉΓòÉΓòÉ 3.6. Object ΓòÉΓòÉΓòÉ

Select Object to create an object file. This listing is not intended to be used
as a programming interface.

Unless you specify an output name for the listing in the Object field, the
listing created will have the same file name as the source file and a file
extension of .OBJ.

Selecting this item is equivalent to specifying the /Fo+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.7. Assembler ΓòÉΓòÉΓòÉ

Select Assembler to create an assembler listing file. This listing is not
intended to be used as a programming interface.

Unless you specify an output name for the listing in the Assembler field, the
listing created will have the same file name as the source file and a file
extension of .ASM.

Selecting this item is equivalent to specifying the /Fa+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.8. Linker map ΓòÉΓòÉΓòÉ

Select Linker map to create map of the links among the object files.

Unless you specify an output name for the listing in the Linker map field, the
listing created will have the same file name as the source file and a file
extension of .MAP.

Selecting this item is equivalent to specifying the /Fm+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 3.9. EXE ΓòÉΓòÉΓòÉ

Enter an output name for the executable file.

Entering a name here is equivalent to specifying the /Fename option on the icc
command line.

The name entered for the executable file is only meaningful if both a compile
and link step is performed. The default file extension for executable files is
EXE.


ΓòÉΓòÉΓòÉ 3.10. Listing ΓòÉΓòÉΓòÉ

Enter an output name for the source listing.

Selecting this item is equivalent to specifying the /Flname option on the icc
command line.

You can enter a file extension with the source listing, but it is recommended
that you use the default extensions. The default file extension for source
listings is LST.


ΓòÉΓòÉΓòÉ 3.11. OBJ ΓòÉΓòÉΓòÉ

Enter an output name for the object file.

Entering a name here is equivalent to specifying the /Foname option on the icc
command line.

You can enter a file extension with the object file, but it is recommended that
you use the default extensions. The default file extension for object files is
OBJ.


ΓòÉΓòÉΓòÉ 3.12. Assembler ΓòÉΓòÉΓòÉ

Enter an output name for the assembler listing.

Entering a name here is equivalent to specifying the /Faname option on the icc
command line.

You can enter a file extension with the assembler listing name, but it is
recommended that you use the default extensions. The default file extension for
assembler listings is ASM.


ΓòÉΓòÉΓòÉ 3.13. Linker map ΓòÉΓòÉΓòÉ

Enter an output name for the linker map.

Entering a name here is equivalent to specifying the /Fmname option on the icc
command line.

You can enter a file extension with the linker map, but it is recommended that
you use the default extensions. The default file extension for linker maps is
MAP.


ΓòÉΓòÉΓòÉ 3.14. Command line include path ΓòÉΓòÉΓòÉ

Use Command line include path to list the include files you want to be used
when the program is to be compiled.

If you do not specify an include search path, the search directory of the
source file is searched first, and then the search paths given in the INCLUDE
environment variable are searched.

For example, assume you wanted to use the files my_defs.h in the e:\temp
directory and my_chars.h in the current directory. Then you would specify the
following command line include path:

e:\temp\my_defs.h
my_chars.h

Note that blank lines between include path statements are ignored.

Entering an include path here is equivalent to specifying the /Ipath[;path;]
option on the icc command line.


ΓòÉΓòÉΓòÉ 4. Listing Options ΓòÉΓòÉΓòÉ

Use this window to control the type of information in the source listing and
the appearance of the file using this window. To indicate that you want a
source listing created select Listing from the File management options window.


ΓòÉΓòÉΓòÉ 4.1. Source ΓòÉΓòÉΓòÉ

Select Source to include your program source code along with the source
listing.

Selecting this item is equivalent to specifying the /Ls+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 4.2. Cross reference ΓòÉΓòÉΓòÉ

Select Cross reference to produce a cross reference listing. The
cross-reference table that is produced identifies variables, structures, and
function names along with the line numbers where the names are declared in the
source code.

Selecting this item is equivalent to specifying the /Lx+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 4.3. Variables layout ΓòÉΓòÉΓòÉ

Select Variables layout to produce a listing of how the variables in your
source code are assigned. The layout that is produced includes all struct and
union variables with their offsets and lengths.

Selecting this item is equivalent to specifying the /La+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 4.4. Expand include files ΓòÉΓòÉΓòÉ

Select None to produce a listing without any #include expanded.

Selecting this item is equivalent to specifying the /Li- and /Lj- option on the
icc command line.

Select User to produce a listing showing the contents of the user #include
files from your source program.

Selecting this item is equivalent to specifying the /Li+ option on the icc
command line.

Select User and system to produce a listing showing the contents of the user
and system #include files from your source program.

Selecting this item is equivalent to specifying the /Lj+ option on the icc
command line.

Because OS/2 file names using the High Performance File System can be 260
characters long, there is no room for the file name on the lines showing the
included code. Counters are used in the include column of the listing output,
and the file name corresponding to each number is given at the bottom of the
source listing.


ΓòÉΓòÉΓòÉ 4.5. Expand all macros ΓòÉΓòÉΓòÉ

Select Expand all macros to produce a listing showing the contents of all the
macros from your source program.

Selecting this item is equivalent to specifying the /Le+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 4.6. Page length ΓòÉΓòÉΓòÉ

Specify a page length for the listing that is produced.  The default page
length is 66 lines.  You can enter a value between 15 and 65535 for the page
length.

Selecting this item is equivalent to specifying the /Lpnum option on the icc
command line.


ΓòÉΓòÉΓòÉ 4.7. Title ΓòÉΓòÉΓòÉ

Specify a title for the listing.  The title name can be up to 256 characters
long. You can also set a title for the listing using the pragma title
directive, however the title will not appear on the first page of the listing.

Selecting this item is equivalent to specifying the /Lt"string" option on the
icc command line.


ΓòÉΓòÉΓòÉ 4.8. Subtitle ΓòÉΓòÉΓòÉ

Specify a subtitle for the listing.  The subtitle name can be up to 256
characters long. You can also set a subtitle for the listing using the pragma
subtitle directive, however the subtitle will not appear on the first page of
the listing.

Selecting this item is equivalent to specifying the /Lu"string" option on the
icc command line.


ΓòÉΓòÉΓòÉ 5. Debug and Diagnostic Options ΓòÉΓòÉΓòÉ

Use this window to set debug and diagnostic options. The information generated
by C Set/2* compiler is provided to help you diagnose problems in your code. Do
not use the debugging information as a programming interface.

Because of the effects of optimization, debugging information generated with
optimization is limited to setting breakpoints at function entry and function
exit and viewing the program at the assembly level. Accurate symbol and type
information are not always available.

To make full use of the C Set/2* Debugger, do not turn on compiler
optimization. Compiler optimization is controlled using the Turn on
optimization option of the Object code options window.


ΓòÉΓòÉΓòÉ 5.1. Generate debugging information ΓòÉΓòÉΓòÉ

Select Generate debugging information to produce C Set/2* debugging
information.

Selecting this item is equivalent to specifying the /Ti+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 5.2. Stop on error count of ΓòÉΓòÉΓòÉ

Specify a value between 1 and 65535 to indicate the number of errors that can
occur during compilation before the process is ended.

The type of error message (Information, Warning, Error, or Severe) that causes
the error counter to be incremented is determined by the Compiler warning level
option. If you do not set a limit on the error counter (leave the field blank),
compilation will continue regardless of the number of errors that occur.

Selecting this item is equivalent to specifying the /Nnum option on the icc
command line.


ΓòÉΓòÉΓòÉ 5.3. Compiler warning level ΓòÉΓòÉΓòÉ

Select the type of compiler error message that you want the compiler to
produce. The type of compiler message that you indicate here is also used to
determine which type of error message will cause the error counter to be
incremented. The types of compiler error messages are:

 Severe              Produce only Severe error messages.

 Error               Produce both Error and Severe error messages.

 Warning             Produce Warning, Error and Severe error messages.

 Information         Produce all error messages (Information, Warning, Error
                     and Severe.)

 Selecting this item is equivalent to specifying the /Wn option on the icc
 command line, where n is equal to 0, 1, 2, or 3.


ΓòÉΓòÉΓòÉ 5.4. Diagnostic options ΓòÉΓòÉΓòÉ

Use the Diagnostic options to examine your source code for possible programming
errors, weak programming style, and other information about the structure of
your program.

Select one of more of the following to indicate that you want diagnostic
information produced:

 o Basic diagnostic messages (/Kb+)
 o Portability messages (/Ko+)
 o Preprocessor warning messages (/Kc+)
 o Preprocessor trace messages (/Kt+)
 o Mapping of names to the linkage editor (/Kr+)
 o Messages about the appearance and behavior of goto statements (/Kg+)
 o Variables that are not explicitly initialized (/Ki+)
 o Function parameters that are not used (/Kp+)
 o Assignments that may cause loss of precision (/Ka+)
 o Messages about enum usage (/Ke+)
 o Variables that have external declarations but are not used. (/Kx+)

 Selecting all items is equivalent to specifying the /Kf+ option on the icc
 command line.


ΓòÉΓòÉΓòÉ 6. Source Code Options ΓòÉΓòÉΓòÉ

Use this window to select options that allow you to control how the C Set/2*
compiler interprets your source file.

Using the Source code options you set the language standard, the type
conversion rule, the alignment and/or packing of data items within unions and
structures,


ΓòÉΓòÉΓòÉ 6.1. ANSI ΓòÉΓòÉΓòÉ

Select ANSI to set the language standard to allow only those extensions the
American National Standards Institute (ANSI).

Selecting this item is equivalent to specifying the /Sa+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.2. SAA level 2 ΓòÉΓòÉΓòÉ

Select SAA level 2 to set the language standard to allow only those extensions
defined by the SAA Level 2 specifications.

Selecting this item is equivalent to specifying the /S2+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.3. Standard extension ΓòÉΓòÉΓòÉ

Select Standard extension to set the language standard to allow those
extensions defined by ANSI and the SAA Level 2 specifications.

Selecting this item is equivalent to specifying the /Se+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.4. Migration extension ΓòÉΓòÉΓòÉ

Select Migration extension to set the language standard to allow migration
extensions.

Selecting this item is equivalent to specifying the /Sm+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.5. Conversion rule ΓòÉΓòÉΓòÉ

Set the rule for type conversion.

Select Preserve sign to preserve the sign of the number being converted. If you
preserve the sign on type conversions your language standard will not conform
to ANSI specifications. Selecting Preserve sign is equivalent to specifying the
/Sr+ option on the icc command line.

Select Preserve accuracy to preserve the accuracy of the number being
converted. Selecting Preserve accuracy is equivalent to specifying the /Sr-
option on the icc command line.


ΓòÉΓòÉΓòÉ 6.6. Align structures and unions along boundary ΓòÉΓòÉΓòÉ

Set the alignment or packing of data items within structs and unions.

Select 1-byte or 2-byte boundaries to indicate that you want structures and
unions to be aligned along 1 or 2-byte boundaries. Selecting 1-byte is
equivalent to specifying /Sp1 or /Sp. Selecting 2-byte is equivalent to
specifying /Sp2.

Select 4-byte to align structs and unions along 4-byte boundaries. This is
considered to be normal alignment. Selecting 4-byte is equivalent to specifying
the /Sp4. option on the icc command line.

Structures and unions are considered to be packed (_Packed).


ΓòÉΓòÉΓòÉ 6.7. Make .OBJ the default extension ΓòÉΓòÉΓòÉ

Select Make .OBJ the default extension to set the default file extension as
.OBJ. This means that if an extension is not specified with a file, then it is
assumed to be an object file.

Selecting this item is equivalent to specifying the /Sd- option on the icc
command line.

If you do not accept .OBJ as the extension in this check box, then the default
file extension is .C.

The extension determines whether the file is treated as a C source file or as
an object file. If the file has an extension of .C, then it is compiled and
linked. If the file has an extension of .OBJ, then it is only linked.


ΓòÉΓòÉΓòÉ 6.8. Allow use of '//' for comments ΓòÉΓòÉΓòÉ

Select Allow use of '//' for comments to allow the double slash format of
indicating comments. This type of comment is ended by a carriage return.

Selecting this item is equivalent to specifying the /Ss+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.9. Allow DBCS support ΓòÉΓòÉΓòÉ

Select Allow DBCS support to allow the use of Double-Byte Character Set symbols
in the source code.

Selecting this item is equivalent to specifying the /Sn+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.10. Allow use of ddnames support ΓòÉΓòÉΓòÉ

Select Allow use of ddnames support to allow the use of ddnames in the source
code.

Selecting this item is equivalent to specifying the /Sh+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 6.11. Margins ΓòÉΓòÉΓòÉ

Specify values for the input file margins. Text which is outside the specified
margins is ignored. It is useful to specify margins when importing source files
that were created on other systems which contain characters that you want to
ignore.

Specify a value for the left margin. The value for the left margin must be
between 1 and 65535. The right margin can be an asterisk (the default value) or
a value between 1 and 65535. The value specified for the right margin must be
greater than or equal to the value specified for the left margin.

Selecting this item is equivalent to specifying the /Sg[l][,r]*] option on the
icc command line.


ΓòÉΓòÉΓòÉ 6.12. Sequence numbers ΓòÉΓòÉΓòÉ

Specify columns in which sequence column numbers appear, and ignore text in
those columns. It is useful to specify sequence columns when importing source
files from systems that use sequence numbers.

Specify a value for the left sequence column. The value for the left and right
column must be between 1 and 65535. The value specified for the right column
must be greater than or equal to the value specified for the left column. If
you do not want to specify a value for the right column you can use an
asterisk.

Selecting this item is equivalent to specifying the /Sq[l][,r] option on the
icc command line.


ΓòÉΓòÉΓòÉ 7. Object Code Control Options ΓòÉΓòÉΓòÉ

Use this window to specify the type of code that the compiler will produce. The
possible types of code include:

 o Dynamically linked run-time libraries
 o Statically linked run-time libraries
 o Single-thread programs
 o Multithread programs
 o Sub-systems.


ΓòÉΓòÉΓòÉ 7.1. Executable environment ΓòÉΓòÉΓòÉ

Use this option to specify which libraries you want to link to.

Select Run-time to link to the run-time libraries. Selecting this item is
equivalent to specifying the /Re option on the icc command line.

Select Sub-system to link to the sub-system libraries. Selecting this item is
equivalent to specifying the /Rn option on the icc command line.


ΓòÉΓòÉΓòÉ 7.2. Library linkage ΓòÉΓòÉΓòÉ

Use this option to specify how you want to link to the run-time libraries.

Select Static to statically link to the run-time libraries. All external names
beginning with the letters Dos, kbd, and Vio are reserved. Selecting this item
is equivalent to specifying the /Gd- option on the icc command line.

Select Dynamic to dynamically link to the run-time libraries. Selecting this
item is equivalent to specifying the /Gd+ option on the icc command line.


ΓòÉΓòÉΓòÉ 7.3. Library selection ΓòÉΓòÉΓòÉ

Use this option to select single or multithread libraries.

Select Single-thread to link with the single-thread version of the library.
Selecting this item is equivalent to specifying the /Gm- option on the icc
command line.

Select Multithread to link with the multithread version of the library.
Selecting this item is equivalent to specifying the /Gm+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.4. Build ΓòÉΓòÉΓòÉ

Use this option to specify the type of file you want to create.

Select EXE to build an executable (.EXE) file. Selecting this item is
equivalent to specifying the /Ge+ option on the icc command line.

Select DLL to build a dynamic link library (DLL) file. Selecting this item is
equivalent to specifying the /Ge- option on the icc command line.

Select Protected DLL to build a protected dynamic link library file. Selecting
this item is equivalent to specifying the /Gp option on the icc command line.


ΓòÉΓòÉΓòÉ 7.5. Target processor ΓòÉΓòÉΓòÉ

Use this option to specify which processor to optimize for.

Select 80386 to optimize code for use with the 386 processor. The code
generated will run on a 486 processor. Selecting this item is equivalent to
specifying the /G3 option on the icc command line.

Select 80486 to optimize code for use with the 486 processor. The code
generated will run on a 386 processor. Selecting this item is equivalent to
specifying the /G4 option on the icc command line.


ΓòÉΓòÉΓòÉ 7.6. Remove stack probes ΓòÉΓòÉΓòÉ

Select Remove stack probes to remove stack probes from the code generated by
the compiler.

Selecting this item is equivalent to specifying the /Gs+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.7. Turn on optimization ΓòÉΓòÉΓòÉ

Select Turn on optimization to optimize the object code. It is recommended that
you do not optimize the object code if you plan to use the C Set/2* debugger.

Selecting this item is equivalent to specifying the /O+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.8. Do not generate default library info ΓòÉΓòÉΓòÉ

Select Do not generate default library info to indicate that the compiler
should not search libraries during compilation to resolve external references.
All libraries must be explicitly specified at link time.

Selecting this item is equivalent to specifying the /Gn+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.9. Use optlink linkage ΓòÉΓòÉΓòÉ

Select Use optlink linkage to indicate that you want to use optlink linkage for
functions. You must include the Programmer's Toolkit header files to call OS/2
application programming interfaces.

Selecting this item is equivalent to specifying the /Mp+ option on the icc
command line.

If you do not select this option then system linkage for functions will be
used. You must include the library header files to call function. This is
equivalent to specifying the /Ms+ option on the icc command line.


ΓòÉΓòÉΓòÉ 7.10. Tiled memory model ΓòÉΓòÉΓòÉ

Select Tiled memory model to store variables such that they can be passed to
16-bit functions. Static and external variables are mapped into 16-bit
segments. Variables larger than 64K will be aligned on, but will still cross,
64K boundaries.

Selecting this item is equivalent to specifying the /Gt- option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.11. Use fast floating point method ΓòÉΓòÉΓòÉ

Select Use fast floating point method to indicate you want the compiler to use
fast floating-point execution. If your program does not need to abide by ANSI
rules regarding the processing of double and float types, then use this option
to increase your program's performance.

Because the floating-point method does not perform all the conversions
necessary to maintain accuracy, some variables may lose precision.

Selecting this item is equivalent to specifying the /Gf+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.12. Allow object code to run at ring 0 ΓòÉΓòÉΓòÉ

Select Allow object code to run at ring 0 to indicate that you want to allow
object code to run at ring 0. Use this option if you are writing code such as
device drivers or operating systems, that will run at ring 0 instead of ring 3.

Selecting this item is equivalent to specifying the /Gr+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 7.13. Enable profiling ΓòÉΓòÉΓòÉ

Select this option to let a compatible profiler analyze the code produced by
the compiler.

Note:  Be sure the /NOE option is specified for the linker when the object code
       is linked.

 Selecting this item is equivalent to specifying the /Gh option on the icc
 command line.


ΓòÉΓòÉΓòÉ 8. Preprocessor Options ΓòÉΓòÉΓòÉ

Use this window to set preprocessor options. Preprocessor directives allow you
to perform such things as include C code from another source file into your
source file, to define macros, and to expand macros.

If you run only the preprocessor, you can use the preprocessor output (which
has all the preprocessor directives executed, but no C code compiled) to help
debug your program. For example, all the #include directives will have the
included file's code inserted into your program, and all macros will be
expanded.


ΓòÉΓòÉΓòÉ 8.1. Run the preprocessor only ΓòÉΓòÉΓòÉ

Select Run the preprocessor only to run only the preprocessor. Create a
preprocessor output file that has the same name as the source file, with the
extension I. Comments are not included in the preprocessor output file.

Selecting this item is equivalent to specifying the /P+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 8.2. Send the output to stdout ΓòÉΓòÉΓòÉ

Select Send the output to stdout to run only the preprocessor and send the
output to the stream specified by stdout.

Selecting this item is equivalent to specifying the /Pd+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 8.3. Retain comments ΓòÉΓòÉΓòÉ

Select Retain comments to include the comments in the preprocessor output file
that is created.

Selecting this item is equivalent to specifying the /Pc option on the icc
command line.


ΓòÉΓòÉΓòÉ 8.4. Remove all user-defined macros ΓòÉΓòÉΓòÉ

Select Remove all user-defined macros to remove all macros that are
user-defined. This option does not remove internally-defined ANSI or SAA
macros, nor does it undefine macros defined in your source code.

Selecting this item is equivalent to specifying the /U* option on the icc
command line.


ΓòÉΓòÉΓòÉ 8.5. Remove ΓòÉΓòÉΓòÉ

Specify the name of the macro you want to remove in the box provided. For
example, if you want to remove the macros _MY_MACRO_ and _EDS_MACRO_, then you
would enter:

_MY_MACRO_
_EDS_MACRO_

Selecting this item is equivalent to specifying the /Uname option on the icc
command line.


ΓòÉΓòÉΓòÉ 8.6. Define ΓòÉΓòÉΓòÉ

Specify the name and value for the macro you want to define in the box
provided. For example, if you want to define the macros _MY_MACRO_ as equal to
43 and _EDS_MACRO_ as equal to 28, then you would enter:

_MY_MACRO_=43
_EDS_MACRO_=28

The macros defined will override macros already defined in your source program.

Selecting this item is equivalent to specifying the /Dname[::n], or /Dname[=n]
option on the icc command line.


ΓòÉΓòÉΓòÉ 9. Other Options ΓòÉΓòÉΓòÉ

Use this window to specify:

 o What parameters to pass to the linker
 o The significant length of external names
 o The default char type for unspecified variables
 o Whether to display the logo when the compiler is invoked
 o A version string in the object file.


ΓòÉΓòÉΓòÉ 9.1. Perform compile only, no link ΓòÉΓòÉΓòÉ

Select Perform compile only, no link to indicate you want to compile but not
link the program.

Selecting this item is equivalent to specifying the /C+ option on the icc
command line.


ΓòÉΓòÉΓòÉ 9.2. Make default char type unsigned ΓòÉΓòÉΓòÉ

Select Make default char type unsigned to set unspecified char declarations to
unsigned char. Selecting this item is equivalent to specifying the /J+ option
on the icc command line.

If you do not select this option, unspecified char declarations will be set to
signed char.


ΓòÉΓòÉΓòÉ 9.3. Display the logo ΓòÉΓòÉΓòÉ

Select Display the logo to display the compiler logo when the compiler is
invoked. The logo is displayed on stderr.

Selecting this item is equivalent to specifying the /Q- option on the icc
command line.


ΓòÉΓòÉΓòÉ 9.4. Length of external names ΓòÉΓòÉΓòÉ

Set the significant length for external names to 255 characters. Selecting this
item is equivalent to specifying the /H255 option on the icc command line.

You can change the sign length by entering a value between 6 and 255 inclusive.
This is equivalent to specifying the /Hnum option on the icc command line.


ΓòÉΓòÉΓòÉ 9.5. Version string ΓòÉΓòÉΓòÉ

Use this option to specify a Version string. The string specified can be up to
256 characters long.

This is equivalent to specifying the /V"string" option on the icc command line.


ΓòÉΓòÉΓòÉ 9.6. Parameters to pass to linker ΓòÉΓòÉΓòÉ

Use this option to specify the parameters that you want to pass to the linker.

This is equivalent to specifying the /B"options" option on the icc command
line.


ΓòÉΓòÉΓòÉ 10. IBM C Set/2* Conflicts ΓòÉΓòÉΓòÉ

You have specified two or more options that are incompatible. The following
rules apply if you specify an incompatible option:

 o You indicated that you wanted to perform syntax checking only, as well as
   one or more of the following: run the preprocessor; create a listing title,
   subtitle, and page length without actual output; any object code control
   option; any debug option; compile and not link; a version string; parameters
   to pass to the linker. The option to perform syntax checking takes
   precedence over the other options selected so the other option or options
   are ignored.

 o You indicated that you wanted to run the preprocessor, as well as one or
   more of the following: create any file listing; any listing option; any
   object code control option; any debug option; compile and not link; a
   version string; parameters to pass to the linker. The option to run only the
   preprocessor takes precedence over the other options selected so that other
   option or options are ignored.

 o You indicated that you wanted to compile only (not perform the link step)
   and also indicated that you wanted to create an .EXE file, or create a
   linker map. The option to compile only, and not link takes precedence.

 o You indicated that you did not want to create an object file but also
   indicated that you wanted to generate debugging information. The option not
   to create an object file takes precedence.

 o You indicated that you wanted to enable for subsystem development but also
   indicated you wanted to used ddnames. The option to enable subsystem
   development takes precedence.


ΓòÉΓòÉΓòÉ 10.1. Ignore conflict ΓòÉΓòÉΓòÉ

Select Ignore conflict to indicate that you want to save your changes and use
the options that take precedence.


ΓòÉΓòÉΓòÉ 10.2. Cancel ΓòÉΓòÉΓòÉ

Select Cancel to return to the IBM C Set/2* Options window and correct
conflicting options.


ΓòÉΓòÉΓòÉ 11. OK ΓòÉΓòÉΓòÉ

Select OK to save the choices you made and remove the window.


ΓòÉΓòÉΓòÉ 12. Default ΓòÉΓòÉΓòÉ

Select Default to change the window's selections back to the default compiler
options.


ΓòÉΓòÉΓòÉ 13. Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the pop-up window. Any selections you may have made are
not saved.


ΓòÉΓòÉΓòÉ 14. Help ΓòÉΓòÉΓòÉ

Select Help to display help information for the item the cursor is on.

Press F2 to obtain help on the entire window.


ΓòÉΓòÉΓòÉ 15. Keys Help ΓòÉΓòÉΓòÉ

The list of keys is arranged in groups.

Use:

 o HELP KEYS to get help

 o SYSTEM KEYS to switch between programs

 o WINDOW KEYS to move around in a program window

 o POP-UP WINDOW KEYS to make a selection in a pop-up window

 o EDITING KEYS to make changes in a pop-up window.

 When two key names are joined by a plus sign (+), use these two keys together.
 Hold down the first key and press the second key.

 HELP KEYS

 F1
           Get help
 F2
           Get extended help (from within any help window)
 F9
           Go to a list of keys (from within any help window)
 F11 or Shift+F1
           Go to the help index (from within any help window)
 Esc
           Cancel help
 Alt+F4
           Close the help window
 Alt+F6
           Move among windows
 Shift+F10
           Get help for help

 SYSTEM KEYS

 Alt+Esc
           Switch to the next program, including full-screen programs
 Alt+Tab
           Switch to the next windowed program
 Ctrl+Esc
           Switch to the Task List

 WINDOW KEYS

 F10
           Go to/from the action bar
 Arrow keys
           Move among choices
 End
           Go to the last choice in a pulldown
 Esc
           Cancel a pulldown, the system menu, or window
 Home
           Go to the first choice in a pulldown
 PgUp
           Scroll the contents of the window up one page
 PgDn
           Scroll the contents of the window down one page
 Underlined letter
           Move among the choices on the action bar and select pulldown items
 Alt
           Go to/from the action bar
 Alt+F4
           Close the window
 Alt+F5
           Restore the window
 Alt+F7
           Move the window
 Alt+F8
           Size the window
 Alt+F9
           Minimize the window
 Alt+F10
           Maximize the window
 Ctrl+PgDn
           Scroll the contents of the window right one page
 Ctrl+PgUp
           Scroll the contents of the window left one page
 Shift+Esc or Alt+Spacebar
           Go to/from the system menu
 Shift+Esc or Alt
           Go to/from the system menu of a text window

 POP-UP WINDOW KEYS

 Enter
           Complete the pop-up window
 Esc
           Cancel the pop-up window
 Spacebar
           Set a check box on/off or perform the task described on the selected
           pushbutton
 Tab
           Move to the next entry field or check box

 EDITING KEYS

 Backspace (left arrow delete)
           Delete the character to the left of the cursor
 Del
           Delete the character at the cursor
 End or Ctrl+Right Arrow key
           Move to the end of a field
 Home or Ctrl+Left Arrow key
           Move to the beginning of a field.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Cannot create a window - out of resources.

The system has run out of resources and cannot open a new window.

Recovery

Close any Presentation Manager* program applications (especially large ones)
you are not using and try again.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Could not get the system path length, return code = <return_code>.

The system path length could not be obtained.

Recovery

View the OS/2* operating system online reference for more information.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Selecting this option discards any changes made in the secondary windows. Do
you want to discard these changes?

Select Yes to discard the changes, otherwise select No.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Are you sure you want to initialize all options to their default values?

Select Yes to initialize all options, otherwise select No.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The entry for the number of errors must be between 1 and 65535, or blank.

The value entered for the number of errors was not between one and 65535. Nor
was it blank.

Recovery

Enter a valid value.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Not enough memory to complete task.

An error occurred while trying to allocate memory. There may be insufficient
memory to complete the task.

Recovery

Close one or more other tasks, and retry the command.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Not enough space in the compile options string to store the specified options.

There is not enough storage allocated to store the compile options string.

Recovery

Use the Language Profile Management window to change the Maximum compile string
in the language profile so that more storage is allocated.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Not enough space in the compile string to store the specified options.

There is not enough storage allocated to store the compile options.

Recovery

Use the Language Profile Management window to change the Maximum compile size
in the language profile so that more storage is allocated.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The page length must be between 15 and 65535.

Recovery

Enter a page length between 15 and 65535.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The length of the external name must be between 6 and 255.

Recovery

Ensure that the length of the external name is between 6 and 255 characters.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The margins must be between 0 and 65535, and the right margin must be greater
than or equal to the left margin, or be represented by the '*' character.

Recovery

Enter valid margins.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The sequence numbers must be between 0 and 65535, and the right sequence number
must be greater than or equal to the left sequence number.

Recovery

Enter a valid sequence number.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The directory name <name_of_directory> is incorrect, return code = return_code.

One or more of the paths contains a string that is not a directory.

Recovery

Correct the directory name and try the command again.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The file name <name_of_file> was entered rather than a directory.

One or more of the paths contains a string that is a file name rather than a
directory.

Recovery

Correct the path string and try the command again.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The directory name <name_of_directory> is longer than the maximum length
<maximum_length> permitted by the operating system.

One or more of the paths contains a directory name that is longer than that
allowed by the operating system.

Recovery

Enter a shorter directory name and try the command again.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

There was an unexpected return code while validating the path:
<path_being_validated>, return code = return_code

An unexpected error occured while a path was being selected.

Recovery

See the OS/2* operating system return code description for more information.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

The directory <name_of_directory> does not exist, return code = return_code Do
you want to ignore it?

The program could not find the directory.

Recovery

Select No if you want to respecify the directory. Otherwise, select Yes to
continue.

See the OS/2* operating system return code description for more information.