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

OS/2 Help File | 1993-10-07 | 22KB | 641 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:

IBM
OS/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 is entirely coincidental.


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

Use this note book 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 also specify whether or not the options are saved with the project.


ΓòÉΓòÉΓòÉ 2.1. Template Support ΓòÉΓòÉΓòÉ

Note:  This 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.

If your are using C++ templates in your project, the template files need to be
compiled before they are linked. This is accomplished by invoking the linker
indirectly through the compiler. That is why the language profile defines
icc.exe as the linker instead of link386.exe and why the linker options dynamic
link library is specified as DDE4ICL.DLL rather than the WorkFrame/2* default
linker options DLL.

In version 2.1 of the WorkFrame/2 product, you can define multiple actions that
use the icc.exe compiler. When the linker is invoked, it has to know which set
of options should be used. Specify the set of compiler options that the linker
uses by selecting one of the entries in the Associate Compiler Action list box.

If you select the Templates used option, the options to compile the template
files are based on the compiler options but are modified. Click on the heading
Compiler Options and Templates for more information.


ΓòÉΓòÉΓòÉ 3. Compiler Options and Templates ΓòÉΓòÉΓòÉ

These compiler options are ignored:

o Perform compile only, no link (on the Other page)
o Perform syntax check only (on the File page)
o All the options on the first Preprocessor page.
o Allow the use of '//' comments (on the Source page)
o Margins and Sequence numbers (on the Source page)
o Preserve DS and ES segments for VDD (on the Source page)

These compiler options will be modified:

o If Object was NOT selected on the File page, it will be selected.
o If SAA level 2 was selected as the Language construct, it will be changed to
  Extended.
o If Preserve sign was selected as the Conversion rule, it will be changed to
  Preserve accuracy.
o When using version 2.1 of the WorkFrame/2* product, the compiler options used
  for specifying the map file (/Fm), the executable file (/Fe), and linker
  options (/B) will be ignored.

Those compiler options not mentioned above will be used when compiling the
template files.


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

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

o Include Debug Information (/DE[BUG])

o Optimize Intrasegment Far Calls (/F[ARCALLTRANSLATION] or
  /NOF[ARCALLTRANSLATION])

o Force Segment Ordering (/DO[SSEG])

o Sort Segments Without Adding 16-byte NULL Region (/NON[ULLSDOSSEG])

o Stack Size (/ST[ACK]:number)

o Module Load Address (/BAS[E]:number)

o Application Type (/PM[TYPE]:parameter)

o Pack The Code Segments (and Size) (/P[ACKCODE][:number]  or /NOP[ACKCODE])

o Pack the Data Segments (and Size) (/PACKD[ATA][:number])

o Maximum Number of Segments (/SE[GMENTS]:number)

o Segment Alignment (/A[LIGNMENT]:number).


ΓòÉΓòÉΓòÉ 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. Optimize Intrasegment Far Calls ΓòÉΓòÉΓòÉ

Select this option to optimize far calls by converting them to near calls if
possible. Do not use this option if data in the program could appear to the
linker as far calls.

The corresponding command line option is /F[ARCALLTRANSLATION].
/NOF[ARCALLTRANSLATION] does not optimize the far calls and is the default.


ΓòÉΓòÉΓòÉ 4.3. Force Segment Ordering ΓòÉΓòÉΓòÉ

Select this option to force segments to be ordered as follows (first to last):

 1. All code segments

 2. Far data segments

 3. Near data (DGROUP) segments, in the following order:

    a. Any segments of class BEGDATA (this class name is reserved)
    b. Any segments not of class BEGDATA, BSS, or STACK
    c. Segments of class BSS
    d. Segments of class STACK
This option also initializes two special variables: _edata is initialized to
DGROUP :BSS and _end is initialized to DGROUP : STACK. These variables have
special meanings for some compilers so you should avoid using them in your
programs. Assembly-language programs can refer to _edata and _end but not
modify them.

If the _TEXT segment is defined, 16 NULL bytes are added to the beginning of
it.

The corresponding command line option is /DO[SSEG].


ΓòÉΓòÉΓòÉ 4.4. Sort Segments Without Adding 16-byte NULL Region ΓòÉΓòÉΓòÉ

