OS/2 Shareware BBS: 10 Tools/10-Tools.zip/cset21v1.zip/IBMCPP/HELP/DDE4ICC.HLP

OS/2 Help File | 1993-10-06 | 66KB | 2,054 lines

ΓòÉΓòÉΓòÉ 1. 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 on 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 Set ++
 IBM
 OS/2
 Operating System/2
 WorkFrame/2.

The following term, denoted by a double asterisk (**) in this help, is a
trademark of the Intel Corporation:

Pentium


ΓòÉΓòÉΓòÉ 2. C/C++ Compiler Options ΓòÉΓòÉΓòÉ

Use the Compiler Options notebook to select which set of IBM* C/C++ Tools
compiler options you want to change.

You can set any of 8 option categories:

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
o User options

Some options have already been set to their default settings. You can change
the default settings by clicking on them and selecting your preferred settings.


ΓòÉΓòÉΓòÉ 3. Save with Project ΓòÉΓòÉΓòÉ

Select the Save with project check box to save the compiler option settings
with the project you are currently working on.  The compiler options you choose
will remain valid each time you compile files from the current project.

If you do not select this check box, the compiler option settings you set now
will remain in effect only until you end the current WorkFrame/2* session.
When you open the next WorkFrame/2 session, the compiler option settings you
last saved with this project will be active.  If you have not previously saved
compiler option settings with the current project, the default settings will
apply.


ΓòÉΓòÉΓòÉ 4. Output File Management Options ΓòÉΓòÉΓòÉ

Use the File page to set compiler options that control the files that the
compiler produces.  These files include:

o Listing
o Intermediate Code
o Object
o Assembler listing
o Linker map
o Executable
o Browser
o Template resolution
o Precompile include.


ΓòÉΓòÉΓòÉ 4.1. Perform Syntax Check Only ΓòÉΓòÉΓòÉ

Select Perform syntax check only to only do a syntax check on the source files.
Only listing (.LST) files are produced when you select this option.

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


ΓòÉΓòÉΓòÉ 4.2. Listing ΓòÉΓòÉΓòÉ

Select the Listing check box to create a listing file from the source file.  If
you do not select the Listing checkbox, no listing file will be produced unless
you select any of the following options on the Listing page of the Compiler
Options notebook:

o Source
o Expand all macros
o Aggregate layout
o Cross reference
o Expand include files.

In the Listing entry field, type the name for the listing file.  If you leave
this field blank, the listing file will have the same name as the source file
with an extension of .LST.

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


ΓòÉΓòÉΓòÉ 4.3. Intermediate ΓòÉΓòÉΓòÉ

Select the Intermediate check box to create intermediate code files only
without completing compilation.

In the Intermediate entry field, type the names you want to give the
intermediate code files.  If you leave this field blank, the intermediate code
files will have the same name as the source file, with the file name extensions
.W, .WH, and .WI.

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

For more information on intermediate code, please refer to the section, Using
the Intermediate Code Linker, in Chapter 4 of the IBM* C/C++ Tools: Programming
Guide.


ΓòÉΓòÉΓòÉ 4.4. Object ΓòÉΓòÉΓòÉ

Select the Object check box to generate an object file.

In the Object entry field, type the name of the object file.  If you leave this
field blank, the object file will have the same name as the source file, with a
.OBJ file name extension.

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


ΓòÉΓòÉΓòÉ 4.5. Assembler ΓòÉΓòÉΓòÉ

Select the Assembler check box to produce an assembler listing file that has
the source code as comments.

Note:  This listing is not guaranteed to compile.

In the Assembler entry field, type the name you want to give the assembler
file.  If you leave this field blank, the assembler file will have the same
name as the source file, with a .ASM file name extension.

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


ΓòÉΓòÉΓòÉ 4.6. Linker Map ΓòÉΓòÉΓòÉ

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

In the Linker map entry field, type the name you want to give the linker map
file.  If you leave this field blank, the linker map file will have the same
name as the source file, with a .MAP file name extension.

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

Note:  To get a more detailed map file, enter /map in the Parameters passed to
       linker entry field in the Other options page.


ΓòÉΓòÉΓòÉ 4.7. .EXE ΓòÉΓòÉΓòÉ

In the .EXE entry field, enter a name for the generated executable file or
dynamic link library (DLL).  If you leave this field blank, the executable file
or DLL will have the same name as the first file, with a .EXE or .DLL file name
extension.

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


ΓòÉΓòÉΓòÉ 4.8. Browser ΓòÉΓòÉΓòÉ

Select the Browser check box to produce a browser file for use with the C/C++
Tools browser.

The browser file will have the same name as the main source file, with a .BRS
file name extension.

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


ΓòÉΓòÉΓòÉ 4.9. Template ΓòÉΓòÉΓòÉ

Select the Template check box to generate files for template resolution.

In the Template directory entry field, type the name of the directory in which
you wish to store the template files. If you leave this field blank, the
template resolution files will be stored in the TEMPINC subdirectory under the
current directory.

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


ΓòÉΓòÉΓòÉ 4.10. Precompiled Header File ΓòÉΓòÉΓòÉ

Select the Precompiled header file check box to generate a precompiled header
file if none exists or if the existing one is out of date.

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


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

Select the Store internal work files on disk check box to store the internal
work files on disk instead of in shared memory. The work files will be stored
in the directory specified by the TMP environment variable.

Note:  Whenever you compile C++ code, internal work files are stored on disk.
       They cannot be stored in shared memory for C++ code.

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


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

Select the Ignore environment include paths check box to ignore the #include
search path(s) given in the INCLUDE environment variable. #include files will
not be searched for in the directories specified by the INCLUDE environment
variable.

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

To specify search directories for #include files, use the Command line include
path entry field.


ΓòÉΓòÉΓòÉ 4.13. Ignore Command Line Include Paths ΓòÉΓòÉΓòÉ

