home *** CD-ROM | disk | FTP | other *** search
-
- ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ
-
- References in this help to IBM products, programs, or services do not imply
- that IBM intends to make these available in all countries in which IBM
- operates.
-
- Any reference to an IBM licensed program in this help is not intended to state
- or imply that only IBM's licensed program may be used. Any functionally
- equivalent product, program, or service that does not infringe any of IBM's
- intellectual property rights may be used instead of the IBM product, program,
- or service.
-
- Evaluation and verification of operation in conjunction with other products,
- except those expressly designated by IBM, is the user's responsibility.
-
- IBM may have patents or pending patent applications covering subject matter in
- this help. The furnishing of this help does not give you any license to these
- patents.
-
- The following terms, denoted by an asterisk (*) in this help, are trademarks of
- the IBM Corporation in the United States and/or other countries:
-
- C/2
- C Set/2
- IBM
- OS/2
- Operating System/2
- Presentation Manager
- WorkFrame/2
-
- This help contains examples of data and reports used in daily business
- operations. To illustrate them as completely as possible, the examples include
- the names of individuals, companies, brands, and products. All of these names
- are fictitious and any similarity to the names and addresses used by an actual
- business enterprise is entirely coincidental.
-
-
- ΓòÉΓòÉΓòÉ 2. Link Options ΓòÉΓòÉΓòÉ
-
- Use this window 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. Save With Project ΓòÉΓòÉΓòÉ
-
- Select Save with project to save the options with the other information of the
- project you are currently working on. Otherwise, the changes only remain in
- effect until the WorkFrame/2* session is closed.
-
-
- ΓòÉΓòÉΓòÉ 3. Generation Options ΓòÉΓòÉΓòÉ
-
- Use this window to control the format and content of the executable file
- produced by the linker:
-
- o Include Debug Information (/CO[DEVIEW])
-
- 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 Application Type (/PM[TYPE]:parameter)
-
- o Pack The Code Segment (and Size) (/P[ACKCODE][:number] or /NOP[ACKCODE])
-
- o Pack Neighboring Logical Data (and Size) (/PACKD[ATA][:number])
-
- o Maximum Number of Segments (/SE[GMENTS]:number)
-
- o Stack Size (/ST[ACK]:number)
-
- o Module Load Address (/BAS[E]:number)
-
- o Segment Alignment (/A[LIGNMENT]:number).
-
-
- ΓòÉΓòÉΓòÉ 3.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 /CO[DEVIEW].
-
-
- ΓòÉΓòÉΓòÉ 3.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.
-
-
- ΓòÉΓòÉΓòÉ 3.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].
-
-
- ΓòÉΓòÉΓòÉ 3.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].
-
-
- ΓòÉΓòÉΓòÉ 3.5. Pack The Code Segment (and Size) ΓòÉΓòÉΓòÉ
-
- Select Pack the code segment to concatenate the code segments when building the
- module.
-
- If the Pack the code segment 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 segment is selected. /NOP[ACKCODE] causes the
- linker to not pack the code.
-
- /PACKC[ODE]:number
- If a number is entered in the Size field.
-
-
- ΓòÉΓòÉΓòÉ 3.6. Pack Neighboring Logical Data (and Size) ΓòÉΓòÉΓòÉ
-
- Select Pack neighboring logical data to concatenate the data segments together
- when building the module.
-
- If the Pack neighboring logical data 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] (the default)
- If the Pack neighboring logical data is selected.
-
- /PACKD[ATA]:number
- If a number is entered in the Size field.
-
-
- ΓòÉΓòÉΓòÉ 3.7. 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 3072 (for the LINK.EXE linker) or zero
- to 16375 (for the LINK386.EXE linker). 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 for the LINK.EXE linker is 128. There is no default value
- for the LINK386.EXE linker.
-
- The corresponding command line option is /SE[GMENTS]:number.
-
-
- ΓòÉΓòÉΓòÉ 3.8. 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.
-
-
- ΓòÉΓòÉΓòÉ 3.9. 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).
-
- The corresponding command line option is /BAS[E]:number.
-
-
- ΓòÉΓòÉΓòÉ 3.10. Segment Alignment ΓòÉΓòÉΓòÉ
-
- Specify the segment alignment factor (in bytes) in the executable file. The
- default value is 512 for 16-bit code and 4096 for 32-bit code.
-
- The corresponding command line option is /A[LIGNMENT]:number.
-
-
- ΓòÉΓòÉΓòÉ 3.11. 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.
-
- 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. Processing Options ΓòÉΓòÉΓòÉ
-
- The options that appear on this window specify to the linker how to build the
- executable file.
-
- They are:
-
- o Do Not Display the Logo (/NOL[OGO])
-
- o No Extended Dictionary Search (/NOE[XTDICTIONARY])
-
- o Display Link-time Information (/INF[ORMATION])
-
- o Run Linker in Batch Mode (/BA[TCH])
-
- o Do Not Ignore Case in Symbol Names (/NOI[GNORECASE])
-
- o Copy Source Line Numbers to Map File (/LI[NENUMBERS])
-
- o Generate Warnings for Fixups (/W[ARNFIXUP])
-
- o Ignore Default Library Search (and Particular Libraries to Ignore)
- (/NOD[EFAULTLIBRARYSEARCH][:libname])
-
- o Produce A Public Symbol Map (and Maximum Number Of Entries)
- (/M[AP][:parameter]).
-
-
- ΓòÉΓòÉΓòÉ 4.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]).
-
-
- ΓòÉΓòÉΓòÉ 4.2. No Extended Dictionary Search ΓòÉΓòÉΓòÉ
-
- Select this option to ignore the extended library information (if it exists)
- found in the library.
-
- The corresponding command line option is /NOE[XTDICTIONARY].
-
-
- ΓòÉΓòÉΓòÉ 4.3. Display Link-time Information ΓòÉΓòÉΓòÉ
-
- Select this option to display messages as it creates the executable file.
-
- The corresponding command line option is /INF[ORMATION].
-
-
- ΓòÉΓòÉΓòÉ 4.4. 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].
-
-
- ΓòÉΓòÉΓòÉ 4.5. Do Not Ignore Case in Symbol Names ΓòÉΓòÉΓòÉ
-
- Select this option to respect the case of external definitions when trying to
- resolve external references.
-
- The corresponding command line option is /NOI[GNORECASE].
-
-
- ΓòÉΓòÉΓòÉ 4.6. Copy Source Line Numbers to Map File ΓòÉΓòÉΓòÉ
-
- Select this option to include line number information in the map file
- generated.
-
- The corresponding command line option is /LI[NENUMBERS].
-
-
- ΓòÉΓòÉΓòÉ 4.7. 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].
-
-
- ΓòÉΓòÉΓòÉ 4.8. Ignore Default Library Search (and Particular Libraries to Ignore) ΓòÉΓòÉΓòÉ
-
- Select Ignore default library search 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 library
- search 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.
-
-
- ΓòÉΓòÉΓòÉ 4.9. Produce A Public Symbol Map (and Maximum Number Of Entries) ΓòÉΓòÉΓòÉ
-
- Use the Produce a public symbol map radio buttons 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.
-
- If you selected Regular and are using the LINK.EXE linker, you can use the
- Maximum number of entries field to specify the number of external symbols that
- the linker should be able to handle. If the linker produces a message
- indicating the map symbol limit is too high, reduce the limit until the
- message stops appearing. The number must be in the range 1 to 32767 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).
- The default value is 2048.
-
- 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.
-
-
- ΓòÉΓòÉΓòÉ 5. File Name Options ΓòÉΓòÉΓòÉ
-
- This window lets you specify the names of the following files:
-
- Module 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.
-
-
- ΓòÉΓòÉΓòÉ 5.1. Module File Name ΓòÉΓòÉΓòÉ
-
- Enter the name of the module file to be produced. If a name is not specified,
- the linker uses the file name of the first object passed to it and adds an
- extension of either EXE or DLL as appropriate. If a name is specified without
- an extension, the linker assumes the extension is either EXE or DLL.
-
-
- ΓòÉΓòÉΓòÉ 5.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 in the Processing Options window. If no extension is specified, the
- linker assumes the extension is MAP.
-
-
- ΓòÉΓòÉΓòÉ 5.3. Libraries to Use ΓòÉΓòÉΓòÉ
-
- Enter the names of the libraries to be searched when the linker tries to
- resolve the external references found in the objects it is linking. If no
- extension is specified in a library name, the linker assumes the extension is
- LIB. The linker searches these libraries before those specified in the objects
- themselves.
-
- You can also specify paths to be searched for the required libraries. Any paths
- you specify will be searched before those in the LIB environment variable.
-
- Note: Use a space (' ') or a plus sign ('+') to separate the entries.
-
-
- ΓòÉΓòÉΓòÉ 5.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> Common Pushbuttons ΓòÉΓòÉΓòÉ
-
-
- ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
-
- Select OK to save the options you chose and remove this window.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
-
- Select Reset to set the options to the values they had when the window was
- opened.
-
- If Reset is selected from the main Link Options window, every link option is
- reset.
-
- If Reset is selected from the one of the pop-up windows selected from the Link
- Options window, only the link options in that pop-up window are reset.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
-
- Select Default to set the options to their default values.
-
- If Default is selected from the main Link Options window, every link option is
- set to its default value.
-
- If Default is selected from the one of the pop-up windows, only the link
- options in that pop-up window are set to the default values.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
-
- Select Cancel to remove the window 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.
-