OS/2 Shareware BBS: 10 Tools/10-Tools.zip/VSCPPv4.zip/VACPP/IBMCPP/HELP/CPPICL30.HLP

OS/2 Help File | 1995-06-02 | 25KB | 709 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 are trademarks of the IBM corporation in the United States
and/or other countries:

BookManager
C/2
C Set/2
C Set ++
Common User Access
CUA
IBM
LibraryReader
Open Class
Operating System/2
OS/2
OS/2 Warp
Personal System/2
PS/2
Presentation Manager
Systems Application Architecture
SAA
VisualAge
WorkFrame
WorkPlace Shell
System Object Model
SOM

Windows is a trademark of Microsoft Corporation.

Pentium is a trademark of Intel Corporation.

Other company, product, and service names, which may be denoted by a double
asterisk (**), may be trademarks of others.

This publication 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.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independent created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact IBM Canada Ltd.,
Department 071, 1150 Eglinton Ave E., North York, ONT Canada M3C 1H7. Such
information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.


ΓòÉΓòÉΓòÉ 2. Link Options ΓòÉΓòÉΓòÉ

Use this notebook to select the group of link options you want to change. The
options you specify are associated with the project you are currently working
on.

You can set any of 4 option categories:

     Generation
     Processing
     File names
     Templates

 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.

 See Command-line equivalents for a mapping between command-line options and
 options set in WorkFrame.


ΓòÉΓòÉΓòÉ 3. Command-line equivalents ΓòÉΓòÉΓòÉ

This table lists linker options in their positive forms only (for example,
/DEBUG appears, but /NODEBUG does not). In most cases, a single checkbox in the
WorkFrame notebook sets either the positive or negative form of the option (for
example, select the checkbox Don't display the logo to set the option /NOLOGO,
and deselect the checkbox to set /LOGO).

OPTION          NOTEBOOK TAB    PAGE    CONTROL DESCRIPTION

/ALIGNMENT      Generation      2       Segment Alignment
/BASE           Generation      1       Module load address
/BROWSE         Generation      1       Include browse information
/DBGPACK        Generation      1       Pack debug information
/DEBUG          Generation      1       Include debug information
/DEFAULTLIB     Processing      1       Ignore default libraries
/EXEPACK        Generation      2       Compression
/EXTDICTIONARY  Processing      1       Search the extended library
/IGNORECASE     Processing      1       Ignore case
/INFORMATION    Processing      1       Display link-time information
/LINENUMBERS    Processing      1       Generate map file with line numbers
/LOGO           Processing      1       Don't display the logo
/MAP            File names      1       Map file name
/MAP            Processing      1       Generate a map file
/OPTFUNC        Generation      2       Remove unreferenced functions
/OUT            File names      1       Generated target file name
/PACKCODE       Generation      2       Pack the code segments
/PACKDATA       Generation      2       Pack the data segments
/PMTYPE         Generation      1       Application type
/SEGMENTS       Generation      2       Maximum number of segments
/STACK          Generation      1       Stack size:


ΓòÉΓòÉΓòÉ 4. Generation ΓòÉΓòÉΓòÉ

Use the Generation pages to control the format and content of the executable
file produced by the linker:

     Include debug information (/DE[BUG])

     Pack debug information (/DB[GPACK])

     Include browse information (/BR[OWSE])

     Stack size (/ST[ACK]:number)

     Module load address (/BAS[E]:number)

     Application type (/PM[TYPE]:parameter)

     Compression (/E[XEPACK][1|2])

     Pack the code segments (/P[ACKCODE][:number])

     Pack the data segments (/PACKD[ATA][:number])

     Maximum number of segments (/SE[GMENTS]:number)

     Segment alignment (/A[LIGNMENT]:number).

     Remove unreferenced functions (/OPTF[UNC]).


ΓòÉΓòÉΓòÉ 4.1. Include debug information ΓòÉΓòÉΓòÉ

If you are going to debug your application, select this option to copy the
debug information from the objects into the module.

The corresponding command line option is /DE[BUG].


ΓòÉΓòÉΓòÉ 4.2. Pack debug information ΓòÉΓòÉΓòÉ

If you are going to debug your application, select this option to pack the
debug information by eliminating redundant debug type information that occurs
in multiple object modules.

The corresponding command line option is /DB[GPACK].


ΓòÉΓòÉΓòÉ 4.3. Include browse information ΓòÉΓòÉΓòÉ