Select the Ignore command line include paths to ignore the search paths
specified in the Command line include path entry field. #include files will not
be searched for in the directories specified in the Command line include path
field.

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


ΓòÉΓòÉΓòÉ 4.14. Command Line Include Path ΓòÉΓòÉΓòÉ

In the Command line include path field, enter the pathnames of directories to
be searched for #include files.  Separate each pathname with a semicolon or
enter one path per line.

If you do not enter any paths in this field, the default is to search the
directory of the source file (for user files only), and then search the paths
given in the INCLUDE environment variable unless the Ignore environment include
paths check box is selected.

Entering paths in this field is equivalent to specifying the /Ipath[;path]
option on the icc command line.


ΓòÉΓòÉΓòÉ 5. Listing File Options ΓòÉΓòÉΓòÉ

Use the Listing page to set compiler options that allow you to control whether
or not a listing file is produced, the type of information in the listing, and
the appearance of the file.


ΓòÉΓòÉΓòÉ 5.1. Source ΓòÉΓòÉΓòÉ

Select the Source check box to include the source code in the listing file.

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


ΓòÉΓòÉΓòÉ 5.2. Expand All Macros ΓòÉΓòÉΓòÉ

Select the Expand all macros check box 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.


ΓòÉΓòÉΓòÉ 5.3. Aggregate Layout ΓòÉΓòÉΓòÉ

Use the Aggregate layout group of radio buttons to specify whether or not you
want to include a layout of all struct and union variables with their offsets
and lengths in the listing file.

Select one of the radio buttons from the group:

None
        Does not produce an aggregate layout.  This is the default setting.
        Selecting this item is equivalent to specifying the /La- or /Lb- option
        on the icc command line.
Referenced
        Includes a layout of only the referenced struct and union variables.
        Selecting this item is equivalent to specifying the /La+ option on the
        icc command line.
All
        Includes a layout of all struct and union variables.  Selecting this
        item is equivalent to specifying the /Lb+ option on the icc command
        line.


ΓòÉΓòÉΓòÉ 5.4. Cross Reference ΓòÉΓòÉΓòÉ

Use the Cross reference group of radio buttons to specify whether or not to
produce a cross reference listing. The generated cross-reference table
identifies variables, structures, and function names along with the line
numbers where the names are declared in the source code.

Select one of the radio buttons from the group:

None
     Does not produce a cross-reference table.  This is the default setting.
     Selecting this item is equivalent to specifying the /Lx- or /Ly- option on
     the icc command line.
Referenced
     Generates a cross-reference table of only the referenced variable,
     structure, and function names.  Selecting this item is equivalent to
     specifying the /Lx+ option on the icc command line.
All
     Generates a cross-reference table of all variable, structure, and function
     names.  The table includes all local identifiers referenced by the user
     and all external identifiers. Selecting this item is equivalent to
     specifying the /Ly+ option on the icc command line.


ΓòÉΓòÉΓòÉ 5.5. Expand Include Files ΓòÉΓòÉΓòÉ

Use the Expand include files group of radio buttons to specify whether or not
to expand #include files.

Select one of the radio buttons from the group:

None
     Does not expand #include files for the listing file.  This is the default
     setting. Selecting this item is equivalent to specifying the /Li- or /Lj-
     option on the icc command line.
User
     Produces 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.
User and system
     Produces 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.


ΓòÉΓòÉΓòÉ 5.6. Page length ΓòÉΓòÉΓòÉ

In the Page length entry field, type a number between 15 and 65535 to set the
page length for the generated listing file. If you leave this field blank, the
default page length of 66 lines will be used.

Entering a number in this field is equivalent to specifying the /Lpnum option
on the icc command line.


ΓòÉΓòÉΓòÉ 5.7. Title ΓòÉΓòÉΓòÉ

In the Title field, type some text to specify a title for the listing.  The
title name can be up to 256 characters long. You can also enter a subtitle
string in the Subtitle field.

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


ΓòÉΓòÉΓòÉ 5.8. Subtitle ΓòÉΓòÉΓòÉ

In the Subtitle field, type some text to specify a subtitle for the listing.
The subtitle name can be up to 256 characters long. You can also enter a Title
string in the Title field.

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


ΓòÉΓòÉΓòÉ 6. Debugging and Diagnostic Options ΓòÉΓòÉΓòÉ

Use the Debugging page to set compiler options that are useful for debugging
your programs.

The information generated by the C/C++ Tools debugger and compiler as a result
of these options are provided to help you diagnose problems in your code.  Do
not use the debugging information as a programming interface.


ΓòÉΓòÉΓòÉ 6.1. Generate Debugging Information ΓòÉΓòÉΓòÉ

Select the Generate debugging information check box to produce debugging
information for use by the C/C++ Tools debugger.

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


ΓòÉΓòÉΓòÉ 6.2. Stop on Error Count of ΓòÉΓòÉΓòÉ

In the Stop on error count of field, type a value between 1 and 65535 to
indicate the maximum number of errors at which to abort compilation.  If you
leave this field blank, compilation will continue until it is completed or
until an unrecoverable error is encountered.

The type of error message (Info, Warning, Error, or Severe) that increments the
error counter is determined by the Compiler warning level option.

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


ΓòÉΓòÉΓòÉ 6.3. Compiler Warning Level ΓòÉΓòÉΓòÉ

Use the Compiler warning level setting to specify the type of messages 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.

Select one radio button from the group:

Severe
     Produce only severe error messages.  The equivalent command-line option is
     /W0.
Error
     Produce only severe errors and errors.  The equivalent command-line option
     is /W1.
Warning
     Produce severe errors, errors, and warnings.  The equivalent command-line
     option is /W2.
Info
     Produce all error message types (severe errors, errors, warnings, and
     information).  This is the default setting. The equivalent command-line
     option is /W3.


ΓòÉΓòÉΓòÉ 6.4. Diagnostic options ΓòÉΓòÉΓòÉ