Select this option to write the segments to the module in the order detailed in
the Force Segment Ordering help.

Unlike Force segment ordering, it does not add 16 NULL bytes to the beginning
of the code segment.

Note:  Do not select this option if the program is being linked with a product
       (such as the C/2* compiler libraries) that requires the NULL bytes
       region.

The corresponding command line option is /NON[ULLSDOSSEG].


ΓòÉΓòÉΓòÉ 4.5. 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:

o Hexadecimal (prefixed by 0x as in 0x2D7)

o Octal (prefixed by zero as in 027)

o Decimal (cannot start with zero as in 27).
The default value is found within the object modules.

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


ΓòÉΓòÉΓòÉ 4.6. 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:

o Hexadecimal (prefixed by 0x as in 0x2D7)

o Octal (prefixed by zero as in 027)

o 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.7. 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 IBM
C/C++ Tools compiler 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.8. Pack The Code Segments (and Size) ΓòÉΓòÉΓòÉ

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:

o Hexadecimal (prefixed by 0x as in 0x2D7)

o Octal (prefixed by zero as in 027)

o 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 (and Size) ΓòÉΓòÉΓòÉ

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:

o Hexadecimal (prefixed by 0x as in 0x2D7)

o Octal (prefixed by zero as in 027)

o 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 zero to 16375. You can use any of the
following formats:

o Hexadecimal (prefixed by 0x as in 0x2D7)

o Octal (prefixed by zero as in 027)

o Decimal (cannot start with zero as in 27).

There is no default value for the LINK386.EXE linker.

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 for 16-bit code and 16 for 32-bit code.

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


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

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

They are:

o Do Not Display the Logo (/NOL[OGO])

o Display Link-time Information (/INF[ORMATION])

o Run Linker in Batch Mode (/BA[TCH])

o Generate Warnings for Fixups (/W[ARNFIXUP])

o Search the Extended Dictionary (/NOE[XTDICTIONARY])

o Ignore Default Libraries (and Particular Libraries to Ignore)
  (/NOD[EFAULTLIBRARYSEARCH][:libname])

o Map File


ΓòÉΓòÉΓòÉ 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. Run Linker in Batch Mode ΓòÉΓòÉΓòÉ

This option causes warning or error messages when a library cannot be found
instead of prompting the user for a new path to the library.

The corresponding command line option is /BA[TCH].


ΓòÉΓòÉΓòÉ 5.4. Generate Warnings for Fixups ΓòÉΓòÉΓòÉ

This option causes a message to be produced for each fixup found or generated
in the module.

The corresponding command line option is /W[ARNFIXUP].


ΓòÉΓòÉΓòÉ 5.5. 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, /NOE[XTDICTIONARY], causes the linker to
NOT search the extended dictionary.


ΓòÉΓòÉΓòÉ 5.6. Ignore Default Libraries (and Particular Libraries to Ignore) ΓòÉΓòÉΓòÉ

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.7. Map File ΓòÉΓòÉΓòÉ

Use the Map File options to specify the content of the map file:

None
          Do not create a map file.

Regular
          Show offsets of all the external symbols that appear in the module.

Full
          Include information about how the references are resolved as well as
          showing the offsets of all external symbols. Select Full only if you
          are using the LINK386.EXE linker.

The corresponding command line options are:

/M[AP]
          If Regular is selected and a maximum number of entries is not
          specified.

/M[AP]:number
          If Regular is selected and a maximum number of entries is specified.

/M[AP]:FULL
          If Full is selected.


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

When using version 2.1 of the WorkFrame/2* product, the entry field contains
the %o substitution variable. This variable is substituted with the Target file
name specified in the project's Settings note book.

The corresponding compiler command line option is /Fefilename.


ΓòÉΓòÉΓòÉ 6.2. Map File Name ΓòÉΓòÉΓòÉ

Enter the name of the map file to be produced. If one is not specified, no map
file will be produced unless the Produce A Public Symbol Map check box was
selected on the Processing page. If no extension is specified, the linker
assumes the extension is MAP.

The corresponding compiler command line option is /Fmfilename.


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


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

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