If you are going to browse your application, select this option to include the
browse information from the object modules in the executable you are creating.

The corresponding command line option is /BR[OWSE].


ΓòÉΓòÉΓòÉ 4.4. Stack size ΓòÉΓòÉΓòÉ

Specify the size of the stack to be used by the module. The size must be in the
range from zero to 65535 (for 16-bit code) or zero to 4294967295 (for 32-bit
code). You can use any of the following formats:

     Hexadecimal (prefixed by 0x as in 0x2D7)

     Octal (prefixed by zero as in 027)

     Decimal (cannot start with zero as in 27).

 The default value is 32K for the first thread of your application.

 The corresponding command line option is /ST[ACK]:number.


ΓòÉΓòÉΓòÉ 4.5. Module load address ΓòÉΓòÉΓòÉ

Use this option to specify the address that the module will be loaded at if the
address space is not being used by other code. You can use this option for both
executable files and dynamic link libraries.

You can use any of the following formats:

     Hexadecimal (prefixed by 0x as in 0x2D7)

     Octal (prefixed by zero as in 027)

     Decimal (cannot start with zero as in 27).

 For executable files, the recommended value is 65536.

 The corresponding command line option is /BAS[E]:number.


ΓòÉΓòÉΓòÉ 4.6. Application type ΓòÉΓòÉΓòÉ

Select one of these radio buttons to specify the type of program to be built by
the linker.

Select None if you do not want the linker to set the type of program. The
program itself will determine what kind of program it is. By default, the
VisualAge C++ linker creates a program that runs in a text window (see Window
below).

Select the PM radio button to specify to the linker that the file to be built
is a Presentation Manager* program and is to be run in a window. The
corresponding command line option is /PM[TYPE]:PM.

Select Window to specify to the linker that the program can run in a window but
is not a Presentation Manager* program. The corresponding command line option
is /PM[TYPE]:VIO.

Select Full screen to specify to the linker that the program can only run in
full screen mode. The corresponding command line option is /PM[TYPE]:NOVIO.


ΓòÉΓòÉΓòÉ 4.7. Compression ΓòÉΓòÉΓòÉ

Use the Compression options to select the type of compression you want to
perform on your executable. The options are as follows:

 None
           Does not compress the executable. The corresponding command line
           option is /NOEXEPACK.
 Data
           Compresses data segments in the executable. The corresponding
           command line option is /EXEPACK.
 Code and data
           Only select this option if your executable does not need to run
           under OS/2 version 2.1 or earlier. Executables compressed with this
           option can only be run under OS/2 version 3.0 or later. This option
           compresses both code and data segments. The corresponding command
           line option is /EXEPACK:2.


ΓòÉΓòÉΓòÉ 4.8. Pack the code segments ΓòÉΓòÉΓòÉ

Select Pack the code segments to concatenate the code segments when building
the module.

If the Pack the code segments check box is selected, you can use the Size entry
field to specify the maximum size of each of the concatenated code segments in
the module. The size must be in one of the following formats:

     Hexadecimal (prefixed by 0x as in 0x2D7)

     Octal (prefixed by zero as in 027)

     Decimal (cannot start with zero as in 27).

 For 16-bit code, the size can be from zero to 65500 and the default value is
 65500.

 For 32-bit code, the size can be from zero to 4294967295 and the default value
 is 4294967295.

 The corresponding command line options are:

 /PACKC[ODE] (the default)
           If the Pack the code segments is selected. /NOP[ACKCODE] causes the
           linker to not pack the code.

 /PACKC[ODE]:number
           If a number is entered in the Size field.


ΓòÉΓòÉΓòÉ 4.9. Pack the data segments ΓòÉΓòÉΓòÉ

Select Pack the data segments to concatenate the data segments together when
building the module.

If the Pack data segments check box is selected, you can use the Size entry
field to specify the maximum size of each of the concatenated data segments in
the module. The size must be in one of the following formats:

     Hexadecimal (prefixed by 0x as in 0x2D7)

     Octal (prefixed by zero as in 027)

     Decimal (cannot start with zero as in 27).

 For 16-bit code, the size can be from zero to 65536 and the default value is
 65536.

 For 32-bit code, the size can be from zero to 4294967295 and the default value
 is 4294967295.

 The corresponding command line options are:

 /PACKD[ATA]
           If the Pack data segments is selected.

 /PACKD[ATA]:number
           If a number is entered in the Size field.