From the Diagnostic options list box, select the diagnostic messages you want
generated.  The level of diagnostic messages generated is controlled by that
specified in the Compiler warning level option.

The diagnostic options help you examine your source code for possible
programming errors, weak programming style, and other information about the
structure of your program.

If you do not select any diagnostic messages from this list box, none will be
generated.

Selecting items from the Diagnostic options list box

 is equivalent to specifying the /Wgrp options
on the icc command line.


ΓòÉΓòÉΓòÉ 6.5. Use DEBUG Memory Supports ΓòÉΓòÉΓòÉ

Select the Use DEBUG memory supports check box to instruct the compiler to use
the debug memory management functions ( _debug_calloc, _debug_malloc, new, and
so on).  Selecting this option also defines the __DEBUG_ALLOC__ macro.

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


ΓòÉΓòÉΓòÉ 6.6. Full Exception Dump Information ΓòÉΓòÉΓòÉ

Select the Full exception dump information check box to provide a complete
machine-state dump when an exception occurs.  If this option is not selected,
only the exception message and address is provided when an exception occurs.

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


ΓòÉΓòÉΓòÉ 7. Source Code Options ΓòÉΓòÉΓòÉ

Use the Source page to set compiler options that allow you to control how the
C/C++ Tools compiler interprets your source file. These options are especially
useful, for example, if you are concerned with migrating code or ensuring
consistency with a particular language or standard.


ΓòÉΓòÉΓòÉ 7.1. Source File Language ΓòÉΓòÉΓòÉ

Use the Source file language setting to specify the default language (C or C++)
for source files.

Select one radio button from the group:

Compiler extension
     Use the file name extension the of source file to determine its language.
     .CPP and .CXX files are compiled as C++ files and .C and all other
     unrecognized files are compiled as C files. This is the default setting.
     The equivalent icc command-line option is /Td.
C
     Compile all source and unrecognized files as C files. The equivalent icc
     command-line option is /Tdc.
C++
     Compile all source and unrecognized files as C++ files and ensure that
     template functions are resolved correctly. The equivalent icc command-line
     option is /Tdp.


ΓòÉΓòÉΓòÉ 7.2. Language Constructs ΓòÉΓòÉΓòÉ

Use the Language constructs setting to specify the default language standard.

Select one radio button from the group:

ANSI
     Allow only those extensions that conform to the American National
     Standards Institute (ANSI).  The equivalent icc command-line option is
     /Sa.
SAA level 2
     Allow only those extensions defined by the SAA Level 2 specifications.
     This option is only valid for C files.  The equivalent icc command-line
     option is /S2.
Extended
     Allow all C/C++ Tools language extensions.  This is the default setting.
     The equivalent icc command-line option is /Se.
Compatibility
     Allow constructs compatible with older levels of the C++ language.  This
     option is only valid for C++ files. The equivalent icc command-line option
     is /Sc.


ΓòÉΓòÉΓòÉ 7.3. Conversion Rule ΓòÉΓòÉΓòÉ

Use the Conversion rule setting to set type conversion rules.  This option is
only valid for C source files.  For C++, the conversion rule is to preserve
accuracy.

Select one radio button from the group:

Preserve sign
     Preserve the sign of the number being converted.  This is an old-style
     rule that is non-conformant to ANSI specifications.  The equivalent icc
     command-line option is /Sr+.
Preserve accuracy
     Preserve the accuracy of the number being converted.  This new-style rule
     is equivalent to specifying the /Sr- option on the icc command line, and
     is the default setting.


ΓòÉΓòÉΓòÉ 7.4. Use Precompiled Header Files ΓòÉΓòÉΓòÉ

Select the Use precompiled header files check box to use precompiler header
files if they exist and are current.

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


ΓòÉΓòÉΓòÉ 7.5. Ignore Unsupported 16-bit Keywords ΓòÉΓòÉΓòÉ

Select the Ignore unsupported 16-bit keywords check box to ignore unsupported
16-bit keywords, such as near and far. Leave this check box blank if you want
to treat unsupported 16-bit keywords like any other identifier.

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


ΓòÉΓòÉΓòÉ 7.6. Make .OBJ the Default Extension ΓòÉΓòÉΓòÉ

Select the Make .OBJ the default extension check box to set the default file
name extension to .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 default extension in this check box, then the
default file name extension is .C if you selected C for the Source file
language option, and .CPP if you selected 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.


ΓòÉΓòÉΓòÉ 7.7. Allow Use of '//' for Comments ΓòÉΓòÉΓòÉ

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

Note:  This option is only valid for C files.  C++ allows double slashes to
       indicate comments as part of the language.

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


ΓòÉΓòÉΓòÉ 7.8. Allow DBCS Support ΓòÉΓòÉΓòÉ

Select the Allow DBCS support check box to allow the use of double-byte
character set (DBCS) symbols in the source code.

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


ΓòÉΓòÉΓòÉ 7.9. Allow Use of ddnames Support ΓòÉΓòÉΓòÉ

Select the Allow use of ddnames support check box 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.


ΓòÉΓòÉΓòÉ 7.10. Enable Support for Memory File ΓòÉΓòÉΓòÉ

Select the Enable support for memory file check box to allow the use of memory
files.

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


ΓòÉΓòÉΓòÉ 7.11. Margins ΓòÉΓòÉΓòÉ

Use the Margins setting to specify values for the input file margins.  Text
which is outside the specified margins is ignored. The Margins setting is
useful for importing source files that were created on other systems and
contain characters you want to ignore.

This option is only valid for C source files.

o In the Left entry field, type a value between 1 and 65535 to specify a value
  for the left margin.

o In the Right entry field, type an asterisk to denote no right margin, or
  enter a value between 1 and 65535.  The value specified for the right margin
  must be greater than or equal than that specified for the left margin.

Selecting this item is equivalent to specifying the /Sg[l][,r|*] option on the
icc command line, where l and r are integers indicating the left and right
margins, respectively.


ΓòÉΓòÉΓòÉ 7.12. Sequence Numbers ΓòÉΓòÉΓòÉ

Use the Sequence numbers setting to specify columns in which sequence column
numbers appear, and ignore the text in those columns.  Setting Sequence numbers
is useful for importing source files from systems that use sequence numbers.

This option is only valid for C source files.

o In the Left entry field, type a value from 1 to 65535 to specify the left
  sequence column.

o In the Right entry field, type an asterisk to denote no right sequence
  column, or enter a value from 1 to 65535.  The value specified for the right
  column must be greater than or equal to the value specified for the left
  column.

Selecting this item is equivalent to specifying the /Sq[l][,r] option on the
icc command line, where l and r are integers respectively indicating the left
and right columns where sequence numbers appear.


ΓòÉΓòÉΓòÉ 7.13. Enum Variables ΓòÉΓòÉΓòÉ

Use the Enum variables setting to control the size of enum variables in the
source code.

Select one radio button from the group:

SAA
     Use the SAA rules, that is, make all enum variables the size of the
     smallest integral type that can contain all variables.  This is the
     default setting.  The equivalent icc command-line option is /Su-.
1 byte
     Make all enum variables 1 byte.  The equivalent icc command-line option is
     /Su1.
2 byte
     Make all enum variables 2 bytes.  The equivalent icc command-line option
     is /Su2.
4 byte
     Make all enum variables 4 byte.  The equivalent icc command-line option is
     /Su4.


ΓòÉΓòÉΓòÉ 7.14. Packed Structures and Unions ΓòÉΓòÉΓòÉ

Use the Packed structures and unions setting to set the alignment or packing of
data items within structs and unions.

Select one radio button from the group:

1 byte
     Set the most restrictive alignment of structure and union members to
     1-byte.  The equivalent icc command-line option is /Sp1.
2 byte
     Set the most restrictive alignment of structure and union members to
     2-byte.  The equivalent icc command-line option is /Sp2.
4-byte
     Set the most restrictive alignment of structure and union members to
     4-byte.  The equivalent icc command-line option is /Sp4.


ΓòÉΓòÉΓòÉ 8. Object Code Options ΓòÉΓòÉΓòÉ

Use the  Object page to set compiler options that allow you to specify the type
of code that the compiler will produce.  The types of code include:

o Dynamically or statically linked runtime libraries
o Single-thread or multithread programs
o Subsystems
o Optimized.


ΓòÉΓòÉΓòÉ 8.1. Executable Environment ΓòÉΓòÉΓòÉ

Use the Executable environment setting to control the executable runtime
environment.

Select one radio button from the group:

Runtime
     Generate executable code that runs in a C/C++ Tools runtime environment.
     This is the default setting.  The equivalent icc command-line option is
     /Re.
Subsystem
     Generate executable code that can be used as a subsystem without a runtime
     environment.  The equivalent icc command-line option is /Rn.


ΓòÉΓòÉΓòÉ 8.2. Library Selection ΓòÉΓòÉΓòÉ

Use the Library selection setting to specify the version of the library you
want to link to.

Select one radio button from the group:

Single-thread
     Link with the single-thread version of the library (no multithread
     capabilities).  This is the default setting.  The equivalent icc
     command-line option is /Gm-.
Multithread
     Link with the multithread version of the library.  The equivalent icc
     command-line option is /Gm+.


ΓòÉΓòÉΓòÉ 8.3. Library Linkage ΓòÉΓòÉΓòÉ

Use the Library linkage setting to specify how you want to link to the runtime
libraries.

Select one radio button from the group:

Static
     Statically link to the runtime libraries.  All external names beginning
     with the letters Dos, Kbd, and Vio are reserved.  This is the default
     setting.  The equivalent icc command-line option is /Gd-.
Dynamic
     Dynamically link to the runtime libraries.   The equivalent icc
     command-line option is /Gd+.


ΓòÉΓòÉΓòÉ 8.4. Build ΓòÉΓòÉΓòÉ

Use the Build setting to specify the type of file you want to create.

Select one radio button from the group:

EXE
      Build an .EXE file.  This is the default setting.  The equivalent icc
      command-line option is /Ge+.
DLL
      Build a dynamic link library (.DLL) file.  The equivalent icc
      command-line option is /Ge-.


ΓòÉΓòÉΓòÉ 8.5. Target Processor ΓòÉΓòÉΓòÉ

Use the Target processor setting to specify which processor to optimize for.

Select one radio button from the group:

80386
     Optimize code for use with the 80386 processor.  The code generated will
     also run on a 80486 or Pentium** processor.  This is the default setting.
     The equivalent icc command-line option is /G3.
80486
     Optimize code for use with the 80486 processor.  The code generated will
     also run on a 80386 or Pentium processor.  The equivalent icc command-line
     option is /G4.
Pentium
     Optimize code for use with the Pentium processor.  The code generated will
     also run on a 80386 or 80486 processor.  The equivalent icc command-line
     option is /G5.


ΓòÉΓòÉΓòÉ 8.6. Turn on Optimization ΓòÉΓòÉΓòÉ

Select the Turn on optimization check box to optimize the object code.  It is
recommended that you do not optimize the object code if you plan to use the
C/C++ Tools debugger.

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


ΓòÉΓòÉΓòÉ 8.7. Do Not Perform Stack Pointer Optimization ΓòÉΓòÉΓòÉ

Select the Do not perform stack pointer optimization check box to turn off
optimizations that involve the stack pointer.

Note:  Turning off stack pointer optimization is not recommended because it
       decreases the performance of your executable file.

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

If you do not select this option, the default is to perform stack pointer
optimization if the Turn on optimization (/O) option is selected.


ΓòÉΓòÉΓòÉ 8.8. Limit Working Set Size While Optimizing ΓòÉΓòÉΓòÉ

Select the Limit working set size while optimizing check box to limit the
working set size to approximately 35Mb while optimizing.