ΓòÉΓòÉΓòÉ 4.10. Maximum number of segments ΓòÉΓòÉΓòÉ

Specify the maximum number of segments that is to be allowed in the module. The
number must be in the range from 1 to 16375. You can use any of the following
formats:

     Hexadecimal (prefixed by 0x as in 0x2D7)

     Octal (prefixed by zero as in 027)

     Decimal (cannot start with zero as in 27).

 The default is 256.

 The corresponding command line option is /SE[GMENTS]:number.


ΓòÉΓòÉΓòÉ 4.11. Segment alignment ΓòÉΓòÉΓòÉ

Specify the segment alignment factor (in bytes) in the executable file. The
default value is 512.

The corresponding command line option is /A[LIGNMENT]:number.


ΓòÉΓòÉΓòÉ 4.12. Remove unreferenced functions ΓòÉΓòÉΓòÉ

Select this option to remove functions that are unreachable. The linker removes
functions that are:

     Not referenced in any input file
     Rendered unreferenced by the removal of other functions
     Not exported for use in other files

 The corresponding command line option is /OPTF[UNC].


ΓòÉΓòÉΓòÉ 5. Processing ΓòÉΓòÉΓòÉ

The options that appear on this page specify to the linker how to build the
executable file.

They are:

     Do not display the logo (/NOL[OGO])

     Display link-time information (/INF[ORMATION])

     Generate a map file (/MAP)

     Generate map file with line numbers ( /LINENUMBERS)

     Ignore case (/I[GNORECASE])

     Search the extended library (/E[XTDICTIONARY])

     Ignore default libraries (/NOD[EFAULTLIBRARYSEARCH][:libname])


ΓòÉΓòÉΓòÉ 5.1. Do not display the logo ΓòÉΓòÉΓòÉ

Choose whether or not to display the name, version, and copyright information
of the linker.

The corresponding command line option is (/NOL[OGO]).


ΓòÉΓòÉΓòÉ 5.2. Display link-time information ΓòÉΓòÉΓòÉ

Select this option to display messages as it creates the executable file.

The corresponding command line option is /INF[ORMATION].


ΓòÉΓòÉΓòÉ 5.3. Ignore case ΓòÉΓòÉΓòÉ

Select this option to ignore the case of external definitions when trying to
resolve external references.

The corresponding command line option is /I[GNORECASE].


ΓòÉΓòÉΓòÉ 5.4. Search the extended dictionary ΓòÉΓòÉΓòÉ

Select this option to use the extended library information (if it exists) found
in the library.

The corresponding command line option is /E[XTDICTIONARY].


ΓòÉΓòÉΓòÉ 5.5. Ignore default libraries ΓòÉΓòÉΓòÉ

Select Ignore default libraries to specify that the linker should not search
the default libraries named within the object modules.

If only certain default libraries should be ignored, you can enter their names
in the Particular libraries to ignore field if the Ignore default libraries
check box is selected.

Note:  If you are specifying more than one library, separate the names with a
       space (' ').

 The corresponding command line options are:

 /NOD[EFAULTLIBRARYSEARCH]
           To ignore all the default libraries named in the object modules.

 /NOD[EFAULTLIBRARYSEARCH]:libname
           For each particular library to be ignored.


ΓòÉΓòÉΓòÉ 5.6. Generate map file ΓòÉΓòÉΓòÉ

Use the Generate map file option to generate a map file. Select Generate map
file with line numbers to include line numbers from the source files in the map
file.

You can specify a name for the map file on the File page of the notebook.

The corresponding command line option is /M[AP].


ΓòÉΓòÉΓòÉ 5.7. Generate map file with line numbers ΓòÉΓòÉΓòÉ

Use the Generate map file with line numbers option to generate a map file that
includes the line numbers from source files in the output. The object files
being linked must contain line number information for this option to take
effect.

You can specify a name for the map file on the File page of the notebook.

The corresponding command line option is /L[INENUMBERS].


ΓòÉΓòÉΓòÉ 6. File names ΓòÉΓòÉΓòÉ

This page lets you specify the names of the following files:

 Generated target file name
           The name of the module file.

 Map file name
           The name of the map file.

 Libraries to use
           The names or paths of any libraries to be used for resolving
           external references. You can also specify paths to be searched for
           the required libraries.

 Definition file name
           The name of the definition file used to build the module.