If you do not select this option, the default is to impose no limit on the
working set size.

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


ΓòÉΓòÉΓòÉ 8.9. Preserve DS and ES Segments for VDD ΓòÉΓòÉΓòÉ

Select the Preserve DS and ES segments for VDD check box to control handling of
DE and ES registers.  This option is provided for virtual device driver (VDD)
development, which is only available for C programs.

If you select this item, the DS and ES registers are saved on entry to an
external function and set to the selector for DGROUP, and then restored on exit
from the function.

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


ΓòÉΓòÉΓòÉ 8.10. Do Not Invoke the Instruction Scheduler ΓòÉΓòÉΓòÉ

Select the Do not invoke the instruction scheduler check box to instruct the
compiler not to use the instruction scheduler even though the Turn on
optimization (/O) option is selected.

If you do not select this option, the default is to invoke the instruction
scheduler if and only if the Turn on optimization option is selected.

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


ΓòÉΓòÉΓòÉ 8.11. Data Segment ΓòÉΓòÉΓòÉ

In the Data segment entry field, type the default name prefix you want to use
for the data and constant segments. The names nameDATA32 and nameCONST32 are
used, where name is the name you entered. You can then give the segments
special attributes by referring to their names.  The renamed segments are not
placed in the default data group.

If you leave this field blank, the default names DATA32 and CONST32 are used.

Specifying a data segment name is equivalent to specifying the /Ndname option
on the icc command line.


ΓòÉΓòÉΓòÉ 8.12. Code Segment ΓòÉΓòÉΓòÉ

In the Code segment entry field, type the default name prefix you want to use
for the code segment.  The name nameCODE32 is used, where name is the name you
entered.  You can then give the segment special attributes by referring to its
name.

If you leave this field blank, the default name CODE32 is used.

Specifying a code segment name is equivalent to specifying the /Ntname option
on the icc command line.


ΓòÉΓòÉΓòÉ 8.13. Inlining ΓòÉΓòÉΓòÉ

Use the Inlining setting to control inlining of user code.

o Select the Turn on check box to inline all user functions qualified with the
  _Inline (for C) or inline (for C++) keyword.  Selecting this item is
  equivalent to specifying the /Oi+ option on the icc command line.

  Note:  When the Turn on optimization (/O) option is active, inlining is
         turned on by default.


o In the Threshold entry field, type a number from 1 to 65535 to inline all
  user functions qualified with the _Inline or inline keyword or that are
  smaller than the Threshold value in abstract code units.  If you leave this
  field blank, all user functions qualified with the _Inline or inline keyword
  will be inlined regardless of their size.

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


ΓòÉΓòÉΓòÉ 8.14. Enable Profiling ΓòÉΓòÉΓòÉ

Select the Enable profiling check box to enable code to be run by EXTRA and
other profiling tools by generated hooks in function prologs.

Note:  To enable code for EXTRA, you must also select the Generate debugging
       information check box in the Debugging page of the Compiler Options
       notebook.

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


ΓòÉΓòÉΓòÉ 8.15. Remove Stack Probes ΓòÉΓòÉΓòÉ

Select the Remove stack probes check box 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.


ΓòÉΓòÉΓòÉ 8.16. Remove C++ Exception Information ΓòÉΓòÉΓòÉ

Select the Remove C++ exception information check box to remove C++ exception
handling information from the code generated by the compiler.

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


ΓòÉΓòÉΓòÉ 8.17. Do Not Generate Default Library Info ΓòÉΓòÉΓòÉ

Select the Do not generate default library info check box to indicate that the
compiler should provide linker information about the default libraries
according to other Object code options.

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

If you do not select this item, no linker information about the default
libraries will be provided.  All libraries must then be explicitly specified at
link time.  This is equivalent to specifying the /Gn- option on the icc command
line.


ΓòÉΓòÉΓòÉ 8.18. Use Optlink Linkage ΓòÉΓòÉΓòÉ

Select the Use optlink linkage check box 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 (API).

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

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


ΓòÉΓòÉΓòÉ 8.19. Use Tiled Memory ΓòÉΓòÉΓòÉ

Select the Use tiled memory check box to enable all variables to 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.

When this option is selected, the memory management functions calloc, free,
malloc, and realloc are mapped to the tiled versions _tcalloc, _tfree,
_tmalloc, and _trealloc.

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


ΓòÉΓòÉΓòÉ 8.20. Use Fast Floating Point Method ΓòÉΓòÉΓòÉ

Select the Use fast floating point method check box to indicate that 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, you can use this option to increase your program's
performance.

Because the floating-point method does not perform all the conversions
specified by the ANSI standards, the results obtained may differ from results
obtained using ANSI methods, but are often more precise.

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


ΓòÉΓòÉΓòÉ 8.21. Generate Code to Run at Ring 0 ΓòÉΓòÉΓòÉ

Select the Generate code to run at ring 0 check box to indicate that you want
to generate 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.


ΓòÉΓòÉΓòÉ 8.22. Remove Unused Data in Intermediate Files ΓòÉΓòÉΓòÉ

Select the Remove unused data in intermediate files check box to tell the
compiler that external functions may not use data defined in the intermediate
files being linked.  The data is only used within the intermediate files being
linked, with the exception of data qualified with the _Export keyword.

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

If you do not select this option, external functions will be allowed to use
data in the intermediate files being linked (equivalent to specifying the /Gu-
option on the icc command line).


ΓòÉΓòÉΓòÉ 8.23. Invoke Intermediate Code Linker ΓòÉΓòÉΓòÉ

Select the Invoke intermediate code linker check box to instruct the compiler
to pass code through the intermediate code linker before generating an object
file.

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

For more information on intermediate code, please refer to the section, Using
the Intermediate Code Linker, in Chapter 4 of the IBM* C/C++ Tools: Programming
Guide.


ΓòÉΓòÉΓòÉ 8.24. Generate FWAIT After Load ΓòÉΓòÉΓòÉ

Select the Generate FWAIT after load check box to generate the FWAIT
instruction after each floating-point load instruction.  This allows the
program to take a floating-point stack overflow exception immediately after the
load instruction that caused it.

Note:  This option is not recommended because it increases the size of your
       executable file and greatly decreases its performance.

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


ΓòÉΓòÉΓòÉ 8.25. Use Fast Integer Method ΓòÉΓòÉΓòÉ

Select the Use fast integer method check box to use fast integer execution.

If you are shifting bits by a variable amount, you can use fast integer
execution to ensure that for values greater than 31, the bits are shifted by
the result of a modulo 32 of the value.  Otherwise, the result of the shift is
0.

Note:  If your shift value is a constant greater than 32, the result will
       always be 0.

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


ΓòÉΓòÉΓòÉ 9. Preprocessor Options ΓòÉΓòÉΓòÉ

Use the Preprocessor page to set compiler options that let you control the use
of the preprocessor.


ΓòÉΓòÉΓòÉ 9.1. Run the Preprocessor Only ΓòÉΓòÉΓòÉ

Select the Run the preprocessor only check box to run the preprocessor only
without running the compiler, and to create a preprocessor output file that has
the same name as the source file, with a .I file name extension. Comments from
the source code are not included in the preprocessor output file.

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


ΓòÉΓòÉΓòÉ 9.2. Send the Output to Stdout ΓòÉΓòÉΓòÉ

Select Send the output to stdout check box to send the preprocessor output to
the stream specified by stdout.

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

If you do not select this item, the created preprocessor output file will have
the same name as the source file with a .I file name extension.  This is
equivalent to specifying the /Pd- option on the icc command line.


ΓòÉΓòÉΓòÉ 9.3. Retain Comments ΓòÉΓòÉΓòÉ

Select the Retain comments check box to include the source code comments in the
generated preprocessor output file.

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


ΓòÉΓòÉΓòÉ 9.4. No Line Numbers ΓòÉΓòÉΓòÉ

Select the No line numbers check box to suppress the creation of #line
directives in preprocessor output.

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


ΓòÉΓòÉΓòÉ 9.5. Remove All User-defined Macros ΓòÉΓòÉΓòÉ

Select the Remove all user-defined macros check box to remove all macros that
are user-defined.

Note:  This option does not affect the macros _DATE_, _TIME_, _TIMESTAMP_,
       _FILE_, and _FUNCTION_, nor does it undefine macros defined in source
       code.

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


ΓòÉΓòÉΓòÉ 9.6. Remove ΓòÉΓòÉΓòÉ

In the Remove entry box, specify the names of macros you want to remove from
the preprocessor output.  For example, if you want to remove the macros
_MY_MACRO_ and _EDS_MACRO_, then you would enter:

_MY_MACRO_
_EDS_MACRO_

Entering the names of macros in this field is equivalent to specifying the
/Uname option on the icc command line.


ΓòÉΓòÉΓòÉ 9.7. Define ΓòÉΓòÉΓòÉ

In the Define entry box, specify the names and values for each preprocessor
macro you want to define.  For example, if you want to define the macros
_MY_MACRO_ to the value 43 and _EDS_MACRO_, to the value 28, then you would
enter:

_MY_MACRO_=43
_EDS_MACRO_=28

The macros you define in the Define list box will override macros already
defined in your source code.

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


ΓòÉΓòÉΓòÉ 10. Other Options ΓòÉΓòÉΓòÉ

Use the Other page to set C/C++ Tools compiler options that control linker
parameters, logo display, default char type, and other compiler options.


ΓòÉΓòÉΓòÉ 10.1. Perform Compile Only, No Link ΓòÉΓòÉΓòÉ

Select the Perform compile only, no link check box 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.


ΓòÉΓòÉΓòÉ 10.2. Make Default Char Type Unsigned ΓòÉΓòÉΓòÉ

Select the Make default char type unsigned check box 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.


ΓòÉΓòÉΓòÉ 10.3. Display the Logo ΓòÉΓòÉΓòÉ

Select the Display the logo check box 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.


ΓòÉΓòÉΓòÉ 10.4. Length of External Names ΓòÉΓòÉΓòÉ

In the Length of external names entry field, type a number from 6 to 255 to set
the significant length for external names.

Setting this option is equivalent to specifying the /H num option on the icc
command line.


ΓòÉΓòÉΓòÉ 10.5. Version String ΓòÉΓòÉΓòÉ

In the Version string entry field, type a text string up to 256 characters long
to include in the object and executable files.

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


ΓòÉΓòÉΓòÉ 10.6. Parameters Passed to Linker ΓòÉΓòÉΓòÉ

In the Parameters passed to linker entry list box, type any parameters you want
passed to the linker.  The icc default parameters are also passed.

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


ΓòÉΓòÉΓòÉ 10.7. Preload Compiler Components ΓòÉΓòÉΓòÉ

Select the Yes checkbox for the Preload compiler components settings to preload
compiler components as they are required.

Once a component is loaded, it remains in memory for 10 minutes, unless you
specified a preferred timeout length in the Timeout field. If it is not
referenced in that time (or the compiler is invoked again with this option
turned off), it is unloaded.  Each compiler component has its own timer.

Note:  This option is not available if you are using the OS/2* 2.0 level of the
       operating system without the Service Pack updates.

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


ΓòÉΓòÉΓòÉ 10.8. Timeout ΓòÉΓòÉΓòÉ

Enter an integer between 1 and 65535 in the Timeout entry field to indicate the
number of minutes you want preloaded compiler components to remain in memory.

If you leave this field blank, the preloaded compiler components will remain in
memory for 10 minutes.

Selecting this item is equivalent to specifying the /Tl:value option on the icc
command line, where value is the timeout value for the preloaded compiler
components.


ΓòÉΓòÉΓòÉ 11. User Options ΓòÉΓòÉΓòÉ