ΓòÉΓòÉΓòÉ 6.1. Generated target file name ΓòÉΓòÉΓòÉ

Enter the name of the module file to be produced.

By default, the entry field contains the %o substitution variable. This
variable is substituted with the Name specified on the Target page of the
project's Settings note book.

The corresponding linker command line option is /OUTfilename.


ΓòÉΓòÉΓòÉ 6.2. Map file name ΓòÉΓòÉΓòÉ

Enter the name of the map file to be produced. You must first specify that you
want a map file, by selecting either the Generate a map file or Generate a map
file check box on the Processing page. If no extension is specified, the linker
assumes the extension is .MAP.

The corresponding linker command line option is /MAPfilename.


ΓòÉΓòÉΓòÉ 6.3. Libraries to use ΓòÉΓòÉΓòÉ

Enter the names of the libraries and object files to be searched when the
linker tries to resolve the external references found in the objects it is
linking. If a name does not have the extension .LIB or .OBJ, the extension .LIB
is appended. If the extension is .OBJ, the name is treated as another file that
will be linked. The linker searches the libraries after searching the objects
themselves.

You can also specify fully qualified names.

Note:  Use a space (' ') to separate the entries.


ΓòÉΓòÉΓòÉ 6.4. Definition file name ΓòÉΓòÉΓòÉ

Enter the name of the definition file used to build the module. If no extension
is specified, the linker assumes the extension is .DEF.


ΓòÉΓòÉΓòÉ 7. Templates ΓòÉΓòÉΓòÉ

Use this page to provide information about template use in your files. Use the
C++ template support controls to indicate whether your code uses templates (and
were compiled with the Produce file - Templates compiler option), and what
compiler action the object files were compiled with.

Note:  If you are linking in old object files, created by previous versions of
the compiler, that use template files, use the procedure given in Old object
files when you compile and link.


ΓòÉΓòÉΓòÉ 7.1. C++ template support ΓòÉΓòÉΓòÉ

Select the Templates used checkbox to indicate that your code uses templates,
and was compiled with the Produce file - Templates compiler option (equivalent
to the /Ft command-line option).

In the Associate Compiler Action pulldown, select the compiler action you used
when compiling the source files. When you link the object files, the template
files are compiled with this action, and then linked with the object files.

Notes:

     By default, there is only one compiler action available in the pulldown.
      However, if you have defined more than one compiler action, be sure that
      the compiler action you specify in the pulldown is the same as the
      compiler action you used during the compile step.
     If you are linking in old object files, created by previous versions of
      the compiler, you need to use the procedure given in Old object files
      when you compile and link.

 The Templates used option only applies to projects containing C++ code that
 uses templates. If you specified C as the Source file language in the compiler
 options dialog, this option has no effect.


ΓòÉΓòÉΓòÉ 7.2. Old object files ΓòÉΓòÉΓòÉ

If you are linking object files created by previous versions of the compiler,
you will need to:

   1. Set the compiler to invoke the linker (in the Compiler Options notebook,
      on the Processing step page, select Compile and link)
   2. Set the /Gk command-line option (in the Compiler Options notebook, on the
      User page, enter /Gk in the entry field)
   3. Pass linker options to the linker, rather than setting them in the Linker
      Options notebook (in the Compiler Options notebook, on the Other page,
      enter linker options using command-line syntax in the Parameters passed
      to linker field).


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

Select OK to save the options you chose and close the note book.


ΓòÉΓòÉΓòÉ <hidden> Reset/Reset page ΓòÉΓòÉΓòÉ

Select Reset to set options to the values they had when the note book was
opened.

If the Reset page pushbutton is selected, only the options on that page are
reset.

If the Reset pushbutton on the bottom of the note book window is selected, all
options in the note book are reset.


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

Select Default to set options to their default values.

If Default pushbutton at the bottom of the note book window is selected, all
options are set to their default values.

If the Default pushbutton on the page is selected, only the options on that
page are set to the default values.


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

Select Cancel to remove the note book without making any changes.


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

The list of keys is arranged in groups.

Use:

     HELP KEYS to get help

     SYSTEM KEYS to switch between programs

     WINDOW KEYS to move around in a program window

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

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

Use DDE4ICC2.DLL to do intermediate linking. See the help for Invoke
intermediate code linker on the Object page of the note book used to set the
compiler options.