Use the User page to enter options that are passed verbatim to the compiler.


ΓòÉΓòÉΓòÉ 11.1. User ΓòÉΓòÉΓòÉ

In the User entry field, type any options that you want passed to the compiler,
verbatim.

Note:  No consistency checking or conflict resolution is performed on any
       options you enter in this field until the compiler is actually invoked.


ΓòÉΓòÉΓòÉ <hidden> 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
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 pull-down
Esc
          Cancel a pull-down, the system menu, or window
Home
          Go to the first choice in a pull-down
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 pull-down 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> Conflicting Compiler Options ΓòÉΓòÉΓòÉ

You have specified two or more options that are incompatible. Select Ignore
conflict to continue and let one option take precedence, as indicated.  Select
Cancel to return to the Compiler Options settings notebook.

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 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
  options are ignored.

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

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

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

o You indicated that you wanted to use tiled memory, but also that you wanted
  to use the debug memory management functions. The option to use the tiled
  memory takes precedence.

o You indicated that you wanted to generate executable code that runs in a
  C/C++ Tools runtime environment, but also that you wanted to generate object
  code to run at ring 0.  The option to generate executable code to run in the
  runtime environment takes precedence.


ΓòÉΓòÉΓòÉ <hidden> Ignore conflict ΓòÉΓòÉΓòÉ

Click on the Ignore conflict push button to indicate that you want to save your
changes and use the options that take precedence.


ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ

Click on the Cancel push button to return to the Compiler Options notebook and
correct conflicting options.


ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ

Click on the OK push button to save the settings you made and close the
Compiler Options notebook


ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ

Click on the Default pushbutton to set all the options in the Compiler Options
notebook back to their default settings.


ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ

Click on the Reset push button to update the compiler options settings to their
initial values.


ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ

Click on the Cancel push button to close the Compiler Options notebook without
saving any changes.


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

Click on the Help push button to get help on the Compiler Options notebook.


ΓòÉΓòÉΓòÉ <hidden> Reset Page ΓòÉΓòÉΓòÉ

Click on the Reset Page push button to update the compiler options settings in
this page to their initial values.


ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ

Click on the Default push button to update the compiler options with their
default values.


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

Click on the Help push button to get help on this page of the Compiler Options
notebook.


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

Explanation:

You are using a compiler options file from a previous version of the
WorkFrame/2* product.  Do you want to use the default option settings?

Recovery:

Select Yes to open the Compiler Options notebook with the default option
settings. Select No to cancel the current operation.


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

Explanation:

The options file for your project has been corrupted.

Recovery:

Use the default options and then reset them to your preferred settings.


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

Explanation:

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 ΓòÉΓòÉΓòÉ

Explanation:

You have chosen to discard all the changes made to the Compiler Options
settings.  Are you sure you want to discard the changes?

Recovery:

Select the Yes push button if you want to discard the changes and exit from the
Compiler Options notebook.  Select the No pushbutton if you want to retain the
changes and return to the previous page without exiting from the Compiler
Options notebook


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

Explanation:

No files that match the specified file specifier were found. Do you want to
ignore it?

Recovery:

Select Yes to ignore the file specifier, save the option settings, and close
the Compiler Options notebook.  Select No to return to the previous page
without closing the Compiler Options notebook.


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

Explanation:

One or more of the specified paths does not exist. Do you want to ignore it?

Recovery:

Select Yes to ignore the specified path, save the current settings, and close
the Compiler Options notebook.  Select No to return to the previous page.

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

One or more of the specified paths contains a directory name that is longer
than the maximum length permitted by the operating system.

Recovery:

Enter a shorter directory name and try the command again.

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

This field requires the names of one or more directory path names.  The path
name must not contain the name of a file.

Recovery:

Type a valid directory path name in the field.


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

Explanation:  The directory path name must be an existing path and must follow
the naming conventions for directories:

o The name must be 1 to 8 alphanumeric characters

o The first character must be alphabetic

o The name cannot contain embedded blanks, or the characters @, #, and $

o If you are specifying more than one path name, separate each with a
  semicolon.

Recovery:  Type a valid directory path name in the field.

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

You have chosen to reset the compiler options to their previous settings.  Are
you sure you want to reset the compiler options?

Recovery:

Select Yes if you want to reset the compiler option settings. Select No to
retain their current settings.  You are then returned to the Compiler Options
notebook.


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

Explanation:

You have chosen to reset the compiler options to their default settings.  Are
you sure you want to update the compiler options with their default settings?

Recovery:

Select the Yes push button if you want to reset the compiler options to the
default settings.  Select the No push button if you want to retain their
current settings.  You are then returned to the Compiler Options notebook.


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

Explanation:

The application was unable to create a dialog panel for the Compiler Options
notebook due to insufficient system resources.

Recovery:

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


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

Explanation:

The system path length could not be obtained.

Recovery:

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

An integer between 1 and 65535 is expected for the Timeout field for preloaded
compiler components. You may also leave this field blank.

Recovery:

Type a number between 1 and 65535, or leave the field blank.


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

Explanation:

An unknown error has been detected.

Recovery:

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

An integer between 1 and 65535 is expected for the Stop on error count of
field.  You may also leave this field blank.

Recovery:

Type a number between 1 and 65535, or leave the field blank.


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

Explanation:

An integer between 15 and 65535 is expected for the Page length field.

Recovery:

Type a number between 15 and 65535.


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

Explanation:

An integer between 6 and 255 is expected for the Length of external names
field.

Recovery:

Type a number between 6 and 255.


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

Explanation:

An integer between 1 and 65535 is expected for the left and right margins.  The
right margin value must be greater than that specified for the left margin.

Recovery:

Type a number between 1 and 65535 for the right and left margin fields.
Specify a number for the right margin that is greater than that specified for
the left margin.


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

Explanation:

An integer between 1 and 65535 is expected for the left and right sequence
numbers.  The right sequence value must be an asterisk (*) to denote no right
sequence column or an integer greater than that specified for the left sequence
column.

Recovery:

Type a number between 1 and 65535 for the right and left sequence numbers.  For
the right sequence column, specify an asterisk or a number that is greater than
that specified for the left sequence column.


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

Explanation:

An integer between 1 and 65535 is expected for the inlining threshold. You may
also leave this field blank.

Recovery:

Enter a number between 1 and 65535 or leave the field blank.


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

Explanation:

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

Recovery:

Use the Language Profile Management window to change one or both of the Maximum
compile string and Maximum compile size field values in the language profile so
that more storage is allocated.


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

Explanation:

You are using a Compiler Options file from a previous version of the
WorkFrame/2* product. Would you like to convert the old compiler option
settings to the new version?

Recovery:

Select Yes to indicate that you want an automatic conversion to be performed
using the old compiler options file.

Note:  Options have been added, changed, or deleted since the last version.
       Please read through the option settings in the Compiler Options notebook
       after the conversion has been completed.

Select No to use the default options.


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

Explanation:

The compiler options dialog needs to store information with the project file.
Because the project file does not exist yet, you cannot set the compiler
options at this time.

Recovery:

For Version 1.1 of the WorkFrame/2, finish creating the project by specifying
any other options (except those for the compiler), and then selecting the OK
push button. Once the project has been created, you can set the compiler
options from the Options pull down on the WorkFrame/2 menu bar.

See the OS/2* Return Codes Help for more information on the error.


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

Explanation:

The specified file could not be found.  A symbolic file name in the original
source file might have caused this error. Occurrences of the indicated file
will be commented out in the created makefile.

Recovery:

 1. Verify that the INCLUDE environment variable is set up correctly.

 2. Verify that the file exists.

 3. You can have the Make Make ignore the error by selecting the Ignore push
    button. The file will appear in the generated make file, but it will not be
    checked for any further include files.


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

Explanation:

Make Make could not acquire enough storage to complete the make file generation

Recovery:

Close other sessions, or make more room on the disk for the OS/2 swap file,
then try the operation again.


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

Explanation:

The name of the specified #include file may be too long or may contain invalid
characters.

Recovery:

Verify the name of the invalid #include file in the source.


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

Explanation:

The specified #include uses a preprocressor variable that could not be
resolved.

Recovery:

Do one of the following to recover:

 1. Have Make Make ignore the error by selecting the Ignore push button.  The
    file will not appear as a dependency in the generated make file. You can
    then manually update the make file later.

 2. Restructure the C/C++ source file to remove the preprocessor variable
    construct so that the #include can be resolved by the make file creation
    utility, then try the operation again.


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

Explanation:

The make file creation utility encountered an error while reading the specified
file.  If the file is on a removable medium, you may have deleted or moved it.
If it is on a LAN, the connection to the LAN server may have been broken.

Recovery:

Verify that the specified file is in the expected location and that it is
accessible, then retry the operation.  If the problem persists, contact your
IBM Service Representative.


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

Explanation:

The make file creation utility was able to find the file, but could not open
it.  Another process may have the file open, or the file name may specify a
directory.

Recovery:

Do one of the following to recover:

 1. Ignore the error by clicking on the Ignore push button on the message
    dialog.  Occurrences of the indicated file in the make file will be
    commented out.  You can manually edit the generated make file afterwards.

 2. Halt the other process that is using the specified file then retry the
    operation.

 3. Correct the source in which this file name appears then retry the
    operation.


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

Explanation:

The specified file may not exist or may be in use by another process.

Recovery:

Ensure that the file exists and that it is not in use by another process, then
try the operation again.


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

Explanation:

The specified file may be in use by another process, or there may not be enough
disk space to write the new information on disk.

Recovery:

Ensure that the file is not in use by another process, and that there is enough
disk space to save the information by deleting or moving unecessary files.


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

Explanation:

The specified project file may be corrupt or invalid.

Recovery:

Ensure that the specified project file is a valid WorkFrame/2* V2.0 project
file.


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

Explanation:

The file could not be found, may be in use by another process, or a system
error could have occurred.

Recovery:

Ensure that the file exists in the expected location and that it is not in use
by another process, then retry the operation.

If this error persists, contact your IBM* Service Representative.


ΓòÉΓòÉΓòÉ <hidden> Retry ΓòÉΓòÉΓòÉ

Click on the Retry push button to try the operation again.


ΓòÉΓòÉΓòÉ <hidden> Abort ΓòÉΓòÉΓòÉ

Click on the Abort push button to terminate the current operation.  No make
files will be generated.


ΓòÉΓòÉΓòÉ <hidden> Ignore ΓòÉΓòÉΓòÉ

Click on the Ignore pushbutton to continue without acknowledging the specified
error.  The make file will be generated but ignoring the error may cause a
related component to be left out of the make file.


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

Explanation:

The application was unable to access the project file.  This may be caused by
one of the following reasons:

o The drive was not ready.  Make sure there is a diskette in the drive you want
  to save the file to.

o The diskette or disk you wanted to write to may be full.  Delete some files
  or specify another disk to write to.

o The diskette or disk may be write-protected.  Remove the write protection on
  the disk to save the file on it.

o The specified path may not exist in your system.  If you have made a typing
  error, re-enter the path.  Otherwise, create the path on your system or
  specify another path.

o The file permissions may be set to read-only.  Change the file permission to
  allow writes or specify another filename to save the file to.

See the OS/2* Return Codes Help for more information on the error.


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

For more information on a message, select it from the list below:

o Compiler DLL internal error - insufficient heap

o Invalid #include in file <filename> - include name = <include name>

o Indeterminate #include in file <filename> - include name = <include name>

o Cannot open file <filename>

o Cannot find file <filename>

o Error reading file <filename>



ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of the IBM Corporation


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

The listing file includes information from the compiler but is not intended for
use as a programming interface.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of the Intel Corporation